Does anyone have experience using pandoc markdown with ACM sig-alternate style?

Does anyone have experience using pandoc markdown with ACM sig-alternate style?

[Brian Danielak]

[-- Attachment #1.1: Type: text/plain, Size: 4418 bytes --]

## Background

I had been writing a manuscript in pandoc markdown, but I'd like to submit 
it to an upcoming ACM conference. 

The relevant ACM style files are 
here: https://www.acm.org/publications/proceedings-template

## The problem(s) I experience

### Using a simple pandoc command won't compile

The first problem I experience is this

```shell
$ pandoc -f markdown -t latex -o test.pdf manuscript.Rmd

! LaTeX Error: Missing \begin{document}.

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

l.995 \Gm@process

pandoc: Error producing PDF
```

### I don't know how to integrate the ACM cls file into a pandoc template

I suspect maybe I'm having this problem because I need to create a custom 
template for pandoc to use(?). But I spent hours trying to frankenstein the 
pandoc template into the existing sample .tex document the ACM provides, 
and all attempts have failed. Then I tried putting the sample .tex file 
from the ACM into the default pandoc template, and I haven't had any 
success on that route either.

I get the same error running `rmarkdown::render()` on the manuscript. I'm 
guessing this error is related to the default 

## Steps to reproduce

I'm basically running a simple pandoc command on this proof-of-concept test 
manuscript file: https://gist.github.com/briandk/31505cfd2c0609aa496a

```shell
$ pandoc -f markdown -t latex -o test.pdf manuscript.Rmd
```

## Existing solutions I found that don't quite work

This person has a great repository, but they're using a totally different 
cls file from the ACM, and my conference does not accept that cls file:

https://github.com/jakobib/pandoc-acm-templates

So, it's not clear to me what (if anything) I would need to do to adapt 
their solution to my use case :-(

## System info

```
# System

Mac OS X El Capitan (10.11.4)

# pandoc

pandoc 1.17.0.3
Compiled with texmath 0.8.5, highlighting-kate 0.6.2.
Syntax highlighting is supported for the following languages:
    abc, actionscript, ada, agda, apache, asn1, asp, awk, bash, bibtex, 
boo, c,
    changelog, clojure, cmake, coffee, coldfusion, commonlisp, cpp, cs, css,
    curry, d, diff, djangotemplate, dockerfile, dot, doxygen, doxygenlua, 
dtd,
    eiffel, elixir, email, erlang, fasm, fortran, fsharp, gcc, glsl,
    gnuassembler, go, hamlet, haskell, haxe, html, idris, ini, isocpp, java,
    javadoc, javascript, json, jsp, julia, kotlin, latex, lex, lilypond,
    literatecurry, literatehaskell, llvm, lua, m4, makefile, mandoc, 
markdown,
    mathematica, matlab, maxima, mediawiki, metafont, mips, modelines, 
modula2,
    modula3, monobasic, nasm, noweb, objectivec, objectivecpp, ocaml, 
octave,
    opencl, pascal, perl, php, pike, postscript, prolog, pure, python, r,
    relaxng, relaxngcompact, rest, rhtml, roff, ruby, rust, scala, scheme, 
sci,
    sed, sgml, sql, sqlmysql, sqlpostgresql, tcl, tcsh, texinfo, verilog, 
vhdl,
    xml, xorg, xslt, xul, yacc, yaml, zsh
Default user data directory: /Users/briandanielak/.pandoc
Copyright (C) 2006-2016 John MacFarlane
Web:  http://pandoc.org
This is free software; see the source for copying conditions.
There is no warranty, not even for merchantability or fitness
for a particular purpose.

# latex

pdfTeX 3.14159265-2.6-1.40.16 (TeX Live 2015)
kpathsea version 6.2.1
Copyright 2015 Peter Breitenlohner (eTeX)/Han The Thanh (pdfTeX).
There is NO warranty.  Redistribution of this software is
covered by the terms of both the pdfTeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the pdfTeX source.
Primary author of pdfTeX: Peter Breitenlohner (eTeX)/Han The Thanh (pdfTeX).
Compiled with libpng 1.6.17; using libpng 1.6.17
Compiled with zlib 1.2.8; using zlib 1.2.8
Compiled with xpdf version 3.04
```

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/c247e2a0-b60f-4337-b2ec-fccc8828f93a%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #1.2: Type: text/html, Size: 5990 bytes --]

Re: Does anyone have experience using pandoc markdown with ACM sig-alternate style?

[John MACFARLANE]

You have:

geometry: paperwidth=8.5in paperheight=11in

Try:

geometry: paperwidth=8.5in,paperheight=11in


+++ Brian Danielak [Mar 27 16 22:10 ]:
>   ## Background
>   I had been writing a manuscript in pandoc markdown, but I'd like to
>   submit it to an upcoming ACM conference.
>   The relevant ACM style files are
>   here: https://www.acm.org/publications/proceedings-template
>   ## The problem(s) I experience
>   ### Using a simple pandoc command won't compile
>   The first problem I experience is this
>   ```shell
>   $ pandoc -f markdown -t latex -o test.pdf manuscript.Rmd
>   ! LaTeX Error: Missing \begin{document}.
>   See the LaTeX manual or LaTeX Companion for explanation.
>   Type  H <return>  for immediate help.
>    ...
>   l.995 \Gm@process
>   pandoc: Error producing PDF
>   ```
>   ### I don't know how to integrate the ACM cls file into a pandoc
>   template
>   I suspect maybe I'm having this problem because I need to create a
>   custom template for pandoc to use(?). But I spent hours trying to
>   frankenstein the pandoc template into the existing sample .tex document
>   the ACM provides, and all attempts have failed. Then I tried putting
>   the sample .tex file from the ACM into the default pandoc template, and
>   I haven't had any success on that route either.
>   I get the same error running `rmarkdown::render()` on the manuscript.
>   I'm guessing this error is related to the default
>   ## Steps to reproduce
>   I'm basically running a simple pandoc command on this proof-of-concept
>   test manuscript
>   file: https://gist.github.com/briandk/31505cfd2c0609aa496a
>   ```shell
>   $ pandoc -f markdown -t latex -o test.pdf manuscript.Rmd
>   ```
>   ## Existing solutions I found that don't quite work
>   This person has a great repository, but they're using a totally
>   different cls file from the ACM, and my conference does not accept that
>   cls file:
>   https://github.com/jakobib/pandoc-acm-templates
>   So, it's not clear to me what (if anything) I would need to do to adapt
>   their solution to my use case :-(
>   ## System info
>   ```
>   # System
>   Mac OS X El Capitan (10.11.4)
>   # pandoc
>   pandoc 1.17.0.3
>   Compiled with texmath 0.8.5, highlighting-kate 0.6.2.
>   Syntax highlighting is supported for the following languages:
>       abc, actionscript, ada, agda, apache, asn1, asp, awk, bash, bibtex,
>   boo, c,
>       changelog, clojure, cmake, coffee, coldfusion, commonlisp, cpp, cs,
>   css,
>       curry, d, diff, djangotemplate, dockerfile, dot, doxygen,
>   doxygenlua, dtd,
>       eiffel, elixir, email, erlang, fasm, fortran, fsharp, gcc, glsl,
>       gnuassembler, go, hamlet, haskell, haxe, html, idris, ini, isocpp,
>   java,
>       javadoc, javascript, json, jsp, julia, kotlin, latex, lex,
>   lilypond,
>       literatecurry, literatehaskell, llvm, lua, m4, makefile, mandoc,
>   markdown,
>       mathematica, matlab, maxima, mediawiki, metafont, mips, modelines,
>   modula2,
>       modula3, monobasic, nasm, noweb, objectivec, objectivecpp, ocaml,
>   octave,
>       opencl, pascal, perl, php, pike, postscript, prolog, pure, python,
>   r,
>       relaxng, relaxngcompact, rest, rhtml, roff, ruby, rust, scala,
>   scheme, sci,
>       sed, sgml, sql, sqlmysql, sqlpostgresql, tcl, tcsh, texinfo,
>   verilog, vhdl,
>       xml, xorg, xslt, xul, yacc, yaml, zsh
>   Default user data directory: /Users/briandanielak/.pandoc
>   Copyright (C) 2006-2016 John MacFarlane
>   Web:  http://pandoc.org
>   This is free software; see the source for copying conditions.
>   There is no warranty, not even for merchantability or fitness
>   for a particular purpose.
>   # latex
>   pdfTeX 3.14159265-2.6-1.40.16 (TeX Live 2015)
>   kpathsea version 6.2.1
>   Copyright 2015 Peter Breitenlohner (eTeX)/Han The Thanh (pdfTeX).
>   There is NO warranty.  Redistribution of this software is
>   covered by the terms of both the pdfTeX copyright and
>   the Lesser GNU General Public License.
>   For more information about these matters, see the file
>   named COPYING and the pdfTeX source.
>   Primary author of pdfTeX: Peter Breitenlohner (eTeX)/Han The Thanh
>   (pdfTeX).
>   Compiled with libpng 1.6.17; using libpng 1.6.17
>   Compiled with zlib 1.2.8; using zlib 1.2.8
>   Compiled with xpdf version 3.04
>   ```
>
>   --
>   You received this message because you are subscribed to the Google
>   Groups "pandoc-discuss" group.
>   To unsubscribe from this group and stop receiving emails from it, send
>   an email to [1]pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>   To post to this group, send email to
>   [2]pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>   To view this discussion on the web visit
>   [3]https://groups.google.com/d/msgid/pandoc-discuss/c247e2a0-b60f-4337-
>   b2ec-fccc8828f93a%40googlegroups.com.
>   For more options, visit [4]https://groups.google.com/d/optout.
>
>References
>
>   1. mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
>   2. mailto:pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
>   3. https://groups.google.com/d/msgid/pandoc-discuss/c247e2a0-b60f-4337-b2ec-fccc8828f93a-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org?utm_medium=email&utm_source=footer
>   4. https://groups.google.com/d/optout

Re: Does anyone have experience using pandoc markdown with ACM sig-alternate style?

[Brian Danielak]

[-- Attachment #1.1: Type: text/plain, Size: 7648 bytes --]

@jgm - That did it! Thank you so much! And thanks again for making pandoc 
:-)

*Follow-up*: could/should the pandoc README be clearer about how to specify 
multiple options to, say, `geometry`? Here's what it currently says under 
`geometry`

> geometry
option for geometry <https://ctan.org/pkg/geometry> package, e.g. margin=1in; 
may be repeated for multiple options

So, I assume that means this bit of YAML would be valid:

```yaml
geometry: paperwidth=8.5in
geometry: paperheight=11in
```

BUT, the comma-delimited solution you proposed (`geometry: 
paperwidth=8.5in,paperheight=11in`) wouldn't have been obvious to me just 
from the README.

Note: that solution *does* seem to be documented for a separate option 
elsewhere in the README (emphasis mine), but it also says space-delimited 
arguments are acceptable:

> --indented-code-classes=*CLASSES*

Specify classes to use for indented code blocks–for example, 
perl,numberLines or haskell. *Multiple classes may be separated by spaces 
or commas.*

I'm happy to issue a pull request or do anything additional if I can help 
:-)

On Monday, March 28, 2016 at 2:38:06 AM UTC-4, John MacFarlane wrote:
>
> You have: 
>
> geometry: paperwidth=8.5in paperheight=11in 
>
> Try: 
>
> geometry: paperwidth=8.5in,paperheight=11in 
>
>
> +++ Brian Danielak [Mar 27 16 22:10 ]: 
> >   ## Background 
> >   I had been writing a manuscript in pandoc markdown, but I'd like to 
> >   submit it to an upcoming ACM conference. 
> >   The relevant ACM style files are 
> >   here: https://www.acm.org/publications/proceedings-template 
> >   ## The problem(s) I experience 
> >   ### Using a simple pandoc command won't compile 
> >   The first problem I experience is this 
> >   ```shell 
> >   $ pandoc -f markdown -t latex -o test.pdf manuscript.Rmd 
> >   ! LaTeX Error: Missing \begin{document}. 
> >   See the LaTeX manual or LaTeX Companion for explanation. 
> >   Type  H <return>  for immediate help. 
> >    ... 
> >   l.995 \Gm@process 
> >   pandoc: Error producing PDF 
> >   ``` 
> >   ### I don't know how to integrate the ACM cls file into a pandoc 
> >   template 
> >   I suspect maybe I'm having this problem because I need to create a 
> >   custom template for pandoc to use(?). But I spent hours trying to 
> >   frankenstein the pandoc template into the existing sample .tex 
> document 
> >   the ACM provides, and all attempts have failed. Then I tried putting 
> >   the sample .tex file from the ACM into the default pandoc template, 
> and 
> >   I haven't had any success on that route either. 
> >   I get the same error running `rmarkdown::render()` on the manuscript. 
> >   I'm guessing this error is related to the default 
> >   ## Steps to reproduce 
> >   I'm basically running a simple pandoc command on this proof-of-concept 
> >   test manuscript 
> >   file: https://gist.github.com/briandk/31505cfd2c0609aa496a 
> >   ```shell 
> >   $ pandoc -f markdown -t latex -o test.pdf manuscript.Rmd 
> >   ``` 
> >   ## Existing solutions I found that don't quite work 
> >   This person has a great repository, but they're using a totally 
> >   different cls file from the ACM, and my conference does not accept 
> that 
> >   cls file: 
> >   https://github.com/jakobib/pandoc-acm-templates 
> >   So, it's not clear to me what (if anything) I would need to do to 
> adapt 
> >   their solution to my use case :-( 
> >   ## System info 
> >   ``` 
> >   # System 
> >   Mac OS X El Capitan (10.11.4) 
> >   # pandoc 
> >   pandoc 1.17.0.3 
> >   Compiled with texmath 0.8.5, highlighting-kate 0.6.2. 
> >   Syntax highlighting is supported for the following languages: 
> >       abc, actionscript, ada, agda, apache, asn1, asp, awk, bash, 
> bibtex, 
> >   boo, c, 
> >       changelog, clojure, cmake, coffee, coldfusion, commonlisp, cpp, 
> cs, 
> >   css, 
> >       curry, d, diff, djangotemplate, dockerfile, dot, doxygen, 
> >   doxygenlua, dtd, 
> >       eiffel, elixir, email, erlang, fasm, fortran, fsharp, gcc, glsl, 
> >       gnuassembler, go, hamlet, haskell, haxe, html, idris, ini, isocpp, 
> >   java, 
> >       javadoc, javascript, json, jsp, julia, kotlin, latex, lex, 
> >   lilypond, 
> >       literatecurry, literatehaskell, llvm, lua, m4, makefile, mandoc, 
> >   markdown, 
> >       mathematica, matlab, maxima, mediawiki, metafont, mips, modelines, 
> >   modula2, 
> >       modula3, monobasic, nasm, noweb, objectivec, objectivecpp, ocaml, 
> >   octave, 
> >       opencl, pascal, perl, php, pike, postscript, prolog, pure, python, 
> >   r, 
> >       relaxng, relaxngcompact, rest, rhtml, roff, ruby, rust, scala, 
> >   scheme, sci, 
> >       sed, sgml, sql, sqlmysql, sqlpostgresql, tcl, tcsh, texinfo, 
> >   verilog, vhdl, 
> >       xml, xorg, xslt, xul, yacc, yaml, zsh 
> >   Default user data directory: /Users/briandanielak/.pandoc 
> >   Copyright (C) 2006-2016 John MacFarlane 
> >   Web:  http://pandoc.org 
> >   This is free software; see the source for copying conditions. 
> >   There is no warranty, not even for merchantability or fitness 
> >   for a particular purpose. 
> >   # latex 
> >   pdfTeX 3.14159265-2.6-1.40.16 (TeX Live 2015) 
> >   kpathsea version 6.2.1 
> >   Copyright 2015 Peter Breitenlohner (eTeX)/Han The Thanh (pdfTeX). 
> >   There is NO warranty.  Redistribution of this software is 
> >   covered by the terms of both the pdfTeX copyright and 
> >   the Lesser GNU General Public License. 
> >   For more information about these matters, see the file 
> >   named COPYING and the pdfTeX source. 
> >   Primary author of pdfTeX: Peter Breitenlohner (eTeX)/Han The Thanh 
> >   (pdfTeX). 
> >   Compiled with libpng 1.6.17; using libpng 1.6.17 
> >   Compiled with zlib 1.2.8; using zlib 1.2.8 
> >   Compiled with xpdf version 3.04 
> >   ``` 
> > 
> >   -- 
> >   You received this message because you are subscribed to the Google 
> >   Groups "pandoc-discuss" group. 
> >   To unsubscribe from this group and stop receiving emails from it, send 
> >   an email to [1]pandoc-discus...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <javascript:>. 
> >   To post to this group, send email to 
> >   [2]pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <javascript:>. 
> >   To view this discussion on the web visit 
> >   [3]
> https://groups.google.com/d/msgid/pandoc-discuss/c247e2a0-b60f-4337- 
> >   b2ec-fccc8828f93a%40googlegroups.com. 
> >   For more options, visit [4]https://groups.google.com/d/optout. 
> > 
> >References 
> > 
> >   1. mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <javascript:> 
> >   2. mailto:pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <javascript:> 
> >   3. 
> https://groups.google.com/d/msgid/pandoc-discuss/c247e2a0-b60f-4337-b2ec-fccc8828f93a-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org?utm_medium=email&utm_source=footer 
> >   4. https://groups.google.com/d/optout 
>
>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/e02e7663-2b8d-4563-93c7-cfc113491d84%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #1.2: Type: text/html, Size: 16053 bytes --]

Re: Does anyone have experience using pandoc markdown with ACM sig-alternate style?

[BP Jonsson]

Den 2016-03-30 kl. 17:32, skrev Brian Danielak:
> So, I assume that means this bit of YAML would be valid:
>
> ```yaml
> geometry: paperwidth=8.5in
> geometry: paperheight=11in
> ```

No you need a list, or the second key will clobber the first one:

```yaml
geometry:
   - paperwidth=8.5in
   - paperheight=11in
```

On the command line OTOH you should write:

```shell
-M geometry=paperwidth=8.5in -M geometry=paperheight=11in
```

Re: Does anyone have experience using pandoc markdown with ACM sig-alternate style?

[Brian Danielak]

[-- Attachment #1.1: Type: text/plain, Size: 1185 bytes --]

Thanks! I'd forgotten about basic YAML syntax O:-)

On Wednesday, March 30, 2016 at 12:26:54 PM UTC-4, BP Jonsson wrote:
>
> Den 2016-03-30 kl. 17:32, skrev Brian Danielak: 
> > So, I assume that means this bit of YAML would be valid: 
> > 
> > ```yaml 
> > geometry: paperwidth=8.5in 
> > geometry: paperheight=11in 
> > ``` 
>
> No you need a list, or the second key will clobber the first one: 
>
> ```yaml 
> geometry: 
>    - paperwidth=8.5in 
>    - paperheight=11in 
> ``` 
>
> On the command line OTOH you should write: 
>
> ```shell 
> -M geometry=paperwidth=8.5in -M geometry=paperheight=11in 
> ``` 
>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/3613f56d-1e90-41c2-a94c-5234f280d6af%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #1.2: Type: text/html, Size: 1804 bytes --]