Walking the path ...
- using simple text markup
- AsciiDoc ( https://github.com/asciidoc/asciidoc )
- with many choices of editors
- Linux : vi/vim/gvim, emacs, gedit, ...
- Multi-platform :
- with many choices of editors
- AsciiDoc ( https://github.com/asciidoc/asciidoc )
- convert to XML/DocBook, leveraging DocBook Authorting and Publishing Suite DAPS ( https://github.com/openSUSE/daps )
- to render with your choice of multiple output formats ... epub, html (single or multipage), pdf
Quickstart ...
-
Browse the following files
- DC-sample DAPS configuration file
- sample.adoc
- images directory where images are stored/referenced from
- review examples to create and view some sample outputs
-
DIY
- either follow tips.md to create local structure or feel free to browse/pull this repository's template content
- git clone "ThisGitHubRepoURL" (to make a local copy)
- or download either master (zip), then unpack it
- cd to your local directory where it landed (or was uncompressed)
- test that you have all the tooling in place to generate an output
- e.g. daps --force -d DC-sample html
- NOTE: besides "html" can also do "html --single", "epub", "pdf" formats, which are also shown in examples
- test with a web browser, open the file:///localDirectoryName/build/sample/html/sample_draft/index.html
- e.g. daps --force -d DC-sample html
- either follow tips.md to create local structure or feel free to browse/pull this repository's template content