r presentation - uon

Take it easy with markdown

Lukasz K Bonenberg

lkbonenberg@gmail.com@LKBLab

1

Outline

Introduction

Re-framing the question

Tools

Some downsides

Let’s talk about this

Demo time

Summary

2

Introduction

3

Questionnaire results

Figure 1: http: // bit. ly/ RMeetupNottingham

• Most interest in:• general understanding• making presentation + report

• more RStudio users than Microsoft Office• git and Markdown more popular than Latex or Beamer• More RMarkdown users than Markdown ! 4

Latex vs Word

Figure 2: Word or Latex5

Latex perception

Figure 3: Complex but worth it6

Microsoft Office perception

Figure 4: An Efficiency Comparison of Document Preparation SystemsUsed in Academic Research and Development 7

Re-framing the question

8

Change

• Change for the sake of change is rarely a sensible use of time.• Tools have to fit the purpose.

9

Does content matters?

Figure 5: Content is king

10

Sum of all parts

Figure 6: Complexity vs time spend

11

Who send what?

Figure 7: Entropy builds up12

Which is my latest copy?

• report_01.doc• report_02.doc• report_03_revByJim.doc• report_04_changes.doc• report_05_final.doc• report_05_finalFinal.doc• report_05_finalFinal_FINAL.doc• report_05_finalFinal_FINAL_send.doc

13

Social aspect

Figure 8: https://rpubs.com/ykashou92/eq_wmap

• Hawkers in Singapore• interactive plots

14

Deep Work

Figure 9: http: // calnewport. com/ books/ deep-work/15

Big guys open source

Figure 1016

Tools

17

RStudio

Figure 11

18

Markdown - Keep it simple

Figure 12: https://daringfireball.net/projects/markdown/19

One to rule them all

Figure 13: http: // pandoc. org/

20

Control the time

Figure 14: How good is your version control21

Some downsides

22

Change

• Change for the sake of change is rarely a sensible use of time.• How are we going to interact with others?

• Tools have to fit the purpose.• How many tools do I need to learn?• Who maintain those tools?

23

How many tools are we using?

Figure 15: complexity vs effort

24

Markdown - its too flexible

Figure 16: Spoil for choice?25

Let’s talk about this

26

Demo time

27

Report example

pandoc 01Markdown.md --output=01Markdown.htmlpandoc 02_Rmd+references.rmd --output=02_Rmd+ref.htmlpandoc 02_Rmd+references.rmd --output=02_Rmd+ref.docxpandoc 03_FinalReport.rmd --output= 03_FinalRep.docx

28

Presentation example

pandoc -t beamer presentation.md -o simple.pdfpandoc --slide-level 2 -H head.tex -B body.tex -t beamerpresentation.md -V theme:metropolis -o Rpresentation.pdf

29

Future work

• running R code inside presentation• converting back from MSc Office - seamless integration• animations + interactive content• Adding Excel• Markdown to PowerPoint

30

Summary

31

Take away notes

• Markdown is one of 20-80 tools - it will cover most of problemswith small effort

• content beats visuals• set of small dedicated tools allow better flexibility and low

entropy

32

useful links

• R• RMarkdown• ioslides• knit

• Online markdown• Pandoc

• try online• check demos

• git• guide• try yourself

33

Thank you

Can you fill in the feedback at http://bit.ly/LKBFeedback?

lkbonenberg@gmail.com

@LKBLab

34