Posted by sgruttendio on Aug 24, 2016; 10:08am
URL: https://discuss.asciidoctor.org/Embed-man-pages-in-a-book-tp4906.html

Hi everybody,

I am new to Asciidoc and Asciidoctor. I am considering using them to write a computer science textbook.

My question is: what is one supposed to do when a book has to include (among other "normal" book content) properly formatted manpages (that is, man pages formatted, more or less, in the traditional "terminal" way)?

I see there is a "book" doctype and a "manpage" doctype but I understand only a doctype is allowed in a project. Is that correct? Am I missing any important concept? Which is the best way to embed man pages in a book?

Thanks in advance for any help

Sgruttendio