diff --git a/pandoc-papers.md b/pandoc-papers.md index e475da3da473880b0d1c6075eff0c493766ef5f3..98a1e74a7e5a37da9bfb22a93972571aff2a2dcc 100644 --- a/pandoc-papers.md +++ b/pandoc-papers.md @@ -8,18 +8,25 @@ author: intro ===== -## motivation +## motivation #1 + + + +## motivation #2 - **focus** on content/writing -- use **version control** with all its benefits - **communication** - avoid emails with attachments, right? - early and frequent reviews +- get rid of MS Word, Google Docs, Dropbox, etc. + +## motivation #3 + +- use **version control** with all its benefits - **automated** - spell checking - high quality typesetting - publishing -- get rid of MS Word, Google Docs, Dropbox, etc. - **future proof** way of doing things, meaning - tools are open source - tools are replaceable or optional @@ -58,15 +65,15 @@ tools ``` - **easy to learn**, read and write -- no distractions to *procrastinate* -- inline \LaTeX\ if needed, e.g. $a^2 + b^2 = c^2$ +- ~~no~~ fewer distractions to *procrastinate* +- inline \LaTeX\ if needed \rightarrow\ $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$ +- ~~no~~ fewer distractions to *procrastinate* +- inline \LaTeX\ if needed \rightarrow\ $a^2 + b^2 = c^2$ ## git & GitLab @@ -114,9 +121,9 @@ workflow ### [set up new project in GitLab](https://git.idiv.de/projects/new) -- use **publishing/project-template** as project template -- project template is managed by our community -- contains Makefile, README, themes, CI/CD, visualization examples etc. +- use project template +- template is managed by our community +- contains Makefile, README, CI/CD, ~~themes~~, visualization examples, etc. ### writing @@ -127,7 +134,7 @@ workflow ### communication -- add contributors / collaborators to GitLab project +- invite contributors / collaborators to GitLab project - use GitLab project as main communication platform - discuss and review in - commit comments @@ -141,7 +148,7 @@ workflow - some parts are done automatically with the project template - deploy PDF to cloud storage: [https://portal.idiv.de/nextcloud/](https://portal.idiv.de/nextcloud/) -- (uses **DRAFT** watermark if commit not tagged) +- (uses **DRAFT** watermark ~~if commit not tagged~~) ## demo @@ -165,8 +172,7 @@ your turn ### create new project - https://git.idiv.de/projects/new -- **create from template** -- **publishing/project-template** +- **create from template** \rightarrow\ **instance** \rightarrow\ **pandoc** - install tools from `README.md` - set up Nextcloud share and CD