

这是我排版文档的经验,该文档使用Latex中的铸造包和acmart文档类提交给arxiv.org。
这是我的文档的序言,该文档已由arxiv处理系统成功处理,生成的PDF文档看上去与在笔记本电脑上生成的PDF文档非常相似。
\ documentclass [sigconf] {acmart} \ makeatlet%1
\ def \ mdseries @ tt {m}%1
\ makeatother%1 \ usepackage [plain] {fancyref}
\ usepackage [draft = true] {minted}%2
\ usepackage {颜色}
\ usepackage {hyperref}%5
\ hypersetup {
colorlinks = true,
linkcolor =蓝色,
filecolor = red,
urlcolor =洋红色,
breaklinks = true,%3
}
\ usepackage {breakurl}%3 \ begin {document}
\草率%4
这是在序言中进行各种调整的原因。
调整1:使用2016 Tex发行版编译不包含代码段%1的文档将导致以下失败。
! Undefined control sequence. \mdseries@tt l.562 ...FV@BreakSymbolIndentLeft}{\ttfamily xxxx}
这是一个已知的问题。
对于2017年Tex发行版[pdfTeX 3.14159265–2.6–1.40.18(TeX Live 2017),不需要片段%1即可解决此问题。
调整2:在第%2行中使用不带[draft=true]选项的pdflatex编译文档将导致以下失败。
打包ifplatform警告:
外壳转义已禁用,因此我只能检测\ ifwindows。
)(/usr/local/texlive/2017/texmf-dist/tex/latex/framed/framed.sty))
! 软件包铸造错误:您必须使用-shell-escape标志调用LaTeX。
有关说明,请参见铸造的包装文档。
可以通过使用-shell-escape选项调用pdflatex来解决此问题。 但是,不能在arxiv处理系统中指定此选项。
调整3:不带行%3编译将导致URL悬垂。 尽管文档说指定\usepackage{breakurl} breaklinks=true或\usepackage{breakurl}就足够了,但都需要两个参数,以避免在arxiv处理系统中出现URL溢出。
调整4:在没有行%4情况下进行编译将导致文本悬空。
调整5:用%5行编译文档将导致以下失败。
! LaTeX Error: Option clash for package hyperref.
原因是arxiv处理系统将在处理文档时自动加载hyperref包,并且多次加载hyperref包时会失败。
在将文档提交给arxiv时,提交另一个名为00README.XXX且其内容为nohypertex的文件将解决此故障,因为nohypertex将指示arxiv处理系统不要自动加载hyperref包。
在此过程中,当我涉足这些问题时,arxiv帮助团队非常响应并乐于助人。
更新
2018年5月3日:在主tex文件的前五行中放置\pdfoutput=1将强制arxiv使用pdflatex处理手稿。