TOOLS FOR ACADEMICWRITING IN THE DIGITAL

WORLDMarkus Kainu

March 22, 2013

You can access these slides at

Press the Escape key to see all slides.

markuskainu.fi/digitalization

MY APPROACH TO PRODUCING SCIENTIFICDOCUMENTS

Free and Open Source Software and OSEmphasis on both, paper and beyond paper publishingBorrowing from computer programming practisesReproducible Reseach

Tietokone tutkijan apuvälineenä

CONTENT1. Why?2. What?3. Introducing Markdown markup language4. Introducing Pandoc document converter5. Introducing

1. WHY?

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 yourdata

THERE IS A NEEDto rethink (among several other things) the very basiccustoms of text writingto be able to publish your stuff online and control yourprojects

2. WHAT?

A WORKFLOW FOR PRODUCINGarticlesslidesblog postslecture materials etc.

BASED ON PLAIN TEXT

2. INTRODUCING MARKDOWN MARKUPLANGUAGE

“Markdown is a text-to-WHATEVER

conversion tool for writers. Markdown allowsyou to write using an easy-to-read, easy-to-

write plain text format, then convert itWHATEVER.

”

Slightly modified from:daringfireball.net/projects/markdown/

TITLE BLOCK % title % name % date

HEADINGS# first level heading ## second level heading

LISTS

bullet listbullet list

1. numbered list2. numbered list

- bullet list - bullet list

1. numbered list 1. numbered list

IMAGES AND LINKS

Image title

 [Helsingin Sanomat](http://www.hs.fi)

Helsingin Sanomat

3. INTRODUCING PANDOC DOCUMENTCONVERTER

About pandoc

SYNTAXConversions

Basic Academic spices

# html pandoc -s document.md -o document.html # pdf pandoc document.md -o document.pdf # docx pandoc -f markdown -t docx document.md -o document.docx # epub pandoc document.md -o document.epub

--toc --number-sections --bibliography=bibtex.bib --variable lang:finnish

DEMO

SOFTWARE ENVIRONMENT - takes about n. 30s

- takes about n. 60 minInstalling PandocInstalling Latex

FILES AND FOLDERSTwo files

figure-folder with two figures

document.mdbibtex.bib

stalingrad_battle.pngcoe.png

Download the demo.zip

SCRIPTS FOR CONVERSION pandoc document.md -o document.pdf --bibliography=bibtex.bib pandoc -s document.md -o document.html --bibliography=bibtex.bib pandoc -f markdown -t docx document.md -o document.docx --bibliography=bibtex.bib pandoc document.md -o document.epub

HOW THIS SLIDESHOW WAS MADEThis slideshow was made using a combination of

and .reveal.js

Pandoc