-
Notifications
You must be signed in to change notification settings - Fork 20
Publication checklist
This page presents some reminders on what to check before you submit your publication.
Most of these are the result of basic errors or the lack of typographical knowledge. As such, they can be checked with a simple search or just skimming through the document.
Advice from others: Checklist for Revising a SIGKDD Data Mining Paper by Eamonn Keogh
- Scroll through the document and thoroughly check for todos. Do a quick search for the
todostring. - Make sure that figure and table caption punctuations are consistent. A possible punctuation is that they all have a dot at the end of the caption.
- Check number formattings. In English texts, the decimal separator should be a
.character. You may add a small non-breaking space between every three digit by using thenumprintpackage, e.g.\numprint{123456}. - Make sure that you use headline capitalization consistently throughout the document. To check this, seach for
section{which will give you all\section{...},\subsection{...}and\subsubsection{...}lines. If you use paragraphs, also search for\paragraph{. - Check your quotation marks. Use the International variations table and the Quotation mark glyphs table.
-
Broken references: search for
[?],[?,,,?,and,?]in the PDF document. -
Broken citations: search for
??in the PDF document. Citations should be punctuated like this one [1]. -
Most templates do not use the
\frenchspacingoption, which makes the space character wider after each dot character. Typically, you should search for occurences ofe.g.andi.e.to change them toe.g.\andi.e.\, respectively. You can define commands to never forget about this:\usepackage{xspace} \newcommand{\ie}{\emph{i.e.}\@\xspace} \newcommand{\eg}{\emph{e.g.}\@\xspace} \newcommand{\etal}{\emph{et al.}\@\xspace} \newcommand{\etc}{etc.\xspace}
Using italics (
\emph) is optional. In US spelling, you should also add commas after 'i.e.' and 'e.g.'. -
Check your Bibliography. If something should be capitalized, add braces to the title, e.g.
{MONDO} {P}rojectand{I}nc{Q}uery-{D}. However, do not add double braces ({{...}}) around the whole title. For details, see How to not mess up your bibliographies with Bibtex. -
Check whether the bibliography has
\_instead of a simple underscore_. Some templates do not omit the backslash automatically, leading to broken links.
- Broken references and citations: search for the string
Error!. This will give you the error messages, including Error! Reference Source Not Found. and Error! Bookmark Not Defined..
-
Have you used the correct font for the intended publishing?
- See a good comparison of TeX fonts in this document: Stephen G. Hartke: A Survey of Free Math Fonts for TeX and LaTeX
Use the Silver Searcher (Windows port) to search for typical errors, such as repeated words (e.g., "the the"):
ag -s " a [aeioAEIOU]"
ag -i " an [bcdfghjklmnpqrstvxzwy]"
ag -i "\s\b(\w+) +\1\b"
ag -i "\s\b(\w+ +\w+) +\1\b"Find instances of inconsistent spelling -- for example, if you want to use British spelling and want to eliminate optimize, optimization, etc., run:
ag '\w+(ization|ize)' --tex -o --no-filename *.tex | sort -uIf you use US spelling, search for:
ag '\w+(isation|ise)' --tex -o --no-filename *.tex | sort -uIf some fonts, e.g. Helvetica, are missing, try converting the document to PDF/A which replaces fonts.
If your figures are missing some fonts (e.g. if they were generated with R and do not have Helvetica and ZapfDingbats embedded), you can also use the following command to embed them with GhostScript. This will embed fonts into all the figures in the fig/ folder, adjust appropriately if needed:
for i in fig/**/*.pdf; do gs -dCompatibilityLevel=1.4 -dPDFSETTINGS=/screen -dCompressFonts=true -dSubsetFonts=true -dNOPAUSE -dBATCH -sDEVICE=pdfwrite -sOutputFile=$i.embed -c ".setpdfwrite <</NeverEmbed [ ]>> setdistillerparams" -f $i; mv $i.embed $i; done-dPDFSETTINGS=/screen rasterizes images to 72dpi.
Use the useDingbats=FALSE option for ggsave, for example:
ggsave(file="results.pdf", width=170, height=160, units="mm", useDingbats=FALSE)During the submission of a paper to SOSYM (Software & Systems Modeling), we experienced that some figures (created in Microsoft PowerPoint and Visio) in the "PDF proof" version (intended for proofreading) were missing all captions. This was strange since the captions used Arial font as recommended by SOSYM. Changing the LaTeX build from PDFLaTeX to XeLaTeX solved the problem.
Experiences as of 2020:
- ACM: no
- easyChair: yes
- CMT: yes