I want to use AsciiDoc to process a large document (sysadmin
site documentation). But chapters get run together like sections.
Is it possible to generate PDFs where each AsciiDoc document
section is rendered starting on a new page, as if it was a chapter?
(Is there some setting for that?)
I want to have a single AsciiDoc file that can be both:
a) included in a larger collection, or
b) published standalone.
Background:
I want to migrate our sysadmin site documentation from DocBook XML to AsciiDoc.
I have 267 DocBook XML files, organized into 5 levels:
set -> book -> book part -> chapter -> section
or
set -> book -> book part -> article -> section
The nifty part is that articles show up in the book but can be
published standalone (great for policies and network diagrams).
AsciiDoc also offers me 5 levels but there are no chapters:
title -> section -> section -> section -> section
I have read the "Combining Separate Documents" in the FAQ
(http://www.methods.co.nz/asciidoc/userguide.html#X90) so I know
I could have more section levels.
I didn't see anything else in the FAQ on processing large documents.
Situation:
My trouble is that chapter content gets treated like
section content after converting (by hand) from DocBook
XML to AsciiDoc. (Because there are no chapters in
AsciiDoc, only sections.)
DocBook XML chapters start on a new page in PDF output;
AsciiDoc sections don't.
I would like the PDF of my Book of Everything to have
these files separated (to be chapters).
I make PDFs from AsciiDoc using a2x with dblatex:
a2x -v --no-xmllint -f pdf --dblatex-opts "-P doc.toc.show=0
-P doc.layout=mainmatter -P doc.publisher.show=1 -P
latex.output.revhistory=0 -P doc.section.depth=1 -P
latex.class.options=letterpaper" index.txt
I looked at DBLatex XSL options at
http://dblatex.sourceforge.net/doc/manual/sec-params.html but didn't
see anything relating to making each section start on a new page.
Would appreciate any help or pointers to relevant documentation, please.
Is this an appropriate use of AsciiDoc?
Yours truly,
Aleksey
--
You received this message because you are subscribed to the Google Groups
"asciidoc" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/asciidoc?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.
