Pathways Paper

Due: September 2021 March 2022 (?)

Tools:

• Format to be AsciiDoc (.adoc)
• AsciiDoc plugin for Visual Studio Code: asciidoctor.asciidoctor-vscode
• Rendering to PDF: see below

Two ways to position the paper:

1. A solution for OpenDRR Pathways - How the platform supports the project.
2. A solution for Open Science - How the platform enables open science from a principled perspective. Demonstrated via an implementation for OpenDRR Pathways. TO BE AN OPENFILE

Title ideas

• OpenDRR Platform, an infrastructure for open science (for risk modelling/hazards)
• Open Science Platform for Disaster Risk Reduction

TOC ideas

• Summary
• Introduction to OpenDRR (mention why opendrr platform was needed/created before Intro to openDRR)
• Platform Requirements
• Architecture
• Lessons learned
• Future development

---

Brainstorming

• On reproducibility: R5 principles

Rendering to PDF

How to convert asciidoc to pdf? - Stack Overflow

To test and compare

1. AsciiDoc → Asciidoctor.js → HTML → wkhtmltopdf → PDF
   (Ctrl+Shift+P, select "AsciiDoc: Export document as PDF", from Visual Studio Code: asciidoctor.asciidoctor-vscode)
2. AsciiDoc → _Asciidoctor PDF → PDF
   (Ctrl+Shift+P, select "AsciiDoc: Export document as PDF", from Visual Studio Code: asciidoctor.asciidoctor-vscode, with setting "Use_asciidoctorpdf" turned on)
3. Asciidoctor PDF (using Prawn)
4. AsciiDoc → Asciidoctor or AsciiDoc → DocBook → DocBook XSL and Apache-FOP → PDF
   (asciidoctor/asciidoctor-fopub: A portable DocBook-to-PDF build command that wraps DocBook XSL and Apache FOP)
5. AsciiDoc → Asciidoctor or AsciiDoc → DocBook → dblatex → PDF