-
Notifications
You must be signed in to change notification settings - Fork 5
Expand file tree
/
Copy pathoutfile.html
More file actions
726 lines (726 loc) · 75.5 KB
/
Copy pathoutfile.html
File metadata and controls
726 lines (726 loc) · 75.5 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="generator" content="pandoc" />
<meta name="author" content="Albert Krewinkel (Pandoc Development Team)" />
<meta name="author" content="Robert Winkler (CINVESTAV Unidad Irapuato, Department of Biochemistry and Biotechnology)" />
<meta name="keywords" content="open science, document formats, markdown, latex, publishing, typesetting" />
<title>Formatting Open Science: agilely creating multiple document formats for academic manuscripts with Pandoc Scholar</title>
<style type="text/css">code{white-space: pre;}</style>
<style type="text/css">
div.sourceCode { overflow-x: auto; }
table.sourceCode, tr.sourceCode, td.lineNumbers, td.sourceCode {
margin: 0; padding: 0; vertical-align: baseline; border: none; }
table.sourceCode { width: 100%; line-height: 100%; }
td.lineNumbers { text-align: right; padding-right: 4px; padding-left: 4px; color: #aaaaaa; border-right: 1px solid #aaaaaa; }
td.sourceCode { padding-left: 5px; }
code > span.kw { color: #007020; font-weight: bold; } /* Keyword */
code > span.dt { color: #902000; } /* DataType */
code > span.dv { color: #40a070; } /* DecVal */
code > span.bn { color: #40a070; } /* BaseN */
code > span.fl { color: #40a070; } /* Float */
code > span.ch { color: #4070a0; } /* Char */
code > span.st { color: #4070a0; } /* String */
code > span.co { color: #60a0b0; font-style: italic; } /* Comment */
code > span.ot { color: #007020; } /* Other */
code > span.al { color: #ff0000; font-weight: bold; } /* Alert */
code > span.fu { color: #06287e; } /* Function */
code > span.er { color: #ff0000; font-weight: bold; } /* Error */
code > span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
code > span.cn { color: #880000; } /* Constant */
code > span.sc { color: #4070a0; } /* SpecialChar */
code > span.vs { color: #4070a0; } /* VerbatimString */
code > span.ss { color: #bb6688; } /* SpecialString */
code > span.im { } /* Import */
code > span.va { color: #19177c; } /* Variable */
code > span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
code > span.op { color: #666666; } /* Operator */
code > span.bu { } /* BuiltIn */
code > span.ex { } /* Extension */
code > span.pp { color: #bc7a00; } /* Preprocessor */
code > span.at { color: #7d9029; } /* Attribute */
code > span.do { color: #ba2121; font-style: italic; } /* Documentation */
code > span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
code > span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
code > span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
</style>
<script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML" type="text/javascript"></script>
</head>
<body>
<div id="header">
<h1 class="title">Formatting Open Science: agilely creating multiple document formats for academic manuscripts with Pandoc Scholar</h1>
<h2 class="author">Albert Krewinkel (Pandoc Development Team)</h2>
<h2 class="author">Robert Winkler (CINVESTAV Unidad Irapuato, Department of Biochemistry and Biotechnology)</h2>
</div>
<div id="TOC">
<ul>
<li><a href="#abstract">Abstract</a></li>
<li><a href="#introduction">Introduction</a><ul>
<li><a href="#preprints-and-e-prints">Preprints and e-prints</a></li>
<li><a href="#open-access">Open Access</a></li>
<li><a href="#cost-of-journal-article-production">Cost of journal article production</a></li>
<li><a href="#current-standard-publishing-formats">Current standard publishing formats</a></li>
</ul></li>
<li><a href="#concepts-of-markdown-and-pandoc">Concepts of markdown and pandoc</a></li>
<li><a href="#markdown-editors-and-online-editing">Markdown editors and online editing</a><ul>
<li><a href="#markdown-editors">Markdown editors</a></li>
<li><a href="#online-editing-and-collaborative-writing">Online editing and collaborative writing</a></li>
<li><a href="#document-versioning-and-change-control">Document versioning and change control</a></li>
</ul></li>
<li><a href="#pandoc-markdown-for-scientific-texts">Pandoc markdown for scientific texts</a><ul>
<li><a href="#tables">Tables</a></li>
<li><a href="#figures-and-images">Figures and images</a></li>
<li><a href="#symbols">Symbols</a></li>
<li><a href="#formulas">Formulas</a></li>
<li><a href="#code-listings">Code listings</a></li>
<li><a href="#other-document-elements">Other document elements</a></li>
</ul></li>
<li><a href="#citations-and-biography">Citations and biography</a><ul>
<li><a href="#reference-databases">Reference databases</a></li>
<li><a href="#inserting-citations">Inserting citations</a></li>
<li><a href="#styles">Styles</a></li>
<li><a href="#creation-of-latex-natbib-citations">Creation of LATEX <code>natbib</code> citations</a></li>
<li><a href="#database-of-cited-references">Database of cited references</a></li>
</ul></li>
<li><a href="#meta-information-of-the-document">Meta information of the document</a><ul>
<li><a href="#flexible-metadata-authoring">Flexible metadata authoring</a></li>
<li><a href="#jats-support">JATS support</a></li>
<li><a href="#citation-types">Citation types</a></li>
</ul></li>
<li><a href="#example-manuscript-with-output-of-docx-odt-format-and-latex-pdf-for-submission-to-different-journals.">Example: Manuscript with output of DOCX/ ODT format and LATEX/ PDF for submission to different journals.</a><ul>
<li><a href="#development-of-a-docx-odt-template">Development of a DOCX/ ODT template</a></li>
<li><a href="#development-of-a-texpdf-template">Development of a TEX/PDF template</a></li>
<li><a href="#styles-for-html-and-epub">Styles for HTML and EPUB</a></li>
</ul></li>
<li><a href="#automating-document-production">Automating document production</a><ul>
<li><a href="#cross-platform-compatibility">Cross-platform compatibility</a></li>
</ul></li>
<li><a href="#perspective">Perspective</a></li>
<li><a href="#conclusions">Conclusions</a></li>
<li><a href="#acknowledgments">Acknowledgments</a></li>
<li><a href="#software-and-code-availability">Software and code availability</a></li>
<li><a href="#bibliography">Bibliography</a></li>
</ul>
</div>
<p><strong>Keywords:</strong> open science, document formats, markdown, latex, publishing, typesetting</p>
<h1 id="abstract">Abstract</h1>
<p>The timely publication of scientific results is essential for dynamic advances in science. The ubiquitous availability of computers which are connected to a global network made the rapid and low-cost distribution of information through electronic channels possible. New concepts, such as Open Access publishing and preprint servers are currently changing the traditional print media business towards a community-driven peer production. However, the cost of scientific literature generation, which is either charged to readers, authors or sponsors, is still high. The main active participants in the authoring and evaluation of scientific manuscripts are volunteers, and the cost for online publishing infrastructure is close to negligible. A major time and cost factor is the formatting of manuscripts in the production stage. In this article we demonstrate the feasibility of writing scientific manuscripts in plain markdown (MD) text files, which can be easily converted into common publication formats, such as PDF, HTML or EPUB, using pandoc. The simple syntax of markdown assures the long-term readability of raw files and the development of software and workflows. We show the implementation of typical elements of scientific manuscripts – formulas, tables, code blocks and citations – and present tools for editing, collaborative writing and version control. We give an example on how to prepare a manuscript with distinct output formats, a DOCX file for submission to a journal, and a LATEX/PDF version for deposition as a PeerJ preprint. Further, we implemented new features for supporting ‘semantic web’ applications, such as the ‘journal article tag suite’ - JATS, and the ‘citation typing ontology’ - CiTO standard. Reducing the work spent on manuscript formatting translates directly to time and cost savings for writers, publishers, readers and sponsors. Therefore, the adoption of the MD format contributes to the agile production of open science literature. Pandoc Scholar is freely available from <a href="https://github.com/pandoc-scholar" class="uri">https://github.com/pandoc-scholar</a>.</p>
\newpage
<h1 id="introduction">Introduction</h1>
<p>Agile development of science depends on the continuous exchange of information between researchers <span class="citation">(Woelfle, Olliaro, and Todd 2011)</span>. In the past, physical copies of scientific works had to be produced and distributed. Therefore, publishers needed to invest considerable resources for typesetting and printing. Since the journals were mainly financed by their subscribers, their editors not only had to decide on the scientific quality of a submitted manuscript, but also on the potential interest to their readers. The availability of globally connected computers enabled the rapid exchange of information at low cost. Yochai Benkler (2006) predicts important changes in the information production economy, which are based on three observations:</p>
<ol style="list-style-type: decimal">
<li>A nonmarket motivation in areas such as education, arts, science, politics and theology.</li>
<li>The actual rise of nonmarket production, made possible through networked individuals and coordinate effects.</li>
<li>The emergence of large-scale peer production, e.g. of software and encyclopedias.</li>
</ol>
<p>Immaterial goods such as knowledge and culture are not lost when consumed or shared – they are ‘nonrival’ –, and they enable a networked information economy, which is not commercially driven <span class="citation">(Benkler 2006)</span>.</p>
<h2 id="preprints-and-e-prints">Preprints and e-prints</h2>
<p>In some areas of science a preprint culture, i.e. a paper-based exchange system of research ideas and results, already existed when Paul Ginsparg in 1991 initiated a server for the distribution of electronic preprints – ‘e-prints’ – about high-energy particle theory at the Los Alamos National Laboratory (LANL), USA <span class="citation">(Ginsparg 1994)</span>. Later, the LANL server moved with Ginsparg to Cornell University, USA, and was renamed as arXiv <span class="citation">(Butler 2001)</span>. Currently, arXiv (<a href="https://arxiv.org/" class="uri">https://arxiv.org/</a>) publishes e-prints related to physics, mathematics, computer science, quantitative biology, quantitative finance and statistics. Just a few years after the start of the first preprint servers, their important contribution to scientific communication was evident <span class="citation">(Ginsparg 1994; Youngen 1998; C. Brown 2001)</span>. In 2014, arXiv reached the impressive number of 1 million e-prints <span class="citation">(Van Noorden 2014)</span>.</p>
<p>In more conservative areas, such as chemistry and biology, accepting the publishing prior peer-review took more time <span class="citation">(C. Brown 2003)</span>. A preprint server for life sciences (<a href="http://biorxiv.org/" class="uri">http://biorxiv.org/</a>) was launched by the Cold Spring Habor Laboratory, USA, in 2013 <span class="citation">(Callaway 2013)</span>. <em>PeerJ preprints</em> (<a href="https://peerj.com/preprints/" class="uri">https://peerj.com/preprints/</a>), started in the same year, accepts manuscripts from biological sciences, medical sciences, health sciences and computer sciences.</p>
<p>The terms ‘preprints’ and ‘e-prints’ are used synonymously, since the physical distribution of preprints has become obsolete. A major drawback of preprint publishing are the sometimes restrictive policies of scientific publishers. The SHERPA/RoMEO project informs about copyright policies and self-archiving options of individual publishers (<a href="http://www.sherpa.ac.uk/romeo/" class="uri">http://www.sherpa.ac.uk/romeo/</a>).</p>
<h2 id="open-access">Open Access</h2>
<p>The term <em>‘Open Access’</em> (OA) was introduced 2002 by the Budapest Open Access Initiative and was defined as:</p>
<p><em>“Barrier-free access to online works and other resources. OA literature is digital, online, free of charge (gratis OA), and free of needless copyright and licensing restrictions (libre OA).”</em> <span class="citation">(Suber 2012)</span></p>
<p>Frustrated by the difficulty to access even digitized scientific literature, three scientists founded the <em>Public Library of Science (PLoS)</em>. In 2003, <em>PLoS Biology</em> was published as the first fully Open Access journal for biology <span class="citation">(P. O. Brown, Eisen, and Varmus 2003; M. Eisen 2003)</span>.</p>
<p>Thanks to the great success of OA publishing, many conventional print publishers now offer a so-called ‘Open Access option’, i.e. to make accepted articles free to read for an additional payment by the authors. The copyright in these hybrid models might remain with the publisher, whilst fully OA usually provide a liberal license, such as the Creative Commons Attribution 4.0 International (CC BY 4.0, <a href="https://creativecommons.org/licenses/by/4.0/" class="uri">https://creativecommons.org/licenses/by/4.0/</a>).</p>
<p>OA literature is only one component of a more general <em>open</em> philosophy, which also includes the access to scholarships, software, and data <span class="citation">(Willinsky 2005)</span>. Interestingly, there are several different ‘schools of thought’ on how to understand and define <em>Open Science</em>, as well the position that any science is open by definition, because of its objective to make generated knowledge public <span class="citation">(Fecher and Friesike 2014)</span>.</p>
<h2 id="cost-of-journal-article-production">Cost of journal article production</h2>
<p>In a recent study, the article processing charges (APCs) for research intensive universities in the USA and Canada were estimated to be about 1,800 USD for fully OA journals and 3,000 USD for hybrid OA journals <span class="citation">(Solomon and Björk 2016)</span>. PeerJ (<a href="https://peerj.com/" class="uri">https://peerj.com/</a>), an OA journal for biological and computer sciences launched in 2013, drastically reduced the publishing cost, offering its members a life-time publishing plan for a small registration fee <span class="citation">(Van Noorden 2012)</span>; alternatively the authors can choose to pay an APC of 1,095 USD, which may be cheaper, if multiple co-authors participate.</p>
<p>Examples such as the <em>Journal of Statistical Software</em> (<em>JSS</em>, <a href="https://www.jstatsoft.org/" class="uri">https://www.jstatsoft.org/</a>) and <em>eLife</em> (<a href="https://elifesciences.org/" class="uri">https://elifesciences.org/</a>) demonstrate the possibility of completely community-supported OA publications. <strong>Fig. 1</strong> compares the APCs of different OA publishing business models.</p>
<p><em>JSS</em> and <em>eLife</em> are peer-reviewed and indexed by Thomson Reuters. Both journals are located in the Q1 quality quartile in all their registered subject categories of the Scimago Journal & Country Rank (<a href="http://www.scimagojr.com/" class="uri">http://www.scimagojr.com/</a>), demonstrating that high-quality publications can be produced without charging the scientific authors or readers.</p>
<div class="figure">
<img src="Fig1.png" title="Article Processing Charges in Open Access publishing" alt="Article Processing Charge (APCs) that authors have to pay for with different Open Access (OA) publishing models. Data from (Solomon and Björk 2016) and journal web-pages." />
<p class="caption">Article Processing Charge (APCs) that authors have to pay for with different Open Access (OA) publishing models. Data from <span class="citation">(Solomon and Björk 2016)</span> and journal web-pages.</p>
</div>
<p>In 2009, a study was carried out concerning the <em>“Economic Implications of Alternative Scholarly Publishing Models”</em>, which demonstrates an overall societal benefit by using OA publishing model <span class="citation">(Houghton et al. 2009)</span>. In the same report, the real publication costs are evaluated. The relative costs of an article for the publisher are represented in <strong>Fig. 2</strong>.</p>
<div class="figure">
<img src="Fig2.png" title="Publishing costs" alt="Estimated publishing cost for a hybrid journal (conventional with Open Access option). Data from (Houghton et al. 2009)." />
<p class="caption">Estimated publishing cost for a ‘hybrid’ journal (conventional with Open Access option). Data from <span class="citation">(Houghton et al. 2009)</span>.</p>
</div>
<p>Conventional publishers justify their high subscription or APC prices with the added value, e.g. journalism (stated in the graphics as ‘non-article processing’). But also stakeholder profits, which could be as high as 50%, must be considered, and are withdrawn from the science budget <span class="citation">(Van Noorden 2013)</span>.</p>
<p>Generally, the production costs of an article could be roughly divided into commercial and academic/ technical costs (<strong>Fig. 2</strong>). For nonmarket production, the commercial costs such as margins/ profits, management etc. can be drastically reduced. Hardware and services for hosting an editorial system, such as Open Journal Systems of the Public Knowledge Project (<a href="https://pkp.sfu.ca/ojs/" class="uri">https://pkp.sfu.ca/ojs/</a>) can be provided by public institutions. Employed scholars can perform editor and reviewer activities without additional cost for the journals. Nevertheless, ‘article processing’, which includes the manuscript handling during peer review and production represents the most expensive part.</p>
<p>Therefore, we investigated a strategy for the efficient formatting of scientific manuscripts.</p>
<h2 id="current-standard-publishing-formats">Current standard publishing formats</h2>
<p>Generally speaking, a scientific manuscript is composed of contents and formatting. While the content, i.e. text, figures, tables, citations etc., may remain the same between different publishing forms and journal styles, the formatting can be very different. Most publishers require the formatting of submitted manuscripts in a certain format. Ignoring this <strong>Guide for Authors</strong>, e.g. by submitting a manuscript with a different reference style, gives a negative impression with a journal’s editorial staff. Too carelessly prepared manuscripts can even provoke a straight ‘desk-reject’ <span class="citation">(Volmer and Stokes 2016)</span>.</p>
<p>Currently DOC(X), LATEX and/ or PDF file formats are the most frequently used formats for journal submission platforms. But even if the content of a submitted manuscript might be accepted during the peer review ‘as is’, the format still needs to be adjusted to the particular publication style in the production stage. For the electronic distribution and archiving of scientific works, which is gaining more and more importance, additional formats (EPUB, (X)HTML, JATS) need to be generated. <strong>Tab. 1</strong> lists the file formats which are currently the most relevant ones for scientific publishing.</p>
<p>Although the content elements of documents, such as title, author, abstract, text, figures, tables, etc., remain the same, the syntax of the file formats is rather different. <strong>Tab. 2</strong> demonstrates some simple examples of differences in different markup languages.</p>
<p>Documents with the commonly used Office Open XML (DOCX Microsoft Word files) and OpenDocument (ODT LibreOffice) file formats can be opened in a standard text editor after unzipping. However, content and formatting information is distributed into various folders and files. Practically speaking, those file formats require the use of special word processing software.</p>
<p>From a writer’s perspective, the use of <em>What You See Is What You Get (WYSIWYG)</em> programs such as Microsoft Word, WPS Office or LibreOffice might be convenient, because the formatting of the document is directly visible. But the complicated syntax specifications often result in problems when using different software versions and for collaborative writing. Simple conversions between file formats can be difficult or impossible. In a worst-case scenario, ‘old’ files cannot be opened any more for lack of compatible software.</p>
<p>In some parts of the scientific community therefore LATEX, a typesetting program in plain text format, is very popular. With LATEX, documents with highest typographic quality can be produced. However, the source files are cluttered with LATEX commands and the source text can be complicated to read. Causes of compilation errors in LATEX are sometimes difficult to find. Therefore, LATEX is not very user friendly, especially for casual writers or beginners.</p>
<p><strong>Table 1</strong>. Current standard formats for scientific publishing.</p>
<table style="width:100%;">
<colgroup>
<col width="7%" />
<col width="20%" />
<col width="14%" />
<col width="11%" />
<col width="46%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"><strong>Type</strong></th>
<th align="left"><strong>Description</strong></th>
<th align="left"><strong>Use</strong></th>
<th align="left"><strong>Syntax</strong></th>
<th align="left"><strong>Reference</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">DOCX</td>
<td align="left">Office Open XML</td>
<td align="left">WYSIWYG editing</td>
<td align="left">XML, ZIP</td>
<td align="left"><span class="citation">(Ngo 2006)</span></td>
</tr>
<tr class="even">
<td align="left">ODT</td>
<td align="left">OpenDocument</td>
<td align="left">WYSIWYG editing</td>
<td align="left">XML, ZIP</td>
<td align="left"><span class="citation">(Brauer et al. 2005)</span></td>
</tr>
<tr class="odd">
<td align="left">PDF</td>
<td align="left">portable document</td>
<td align="left">print replacement</td>
<td align="left">PDF</td>
<td align="left"><span class="citation">(International Organization for Standardization 2013)</span></td>
</tr>
<tr class="even">
<td align="left">EPUB</td>
<td align="left">electronic publishing</td>
<td align="left">e-books</td>
<td align="left">HTML5, ZIP</td>
<td align="left"><span class="citation">(Eikebrokk, Dahl, and Kessel 2014)</span></td>
</tr>
<tr class="odd">
<td align="left">JATS</td>
<td align="left">journal article tag suite</td>
<td align="left">journal publishing</td>
<td align="left">XML</td>
<td align="left"><span class="citation">(National Information Standards Organization 2012)</span></td>
</tr>
<tr class="even">
<td align="left">LATEX</td>
<td align="left">typesetting system</td>
<td align="left">high-quality print</td>
<td align="left">TEX</td>
<td align="left"><span class="citation">(Lamport 1994)</span></td>
</tr>
<tr class="odd">
<td align="left">HTML</td>
<td align="left">hypertext markup</td>
<td align="left">websites</td>
<td align="left">(X)HTML</td>
<td align="left"><span class="citation">(Raggett et al. 1999; Hickson et al. 2014)</span></td>
</tr>
<tr class="even">
<td align="left">MD</td>
<td align="left">Markdown</td>
<td align="left">lightweight markup</td>
<td align="left">plain text MD</td>
<td align="left"><span class="citation">(Ovadia 2014; Leonard 2016)</span></td>
</tr>
</tbody>
</table>
<p><strong>Table 2.</strong> Examples for formatting elements and their implementations in different markup languages.</p>
<table style="width:100%;">
<colgroup>
<col width="12%" />
<col width="19%" />
<col width="36%" />
<col width="30%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"><strong>Element</strong></th>
<th align="left"><strong>Markdown</strong></th>
<th align="left"><strong>LATEX</strong></th>
<th align="left"><strong>HTML</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><strong>structure</strong></td>
<td align="left"></td>
<td align="left"></td>
</tr>
<tr class="even">
<td align="left">section</td>
<td align="left"><code># Intro</code></td>
<td align="left"><code>\section{Intro}</code></td>
<td align="left"><code><h1>Intro</h1></code></td>
</tr>
<tr class="odd">
<td align="left">subsection</td>
<td align="left"><code>## History</code></td>
<td align="left"><code>\subsection{History}</code></td>
<td align="left"><code><h2>History</h2></code></td>
</tr>
<tr class="even">
<td align="left"><strong>text style</strong></td>
<td align="left"></td>
<td align="left"></td>
</tr>
<tr class="odd">
<td align="left">bold</td>
<td align="left"><code>**text**</code></td>
<td align="left"><code>\textbf{text}</code></td>
<td align="left"><code><b>text</b></code></td>
</tr>
<tr class="even">
<td align="left">italics</td>
<td align="left"><code>*text*</code></td>
<td align="left"><code>\textit{text}</code></td>
<td align="left"><code><i>text</i></code></td>
</tr>
<tr class="odd">
<td align="left"><strong>links</strong></td>
<td align="left"></td>
<td align="left"></td>
</tr>
<tr class="even">
<td align="left">HTTP link</td>
<td align="left"><code><https:// arxiv.org></code></td>
<td align="left"><code>\usepackage{url} \url{https://arxiv.org}</code></td>
<td align="left"><code><a href="https:// arxiv.org"></a></code></td>
</tr>
</tbody>
</table>
<p>In academic publishing, it is additionally desirable to create different output formats from the same source text:</p>
<ul>
<li>For the publishing of a book, with a print version in PDF and an electronic version in EPUB.</li>
<li>For the distribution of a seminar script, with an online version in HTML and a print version in PDF.</li>
<li>For submitting a journal manuscript for peer-review in DOCX, as well as a preprint version with another journal style in PDF.</li>
<li>For archiving and exchanging article data using the Journal Article Tag Suite (JATS) <span class="citation">(National Information Standards Organization 2012)</span>, a standardized format developed by the NLM.</li>
</ul>
<p>Some of the tasks can be performed e.g. with LATEX, but an integrated solution remains a challenge. Several programs for the conversion between documents formats exist, such as the e-book library program calibre <a href="http://calibre-ebook.com/" class="uri">http://calibre-ebook.com/</a>. But the results of such conversions are often not satisfactory and require substantial manual corrections.</p>
<p>Therefore, we were looking for a solution that enables the creation of scientific manuscripts in a simple format, with the subsequent generation of multiple output formats. The need for hybrid publishing has been recognized outside of science <span class="citation">(DPT Collective 2015; Kielhorn 2011)</span>, but the requirements specific to scientific publishing have not been addressed so far. Therefore, we investigated the possibility to generate multiple publication formats from a simple manuscript source file.</p>
<h1 id="concepts-of-markdown-and-pandoc">Concepts of markdown and pandoc</h1>
<p>Markdown was originally developed by John Gruber in collaboration with Aaron Swartz, with the goal to simplify the writing of HTML documents <a href="http://daringfireball.net/projects/markdown/" class="uri">http://daringfireball.net/projects/markdown/</a>. Instead of coding a file in HTML syntax, the content of a document is written in plain text and annotated with simple tags which define the formatting. Subsequently, the Markdown (MD) files are parsed to generate the final HTML document. With this concept, the source file remains easily readable and the author can focus on the contents rather than formatting. Despite its original focus on the web, the MD format has been proven to be well suited for academic writing <span class="citation">(Ovadia 2014)</span>. In particular, pandoc-flavored MD (<a href="http://pandoc.org/" class="uri">http://pandoc.org/</a>) adds several extensions which facilitate the authoring of academic documents and their conversion into multiple output formats. <strong>Tab. 2</strong> demonstrates the simplicity of MD compared to other markup languages. <strong>Fig. 3</strong> illustrates the generation of various formatted documents from a manuscript in pandoc MD. Some relevant functions for scientific texts are explained below in more detail.</p>
<div class="figure">
<img src="Fig3.png" title="Workfow for the generation of multiple document formats with pandoc" alt="Workfow for the generation of multiple document formats with pandoc. The markdown (MD) file contains the manuscript text with formatting tags, and can also refer to external files such as images or reference databases. The pandoc processor converts the MD file to the desired output formats. Documents, citations etc. can be defined in style files or templates." />
<p class="caption">Workfow for the generation of multiple document formats with pandoc. The markdown (MD) file contains the manuscript text with formatting tags, and can also refer to external files such as images or reference databases. The pandoc processor converts the MD file to the desired output formats. Documents, citations etc. can be defined in style files or templates.</p>
</div>
<h1 id="markdown-editors-and-online-editing">Markdown editors and online editing</h1>
<p>The usability of a text editor is important for the author, either writing alone or with several co-authors. In this section we present software and strategies for different scenarios. <strong>Fig. 4</strong> summarizes various options for local or networked editing of MD files.</p>
<div class="figure">
<img src="Fig4.png" title="Offline and online editing of markdown files" alt="Markdown files can be edited on local devices or on cloud drives. A local or remote git repository enables advanced advanced version control." />
<p class="caption">Markdown files can be edited on local devices or on cloud drives. A local or remote git repository enables advanced advanced version control.</p>
</div>
<h2 id="markdown-editors">Markdown editors</h2>
<p>Due to MD’s simple syntax, basically any text editor is suitable for editing markdown files. The formatting tags are written in plain text and are easy to remember. Therefore, the author is not distracted by looking around for layout options with the mouse. For several popular text editors, such as vim (<a href="http://www.vim.org/" class="uri">http://www.vim.org/</a>), GNU Emacs (<a href="https://www.gnu.org/software/emacs/" class="uri">https://www.gnu.org/software/emacs/</a>), atom (<a href="https://atom.io/" class="uri">https://atom.io/</a>) or geany (<a href="http://www.geany.org/" class="uri">http://www.geany.org/</a>), plugins provide additional functionality for markdown editing, e.g. syntax highlighting, command helpers, live preview or structure browsing.</p>
<p>Various dedicated markdown editors have been published as well. Many of those are cross-platform compatible, such as Abricotine (<a href="http://abricotine.brrd.fr/" class="uri">http://abricotine.brrd.fr/</a>), ghostwriter (<a href="https://github.com/wereturtle/ghostwriter" class="uri">https://github.com/wereturtle/ghostwriter</a>) and CuteMarkEd (<a href="https://cloose.github.io/CuteMarkEd/" class="uri">https://cloose.github.io/CuteMarkEd/</a>).</p>
<p>The lightweight format is also ideal for writing on mobile devices. Numerous applications are available on the App stores for Android and iOS systems. The programs Swype and Dragon (<a href="http://www.nuance.com/" class="uri">http://www.nuance.com/</a>) facilitate the input of text on such devices by guessing words from gestures and speech recognition (dictation).</p>
<p><strong>Fig. 5.</strong> shows the editing of a markdown file, using the cross-platform editor Atom with several markdown plugins.</p>
<div class="figure">
<img src="Fig5.png" title="Atom editor" alt="Document directory tree, editing window and HTML preview using the Atom editor." />
<p class="caption">Document directory tree, editing window and HTML preview using the Atom editor.</p>
</div>
<h2 id="online-editing-and-collaborative-writing">Online editing and collaborative writing</h2>
<p>Storing manuscripts on network drives (<em>The Cloud</em>) has become popular for several reasons:</p>
<ul>
<li>Protection against data loss.</li>
<li>Synchronization of documents between several devices.</li>
<li>Collaborative editing options.</li>
</ul>
<p>Markdown files on a Google Drive (<a href="https://drive.google.com" class="uri">https://drive.google.com</a>) for instance can be edited online with StackEdit (<a href="https://stackedit.io" class="uri">https://stackedit.io</a>). <strong>Fig. 6</strong> demonstrates the online editing of a markdown file on an ownCloud (<a href="https://owncloud.com/" class="uri">https://owncloud.com/</a>) installation. OwnCloud is an Open Source software platform, which allows the set-up of a file server on personal webspace. The functionality of an ownCloud installation can be enhanced by installing plugins.</p>
<div class="figure">
<img src="Fig6.png" title="Online editing on with an ownCloud plugin" alt="Direct online editing of this manuscript with live preview using the ownCloud Markdown Editor plugin by Robin Appelman." />
<p class="caption">Direct online editing of this manuscript with live preview using the ownCloud Markdown Editor plugin by Robin Appelman.</p>
</div>
<p>Even mathematical formulas are rendered correctly in the HTML live preview window of the ownCloud markdown plugin (<strong>Fig. 6</strong> ).</p>
<p>The collaboration and authoring platform Authorea (<a href="https://www.authorea.com/" class="uri">https://www.authorea.com/</a>) also supports markdown as one of multiple possible input formats. This can be beneficial for collaborations in which one or more authors are not familiar with markdown syntax.</p>
<h2 id="document-versioning-and-change-control">Document versioning and change control</h2>
<p>Programmers, especially when working in distributed teams, rely on version control systems to manage changes of code. Currently, Git (<a href="https://git-scm.com/" class="uri">https://git-scm.com/</a>), which is also used e.g. for the development of the Linux kernel, is one of the most employed software solutions for versioning. Git allows the parallel work of collaborators and has an efficient merging and conflict resolution system. A Git repository may be used by a single local author to keep track of changes, or by a team with a remote repository, e.g. on github (<a href="https://github.com/" class="uri">https://github.com/</a>) or bitbucket (<a href="https://bitbucket.org/" class="uri">https://bitbucket.org/</a>). Because of the plain text format of markdown, Git can be used for version control and distributed writing. For the writing of the present article, the co-authors (Germany and Mexico) used a remote Git repository on bitbucket. The plain text syntax of markdown facilitates the visualization of differences of document versions, as shown in <strong>Fig. 7</strong>.</p>
<div class="figure">
<img src="Fig7.png" title="Version control using a git repository" alt="Version control and collaborative editing using a git repository on bitbucket." />
<p class="caption">Version control and collaborative editing using a git repository on bitbucket.</p>
</div>
<h1 id="pandoc-markdown-for-scientific-texts">Pandoc markdown for scientific texts</h1>
<p>In the following section, we demonstrate the potential for typesetting scientific manuscripts with pandoc using examples for typical document elements, such as tables, figures, formulas, code listings and references. A brief introduction is given by <span class="citation">Dominici (2014)</span>. The complete Pandoc User’s Manual is available at <a href="http://pandoc.org/MANUAL.html" class="uri">http://pandoc.org/MANUAL.html</a>.</p>
<h2 id="tables">Tables</h2>
<p>There are several options to write tables in markdown. The most flexible alternative - which was also used for this article - are pipe tables. The contents of different cells are separated by pipe symbols (<code>|</code>):</p>
<pre><code>Left | Center | Right | Default
:-----|:------:|------:|---------
LLL | CCC | RRR | DDD</code></pre>
<p>gives</p>
<table>
<thead>
<tr class="header">
<th align="left">Left</th>
<th align="center">Center</th>
<th align="right">Right</th>
<th align="left">Default</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">LLL</td>
<td align="center">CCC</td>
<td align="right">RRR</td>
<td align="left">DDD</td>
</tr>
</tbody>
</table>
<p>The headings and the alignment of the cells are given in the first two lines. The cell width is variable. The pandoc parameter <code>--columns=NUM</code> can be used to define the length of lines in characters. If contents do not fit, they will be wrapped.</p>
<p>Complex tables, e.g. tables featuring multiple headers or those containing cells spanning multiple rows or columns, are currently not representable in markdown format. However, it is possible to embed LATEX and HTML tables into the document. These format-specific tables will only be included in the output if a document of the respective format is produced. This is method can be extended to apply any kind of format-specific typographic functionality which would otherwise be unavailable in markdown syntax.</p>
<h2 id="figures-and-images">Figures and images</h2>
<p>Images are inserted as follows:</p>
<pre><code></code></pre>
<p>e.g.</p>
<pre><code></code></pre>
<p>The <em>alt text</em> is used e.g. in HTML output. Image dimensions can be defined in braces:</p>
<pre><code></code></pre>
<p>As well, an identifier for the figure can be defined with <code>#</code>, resulting e.g. in the image attributes <code>{#figure1 height=30%}</code>.</p>
<p>A paragraph containing only an image is interpreted as a figure. The <em>alt text</em> is then output as the figure’s caption.</p>
<h2 id="symbols">Symbols</h2>
<p>Scientific texts often require special characters, e.g. Greek letters, mathematical and physical symbols etc.</p>
<p>The UTF-8 standard, developed and maintained by <em>Unicode Consortium</em>, enables the use of characters across languages and computer platforms. The encoding is defined as RFC document 3629 of the Network Working group <span class="citation">(Yergeau 2003)</span> and as ISO standard ISO/IEC 10646:2014 <span class="citation">(International Organization for Standardization 2014)</span>. Specifications of Unicode and code charts are provided on the Unicode homepage (<a href="http://www.unicode.org/" class="uri">http://www.unicode.org/</a>).</p>
<p>In pandoc mardown documents, Unicode characters such as °, α , ä , Å can be inserted directly and passed to the different output documents. The correct processing of MD with UTF-8 encoding to LATEX/PDF output requires the use of the <code>--latex-engine=xelatex</code> option and the use of an appropriate font. The Times-like XITS font (<a href="https://github.com/khaledhosny/xits-math" class="uri">https://github.com/khaledhosny/xits-math</a>), suitable for high quality typesetting of scientific texts, can be set in the LATEX template:</p>
<div class="sourceCode"><pre class="sourceCode latex"><code class="sourceCode latex">\usepackage{unicode-math}
\setmainfont
[ Extension = .otf,
UprightFont = *-regular,
BoldFont = *-bold,
ItalicFont = *-italic,
BoldItalicFont = *-bolditalic,
]{xits}
\setmathfont
[ Extension = .otf,
BoldFont = *bold,
]{xits-math}</code></pre></div>
<p>To facilitate the input of specific characters, so-called mnemonics can be enabled in some editors (e.g. in atom by the <code>character-table</code> package). For example, the 2-character Mnemonics ‘:u’ gives ‘ü’ (diaeresis), or ’D*’ the Greek Δ. The possible character mnemonics and character sets are listed in RFC 1345 <a href="http://www.faqs.org/rfcs/rfc1345.html" class="uri">http://www.faqs.org/rfcs/rfc1345.html</a> <span class="citation">(Simonsen 1992)</span>.</p>
<h2 id="formulas">Formulas</h2>
<p>Formulas are written in LATEX mode using the delimiters <code>$</code>. E.g. the formula for calculating the standard deviation <span class="math inline">\(s\)</span> of a random sampling would be written as:</p>
<pre><code>$s=\sqrt{\frac{1}{N-1}\sum_{i=1}^N(x_i-\overline{x})^{2}}$</code></pre>
<p>and gives:</p>
<p><span class="math inline">\(s=\sqrt{\frac{1}{N-1}\sum_{i=1}^N(x_i-\overline{x})^{2}}\)</span></p>
<p>with <span class="math inline">\(x_i\)</span> the individual observations, <span class="math inline">\(\overline{x}\)</span> the sample mean and <span class="math inline">\(N\)</span> the total number of samples.</p>
<p>Pandoc parses formulas into internal structures and allows conversion into formats other than LATEX. This allows for format-specific formula representation and enables computational analysis of the formulas <span class="citation">(Corbí and Burgos 2015)</span>.</p>
<h2 id="code-listings">Code listings</h2>
<p>Verbatim code blocks are indicated by three tilde symbols:</p>
<pre><code>~~~
verbatim code
~~~</code></pre>
<p>Typesetting <code>inline code</code> is possible by enclosing text between back ticks.</p>
<pre><code>`inline code`</code></pre>
<h2 id="other-document-elements">Other document elements</h2>
<p>These examples are only a short demonstration of the capacities of pandoc concerning scientific documents. For more detailed information, we refer to the official manual ( <a href="http://pandoc.org/MANUAL.html" class="uri">http://pandoc.org/MANUAL.html</a>).</p>
<h1 id="citations-and-biography">Citations and biography</h1>
<p>The efficient organization and typesetting of citations and bibliographies is crucial for academic writing. Pandoc supports various strategies for managing references. For processing the citations and the creation of the bibliography, the command line parameter <code>--filter pandoc-citeproc</code> is used, with variables for the reference database and the bibliography style. The bibliography will be located automatically at the header <code># References</code> or <code># Bibliography</code>.</p>
<h2 id="reference-databases">Reference databases</h2>
<p>Pandoc is able to process all mainstream literature database formats, such as RIS, BIB, etc. However, for maintaining compatibility with LATEX/ BIBTEX, the use of BIB databases is recommended. The used database either can be defined in the YAML metablock of the MD file (see below) or it can be passed as parameter when calling pandoc.</p>
<h2 id="inserting-citations">Inserting citations</h2>
<p>For inserting a reference, the database key is given within square brackets, and indicated by an ‘@’. It is also possible to add information, such as page:</p>
<pre><code>[@suber_open_2012; @benkler_wealth_2006, 57 ff.]</code></pre>
<p>gives <span class="citation">(Suber 2012; Benkler 2006, 57 ff.)</span>.</p>
<h2 id="styles">Styles</h2>
<p>The Citation Style Language (CSL) <a href="http://citationstyles.org/" class="uri">http://citationstyles.org/</a> is used for the citations and bibliographies. This file format is supported e.g. by the reference management programs Mendeley <a href="https://www.mendeley.com/" class="uri">https://www.mendeley.com/</a>, Papers <a href="http://papersapp.com/" class="uri">http://papersapp.com/</a> and Zotero <a href="https://www.zotero.org/" class="uri">https://www.zotero.org/</a>. CSL styles for particular journals can be found from the Zotero style repository <a href="https://www.zotero.org/styles" class="uri">https://www.zotero.org/styles</a>. The bibliography style that pandoc should use for the target document can be chosen in the YAML block of the markdown document or can be passed in as an command line option. The latter is more recommendable, because distinct bibliography style may be used for different documents.</p>
<h2 id="creation-of-latex-natbib-citations">Creation of LATEX <code>natbib</code> citations</h2>
<p>For citations in scientific manuscripts written in LATEX, the natbib package is widely used. To create a LATEX output file with natbib citations, pandoc simply has to be run with the <code>--natbib</code> option, but without the <code>--filter pandoc-citeproc</code> parameter.</p>
<h2 id="database-of-cited-references">Database of cited references</h2>
<p>To share the bibliography for a certain manuscript with co-authors or the publisher’s production team, it is often desirable to generate a subset of a larger database, which only contains the cited references. If LATEX output was generated with the <code>--natbib</code> option, the compilation of the file with LATEX gives an AUX file (in the example named <code>md-article.aux</code>), which subsequently can be extracted using BibTool <a href="https://github.com/ge-ne/bibtool" class="uri">https://github.com/ge-ne/bibtool</a>:</p>
<pre><code>~~~
bibtool -x md-article.aux -o bibshort.bib
~~~</code></pre>
<p>In this example, the article database will be called <code>bibshort.bib</code>.</p>
<p>For the direct creation of an article specific BIB database without using LATEX, we wrote a simple Perl script called <code>mdbibexport</code> (<a href="https://github.com/robert-winkler/mdbibexport" class="uri">https://github.com/robert-winkler/mdbibexport</a>).</p>
<h1 id="meta-information-of-the-document">Meta information of the document</h1>
<p><span class="citation">Bourne (2005)</span> argues that journals should be effectively equivalent to biological databases: both provide data which can be referenced by unique identifiers like DOI or e.g. gene IDs. Applying the semantic-web ideas of <span class="citation">Berners-Lee and Hendler (2001)</span> to this domain can make this vision a reality. Here we show how metadata can be specified in markdown. We propose conventions, and demonstrate their suitability to enable interlinked and semantically enriched journal articles.</p>
<p>Document information such as title, authors, abstract etc. can be defined in a metadata block written in YAML syntax. YAML (“YAML Ain’t Markup Language”, <a href="http://yaml.org/" class="uri">http://yaml.org/</a>) is a data serialization standard in simple, human readable format. Variables defined in the YAML section are processed by pandoc and integrated into the generated documents. The YAML metadata block is recognized by three hyphens (<code>---</code>) at the beginning, and three hyphens or dots (<code>...</code>) at the end, e.g.:</p>
\newpage
<div class="sourceCode"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span class="ot">---</span>
<span class="fu">title:</span> Formatting Open Science
<span class="fu">subtitle:</span> agile creation of multiple document types
<span class="fu">date:</span> 2017-02-10
<span class="co">...</span></code></pre></div>
<p>The public availability of all relevant information is a central aspect of Open Science. Analogous to article contents, data should be accessible via default tools. We believe that this principle must also be applied to article metadata. Thus, we created a custom pandoc writer that emits the article’s data as JSON–LD <span class="citation">(Lanthaler and Gütl 2012)</span>, allowing for informational and navigational queries of the journal’s data with standard tools of the semantic web. The above YAML information would be output as:</p>
<div class="sourceCode"><pre class="sourceCode json"><code class="sourceCode json"><span class="fu">{</span>
<span class="dt">"@context"</span><span class="fu">:</span> <span class="fu">{</span>
<span class="dt">"@vocab"</span><span class="fu">:</span> <span class="st">"http://schema.org/"</span><span class="fu">,</span>
<span class="dt">"date"</span><span class="fu">:</span> <span class="st">"datePublished"</span><span class="fu">,</span>
<span class="dt">"title"</span><span class="fu">:</span> <span class="st">"headline"</span><span class="fu">,</span>
<span class="dt">"subtitle"</span><span class="fu">:</span> <span class="st">"alternativeTitle"</span>
<span class="fu">},</span>
<span class="dt">"@type"</span><span class="fu">:</span> <span class="st">"ScholarlyArticle"</span><span class="fu">,</span>
<span class="dt">"title"</span><span class="fu">:</span> <span class="st">"Formatting Open Science"</span><span class="fu">,</span>
<span class="dt">"subtitle"</span><span class="fu">:</span> <span class="st">"agile creation of multiple document types"</span><span class="fu">,</span>
<span class="dt">"date"</span><span class="fu">:</span> <span class="st">"2017-02-10"</span>
<span class="fu">}</span></code></pre></div>
<p>This format allows processing of the information by standard data processing software and browsers.</p>
<h2 id="flexible-metadata-authoring">Flexible metadata authoring</h2>
<p>We developed a method to allow writers the flexible specification of authors and their respective affiliations. Author names can be given as a string, via the key of a single-element object, or explicitly as a <code>name</code> attribute of an object. Affiliations can be specified directly as properties of the author object, or separately in the <code>institute</code> object.</p>
<p>Additional information, e.g. email addresses or identifiers like ORCID <span class="citation">(Haak et al. 2012)</span>, can be added as additional values:</p>
<div class="sourceCode"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span class="fu">author:</span>
<span class="kw">-</span> <span class="fu">John Doe:</span>
<span class="fu">institute:</span> fs
<span class="fu">email:</span> john.doe@example.com
<span class="fu">orcid:</span> 0000-0000-0000-0000
<span class="fu">institute:</span>
<span class="fu">fs:</span> Science Formatting Working Group</code></pre></div>
<h2 id="jats-support">JATS support</h2>
<p>The journal article tag suite (JATS) was developed by the NLM and standardized by ANSI/NISO as an archiving and exchange format of journal articles and the associated metadata <span class="citation">(National Information Standards Organization 2012)</span>, including data of the type shown above. The <code>pandoc-jats</code> writer by Martin Fenner is a plugin usable with pandoc to produce JATS-formatted output. The writer was adapted to be compatible with our metadata authoring method, allowing for simple generation of files which contain the relevant metadata.</p>
<h2 id="citation-types">Citation types</h2>
<p>Writers can add information about the reason a citation is given. This might help reviewers and readers, and can simplify the search for relevant literature. We developed an extended citation syntax that integrates seamlessly into markdown and can be used to add complementary information to citations. Our method is based on CiTO, the Citation Typing Ontology <span class="citation">(Shotton 2010)</span>, which specifies a vocabulary for the motivation when citing a resource. The type of a citations can be added to a markdown citation using <code>@CITO_PROPERTY:KEY</code>, where <code>CITO_PROPERTY</code> is a supported CiTO property, and <code>KEY</code> is the usual citation key. Our tool extracts that information and includes it in the generated linked data output. A general CiTO property (<em>cites</em>) is used, if no CiTO property is found in a citation key.</p>
<p>The work at hand will always be the subject of the generated semantic <em>subject-predicate-object</em> triples. Some CiTO predicates cannot be used in a sensical way under this condition. Focusing on author convenience, we use this fact to allow shortening of properties when sensible. E.g. if authors of a biological paper include a reference to the paper describing a method which was used in their work, this relation can be described by the <em>uses_method_in</em> property of the CiTO ontology. The inverse property, <em>provides_method_for</em>, would always be nonsensical in this context as implied by causality. It is therefore not supported by our tool. This allows us to introduce an abbreviation (<em>method</em>) for the latter property, as any ambiguity has been eliminated. Users of western blotting might hence write <code>@method_in:towbin_1979</code> or even just <code>@method:towbin_1979</code>, where <em>towbin_1979</em> is the citation identifier of the describing paper by <span class="citation">Towbin, Staehelin, and Gordon (1979)</span>.</p>
<h1 id="example-manuscript-with-output-of-docx-odt-format-and-latex-pdf-for-submission-to-different-journals.">Example: Manuscript with output of DOCX/ ODT format and LATEX/ PDF for submission to different journals.</h1>
<p>Scientific manuscripts have to be submitted in a format defined by the journal or publisher. At the moment, DOCX is the most common file format for manuscript submission. Some publishers also accept or require LATEX or ODT formats. Additional to the general style of the manuscript - organization of sections, fonts, etc. – the citation style of the journal must also be followed. Often, the same manuscript has to be prepared for different journals, e.g. if the manuscript was rejected by a journal and has to be formatted for another one, or if a preprint of the paper is submitted to an archive that requires a distinct document format than the targeted peer-reviewed journal.<br> In this example, we want to create a manuscript for a <em>PLoS</em> journal in DOCX and ODT format for WYSIWYG word processors. Further, a version in LATEX/ PDF should be produced for PeerJ submission and archiving at the PeerJ preprint server.</p>
<p>The examples for DOCX/ ODT are kept relatively simple, to show the proof-of-principle and to provide a plain document for the development of own templates. Nevertheless, the generated documents should be suitable for submission after little manual editing. For specific journals it may be necessary to create more sophisticated templates or to copy/ paste the generic DOCX/ ODT output into the publisher’s template.</p>
<h2 id="development-of-a-docx-odt-template">Development of a DOCX/ ODT template</h2>
<p>A first DOCX document with bibliography in <em>PLoS</em> format is created with pandoc DOCX output:</p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">pandoc</span> -S -s --csl=plos.csl --filter pandoc-citeproc
<span class="kw">-o</span> pandoc-manuscript.docx agile-editing-pandoc.md</code></pre></div>
<p>The parameters <code>-S -s</code> generate a typographically correct (dashes, non-breaking spaces etc.) stand-alone document. A bibliography with the <em>PLoS</em> style is created by the citeproc filter setting <code>--csl=plos.csl --filter pandoc-citeproc</code>.</p>
<p>The document settings and styles of the resulting file <code>pandoc-manuscript.docx</code> can be optimized and be used again as document template (<code>--reference-docx=pandoc-manuscript.docx</code>).</p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">pandoc</span> -S -s --reference-docx=pandoc-manuscript.docx --csl=plos.csl
<span class="kw">--filter</span> pandoc-citeproc -o outfile.docx agile-editing-pandoc.md</code></pre></div>
<p>It is also possible to directly re-use a previous output file as template (i.e. template and output file have the same file name):</p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">pandoc</span> -S -s --columns=10 --reference-docx=pandoc-manuscript.docx
<span class="kw">--csl</span>=plos.csl --filter=pandoc-citeproc
<span class="kw">-o</span> pandoc-manuscript.docx agile-editing-pandoc.md</code></pre></div>
<p>In this way, the template can be incrementally adjusted to the desired document formatting. The final document may be employed later as pandoc template for other manuscripts with the same specifications. In this case, running pandoc the first time with the template, the contents of the new manuscript would be filled into the provided DOCX template. A page with DOCX manuscript formatting of this article is shown in <strong>Fig. 8</strong>.</p>
<div class="figure">
<img src="Fig8.png" title="Editing a pandoc generated DOCX in Office 365" alt="Opening a pandoc-generated DOCX in Microsoft Office 365." />
<p class="caption">Opening a pandoc-generated DOCX in Microsoft Office 365.</p>
</div>
<p>The same procedure can be applied with an ODT formatted document.</p>
<h2 id="development-of-a-texpdf-template">Development of a TEX/PDF template</h2>
<p>The default pandoc LATEX template can be written into a separate file by:</p>
<div class="sourceCode"><pre class="sourceCode bash"><code class="sourceCode bash"><span class="kw">pandoc</span> -D latex <span class="kw">></span> template-peerj.latex</code></pre></div>
<p>This template can be adjusted, e.g. by defining Unicode encoding (see above), by including particular packages or setting document options (line numbering, font size). The template can then be used with the pandoc parameter <code>--template=pandoc-peerj.latex</code>.</p>
<p>The templates used for this document are included as Supplemental Material (see section <em>Software and code availability</em> below).</p>
<h2 id="styles-for-html-and-epub">Styles for HTML and EPUB</h2>
<p>The style for HTML and EPUB formats can be defined in .css stylesheets. The Supplemental Material contains a simple example .css file for modifying the HTML output, which can be used with the pandoc parameter <code>-c pandoc.css</code>.</p>
<h1 id="automating-document-production">Automating document production</h1>
<p>The commands necessary to produce the document in a specific formats or styles can be defined in a simple <code>Makefile</code>. An example <code>Makefile</code> is included in the source code of this preprint. The desired output file format can be chosen when calling <code>make</code>. E.g. <code>make outfile.pdf</code> produces this preprint in PDF format. Calling <code>make</code> without any option creates all listed document types. A <code>Makefile</code> producing DOCX, ODT, JATS, PDF, LATEX, HTML and EPUB files of this document is provided as Supplemental Material.</p>
<h2 id="cross-platform-compatibility">Cross-platform compatibility</h2>
<p>The <code>make</code> process was tested on Windows 10 and Linux 64 bit. All documents – DOCX, ODT, JATS, LATEX, PDF, EPUB and HTML – were generated successfully, which demonstrates the cross-platform compatibility of the workflow.</p>
<h1 id="perspective">Perspective</h1>
<p>Following the trend to peer production, the formatting of scientific content must become more efficient. Markdown/ pandoc has the potential to play a key role in the transition from proprietary to community-driven academic production. Important research tools, such as the statistical computing and graphics language R <span class="citation">(R Core Team 2014)</span> and the Jupyter notebook project <span class="citation">(Kluyver et al. 2016)</span> have already adopted the MD syntax (e.g. <a href="http://rmarkdown.rstudio.com/" class="uri">http://rmarkdown.rstudio.com/</a>). The software for writing manuscripts in MD is mature enough to be used by academic writers. Therefore, publishers also should consider implementing the MD format into their editorial platforms.</p>
<h1 id="conclusions">Conclusions</h1>
<p>Authoring scientific manuscripts in markdown (MD) format is straight-forward, and manual formatting is reduced to a minimum. The simple syntax of MD facilitates document editing and collaborative writing. The rapid conversion of MD to multiple formats such as DOCX, LATEX, PDF, EPUB and HTML can be done easily using pandoc, and templates enable the automated generation of documents according to specific journal styles.</p>
<p>The additional features we implemented facilitate the correct indexing of meta information of journal articles according to the ‘semantic web’ philosophy.</p>
<p>Altogether, the MD format supports the agile writing and fast production of scientific literature. The associated time and cost reduction especially favours community-driven publication strategies.</p>
<h1 id="acknowledgments">Acknowledgments</h1>
<p>We cordially thank Dr. Gerd Neugebauer for his help in creating a subset of a bibtex data base using BibTool, as well as Dr. Ricardo A. Chávez Montes, Prof. Magnus Palmblad and Martin Fenner for comments on the manuscript. Warm thanks also go to Anubhav Kumar and Jennifer König for proofreading.</p>
\newpage
<h1 id="software-and-code-availability">Software and code availability</h1>
<p>The relevant software for creating this manuscript used is cited according to <span class="citation">(Smith, Katz, and Niemeyer 2016)</span> and listed in <strong>Tab. 3</strong>. Since unique identifiers are missing for most software projects, we only refer to the project homepages or software repositories:</p>
<p><strong>Table 3.</strong> Relevant software used for this article.</p>
<table style="width:100%;">
<colgroup>
<col width="10%" />
<col width="24%" />
<col width="20%" />
<col width="7%" />
<col width="7%" />
<col width="30%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"><strong>Software</strong></th>
<th align="left"><strong>Use</strong></th>
<th align="left"><strong>Authors</strong></th>
<th align="left"><strong>Version</strong></th>
<th align="left"><strong>Release</strong></th>
<th align="left"><strong>Homepage/ repository</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left">pandoc</td>
<td align="left">universal markup converter</td>
<td align="left">John MacFarlane</td>
<td align="left">1.16.0.2</td>
<td align="left">16/01/13</td>
<td align="left"><a href="http://www.pandoc.org" class="uri">http://www.pandoc.org</a></td>
</tr>
<tr class="even">
<td align="left">pandoc-citeproc</td>
<td align="left">library for CSL citations with pandoc</td>
<td align="left">John MacFarlane, Andrea Rossato</td>
<td align="left">0.9.1</td>
<td align="left">16/03/19</td>
<td align="left"><a href="https://github.com/jgm/pandoc-citeproc" class="uri">https://github.com/jgm/pandoc-citeproc</a></td>
</tr>
<tr class="odd">
<td align="left">pandoc-jats</td>
<td align="left">creation of JATS files with pandoc</td>
<td align="left">Martin Fenner</td>
<td align="left">0.9</td>
<td align="left">15/04/26</td>
<td align="left"><a href="https://github.com/mfenner/pandoc-jats" class="uri">https://github.com/mfenner/pandoc-jats</a></td>
</tr>
<tr class="even">
<td align="left">ownCloud</td>
<td align="left">personal cloud software</td>
<td align="left">ownCloud GmbH, Community</td>
<td align="left">9.1.1</td>
<td align="left">16/09/20</td>
<td align="left"><a href="https://owncloud.org/" class="uri">https://owncloud.org/</a></td>
</tr>
<tr class="odd">
<td align="left">Markdown Editor</td>
<td align="left">plugin for ownCloud</td>
<td align="left">Robin Appelman</td>
<td align="left">0.1</td>
<td align="left">16/03/08</td>
<td align="left"><a href="https://github.com/icewind1991/files_markdown" class="uri">https://github.com/icewind1991/files_markdown</a></td>
</tr>
<tr class="even">
<td align="left">BibTool</td>
<td align="left">Bibtex database tool</td>
<td align="left">Gerd Neugebauer</td>
<td align="left">2.63</td>
<td align="left">16/01/16</td>
<td align="left"><a href="https://github.com/ge-ne/bibtool" class="uri">https://github.com/ge-ne/bibtool</a></td>
</tr>
</tbody>
</table>
<p>The software created as part of this article, <em>pandoc-scholar</em>, is suitable for general use and has been published at <a href="https://github.com/pandoc-scholar/pandoc-scholar" class="uri">https://github.com/pandoc-scholar/pandoc-scholar</a>, DOI: <a href="https://doi.org/10.5281/zenodo.376761">10.5281/zenodo.376761</a>. The source code of this manuscript, as well as the templates and pandoc Makefile, have been deposited to <a href="https://github.com/robert-winkler/scientific-articles-markdown/" class="uri">https://github.com/robert-winkler/scientific-articles-markdown/</a>.</p>
<p>Drawings for document types, devices and applications have been adopted from Calibre <a href="http://calibre-ebook.com/" class="uri">http://calibre-ebook.com/</a>, openclipart <a href="https://openclipart.org/" class="uri">https://openclipart.org/</a> and the GNOME Theme Faenza <a href="https://code.google.com/archive/p/faenza-icon-theme/" class="uri">https://code.google.com/archive/p/faenza-icon-theme/</a>.</p>
\newpage
<h1 id="bibliography" class="unnumbered">Bibliography</h1>
<div id="refs" class="references">
<div id="ref-benkler_wealth_2006">
<p>Benkler, Yochai. 2006. <em>The Wealth of Networks: How Social Production Transforms Markets and Freedom</em>. New Haven, CT, USA: Yale University Press.</p>
</div>
<div id="ref-berners-lee_publishing_2001">
<p>Berners-Lee, Tim, and James Hendler. 2001. “Publishing on the Semantic Web.” <em>Nature</em> 410 (6832): 1023–4. doi:<a href="https://doi.org/10.1038/35074206">10.1038/35074206</a>.</p>
</div>
<div id="ref-bourne_database_2005">
<p>Bourne, Philip. 2005. “Will a Biological Database Be Different from a Biological Journal?” <em>PLOS Computational Biology</em> 1 (3): e34. doi:<a href="https://doi.org/10.1371/journal.pcbi.0010034">10.1371/journal.pcbi.0010034</a>.</p>
</div>
<div id="ref-ODF">
<p>Brauer, Michael, Patrick Durusau, Gary Edwards, David Faure, Tom Magliery, and Daniel Vogelheim. 2005. “Open Document Format for Office Applications (OpenDocument) V1.0.” OASIS.</p>
</div>
<div id="ref-brown_e-volution_2001">
<p>Brown, Cecelia. 2001. “The E-Volution of Preprints in the Scholarly Communication of Physicists and Astronomers.” <em>J. Am. Soc. Inf. Sci.</em> 52 (3): 187–200. doi:<a href="https://doi.org/10.1002/1097-4571(2000)9999:9999<::AID-ASI1586>3.0.CO;2-D">10.1002/1097-4571(2000)9999:9999<::AID-ASI1586>3.0.CO;2-D</a>.</p>
</div>
<div id="ref-brown_role_2003">
<p>———. 2003. “The Role of Electronic Preprints in Chemical Communication: Analysis of Citation, Usage, and Acceptance in the Journal Literature.” <em>J. Am. Soc. Inf. Sci.</em> 54 (5): 362–71. doi:<a href="https://doi.org/10.1002/asi.10223">10.1002/asi.10223</a>.</p>
</div>
<div id="ref-brown_why_2003">
<p>Brown, Patrick O, Michael B Eisen, and Harold E Varmus. 2003. “Why PLoS Became a Publisher.” <em>PLoS Biol</em> 1 (1). doi:<a href="https://doi.org/10.1371/journal.pbio.0000036">10.1371/journal.pbio.0000036</a>.</p>
</div>
<div id="ref-butler_alamos_2001">
<p>Butler, Declan. 2001. “Los Alamos Loses Physics Archive as Preprint Pioneer Heads East.” <em>Nature</em> 412 (6842): 3–4. doi:<a href="https://doi.org/10.1038/35083708">10.1038/35083708</a>.</p>
</div>
<div id="ref-callaway_preprints_2013">
<p>Callaway, Ewen. 2013. “Preprints Come to Life.” <em>Nature News</em> 503 (7475): 180. doi:<a href="https://doi.org/10.1038/503180a">10.1038/503180a</a>.</p>
</div>
<div id="ref-garnet_semiautomatic_2015">
<p>Corbí, Alberto, and Daniel Burgos. 2015. “Semi-Automated Correction Tools for Mathematics-Based Exercises in MOOC Environments.” <em>International Journal of Interactive Multimedia and Artificial Intelligence</em> 3 (3): 89–95. doi:<a href="https://doi.org/10.9781/ijimai.2015.3312">10.9781/ijimai.2015.3312</a>.</p>
</div>
<div id="ref-dominici_pandoc_2014">
<p>Dominici, Massimiliano. 2014. “An Overview of Pandoc.” <em>TUGboat</em> 35 (1): 44–50.</p>
</div>
<div id="ref-dptcollective_toolkit_2015">
<p>DPT Collective. 2015. “From Print to Ebooks: A Hybrid Publishing Toolkit for the Arts.” In, edited by Joe Monk, Miriam Rasch, Florian Cramer, and Amy Wu. Institute of Network Cultures.</p>
</div>
<div id="ref-eikebrokk_epub_2014">
<p>Eikebrokk, Trude, Tor Arne Dahl, and Siri Kessel. 2014. “EPUB as Publication Format in Open Access Journals: Tools and Workflow.” <em>Code4Lib</em>, no. 24 (April).</p>
</div>
<div id="ref-eisen_publish_2003">
<p>Eisen, Michael. 2003. “Publish and Be Praised.” <em>The Guardian</em>, October.</p>
</div>
<div id="ref-fecher_open_2014">
<p>Fecher, Benedikt, and Sascha Friesike. 2014. “Open Science: One Term, Five Schools of Thought.” In <em>Opening Science</em>, edited by Sönke Bartling and Sascha Friesike, 17–47. Springer International Publishing.</p>
</div>
<div id="ref-ginsparg_first_1994">
<p>Ginsparg, Paul. 1994. “First Steps Towards Electronic Research Communication.” <em>Computers in Physics</em> 8 (4): 390–96. doi:<a href="https://doi.org/10.1063/1.4823313">10.1063/1.4823313</a>.</p>
</div>
<div id="ref-haak_orcid_2012">
<p>Haak, Laurel L., Martin Fenner, Laura Paglione, Ed Pentz, and Howard Ratner. 2012. “ORCID: A System to Uniquely Identify Researchers.” <em>Learned Publishing</em> 25 (4): 259–64. doi:<a href="https://doi.org/10.1087/20120404">10.1087/20120404</a>.</p>
</div>
<div id="ref-HTML5">
<p>Hickson, Ian, Robin Berjon, Steve Faulkner, Travis Leithead, Erika Doyle Navara, Edward O’Connor, Silvia Pfeiffer, et al. 2014. “HTML5.” W3C Recommendation. W3C.</p>
</div>
<div id="ref-houghton_economic_2009">
<p>Houghton, John, Bruce Rasmussen, Peter Sheehan, Charles Oppenheim, Anne Morris, Claire Creaser, Helen Greenwood, Mark Summers, and Adrian Gourlay. 2009. “Economic Implications of Alternative Scholarly Publishing Models: Exploring the Costs and Benefits.” <a href="http://www.webarchive.org.uk/wayback/archive/20140614041628/http://www.jisc.ac.uk/publications/reports/2009/economicpublishingmodelsfinalreport.aspx#downloads" class="uri">http://www.webarchive.org.uk/wayback/archive/20140614041628/http://www.jisc.ac.uk/publications/reports/2009/economicpublishingmodelsfinalreport.aspx#downloads</a>.</p>
</div>
<div id="ref-international_organization_for_standardization_iso_2013">
<p>International Organization for Standardization. 2013. “ISO 32000-1:2008 - Document Management – Portable Document Format – Part 1: PDF 1.7.” <em>ISO</em>. <a href="http://www.iso.org/iso/home/store/catalogue_tc/catalogue_detail.htm?csnumber=51502" class="uri">http://www.iso.org/iso/home/store/catalogue_tc/catalogue_detail.htm?csnumber=51502</a>.</p>
</div>
<div id="ref-international_organization_for_standardization_iso/iec_2014">
<p>———. 2014. “ISO/IEC 10646:2014 - Information Technology – Universal Coded Character Set (UCS).” <em>ISO</em>. <a href="http://www.iso.org/iso/home/store/catalogue_tc/catalogue_detail.htm?csnumber=63182" class="uri">http://www.iso.org/iso/home/store/catalogue_tc/catalogue_detail.htm?csnumber=63182</a>.</p>
</div>
<div id="ref-kielhorn_multi_2011">
<p>Kielhorn, Axel. 2011. “Multi-Target Publishing-Generating EPub, PDF, and More, from Markdown Using Pandoc.” <em>TUGboat-TeX Users Group</em> 32 (3): 272.</p>
</div>
<div id="ref-kluyver_jupyter_2016">
<p>Kluyver, Thomas, Benjamin Ragan-Kelley, Fernando Pérez, Brian Granger, Matthias Bussonnier, Jonathan Frederic, Kyle Kelley, et al. 2016. “Jupyter Notebooks—a Publishing Format for Reproducible Computational Workflows.” In <em>Positioning and Power in Academic Publishing: Players, Agents and Agendas</em>, 87–90. doi:<a href="https://doi.org/10.3233/978-1-61499-649-1-87">10.3233/978-1-61499-649-1-87</a>.</p>
</div>
<div id="ref-lamport_latex:_1994">
<p>Lamport, Leslie. 1994. <em>LaTeX: A Document Preparation System</em>. 2 edition. Reading, Mass: Addison-Wesley Professional.</p>
</div>
<div id="ref-lanthaler_jsonld_2012">
<p>Lanthaler, Markus, and Christian Gütl. 2012. “On Using JSON-LD to Create Evolvable RESTful Services.” In <em>Proceedings of the Third International Workshop on RESTful Design</em>, 25–32. ACM.</p>
</div>
<div id="ref-rfc7764">
<p>Leonard, Sean. 2016. “Guidance on Markdown: Design Philosophies, Stability Strategies, and Select Registrations.” RFC. RFC Editor; Internet Request for Comments.</p>
</div>
<div id="ref-JATS">
<p>National Information Standards Organization. 2012. “JATS: Journal Article Tag Suite.” ANSI/NISO Z39.96.</p>
</div>
<div id="ref-OOXML">
<p>Ngo, Tom. 2006. “OFFICE OPEN XML OVERVIEW ECMA TC45.” Ecma International.</p>
</div>
<div id="ref-ovadia_markdown_2014">
<p>Ovadia, Steven. 2014. “Markdown for Librarians and Academics.” <em>Behavioral & Social Sciences Librarian</em> 33 (2): 120–24. doi:<a href="https://doi.org/10.1080/01639269.2014.904696">10.1080/01639269.2014.904696</a>.</p>
</div>
<div id="ref-R_2014">
<p>R Core Team. 2014. <em>R: A Language and Environment for Statistical Computing</em>. Vienna, Austria: R Foundation for Statistical Computing. <a href="https://www.R-project.org" class="uri">https://www.R-project.org</a>.</p>
</div>
<div id="ref-HTML4">
<p>Raggett, Dave, Arnaud Le Hors, Ian Jacobs, Arnaud Le Hors, Dave Raggett, and Ian Jacobs. 1999. “HTML 4.01 Specification.” W3C Recommendation. W3C.</p>
</div>
<div id="ref-shotton_cito_2010">
<p>Shotton, David. 2010. “CiTO, the Citation Typing Ontology.” <em>Journal of Biomedical Semantics</em> 1 (1): S6. doi:<a href="https://doi.org/10.1186/2041-1480-1-S1-S6">10.1186/2041-1480-1-S1-S6</a>.</p>
</div>
<div id="ref-rfc1345">
<p>Simonsen, K. 1992. “Character Mnemonics & Character Sets.” RFC. Rationel Almen Planlaegning; Internet Request for Comments.</p>
</div>
<div id="ref-smith_software_2016">
<p>Smith, Arfon M., Daniel S. Katz, and Kyle E. Niemeyer. 2016. “Software Citation Principles.” Edited by Silvio Peroni. <em>PeerJ Computer Science</em> 2 (September): e86. doi:<a href="https://doi.org/10.7717/peerj-cs.86">10.7717/peerj-cs.86</a>.</p>
</div>
<div id="ref-solomon_article_2016">
<p>Solomon, David, and Bo-Christer Björk. 2016. “Article Processing Charges for Open Access Publicationthe Situation for Research Intensive Universities in the USA and Canada.” <em>PeerJ</em> 4 (July): e2264. doi:<a href="https://doi.org/10.7717/peerj.2264">10.7717/peerj.2264</a>.</p>
</div>
<div id="ref-suber_open_2012">
<p>Suber, Peter. 2012. <em>Open Access</em>. Cambridge, Mass: The MIT Press.</p>
</div>
<div id="ref-towbin_electrophoretic_1979">
<p>Towbin, H., T. Staehelin, and J. Gordon. 1979. “Electrophoretic Transfer of Proteins from Polyacrylamide Gels to Nitrocellulose Sheets: Procedure and Some Applications.” <em>Proceedings of the National Academy of Sciences</em> 76 (9): 4350–4. <a href="http://www.pnas.org/content/76/9/4350" class="uri">http://www.pnas.org/content/76/9/4350</a>.</p>
</div>
<div id="ref-van_noorden_journal_2012">
<p>Van Noorden, Richard. 2012. “Journal Offers Flat Fee for ‘All You Can Publish’.” <em>Nature News</em> 486 (7402): 166. doi:<a href="https://doi.org/10.1038/486166a">10.1038/486166a</a>.</p>
</div>
<div id="ref-van_noorden_open_2013">
<p>———. 2013. “Open Access: The True Cost of Science Publishing.” <em>Nature</em> 495 (7442): 426–29. doi:<a href="https://doi.org/10.1038/495426a">10.1038/495426a</a>.</p>
</div>
<div id="ref-van_noorden_arxiv_2014">
<p>———. 2014. “The ArXiv Preprint Server Hits 1 Million Articles.” <em>Nature News</em>. doi:<a href="https://doi.org/10.1038/nature.2014.16643">10.1038/nature.2014.16643</a>.</p>
</div>
<div id="ref-volmer_how_2016">
<p>Volmer, Dietrich A., and Caroline S. Stokes. 2016. “How to Prepare a Manuscript Fit-for-Purpose for Submission and Avoid Getting a ‘Desk-Reject’.” <em>Rapid Commun. Mass Spectrom.</em>, January, n/a–n/a. doi:<a href="https://doi.org/10.1002/rcm.7746">10.1002/rcm.7746</a>.</p>
</div>
<div id="ref-willinsky_unacknowledged_2005">
<p>Willinsky, John. 2005. “The Unacknowledged Convergence of Open Source, Open Access, and Open Science.” <em>First Monday</em> 10 (8). doi:<a href="https://doi.org/10.5210/fm.v10i8.1265">10.5210/fm.v10i8.1265</a>.</p>
</div>
<div id="ref-woelfle_open_2011">
<p>Woelfle, Michael, Piero Olliaro, and Matthew H. Todd. 2011. “Open Science Is a Research Accelerator.” <em>Nat Chem</em> 3 (10): 745–48. doi:<a href="https://doi.org/10.1038/nchem.1149">10.1038/nchem.1149</a>.</p>
</div>
<div id="ref-rfc3629">
<p>Yergeau, F. 2003. “UTF-8, a Transformation Format of ISO 10646.” RFC. Alis Technologies.</p>
</div>
<div id="ref-youngen_citation_1998">
<p>Youngen, Gregory K. 1998. “Citation Patterns to Traditional and Electronic Preprints in the Published Literature.” <em>Coll. Res. Libr.</em> 59 (5): 448–56. doi:<a href="https://doi.org/10.5860/crl.59.5.448">10.5860/crl.59.5.448</a>.</p>
</div>
</div>
</body>
</html>