summaryrefslogtreecommitdiff
path: root/doc/faq.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/faq.txt')
-rw-r--r--doc/faq.txt21
1 files changed, 21 insertions, 0 deletions
diff --git a/doc/faq.txt b/doc/faq.txt
index 642691e..2b67a79 100644
--- a/doc/faq.txt
+++ b/doc/faq.txt
@@ -1381,3 +1381,24 @@ into the generated HTML output. For example:
---------------------------------------------------------------
+== Why is there a period after the block title in the PDF output?
+If your document has blocks that have block titles, you may notice in
+the PDF output (generated by `a2x(1)` using the `--fop` flag) that a
+period gets added to the end of the block title.
+
+You will not see the period in the intermediary DocBook XML that’s
+generated when creating a PDF -- it’s added by the DocBook XSL
+templates when the DocBook XML is converted to FO XML.
+
+The DocBook XSL attribute that controls what character is added after
+a block title is
+http://docbook.sourceforge.net/release/xsl/1.78.1/doc/html/runinhead.default.title.end.punct.html[
+runinhead.default.title.end.punct]. You can override it and eliminate
+the default period value by adding the following line to the
+`./docbook-xsl/common.xsl` file that ships with AsciiDoc:
+
+ <xsl:param name="runinhead.default.title.end.punct"/>
+
+This FAQ was
+https://groups.google.com/group/asciidoc/browse_thread/thread/19dda8807fa7c3f2[contributed
+by Dan Allen].