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 ...@@ -10,7 +10,13 @@ pandoc-papers.pdf: pandoc-papers.md
-V institute=iDiv \ -V institute=iDiv \
-V theme=Frankfurt \ -V theme=Frankfurt \
-V navigation=horizontal \ -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 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 # intro
## goals ## motivation
- **focus** on content/writing - **focus** on content/writing
- use **version control** with all its benefits - use **version control** with all its benefits
- next generation **communication** - **communication**
- avoid emails with attachments, right? - avoid emails with attachments, right?
- early and frequent reviews improve quality - early and frequent reviews
- **automated** - **automated**
- spell checking - spell checking
- high quality typesetting - high quality typesetting
...@@ -17,6 +21,15 @@ ...@@ -17,6 +21,15 @@
- get rid of MS Word, Google Docs, Dropbox - get rid of MS Word, Google Docs, Dropbox
- **future proof** way of doing things - **future proof** way of doing things
## agenda
- short presentation
- demo
- tool installation
- your first project
- learn tools and workflows
- establish community
# tools # tools
## pandoc ## pandoc
...@@ -29,7 +42,7 @@ ...@@ -29,7 +42,7 @@
### target**s** ### target**s**
- high quality PDF via \LaTeX - high quality PDF via \LaTeX
- others: html, epub, docx, odt - others: html web page, epub, docx, odt
### templates ### templates
...@@ -39,19 +52,19 @@ ...@@ -39,19 +52,19 @@
## Markdown ## Markdown
### rendered ### source
```
- **easy to learn**, read and write - **easy to learn**, read and write
- no distractions to *procrastinate* - no distractions to *procrastinate*
- inline \LaTeX\ if needed, e.g. $a^2 + b^2 = c^2$ - inline \LaTeX\ if needed, e.g. $a^2 + b^2 = c^2$
```
### source ### rendered
```
- **easy to learn**, read and write - **easy to learn**, read and write
- no distractions to *procrastinate* - no distractions to *procrastinate*
- inline \LaTeX\ if needed, e.g. $a^2 + b^2 = c^2$ - inline \LaTeX\ if needed, e.g. $a^2 + b^2 = c^2$
```
## git & GitLab ## git & GitLab
...@@ -79,14 +92,15 @@ ...@@ -79,14 +92,15 @@
- add results as CSV to repository - add results as CSV to repository
- visualize data in CSV to charts - visualize data in CSV to charts
## make ## build tool
### simple build tool ### make
- glues everything together - glues everything together
- automated build - automated build
- render images from **dot** and **CSV** sources - render images from **dot** and **CSV** sources
- build PDF - build PDF
- run spell check
# workflow # workflow
...@@ -178,6 +192,16 @@ git diff -w --ignore-blank-lines --word-diff ...@@ -178,6 +192,16 @@ git diff -w --ignore-blank-lines --word-diff
watchexec -w paper.md -- make paper.pdf 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 # your turn
## discussion ## discussion
...@@ -189,10 +213,25 @@ watchexec -w paper.md -- make paper.pdf ...@@ -189,10 +213,25 @@ watchexec -w paper.md -- make paper.pdf
- How do you communicate, collaborate and review? - How do you communicate, collaborate and review?
- What annoys you the most? (i.e. how can we improve) - 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 - set up git project
- convert existing documents to Markdown - convert existing documents to Markdown
- build with pandoc - build with pandoc
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment