tools for academic writing in the digital world
DESCRIPTION
TRANSCRIPT
![Page 1: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/1.jpg)
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
![Page 2: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/2.jpg)
![Page 3: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/3.jpg)
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ä
![Page 4: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/4.jpg)
CONTENT1. Why?2. What?3. Introducing Markdown markup language4. Introducing Pandoc document converter5. Introducing
![Page 5: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/5.jpg)
1. WHY?
![Page 6: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/6.jpg)
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
![Page 7: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/7.jpg)
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
![Page 8: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/8.jpg)
2. WHAT?
![Page 9: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/9.jpg)
A WORKFLOW FOR PRODUCINGarticlesslidesblog postslecture materials etc.
![Page 10: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/10.jpg)
BASED ON PLAIN TEXT
![Page 11: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/11.jpg)
2. INTRODUCING MARKDOWN MARKUPLANGUAGE
![Page 12: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/12.jpg)
“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/
![Page 13: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/13.jpg)
TITLE BLOCK % title % name % date
![Page 14: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/14.jpg)
HEADINGS# first level heading ## second level heading
![Page 15: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/15.jpg)
LISTS
bullet listbullet list
1. numbered list2. numbered list
- bullet list - bullet list
1. numbered list 1. numbered list
![Page 16: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/16.jpg)
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
![Page 17: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/17.jpg)
3. INTRODUCING PANDOC DOCUMENTCONVERTER
![Page 19: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/19.jpg)
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
![Page 20: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/20.jpg)
DEMO
![Page 21: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/21.jpg)
SOFTWARE ENVIRONMENT - takes about n. 30s
- takes about n. 60 minInstalling PandocInstalling Latex
![Page 22: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/22.jpg)
FILES AND FOLDERSTwo files
figure-folder with two figures
document.mdbibtex.bib
stalingrad_battle.pngcoe.png
Download the demo.zip
![Page 23: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/23.jpg)
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
![Page 24: Tools for Academic Writing in the Digital World](https://reader034.vdocument.in/reader034/viewer/2022052522/5484875c5906b594158b47b1/html5/thumbnails/24.jpg)
HOW THIS SLIDESHOW WAS MADEThis slideshow was made using a combination of
and .reveal.js
Pandoc