pdf creation

OS-Strategy_NHMW.md

@@ -1,31 +1,47 @@
 # Open Science in Museums - Strategy of the Naturhistorisches Museum Wien (NHMW): <br><br>  *The benefits of openness*
 ###
 
+<!-- comment .pdf creation begin -->
 [![version](https://img.shields.io/badge/version-1.0-blue)](#)
 [![license](https://img.shields.io/badge/license-CC--BY--4.0-brightgreen)](https://creativecommons.org/licenses/by/4.0/)
 [![date](https://img.shields.io/badge/date-2022--04--27-green)](#)
 [![date](https://img.shields.io/badge/doi-20020427-orange)](https://doi.org/doitocome)
+<!-- comment .pdf creation end -->
 
-<!--
+<!-- uncomment begin
 ###
--->
-
+uncomment end -->
 
+<!-- comment .pdf creation begin -->
 **Authors:**   
 *[Vohland, Katrin](https://orcid.org/0000-0002-7214-7015) [![orcID](assets/ORCID-iD_icon-vector.svg)](https://orcid.org/0000-0002-7214-7015);
 [Eichert, Stefan](https://orcid.org/0000-0002-5827-0797) [![orcID](assets/ORCID-iD_icon-vector.svg)](https://orcid.org/0000-0002-5827-0797);
 Fiedler, Sarah;
 [Kapun, Martin](https://orcid.org/0000-0002-3810-0504) [![orcID](assets/ORCID-iD_icon-vector.svg)](https://orcid.org/0000-0002-3810-0504);
 [Kroh, Andreas](https://orcid.org/0000-0002-8566-8848) [![orcID](assets/ORCID-iD_icon-vector.svg)](https://orcid.org/0000-0002-8566-8848);
 [Mehu-Blantar, Ines](https://orcid.org/0000-0003-0564-4617) [![orcID](assets/ORCID-iD_icon-vector.svg)](https://orcid.org/0000-0003-0564-4617);
-Ott, Iris;
+[Ott, Iris](https://orcid.org/0000-0002-5963-349X) [![orcID](assets/ORCID-iD_icon-vector.svg)](https://orcid.org/0000-0002-5963-349X);
 [Rainer, Heimo](https://orcid.org/0000-0002-5963-349X) [![orcID](assets/ORCID-iD_icon-vector.svg)](https://orcid.org/0000-0002-5963-349X);
 [Schwentner, Martin](https://orcid.org/0000-0002-1373-456X) [![orcID](assets/ORCID-iD_icon-vector.svg)](https://orcid.org/0000-0002-1373-456X);
 [Zimmermann, Eva](https://orcid.org/0000-0002-6537-106X) [![orcID](assets/ORCID-iD_icon-vector.svg)](https://orcid.org/0000-0002-6537-106X);*
+<!-- comment .pdf creation end -->
+
+<!-- -- uncomment begin
+**Authors:**   
+*[Vohland, Katrin](https://orcid.org/0000-0002-7214-7015) [![orcID](assets/ORCID-iD_icon-vector10.svg)](https://orcid.org/0000-0002-7214-7015);
+[Eichert, Stefan](https://orcid.org/0000-0002-5827-0797) [![orcID](assets/ORCID-iD_icon-vector10.svg)](https://orcid.org/0000-0002-5827-0797);
+Fiedler, Sarah;
+[Kapun, Martin](https://orcid.org/0000-0002-3810-0504) [![orcID](assets/ORCID-iD_icon-vector10.svg)](https://orcid.org/0000-0002-3810-0504);
+[Kroh, Andreas](https://orcid.org/0000-0002-8566-8848) [![orcID](assets/ORCID-iD_icon-vector10.svg)](https://orcid.org/0000-0002-8566-8848);
+[Mehu-Blantar, Ines](https://orcid.org/0000-0003-0564-4617) [![orcID](assets/ORCID-iD_icon-vector10.svg)](https://orcid.org/0000-0003-0564-4617);
+[Ott, Iris](https://orcid.org/0000-0002-5963-349X) [![orcID](assets/ORCID-iD_icon-vector10.svg)](https://orcid.org/0000-0002-5963-349X);
+[Rainer, Heimo](https://orcid.org/0000-0002-5963-349X) [![orcID](assets/ORCID-iD_icon-vector10.svg)](https://orcid.org/0000-0002-5963-349X);
+[Schwentner, Martin](https://orcid.org/0000-0002-1373-456X) [![orcID](assets/ORCID-iD_icon-vector10.svg)](https://orcid.org/0000-0002-1373-456X);
+[Zimmermann, Eva](https://orcid.org/0000-0002-6537-106X) [![orcID](assets/ORCID-iD_icon-vector10.svg)](https://orcid.org/0000-0002-6537-106X);*
 
-<!--
 ##
--->
+uncomment end -->
+
 <br>
 Please cite this document as follows:
 <br>
@@ -45,33 +61,39 @@ Please cite this document as follows:
 <br>
 <br>
 
-<!--
+<!-- uncomment begin
 ##
--->
+uncomment end -->
 
+<!-- comment .pdf creation begin -->
 [![nhmw logo](assets/logo.svg)](https://nhm-wien.ac.at)
 
 Burgring 7  
 1010 Wien  
 [https://nhm-wien.ac.at](https://nhm-wien.ac.at/)
+<!-- comment .pdf creation end -->
 
+<!-- uncomment begin
+[![nhmw logo](assets/logosm.svg)](https://nhm-wien.ac.at)
 
-<!--
+Burgring 7  
+1010 Wien  
+[https://nhm-wien.ac.at](https://nhm-wien.ac.at/)
 ##
-| Version | Date | DOI |
-|---------|------|-----|
- |1.0|2022-04-27|https://doi.org/doitocome|
-
 This work is licensed under a
 [Creative Commons Attribution 4.0 International License](http://creativecommons.org/licenses/by/4.0/).
 
 [![CC BY 4.0](https://i.creativecommons.org/l/by/4.0/88x31.png)](http://creativecommons.org/licenses/by/4.0/)
 
+\
 
+| Version | Date | DOI |
+|---------|------|-----|
+ |1.0|2022-04-27|https://doi.org/doitocome|
 ####
 
 \pagebreak
--->
+uncomment end -->
 
 <br>
 <br>
@@ -148,9 +170,9 @@ This work is licensed under a
 
 ---
 
-<!--
+<!-- uncomment begin
 \pagebreak
--->
+uncomment end -->
 
 # Summary
 

pdf_workflow.md

@@ -0,0 +1,35 @@
+# PDF creation
+
+This document explains the workflow for the generic creation of a PDF version 
+of the main .md document.
+
+## Make sure [`pandoc`](https://pandoc.org/) is installed locally on your system:
+On Linux (Debian/Ubuntu):
+>sudo apt-get install pandoc texlive-latex-base texlive-fonts-recommended texlive-extra-utils texlive-latex-extra
+
+For other distributions see: https://pandoc.org/installing.html
+
+## Prepare the `OS-Strategy-NHMW-Vx.md`file for conversion
+
+search and replace:
+
+* 1: `<!-- comment .pdf creation begin -->` with `<!--`  
+* 2: `<!-- comment .pdf creation end -->` with `-->`
+* 3: `<!-- uncomment begin` with `<!-- uncomment begin -->`
+* 4: `<!-- uncomment end` with `<!-- uncomment end -->`
+
+## Create .pdf
+Open a terminal and convert the .md file to .pdf
+>  pandoc sourcefile.md -o outputfile.pdf
+
+## Undo comment/uncomment
+
+search and replace:
+
+* 1: `<!--` with `<!-- comment .pdf creation begin -->`   
+* 2: `-->` with `<!-- comment .pdf creation end -->`
+* 3: `<!-- uncomment begin -->` with `<!-- uncomment begin`
+* 4: `<!-- uncomment end -->` with `<!-- uncomment end`
+
+## Check the pdf file
+That's it! Hope you like the result.