1. TOOLS FOR ACADEMIC
WRITING IN THE DIGITAL
WORLD
Markus Kainu
March 22, 2013
You can access these slides at
markuskainu.fi/digitalization
Press the E c p key to see all slides.
sae

3. MY APPROACH TO PRODUCING SCIENTIFIC
DOCUMENTS
Tietokone tutkijan apuvälineenä
Free and Open Source Software and OS
Emphasis on both, paper and beyond paper publishing
Borrowing from computer programming practises
Reproducible Reseach

4. CONTENT
1. Why?
2. What?
3. Introducing Markdown markup language
4. Introducing Pandoc document converter
5. Introducing

5. 1. WHY?

6. 1. Paper as a primary platform for publishing IS threatened,
BUT writing as a primary tool is NOT threatened
2. Digital formats open new possibilities for presenting your
data

7. THERE IS A NEED
to rethink (among several other things) the very basic
customs of text writing
to be able to publish your stuff online and control your
projects

8. 2. WHAT?

9. A WORKFLOW FOR PRODUCING
articles
slides
blog posts
lecture materials etc.

10. BASED ON PLAIN TEXT

11. 2. INTRODUCING MARKDOWN MARKUP
LANGUAGE

12. “
Markdown is a text-to-WHATEVER
conversion tool for writers. Markdown allows
you to write using an easy-to-read, easy-to-
write plain text format, then convert it
WHATEVER.
Slightly modified from:
daringfireball.net/projects/markdown/
”

13. TITLE BLOCK
%tte
il
%nm
ae
%dt
ae

14. HEADINGS
#frtlvlhaig
is ee edn
# scn lvlhaig
# eod ee edn

15. LISTS
-ble ls
ult it
-ble ls
ult it
bullet list
bullet list
1 nmee ls
. ubrd it
1 nmee ls
. ubrd it
1. numbered list
2. numbered list

16. IMAGES AND LINKS
!tte(tp/dibl.3aaoascmues651sresos4
[il]ht:/rbbes.mznw.o/sr/17/cenht/
234mrdw.n)
49/akonpg
[esni Snmt(tp/wwh.i
Hlign aoa]ht:/w.sf)
Image title
Helsingin Sanomat

17. 3. INTRODUCING PANDOC DOCUMENT
CONVERTER

18. About pandoc

19. SYNTAX
Conversions
#hm
tl
pno - dcmn.d- dcmn.tl
adc s ouetm o ouethm
#pf
d
pno dcmn.d- dcmn.d
adc ouetm o ouetpf
#dc
ox
pno - mrdw - dc dcmn.d- dcmn.ox
adc f akon t ox ouetm o ouetdc
#eu
pb
pno dcmn.d- dcmn.pb
adc ouetm o oueteu
Basic Academic spices
-tc
-o
-nme-etos
-ubrscin
-bbigah=itxbb
-ilorpybbe.i
-vral ln:ins
-aibe agfnih

20. DEMO

21. SOFTWARE ENVIRONMENT
Installing Pandoc - takes about n. 30s
Installing Latex - takes about n. 60 min

22. FILES AND FOLDERS
Two files
document.md
bibtex.bib
figure-folder with two figures
stalingrad_battle.png
coe.png
Download the demo.zip

23. SCRIPTS FOR CONVERSION
pno dcmn.d- dcmn.d -bbigah=itxbb
adc ouetm o ouetpf -ilorpybbe.i
pno - dcmn.d- dcmn.tl-bbigah=itxbb
adc s ouetm o ouethm -ilorpybbe.i
pno - mrdw - dc dcmn.d- dcmn.ox-bbiga
adc f akon t ox ouetm o ouetdc -ilor
pybbe.i
h=itxbb
pno dcmn.d- dcmn.pb
adc ouetm o oueteu

24. HOW THIS SLIDESHOW WAS MADE
This slideshow was made using a combination of reveal.js
and Pandoc .