Skip to content
Snippets Groups Projects
Verified Commit 9f5ae7cc authored by ck85nori's avatar ck85nori :railway_track:
Browse files

updates pandoc papers

parent 7cde4b24
No related branches found
No related tags found
No related merge requests found
......@@ -10,7 +10,13 @@ pandoc-papers.pdf: pandoc-papers.md
-V institute=iDiv \
-V theme=Frankfurt \
-V navigation=horizontal \
-s pandoc-papers.md -t beamer -o pandoc-papers.pdf
-V titlegraphic=img/idiv-black.png \
-V logo=img/idiv-black-logo.png \
--pdf-engine=xelatex \
-s \
-t beamer \
-o pandoc-papers.pdf \
pandoc-papers.md
all: subdirs
......
img/idiv-black-logo.png

10.1 KiB

img/idiv-black.png

34.9 KiB

% pandoc papers workshop
% Christian Krause
---
title: pandoc papers
subtitle: a future proof way to write
author:
- Christian Krause
...
# intro
## goals
## motivation
- **focus** on content/writing
- use **version control** with all its benefits
- next generation **communication**
- **communication**
- avoid emails with attachments, right?
- early and frequent reviews improve quality
- early and frequent reviews
- **automated**
- spell checking
- high quality typesetting
......@@ -17,6 +21,15 @@
- 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
......@@ -29,7 +42,7 @@
### target**s**
- high quality PDF via \LaTeX
- others: html, epub, docx, odt
- others: html web page, epub, docx, odt
### templates
......@@ -39,19 +52,19 @@
## Markdown
### rendered
### source
```
- **easy to learn**, read and write
- no distractions to *procrastinate*
- inline \LaTeX\ if needed, e.g. $a^2 + b^2 = c^2$
```
### source
### 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
......@@ -79,14 +92,15 @@
- add results as CSV to repository
- visualize data in CSV to charts
## make
## build tool
### simple build tool
### make
- glues everything together
- automated build
- render images from **dot** and **CSV** sources
- build PDF
- run spell check
# workflow
......@@ -178,6 +192,16 @@ git diff -w --ignore-blank-lines --word-diff
watchexec -w paper.md -- make paper.pdf
```
## community #4
### [https://git.idiv.de/publishing](https://git.idiv.de/publishing)
- contribute to project template
- contribute to pandoc templates
- contribute to bibliography
# demo
# your turn
## discussion
......@@ -189,10 +213,25 @@ watchexec -w paper.md -- make paper.pdf
- How do you communicate, collaborate and review?
- What annoys you the most? (i.e. how can we improve)
## let's use it
## installation
### tools
- git
- pandoc, pandoc-citeproc
- \LaTeX
- make
- [watchexec](https://github.com/watchexec/watchexec/releases)
- xspell
- graphviz
- R
### editor
- Atom
## workflow
- install tools
- install editor
- set up git project
- convert existing documents to Markdown
- build with pandoc
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment