diff options
author | Stuart Rackham <srackham@methods.co.nz> | 2013-11-06 11:15:19 +1300 |
---|---|---|
committer | Stuart Rackham <srackham@methods.co.nz> | 2013-11-06 11:15:19 +1300 |
commit | 3d2ce9fd92ae1a94bfd45e1dded84a5a5439432f (patch) | |
tree | 1c3d6e41acc01c1af07af9a404dac4ff835b3d60 | |
parent | 184bbef644b5ba03e9c05934a6336b52ee3b74ca (diff) | |
download | asciidoc-3d2ce9fd92ae1a94bfd45e1dded84a5a5439432f.tar.gz |
Documentation updates.
-rw-r--r-- | doc/faq.txt | 21 | ||||
-rw-r--r-- | examples/website/index.txt | 17 |
2 files changed, 29 insertions, 9 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]. diff --git a/examples/website/index.txt b/examples/website/index.txt index 46a7f41..f4535fa 100644 --- a/examples/website/index.txt +++ b/examples/website/index.txt @@ -194,15 +194,9 @@ image::images/highlighter.png[height=400,caption="",link="images/highlighter.png (used by http://projects.gnome.org/gedit/[gedit] and a number of other applications). The project is hosted here: https://launchpad.net/asciidoc-gtk-highlight -- Florian Kaufman has written 'adoc-mode.el' -- a major-mode for - editing AsciiDoc files in Emacs, you can find it - http://code.google.com/p/sensorflo-emacs/[here]. -- The http://xpt.sourceforge.net/[*Nix Power Tools project] has - released an http://xpt.sourceforge.net/tools/doc-mode/[AsciiDoc - syntax highlighter for Emacs]. -- Terrence Brannon has written - http://github.com/metaperl/asciidoc-el[AsciiDoc functions for - Emacs]. +- AsciiDoc resources for the Emacs editor can be found on the + http://www.emacswiki.org/emacs/AsciiDoc[AsciiDoc page] at the + http://www.emacswiki.org/emacs/EmacsWiki[Emacs Wiki]. - Christian Zuckschwerdt has written a https://github.com/zuckschwerdt/asciidoc.tmbundle[TextMate bundle] for AsciiDoc. @@ -334,6 +328,11 @@ github] that converts DocBook to AsciiDoc. - Christian Goltz has written https://github.com/christiangoltz/shaape[Shaape], an Ascii art to image converter for AsciiDoc. +- Eduardo Santana has written an + https://github.com/edusantana/asciidoc-highlight[Asciidoc Highlight + for Notepad++]. +- http://www.geany.org/[Geany] 1.23 adds document structure support + for AsciiDoc. Please let me know if any of these links need updating. |