xmlgraphics-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From psan...@apache.org
Subject svn commit: r1419541 - /xmlgraphics/site/trunk/content/fop/faq.mdtext
Date Mon, 10 Dec 2012 15:59:58 GMT
Author: psancho
Date: Mon Dec 10 15:59:57 2012
New Revision: 1419541

URL: http://svn.apache.org/viewvc?rev=1419541&view=rev
Log:
faq: code formatting

Modified:
    xmlgraphics/site/trunk/content/fop/faq.mdtext

Modified: xmlgraphics/site/trunk/content/fop/faq.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/faq.mdtext?rev=1419541&r1=1419540&r2=1419541&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/fop/faq.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/faq.mdtext Mon Dec 10 15:59:57 2012
@@ -186,8 +186,9 @@ Try also setting the [font-base configur
 ### 2.12. I get a SAXException: Mismatch: page-sequence vs. root (or similar). {#saxexception-mismatch}
 
 The full exception usually looks similar to this:
-Mismatch: page-sequence (http://www.w3.org/1999/XSL/Format) vs. root
-        (http://www.w3.org/1999/XSL/Format)
+
+    Mismatch: page-sequence (http://www.w3.org/1999/XSL/Format) vs. root (http://www.w3.org/1999/XSL/Format)
+
 This exception is usually a follow-up error after another exception. Sometimes the original
exception gets swallowed by Xalan's default `ErrorListener` (should be fixed in the latest
Xalan release).
 
 The work-around is to set an explicit `ErrorListener` on the `Transformer`. The `ErrorListener`
can be as simple as this:
@@ -277,23 +278,26 @@ Current FOP releases have extensive supp
 The concept is called “blind table”. The table is used for pure layout reasons
and is not obvious in the output.
 
 An example of an image and the image caption to be kept together:
-<fo:table table-layout="fixed" width="100%">
-  <fo:table-column column-width="proportional-column-width(1)"/>
-  <fo:table-body>
-    <fo:table-row keep-with-next="always">
-      <fo:table-cell>
-        <fo:block>
-          <fo:external-graphic src="foo.jpg"/>
-        </fo:block>
-      </fo:table-cell>
-    </fo:table-row>
-    <fo:table-row>
-      <fo:table-cell>
-        <fo:block>Image Caption</fo:block>
-      </fo:table-cell>
-    </fo:table-row>
-  </fo:table-body>
-</fo:table>
+
+    :::xml
+    <fo:table table-layout="fixed" width="100%">
+      <fo:table-column column-width="proportional-column-width(1)"/>
+      <fo:table-body>
+        <fo:table-row keep-with-next="always">
+          <fo:table-cell>
+            <fo:block>
+              <fo:external-graphic src="foo.jpg"/>
+            </fo:block>
+          </fo:table-cell>
+        </fo:table-row>
+        <fo:table-row>
+          <fo:table-cell>
+            <fo:block>Image Caption</fo:block>
+          </fo:table-cell>
+        </fo:table-row>
+      </fo:table-body>
+    </fo:table>
+
 Consider upgrading to the latest version which supports keeps.
 
 ### 3.7. My tables are missing, or missing their content. {#table-missing}
@@ -338,11 +342,17 @@ The most recent FOP releases should have
 ### 3.13. Hyphenation does not work. {#hyphenation-fails}
 
 Make sure you have set the language and optionally the country attributes for an appropriate
XSL-FO element (fo:page-sequence, fo:block or fo:character):
-<fo:page-sequence language="fi">
+
+    :::xml
+    <fo:page-sequence language="fi">
+
 See [Hyphenation Support][currentFop_hyphenation_support] for details and instructions on
using hyphenation with FOP.
 
-Explicitly enable hyphenation for an appropriate XSL-FO element (fo:block, fo:character):
-<fo:block hyphenate="true">
+Explicitly enable hyphenation for an appropriate XSL-FO element (`fo:block`, `fo:character`):
+
+    :::xml
+    <fo:block hyphenate="true">
+
 ### 3.14. When I use margins, my content in a nested table or block-containers gets indented
twice. Is this a bug? {#indent-inheritance}
 
 No, although you might easily think so. The problem has to do with property inheritance of
the start-indent and end-indent properties to which the margin properties are mapped. Apache
FOP strictly adheres to the XSL-FO specification here which many other commercial FO implementations
don't do to better meet end-user expectations. You can make FOP behave like these if you set
`setBreakIndentInheritanceOnReferenceAreaBoundary(true)` on the FOUserAgent. The better way
is to reset `start-indent` and `end-indent` to "0pt" on table-body or block-container. For
further details, please consult the [Wiki page on Indent Inheritance](http://wiki.apache.org/xmlgraphics-fop/IndentInheritance).
@@ -445,9 +455,15 @@ The standard text fonts supplied with Ac
 If you use your own fonts, the font must have a glyph for the desired character. Furthermore
the font must be available on the machine where the PDF is viewed or it must have been embedded
in the PDF file. See [embedding fonts][currentFop_fonts].
 
 For most symbols, it is better to select the symbol font explicitely, for example in order
to get the symbol for the mathematical empty set, write:
-<fo:inline font-family="Symbol">&#x2205;</fo:inline>
-The "#" shows up if the selected font does not define a glyph for the required character,
for example if you try:
-<fo:inline font-family="Helvetica">&#x2205;</fo:inline>
+
+    :::xml
+    <fo:inline font-family="Symbol">&#x2205;</fo:inline>
+
+The "`#`" shows up if the selected font does not define a glyph for the required character,
for example if you try:
+
+    :::xml
+    <fo:inline font-family="Helvetica">&#x2205;</fo:inline>
+
 ### 6.3. What tools are available for post-processing my PDF document? {#pdf-postprocess}
 
 See [PDF Post-processing][currentFop_output_pdfPostProcess].



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: commits-help@xmlgraphics.apache.org


Mime
View raw message