WIS2 Transition Guide

Overview

This directory manages the WIS2 Transition Guide. This document provides technical guidance on transitioning from GTS to WIS2.

Dependencies

Documentation is managed with Asciidoctor.

Link checking is managed with asciidoc-link-check.

PDF generation is managed with asciidoctor-pdf.

apt-get install pandoc
npm install asciidoctor asciidoctor-pdf asciidoc-link-check

Building the document

# create HTML (single page)
asciidoctor --trace -o wis2-transition-guide.html index.adoc
# create PDF
asciidoctor --trace -r asciidoctor-pdf --trace -b pdf -o wis2-transition-guide.pdf index.adoc
# create Word document
asciidoctor --trace --backend docbook --out-file - index.adoc | pandoc --from docbook --to docx --output wis2-transition-guide.docx

check links

find . -name "???.adoc" -exec asciidoc-link-check -p -c asciidoc-link-check-config.json {} \;

Note: Makefile provides shortcuts to these commands if you are able to run make.