用ACM样式为Arxiv排版文档

这是我排版文档的经验,该文档使用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处理手稿。