[Tex/LaTex] How to decypher Arxiv latex compilation errors

arxiv

I am trying to make my first submission to arXiv. I have a document with multiple include modules and images. When arXiv compiles it, it throws a lot of output, the major error being:

! LaTeX Error: Unknown option 'nameinlink' for package 'cleveref'.

Needless to say that the document compiles no problem on my machine.

I will write the document preamble here, perhaps it is of any help

\documentclass[a4paper,11pt]{article}

\usepackage[sort&compress,super]{natbib}
\usepackage[T1]{fontenc}

\usepackage[english]{babel}
\usepackage{amsmath, esint}
\usepackage{amssymb}
\usepackage{graphicx}
\usepackage{tabularx}
\usepackage{caption}
\usepackage{subcaption}
\usepackage{url}
\usepackage{array}
\usepackage{algorithm,algorithmic}
\usepackage{tikz}
\usepackage{url}  
\usetikzlibrary{arrows}
\usetikzlibrary{mindmap,trees}
\usepackage[overlay,absolute]{textpos}
\usepackage{wrapfig}
\usepackage{makeidx}
\usepackage{listings}
\usepackage{color}
\usepackage{xcolor}
\usepackage{enumitem}
\usepackage[normalem]{ulem}
\usepackage{mathtools}
\usepackage{lscape}
\usepackage{hyperref}
\usepackage{cleveref}

\usepackage{mdframed}
\definecolor{mycolor}{rgb}{0.122, 0.435, 0.698}

Please help

EDIT

Removing [nameinlink] from cleveref brings me one step further:

! LaTeX Error: Option clash for package hyperref.

See the LaTeX manual or LaTeX Companion for explanation.
Type H <return> for immediate help.
...

l.107 \begin
{document}
?
! Emergency stop.
...

EDIT 2

Sorry, I forgot the mdframed in the original post

Best Answer

I have found the solution here.

Option clash with hyperref

The answer is to completely ignore hyperref errors and ensure that all of the other errors - e.g. missing pictures are in place. If the above error is the only error in the document, it compiles nevertheless

Related Solutions

[Tex/LaTex] How to upload LaTeX-generated pdf paper to arXiv without LaTeX sources

Update 2018-11-26: According to the comment from Andrew MacFie, this method no longer works: the arXiv have put in place a check specifically for this. Whether or not they have solved the underlying problem, I have no idea. Whether or not a variation of this solution would work, I have no idea.

I strongly advise uploading the source code to the arXiv for archival purposes. Once the document itself is made public, there is no reason I can think of for not making the source code public. That said, there can be reasons for avoiding the arXiv's own compiler if it doesn't have up to date versions of packages that you use and, for example, uploading the entirety of TikZ/PGF with your document seems a little excessive. (NB For TikZ/PGF specifically, the external library is a big help here.)

Include a PDF copy of the article with your submission (with a slightly modified filename), and at the top of the document put the following (suitably edited):

\documentclass[a4paper]{article}
\pdfoutput=1
\usepackage{hyperref}
\hypersetup{
  pdfinfo={
    Title={Your Title Here},
    Author={Your Name Here},
    Subject={If you want to put something here, do so},
    Keywords={Add some keywords if you feel so inclined}
  }
}
\usepackage{pdfpages}

\begin{document}
\includepdf[pages=1-last]{the_real_article.pdf}
\end{document}

<rest of source code goes here>

I think that to comply with the spirit of the arXiv, in that you're making stuff generally available, then if you are doing this then you should go the extra mile and include something like the list of packages used with their versions so that someone who downloads the source will know what they need in order to compile it.

I can attest to the fact that this has worked in the past.

[Tex/LaTex] Arxiv Latex Upload Error

The log file you get says it all:

Package pdfpages Warning: I will use a dummy \includepdf command
(pdfpages) which will NOT insert any pages, because
(pdfpages) you are producing DVI output.

You need that your submission is processed with pdflatex, not with the latex engine that arXiv uses by default.

From the help page of arXiv, http://arxiv.org/help/submit_tex

Considerations for PDFLaTeX submissions

arXiv fully supports and recognizes PDFLaTeX. You can ensure pdflatex processing by setting \pdfoutput=1 within the first 5 lines of the preamble of the main pdflatex file. You should not need any other special flag. However since this is a relatively new feature, we urge you to carefully verify the PDF arXiv generates and to report any problems which may surface.

Should you need conditional branching in your source, use the ifpdf package. Do not re-invent the wheel. ifpdf provides a robust and well tested mechanism to distinguish between pdflatex in pdf mode and other modes or engines.

Some packages may require a particular back-end driver, in the form of a package option, e.g. \usepackage[pdftex]{...}. However, the graphics and hyperref packages determine the proper driver automatically; you don't have to make this explicit choice and should not do so to avoid conflicts.

You can use the full range of pdf specific hypertex options to augment metadata in the PDF file, e.g. \hypersetup{pdfauthor={some author},pdftitle={eye-catching title}}.

Figures can be included in JPEG, PNG, or PDF format with the standard graphics package. For security reasons arXiv does not allow for automated format conversion, so your figures must be in the proper format already.

Unlike native LaTeX, the default output format for PDFLaTeX is PDF, with no intermediate DVI or PostScript. Thus, these formats are not available for download for PDFLaTeX submissions.

So the best solution to your problem is starting the main file with

\pdfoutput=1

\documentclass[...]{...}

Best Answer

Related Solutions

[Tex/LaTex] How to upload LaTeX-generated pdf paper to arXiv without LaTeX sources

[Tex/LaTex] Arxiv Latex Upload Error

Related Question