pandoc-papers.md

title: pandoc papers
subtitle: a future proof way to write
author:
- Christian Krause

intro

motivation

• focus on content/writing
• use version control with all its benefits
• communication
  • avoid emails with attachments, right?
  • early and frequent reviews
• automated
  • spell checking
  • high quality typesetting
  • publishing
• get rid of MS Word, Google Docs, Dropbox
• future proof way of doing things

agenda

• short presentation
• demo
• tool installation
• your first project
• learn tools and workflows
• establish community

tools

pandoc

source: markup

• usually Markdown
• less powerful than \LaTeX, but inline \LaTeX\ can be used

targets

• high quality PDF via \LaTeX
• others: html web page, epub, docx, odt

templates

• different journals
• iDiv branding
• draft branding

Markdown

source

- **easy to learn**, read and write
- no distractions to *procrastinate*
- inline \LaTeX\ if needed, e.g. $a^2 + b^2 = c^2$

rendered

• easy to learn, read and write
• no distractions to procrastinate
• inline \LaTeX\ if needed, e.g. a^2 + b^2 = c^2

git & GitLab

git

• version control
• free backup

GitLab: https://git.idiv.de

• self-hosted, full access control
• communication: discussion and reviews
• continuous deployment to e.g. cloud storage

visualization

Graphviz/dot

• graph visualization language
• define flowcharts with code
• dot handles rendering to SVG

R scripts

• add results as CSV to repository
• visualize data in CSV to charts

build tool