Live data from Hacker News

Show HN: LaTeX Boilerplates – Plain-Text Document Production System

mrzool.cc

21–30 of 44 posts

Re: Show HN: LaTeX Boilerplates – Plain-Text Document Production System

#21
post #14

They look great. Installing pandoc is a pain, though. My CV is LaTeX as well—using the moderncv template—and I build it regularly on both GNU/Linux and Mac OS X: https://github.com/alanorth/cv

> Installing pandoc is a pain, though.

I'm genuinely curious about this statement. I thought you must be using Windows, but the latter part of your comment contradicts that.

Re: Show HN: LaTeX Boilerplates – Plain-Text Document Production System

#23
post #12

RStudio (IDE for R) has a great MarkDown to PDF, Word or HTML using Pandoc. http://rmarkdown.rstudio.com/pdf_document_format.html Might help you to see their process. You can do the whole thing with CLI but easy in their IDE.

Why would you want to use an IDE (RStudio or whatever) to run pandoc over an markdown file?

Re: Show HN: LaTeX Boilerplates – Plain-Text Document Production System

#24
I use a similar workflow using Pandoc at work. I painstakingly re-created our corporate Word documentation templates using LaTeX and then set up Pandoc to generate documents from Markdown using these templates.

In addition to this, I used Haskell and Diagrams to produce DSLs for rendering various UML documents from text based descriptions. These can be rendered in both vector graphics formats (SVG and Encapsulated Postscript) as well as a written description of the diagram that can be provided for accessibility reasons.

The big take-away I got out of this process was that I could write human-readable documents that were also machine-readable while also providing a higher level of accessibility for this documentation than would be possible using traditional WYSIWYG tools.

I highly recommend this style of documentation workflow.

Re: Show HN: LaTeX Boilerplates – Plain-Text Document Production System

#26

I use a similar workflow using Pandoc at work. I painstakingly re-created our corporate Word documentation templates using LaTeX and then set up Pandoc to generate documents from Markdown using these templates. In addition to this, I used Haskell and Diagrams to produce DSLs for rendering various UML documents from text based descriptions. These can be rendered in both vector graphics formats (SVG and Encapsulated Po…

I found LaTeX to be an enjoyable way to create non-traditional PDFs with better control over styling than you would get from something that rendered HTML to PDF directly, like Prince or WebkitToPdf. The downside was all the Googling and troubleshooting when things didn't behave as expected -- LaTeX is pretty much the opposite of WYSIWYG and doesn't have Chrome Developer Tools ;-)

In my case, I was actually stuck with creating a template for Invoice/Order PDFs based on a CRM that was written in PHP, so I made a PHP script that output LaTeX, then rendered that in a folder. The trick was to use a temporary folder for each document render, and to manage the process hands-free using latex-mk: http://tex.stackexchange.com/questions/210500/why-is-somethi...

The resulting PDFs then didn't break lines in the wrong places, had the correct margins on the first page vs other pages, were very graphically rich with vector graphics, and could be produced quickly on demand through their web-based CRM, all thanks to LaTeX and a few days' time debugging.

Re: Show HN: LaTeX Boilerplates – Plain-Text Document Production System

#27
Kudos for this great, yet simple and lean toolchain!

Anyone familiar with command line tools and a corresponding aversion for bloated WYSIWYG apps will second the underlying idea that MS Word (and the likes) “should die” in favor of plain text workflows.

Yet, with the help of Pandoc (which does the heavy lifting in these boilerplates), nothing prevents you to keep using Word as a front-end and plug it in this exact same workflow. Word may not be the best-of-bread typesetting engine or layouting tool, but to many it still is useful as a quite decent word processor.

For those interested, I did a (long-read) write-up on how one could go from Word over Markdown to even InDesign (as an alternative templating/typesetting engine, instead of LaTeX/XeTeX): http://rhythmus.be/md2indd/

Re: Show HN: LaTeX Boilerplates – Plain-Text Document Production System

#29

Been collecting a few links on this topic: https://www.rpi.edu/dept/arc/training/latex/resumes/ https://github.com/mrzool/cv-boilerplate https://github.com/posquit0/Awesome-CV

At the time of writing my article cited above, I didn’t yet came across this one:

[Sustainable Authorship in Plain Text using Pandoc and Markdown](http://programminghistorian.org/lessons/sustainable-authorsh...)

Re: Show HN: LaTeX Boilerplates – Plain-Text Document Production System

#30
post #20

Thanks for all the feedback! Make sure to check out this article where I talk in depth about a typical workflow and the rationale behind this project: http://mrzool.cc/writing/typesetting-automation/

One thing I didn't really see in that post is why not just LaTeX directly. Is it just that you prefer Markdown syntax? (Which I guess is a valid reason.)
Post reply on HN