Upload
markus-kainu
View
1.343
Download
1
Embed Size (px)
DESCRIPTION
Citation preview
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
![title](http://dribbble.s3.amazonaws.com/users/61571/screenshots/424394/markdown.png) [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