summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStuart Rackham <srackham@methods.co.nz>2013-11-06 11:15:19 +1300
committerStuart Rackham <srackham@methods.co.nz>2013-11-06 11:15:19 +1300
commit3d2ce9fd92ae1a94bfd45e1dded84a5a5439432f (patch)
tree1c3d6e41acc01c1af07af9a404dac4ff835b3d60
parent184bbef644b5ba03e9c05934a6336b52ee3b74ca (diff)
downloadasciidoc-3d2ce9fd92ae1a94bfd45e1dded84a5a5439432f.tar.gz
Documentation updates.
-rw-r--r--doc/faq.txt21
-rw-r--r--examples/website/index.txt17
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.