# asciidoctor

documentation asciidoctor

# Pros

include files as snippets
diagrams

# How it works?

Parses one file at a time, markup to HTML
Template Engine tilt

# How to write a book?

Code your documentation

Why not use google docs? Throw in some code, text and images and it works.
- Biggest problem is analyzing what has changed
import, embedd, include code, images in chapters
Google docs is not good for version control

HTML, PDF, ePUB, MOBI

# Parts of a book

https://en.wikipedia.org/wiki/Colophon_(publishing)
Preamble

COnvert all *.adoc files

asciidoctor -o out *.adoc

# References

← Animation Bash →