Skip to content

Quick start for modern LaTeXing for an ACM conference

Notifications You must be signed in to change notification settings

latextemplates/ACM

Repository files navigation

ACM

Quick start for modern LaTeXing for an ACM conference.

The official template is distributed via CTAN as the acmart package, which is actively maintained. However, de-facto configurations (hyperref) and modern features of latex (microtype) are not configured. This template does it.

This template is for the conferences. In case you need other configurations, please adapt paper-conference.tex or run the latex template generator.

To build the whole document, execute following command. Note that this requires a working perl installation.

latexmk paper

To enable this, please move _latexmkrc to latexmkrc.

In case something goes wrong, you can instruct the LaTeX compiler to stop at the first error:

lualatex paper

Benefits

Following features are enabled in this template:

  • (Optional) Typesetting of listings using advanced highlighting powered by the minted package.
  • Generated PDF allows for copy and paste of text without getting words with ligatures such as "workflow" destroyed. This is enabled by glyphtounicode, which encodes ligatures (such as fl) using unicode characters.
  • Support of hyperlinked references without extra color thanx to hyperref.
  • Better breaking of long URLs.
  • Support for \powerset command.
  • (Optional) Support todos as pdf annotations. This is enabled by the pdfcomment package.
  • microtypographic extensions for a better look of the paper.
  • Modern packages such as microtype, cleveref, csquotes, paralist, hyperref, hypcap, upquote, booktabs.
  • (Optional) LaTeX compilation using the modern lualatex compiler.
  • Ready-to-go configuration for latexindent.
  • Proper hyphenation and microtype for English texts.

Disabled features

Following features were not activated for this template. You can run the latex template generator to enable the features.

Hints on writing an abstract and thesis by Dirk Fahland.

Tool hints

MiKTeX installation hints are given at http://latextemplates.github.io/scientific-thesis-template/#installation-hints-for-windows.

To have minted running properly, you have to do following steps on Windows:

  1. Install python: choco install python - that uses chocolatey to install Python
  2. Install pygments: pip instal pygments - that uses the Pyhton package manager to install the pygments library
  3. When latexing, use -shell-escape: pdflatex -shell-escape paper. You can also just execute latexmk paper.

Usage with docker

The generated Dockerfile is based on the Dockerfile by the Island of TeX.

docker run --rm -v "c:\users\example\latex-document:/workdir" latexmk

Following one-time setup is required:

docker build -t ltg .

FAQs

Q: How can I synchronize updates from the template to my repository?

  1. Initialize your git repository as usual
  2. Add this repository as upstream: git remote add upstream https://github.com/latextemplates/LNCS.git
  3. Merge the branch upstream/main into your main branch: git merge upstream/main.

After that you can use and push the main branch as usual. Notes on syncing with the upstream repository are available from GitHub.

Q: I get the error ! pdfTeX error (font expansion): auto expansion is only possible with scalable fonts.

Install the cm-super package using the MiKTeX package manager. Then, run initexmf --mkmaps on the command line. (Long description: https://tex.stackexchange.com/a/324972/9075)

Q: I get Package csquotes Error: Unbalanced groups or invalid nesting. What can I do?

A: You have activated \MakeOuterQuote{"} and used some special babel command to allow hyphenation at other places as a dash. One example is writing application"=specific. Now, you have to decide whether you want keep using plain quotes to enquote a word or use the special hyphenation command. In other words: Do you want "quote" and app\-lication\-specific or \enquote{quote} and application"=specific?

Note that this should not happen when the template is generated as the setting tweakouterquote ensures that these two options are mutually exclusive.

Q: I need more space. What can I do?

The most simple solution to get more space is to exchange the font.

Q: How can I reformat my .tex files?

Execute following command:

latexindent -l -s -sl -w paper.tex

Q: I want to obey the one-sentence-per-line rule. How can I do that?

Execute following command:

latexindent -m -l -s -sl -w paper.tex

Attention! This is work in progress and does not always produce best results.

Q: Can I also write in German?

Yes. You can regenerate the template and choose "German" as language.

Q: ngerman-x-latest is reported missing

Install the package dehyph-exptl.

Q: I get ! I can't find file `clmr28t10+20'.

You seem to use latexmk locally. Please move _latexmkrc to latexmkrc to get latexmk working. If you don't do this, latexmk tries to execute latex, which tries to produce a DVI file (and not a PDF file).

Further information

About

Quick start for modern LaTeXing for an ACM conference

Resources

Stars

Watchers

Forks

Languages