- Lehrbuch für den Öffentlichen Gesundheitsdienst / Textbooks for the Public Health Service. Re: COVID-19
Project to pull together the different parts that make up the public health textbook framework for books sprints and OER. Collaborative publications connected to OER.
Objective: ‘Free up health knowledge held in professionals and workforce for use in public health and COVID-19 emergency’
ContentMine for the EU hackathon (2020-04-24:26) on COVID. Team "ContentMine" under http://euvsvirus.org. Organise volunteers and lend help where needed and explore ContentMine/openVirus use for 'Global Contact Tracing Sprint'. OpenVirus https://github.com/petermr/openVirus/blob/master/OVERVIEW.md
https://github.com/akademie-oeffentliches-gesundheitswesen/krisenmanagment to https://www.oncampus.de/weiterbildung/moocs/krisenmanagement
https://www.oncampus.de/weiterbildung/moocs/kontaktpersonennachverfolgung
- General Public Health
- Pediatrics
- Contact tracing and tracking
Any questions Simon Worthington DM @mrchristian99 email simon.worthington@tib.eu
The current focus of our work is on automation of the pipeline between the editor Fidus Writer and GitHub. Once completed this will fully automate the multi-format output and enable content reuse by other publishing and learning platforms — say Manubot for scientific publishing or Moodle for MOOCs.
https://github.com/fiduswriter/fiduswriter-github-export
See: Documentation FW-GH
- Fidus Writer – Real-time collaborative WYSIWYG editor
- GitHub infrastructure – versioning, crypto IDs, API, web server, CI/CD, etc
- Scalable – modern cloud infrastructure from Endocode meaning instant deployment, low costs, etc
- Multi-format publication ready outputs (PRO) – 100% standards validation and distribution channels ready
- Multiverse interoperability – publications ready for use in format domains: R, RDF, XML, etc.
- Open Science Service Ready – publication sources on GitHub makes content ready for processing by content services (e.g., smart objects) and data science services (e.g., PiDs), with metering.
- Multilingual R/L, L/R translation – CI driven translation on GitLab via Crowdin or Weblate (courtesy Modern Publishing, Hamburg Open Science)
- Real-time validation – validate against defined targets to ensure content 100% usable, with interactive GUI - phase two Transpect pipeline feature.
- Service metering – provide metrics and monitoring to support a sustainable economy by providers of services and skilled labor.
- Interface Moodle and LMSs – enable bi-direction LMS support
- Metadata – extensive, publication, assets, LOD and Wikidata, social media, and usage and sharing, PIDs
- Contributors and roles – rewards, attribution
- Community publication features – enable awards, credit and acknowledgements with pathways and on-ramps to contribute
- Designed for next generation scholarly publishing – standards, citations, etc
Caption - ADA – Advanced Document Architecture https://www.draw.io/?page-id=6a731a19-8d31-9384-78a2-239565b7b9f0&scale=auto#G1Wab_PZmNacR4Ql8kYLtK8qbnRnVNABas
The objective of the technology is to facilitate rapid book and online learning publishing, maintain academic high quality standards, and utilizing modern Open Science services and low-cost easy to deploy modern cloud infrastructure. We automate as many workflow parts as possible to maximise time and cost efficiency.
The book sprint technology is built from existing open-source software modules, where we maintain active research relationships with the maintainers. The system has an overall Technology Readiness Level (TRL) of 7 (system prototype demonstration in operational environment used). The system has been used by over 100 professionals in 10 book sprints.
- Fidus Writer – Real-time collaborative WYSIWYG editor. Fidus Writer is an online academic word processor like Google Docs. It uses Prose Mirror for its writing interface, as technology from a Berlin startup which solved the collaborative real-time editing. It can also be used offline, synchronizing when connected again. The system can interface citation databases, produce interoperable outputs such as JATS DAR, and interface GitHub. It’s five years old and has been funded by DFG. https://www.fiduswriter.org/
- GitHub/Lab automation and collaboration tech stack – versioning, crypto IDs, API, web server, CI/CD, etc. GitHub and GitLab has three categories of use for the project. 1. As an interoperable source storage for publishing and which offers free web hosting and domains. 2. For Git which gives versioning and allows for a variety of back-office asynchronous collaboration. 3. Automation. The tech stack, APIs and continuous integration and continuous development (CI/CD) etc., means a wide array of tasks can be automated.
- Scalable modern cloud infrastructure from Endocode AG. Endocode work as a Google Deutschland partner using open-source technologies to supply blue chip corporate clients with scaleable infrastructures, SAP, VW, etc. Endocode take our open-source modules and Containerize the components as Kubernetes clusters. They use technology such as Terraform which allows scripts or recipes to deploy a complete infrastructure in the fraction of the time and cost of normal IT provision. A benefit is system adoption by non experts on low cost infrastructure. “ADA — Phases of Development: Proof of Concept to Community Handover – an Interoperable Framework for Microservices in Scholarly Publishing”. Zenodo, August 1, 2019 https://doi.org/10.5281/zenodo.3626810.
- Multi-format publication ready outputs (PRO) – 100% standards validation and distribution channels ready. Currently we employ CSS typesetting using Vivliosyle extension framework to W3C Paged Media CSS with some clever CSS from our team (https://vivliostyle.org/). Using format transformation web, Markdown and ‘computational publishing’ formats can be output. Transpect from Le-tex GmbH, one of Germany's leading XML content house is used for sharded output pipelines and validation (https://transpect.github.io/). Publication ready outputs (PRO) is a concept put in place by our research to designate publishing target outputs as being 100% validated ready to publish, e.g., be format compliant and have all aspects such as correct metadata. Many systems ‘say’ that can make an EPUB 3.0 for example but the output will not be ready for publishing so in effect not ready for distribution.
- Multiverse interoperability – publications ready for use in format domains: R, RDF, XML, etc. Many scholarly disciplines are tied to specific technical formats: data scientists will use R to run analysis; knowledge graph communities will use RDF, etc. Out system if format agnostic and instead we look for format capabilities and rank formats by feature lists. We look to hold master formats with as much information as possible and then transform files between formats. A main tool for this is Transpect, as well as others, but it can also be through frameworks like Pandoc and CI pipelines.
- Open Science Service Ready – publication sources on GitHub makes content ready for processing by content services (e.g., smart objects) and data science services (e.g., PiDs), with metering. The future of scholarly publishing is the ‘Computational Publication’ but moving to this new form of modular document will be a slow process. See: Research Compendium https://research-compendium.science/. To facilitate this transition we enable service access. For example in authoring or post-processing: knowledge graphs, Wikidata indexing, and data mining citable searches can be used. As well as the use of smart objects for images and diagrams: Diagram.net https://www.diagrams.net/ or European Molecular Biology Organization EMBO https://sourcedata.embo.org/ or semantic video embeds from TIB AV Portal https://av.tib.eu/.
- Multilingual R/L, L/R translation – CI driven translation on GitLab via Crowdin https://crowdin.com/ or Weblate https://weblate.org/en-gb/ (courtesy Modern Publishing, Hamburg Open Science: https://oa-pub.hos.tuhh.de/en/). Additionally machine and human translation can be combined using DeepL https://www.deepl.com/home. Initially the setup is used on GitLab with a Crowdin used in a CI pipeline. When new content is added users are emailed and translation updates are made through an easy to use interface. Crowdin is used as it can accomodate L/R and R/L text in the same document, this is important for example with arabic annotations on a French document.
- Real-time validation – validate against defined targets to ensure content 100% usable, with interactive GUI – phase two Transpect pipeline feature. We use Continuous Integration (CI) to test publication ready outputs against target outputs, and against new releases of formats. This can be done in real-time and ensures that content is always ready to be distributed and wont go out of service. Transpect is used for this process. The validation service can also ensure format compliance and give quality assurance levels when many external processes are being used. Manual and automatic fixes can be applied.
- Service metering – provide metrics and monitoring to support a sustainable economy by providers of services and skilled labor. Open Science and publishing services can be metered via API calls as well as other unit measurements. Metering can be used to allow for subsiding services and auditing resources needed. Metering also allows for a sustainable economy to be put in place and for different actors to join a market place. Google Cloud Platform (GCP) and GitHub/Lab would be used initially for metering. GCP https://cloud.google.com/products/.
- Interface Moodle and Learning Management Systems (LMSs) – enable bi-direction LMS support. Book chapters, books and collections of books can be published directly to Moodle via its API https://docs.moodle.org/dev/Main_Page. Additionally using the API usage data and tests and other media can be associated with publications.
- Metadata – extensive, publication, assets, Linked Open Data (LOD) and Wikidata, social media, and alt metrics and usage, and sharing, PIDs. Master files in Fidus Writer are already able to have tagging added making them usable in Digital Humanities and data science contexts. Document metadata is stored as Yaml files. ISBNs, DOIs and ORCID are used.
- Community publication features – enable awards, credit and acknowledgements with pathways and on-ramps to invite collaboration and crowdsourcing. Publications such as The Turing Way (https://the-turing-way.netlify.app/) demonstrate how a publication can be owned by a community. There are a number of layers that can be applied to making a publication increase in quality and value by supporting collaboration. First we use Hypothesis for commenting (https://web.hypothes.is/). Then these are the group working functions of GitHub/Lab. Most important are the social aspects which means strategizing ways of involvement for a community, see interview in GenR with director of research Juan Pablo Alperin of Open Journal Systems and PKP (https://genr.eu/wp/open-source-innovating-publishing-pkps-open-preprint-systems/). Attribution and rewards are important here and we would use CRediT – Contributor Roles Taxonomy as a basis for capturing this information https://casrai.org/credit/.
Diagram.net schematic https://drive.google.com/file/d/1-P65cgrcGabE_1Hdoo-P9ya20sPaUuLe/view?usp=sharing
- Emergency Book bookstrap (triage), 8+ books - https://akademie-oeffentliches-gesundheitswesen.github.io/lehrbuch-krisenmanagment/
- Metadata consultation TIB - bootstrap metadata across multiformat books, book trade and scholarly, library and OER, + usage metrics
- Fidus to GitHub - https://github.com/fiduswriter/fiduswriter-github-export
- Templating work for Fidus to GitHub - In-progress
- Fidus UI
- Template consultation from Vivliostyle, Le-tex, and Avco on Jekyll - In-progress
- Pipeline consultation with Le-tex
- Flight checker
- Publication Ready Outputs (PRO) validation
- Flight checker
- Avco/Interpunct on designing a Bootstrap for multiformat
- Metadata consultation TIB - crypto IDs, OSL/TIB (review round 1 and incorporate blockchain)
- System review - post Book triage
- Moodle OER pipeline
- Sysadmin server due to rapid development
- Pandoc in browser
- Pandoc-scholar and GitLab CI - Connect to Modern Publishing, Hamburg Open Science (HOS) - https://oa-pub.hos.tuhh.de/en/
- ADA - Microservice / cloud / CD-CI / API Endocode - connects us to the world
- Endocode cloud build with Fidus Writer
- Validator CI for publishing / OER
- Editorial, proofing, markup - workflow and pipeline
- RINSE REPEAT!!!
- Connect ORKG, Markus Stocker semantic authoring pipelines
Simon Worthington, Lisa Nöth, and Johannes Amorosa, ‘ADA — Phases of Development: Proof of Concept to Community Handover – an Interoperable Framework for Microservices in Scholarly Publishing’, 1 August 2019, https://doi.org/10.5281/zenodo.3626810.
- OSL/TIB - Lambert Heller, Anna Eckhardt, and Simon Worthington
- Academy for Public Health in Düsseldorf - Peter Tinnemann and Jakob Schumacher (Fidus2GitHub RScript)
- Team Fidus Writer - Johannes Wilm
- Team Endocode - Lisa Nöth and Johannes Amorosa
- Christian Ahlert, Minibarlabs
- Vivliostyle for the support on Slack
- Avco.com
- Interpunct Design
- RunStop
Content - Copyright the authors 2020. Creative Commons: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) https://creativecommons.org/licenses/by-sa/4.0/deed.de | Source https://github.com/TIBHannover/ADA-Lehrbuch
Code - Advanced Documennt Architecture (ADA), Copyright the authors 2018-20 the authors. GNU General Public License v3.0 https://github.com/TIBHannover/ADA_infra/blob/master/LICENSE | Source https://github.com/TIBHannover/ADA_infra
Data - All data and data sets produced would be CC 0, Public Domain, https://creativecommons.org/publicdomain/zero/1.0/
All fonts and graphics and media production software used on the production would be OSI compliant.
FAIR principles would also be applied https://www.go-fair.org/fair-principles/
All third party content and code is the copyright of the authors and under their respective OSI compliant open licenses for code and compliant with Creative Commons: Attribution-ShareAlike 4.0 International for content.