Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
git-seminar
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Requirements
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Locked files
Deploy
Releases
Package Registry
Model registry
Operate
Terraform modules
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
Repository analytics
Code review analytics
Issue analytics
Insights
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Maximilian Konzack
git-seminar
Commits
5be95050
Verified
Commit
5be95050
authored
5 years ago
by
ck85nori
Browse files
Options
Downloads
Patches
Plain Diff
updates pandoc papers
parent
52d2f1e8
No related branches found
No related tags found
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
pandoc-papers.md
+29
-27
29 additions, 27 deletions
pandoc-papers.md
with
29 additions
and
27 deletions
pandoc-papers.md
+
29
−
27
View file @
5be95050
% pandoc papers
% pandoc papers
workshop
% Christian Krause
# intro
## goals
-
focus on content/writing
-
version control
-
next generation communication
-
**
focus
**
on content/writing
-
use
**
version control
**
with all its benefits
-
next generation
**
communication
**
-
avoid emails with attachments, right?
-
reviews!
-
automated publishing
-
early and frequent reviews improve quality
-
**
automated
**
publishing
-
high quality typesetting
-
get rid of MS Word, Google Docs, Dropbox
# tools
...
...
@@ -20,11 +21,11 @@
### source: markup
-
usually
**Markdown**
-
less powerful than LaTeX, but inline LaTeX can be used
-
less powerful than
\
L
aTeX, but inline
\
L
aTeX
\
can be used
### target**s**
-
high quality PDF via LaTeX
-
high quality PDF via
\
L
aTeX
-
others: html, epub, docx, odt
### templates
...
...
@@ -39,14 +40,14 @@
-
**easy to learn**
, read and write
-
no distractions to
*procrastinate*
-
inline LaTeX if needed
:
$a^2 + b^2 = c^2$
-
inline
\
L
aTeX
\
if needed
, e.g.
$a^2 + b^2 = c^2$
### source
```
- **easy to learn**, read and write
- no distractions to *procrastinate*
- inline LaTeX if needed
:
$a^2 + b^2 = c^2$
- inline
\
LaTeX
\
if needed
, e.g.
$a^2 + b^2 = c^2$
```
## git & GitLab
...
...
@@ -68,14 +69,12 @@
-
graph visualization language
-
define flowcharts with code
-
**dot**
handles rendering
-
use
**make**
to build
-
**dot**
handles rendering to
**SVG**
### R scripts
-
add results as CSV to repository
-
visualize data in CSV to charts
-
use
**make**
to build
## make
...
...
@@ -101,7 +100,7 @@
### writing
-
start writing the main document in Markdown
-
use
good
text editor you're comfortable with
-
use text editor you're comfortable with
## workflow #2
...
...
@@ -129,17 +128,7 @@
-
use git sub-module to include
-
share with all@idiv / world
# misc
## helpful commands
```
bash
# better diff command for text
git diff
-w
--ignore-blank-lines
--word-diff
# watch source and build if changes
watchexec
-w
paper.md
--
make paper.pdf
```
# community
## community #1
...
...
@@ -147,11 +136,12 @@ watchexec -w paper.md -- make paper.pdf
-
`README.md`
with instructions how to build
-
`Makefile`
with general build instructions
-
include pandoc LaTeX themes via sub-module
-
include pandoc
\
L
aTeX
\
themes via sub-module
-
CD pipeline instructions
-
`main.md`
with hello world document using includes for chapters
-
example
**dot**
file for flowchart
-
example
**CSV**
and
**R script**
to generate charts
-
example
**BibTeX**
integration
-
`.gitignore`
with default products
## community #2
...
...
@@ -170,9 +160,21 @@ watchexec -w paper.md -- make paper.pdf
### others
-
repository with LaTeX templates for pandoc
-
repository with
\
L
aTeX
\
templates for pandoc
-
**review-able**
PDF template with link to join discussion at every paragraph
## community #3
### helpful commands
```
bash
# better diff command for text
git diff
-w
--ignore-blank-lines
--word-diff
# watch source and build if changes
watchexec
-w
paper.md
--
make paper.pdf
```
# your turn
## discussion
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment