xmlgraphics-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From psan...@apache.org
Subject svn commit: r1417895 [9/12] - in /xmlgraphics/site/trunk/content: ./ batik/ batik/dev/ batik/tools/ batik/using/ batik/using/scripting/ commons/ fop/ fop/0.95/ fop/1.0/ fop/1.1/ fop/dev/ fop/dev/design/ fop/trunk/
Date Thu, 06 Dec 2012 14:10:33 GMT
Modified: xmlgraphics/site/trunk/content/fop/dev/design/pdf-library.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/design/pdf-library.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/design/pdf-library.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/design/pdf-library.mdtext Thu Dec  6 14:10:09 2012
@@ -3,17 +3,17 @@ Title: Apache(tm) FOP Design: PDF Librar
 #Apache™ FOP Design: PDF Library
-## Introduction <a id="intro"></a>
+## Introduction {#intro}
 The PDF Library is an independant package of classes in Apache&trade; FOP. These class provide a simple way to construct documents and add the contents. The classes are found in `org.apache.fop.pdf.*`.
-## PDF Document <a id="PDF+Document"></a>
+## PDF Document {#PDF+Document}
 This is where most of the document is created and put together.
 It sets up the header, trailer and resources. Each page is made and added to the document. There are a number of methods that can be used to create/add certain PDF objects to the document.
-## Building PDF <a id="Building+PDF"></a>
+## Building PDF {#Building+PDF}
 The PDF Document is built by creating a page for each page in the Area Tree.
@@ -27,25 +27,25 @@ It has a separate object for the image d
 The java objects that represent a pdf object implement a method that returns the markup for inserting into a stream. The method is: byte[] toPDF().
-## Features <a id="Features"></a>
+## Features {#Features}
-### Fonts <a id="Fonts"></a>
+### Fonts {#Fonts}
 Support for embedding fonts and using the default Acrobat fonts.
-### Images <a id="Images"></a>
+### Images {#Images}
 Images can be inserted into a page. The image can either be inserted as a pixel map or directly insert a jpeg image.
-### Stream Filters <a id="Stream+Filters"></a>
+### Stream Filters {#Stream+Filters}
 A number of filters are available to encode the pdf streams. These filters can compress the data or change it such as converting to hex.
-### Links <a id="Links"></a>
+### Links {#Links}
 A pdf link can be added for an area on the page. This link can then point to an external destination or a position on any page in the document.
-### Patterns <a id="Patterns"></a>
+### Patterns {#Patterns}
 The fill and stroke of graphical objects can be set with a colour, pattern or gradient.

Modified: xmlgraphics/site/trunk/content/fop/dev/design/properties.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/design/properties.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/design/properties.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/design/properties.mdtext Thu Dec  6 14:10:09 2012
@@ -3,11 +3,11 @@ Title: Apache(tm) FOP Design: Properties
 #Apache&trade; FOP Design: Properties
 <authors><person email="" name="Karen Lease"></person></authors>
-## Introduction <a id="intro"></a>
+## Introduction {#intro}
 As the input XSL-FO is being parsed and the FO Tree is being built, the attributes of the FO elements are passed by the parser to the related FO object. The java object that represent the FO object then converts the attributes into properties that are stored in the FO Tree.
-## Issues <a id="issues"></a>
+## Issues {#issues}
 The following are some issues when dealing with properties:
@@ -22,7 +22,7 @@ The following are some issues when deali
 - Expressions: XSL-FO expressions can be included in properties.
-## Overview of Processing <a id="process-overview"></a>
+## Overview of Processing {#process-overview}
 The general flow of property processing is as follows:
@@ -33,13 +33,13 @@ The general flow of property processing 
 - FObj.handleAttrs then cross-references the returned PropertyList with the FObj, creates a PropertyManager to facilitate downstream processing of the PropertyList, and handles the special case of the writing-mode property.
-## PropertyListBuilder <a id="plb"></a>
+## PropertyListBuilder {#plb}
 Each plb object contains a hash of property names and *their* respective Makers. It may also contain element-specific property maker hashes; these are based on the *local name* of the flow object, ie. *table-row*, not *fo:table-row*. If an element-specific property mapping exists, it is preferred to the generic mapping.
 The PLB loops through each attribute in the list, finds an appropriate "Maker" for it, then calls the Maker to convert the attribute value into a Property object of the correct type, and stores that Property in the PropertyList.
-## Property datatypes <a id="datatypes"></a>
+## Property datatypes {#datatypes}
 The property datatypes are defined in the org.apache.fop.datatypes package, except Number and String which are java primitives. The FOP datatypes are:
@@ -66,7 +66,7 @@ The Property class provides a "wrapper" 
 The base Property class defines accessor methods for all FO property datatypes, such as getNumber(), getColorType(), getSpace(), getEnum(), etc. It doesn't define accessors for SVG types, since these are handled separately (at least for now.) In the base Property class, all of these methods return null, except getEnum which returns 0. Individual subclasses return a value of the appropriate type, such as Length or ColorType. A subclass may also choose to return a reasonable value for other accessor types. For example, a SpaceProperty will return the optimum value if asked for a Length.
-## Property Makers <a id="makers"></a>
+## Property Makers {#makers}
 The Property class contains a nested class called *Maker*. This is the base class for all other property Makers. It provides basic framework functionality which is overridden by the code generated by properties.xsl from the *properties.xml files. In particular it provides basic expression evaluation, using PropertyParser class in the org.apache.fop.fo.expr package.
@@ -76,11 +76,11 @@ For each generic or specific property de
 The PLB finds a "Maker" for the property based on the attribute name and the element name. Most Makers are generic and handle the attribute on any element, but it's possible to set up an element-specific property Maker. The attribute name to Maker mappings are automatically created during the code generation phase by processing the XML property description files.
-## Processing the attribute list <a id="attribute-list"></a>
+## Processing the attribute list {#attribute-list}
 The PLB first looks to see if the font-size property is specified, since it sets up relative units which can be used in other property specifications. Each attribute is then handled in turn. If the attribute specifies part of a compound property such as space-before.optimum, the PLB looks to see if the attribute list also contains the "base" property (space-before in this case) and processes that first.
-## How the Property Maker works <a id="maker-design"></a>
+## How the Property Maker works {#maker-design}
 There is a family of Maker objects for each of the property datatypes, such as Length, Number, Enumerated, Space, etc. But since each Property has specific aspects such as whether it's inherited, its default value, its corresponding properties, etc. there is usually a specific Maker for each Property. All these Maker classes are created during the code generation phase by processing (using XSLT) the XML property description files to create Java classes.
@@ -94,7 +94,7 @@ If the returned Property value is of the
 Some kinds of property values can't be fully resolved during FO tree building because they depend on layout information. This is the case of length values specified as percentages and of the special proportional-column-width(x) specification for table-column widths. These are stored as special kinds of Length objects which are evaluated during layout. Expressions involving "em" units which are relative to font-size _are_ resolved during the FO tree building however.
-## Structure of the PropertyList <a id="property-list-struct"></a>
+## Structure of the PropertyList {#property-list-struct}
 The PropertyList extends HashMap and its basic function is to associate Property value objects with Property names. The Property objects are all subclasses of the base Property class. Each one simply contains a reference to one of the property datatype objects. Property provides accessors for all known datatypes and various subclasses override the accessor(s) which are reasonable for the datatype they store.
@@ -102,11 +102,11 @@ The PropertyList itself provides various
 The main logic is:<br></br>If the property is a writing-mode relative property (using start, end, before or after in its name), the corresponding absolute property value is returned if it's explicitly set on this FO.<br></br>Otherwise, the writing-mode relative value is returned if it's explicitly set. If the property is inherited, the process repeats using the PropertyList of the FO's parent object. (This is easy because each PropertyList points to the PropertyList of the nearest ancestor FO.) If the property isn't inherited or no value is found at any level, the initial value is returned.
-## Implementing Standard Properties <a id="property-spec"></a>
+## Implementing Standard Properties {#property-spec}
 Because the properties defined in the standard are basically static, FOP currently builds the source code for the related Property classes from an XML data file. All properties are specified in src/codegen/foproperties.xml. The related classes are created automatically during the build process by applying an XSLT stylesheet to the foproperties.xml file.
-### Generic properties <a id="generic"></a>
+### Generic properties {#generic}
 In the properties xml files, one can define generic property definitions which can serve as a basis for individual property definitions. There are currently several generic properties defined in foproperties.xml. An example is GenericColor, which defines basic properties for all ColorType properties. Since the generic specification doesn't include the inherited or default elements, these should be set in each property which is based on GenericColor. Here is an example:
@@ -130,17 +130,17 @@ A generic class may also be hand-coded, 
 This is illustrated by the SVG properties, most of which use one of the Property subclasses defined in the *org.apache.fop.svg* package. Although all of these properties are now declared in svgproperties.xml, no specific classes are generated. Classes are only generated for those SVG properties which are not based on generic classes defined in svg.
-### Element-specific properties <a id="element-specific"></a>
+### Element-specific properties {#element-specific}
 Properties may be defined for all flow objects or only for particular flow objects. A PropertyListBuilder object will always look first for a Property.Maker for the flow object before looking in the general list. These are specified in the `element-property-list` section of the properties.xml files. The `localname` element children of this element specify for which flow-object elements the property should be registered.
  *NOTE*: All the properties for an object or set of objects must be specified in a single element-property-list element. If the same localname appears in several element lists, the later set of properties will hide the earlier ones! Use the *ref* functionality if the same property is to be used in different sets of element-specific mappings.
-### Reference properties <a id="reference"></a>
+### Reference properties {#reference}
 A property element may have a type attribute with the value `ref`. The content of the *name* child element is the name of the referenced property (not its class-name!). This indicates that the property specification has already been given, either in this same specification file or in a different one (indicated by the `family` attribute). The value of the family attribute is *XX* where the file *XXproperties.xml* defines the referenced property. For example, some SVG objects may have properties defined for FO. Rather than defining them again with a new name, the SVG properties simply reference the defined FO properties. The generating mapping for the SVG properties will use the FO Maker classes.
-### Corresponding properties <a id="corresponding"></a>
+### Corresponding properties {#corresponding}
 Some properties have both *absolute* and *writing-mode-relative* forms. In general, the absolute forms are equivalent to CSS properties, and the writing-mode-relative forms are based on DSSSL. FO files may use either or both forms. In FOP code, a request for an absolute form will retrieve that value if it was specified on the FO; otherwise the corresponding relative property will be used if it was specified. However, a request for a relative form will only use the specified relative value if the corresponding absolute value was *not* specified for that FO.
@@ -148,7 +148,7 @@ Corresponding properties are specified i
  *NOTE*: most current FOP code accesses the absolute variants of these properties, notably for padding, border, height and width attributes. However it does use start-indent and end-indent, rather than the "absolute" margin properties.
-## Mapping <a id="mapping"></a>
+## Mapping {#mapping}
 The XSL script `propmap.xsl` is used to generate property mappings based on both foproperties.xml and svgproperties.xml. The mapping classes in the main fop packages simply load these automatically generated mappings. The mapping code still uses the static "maker" function of the generated object to obtain a Maker object. However, for all generated classes, this method returns an instance of the class itself (which is a subclass of Property.Maker) and not an instance of a separate nested Maker class.
@@ -156,13 +156,13 @@ For most SVG properties which use the SV
 The property generation also handles element-specific property mappings as specified in the properties XML files.
-## Enumerated values <a id="enumerated"></a>
+## Enumerated values {#enumerated}
 For any property whose datatype is `Enum` or which contains possible enumerated values, FOP code may need to access enumeration constants. These are defined in the interfaces whose name is the same as the generated class name for the property, for example `BorderBeforeStyle.NONE`. These interface classes are generated by the XSL script `enumgen.xsl`. A separate interface defining the enumeration constants is always generated for every property which uses the constants, even if the constants themselves are defined in a generic class, as in BorderStyle.
 If a subproperty or component of a compound property has enumerated values, the constants are defined in a nested interface whose name is the name of the subproperty (using appropriate capitalization rules). For example, the keep properties may have values of AUTO or FORCE or an integer value. These are defined for each kind of keep property. For example, the keep-together property is a compound property with the components within-line, within-column and within-page. Since each component may have the values AUTO or FORCE, the KeepTogether interface defines three nested interfaces, one for each component, and each defines these two constants. An example of a reference in code to the constant is `KeepTogether.WithinPage.AUTO`.
-## Compound property types <a id="compound"></a>
+## Compound property types {#compound}
 Some XSL FO properties are specified by compound datatypes. In the FO file, these are defined by a group of attributes, each having a name of the form `property.component`, for example `space-before.minimum`. These are several compound datatypes:
@@ -179,10 +179,10 @@ These are described in the properties.xm
 Specific datatype classes exist for each compound property. Each component of a compound datatype is itself stored as a Property object. Individual components may be accessed either by directly performing a get operation on the name, using the "dot" notation, eg. `get("space-before.optimum")` ; or by using an accessor on the compound property, eg. `get("space-before").getOptimum()`. In either case, the result is a Property object, and the actual value may be accessed (in this example) by using the "getLength()" accessor.
-## Refinement <a id="refine"></a>
+## Refinement {#refine}
 The **Refinement** step is part of reading and using the properties which may happen immediately or during the layout process. FOP does not currently use a separate Refinement process, but tends to handle refining steps as the FO Tree is built.
-## Refined FO Tree <a id="refined-fo-tree"></a>
+## Refined FO Tree {#refined-fo-tree}
 The Refined FO Tree is the result of the Refinement process.

Modified: xmlgraphics/site/trunk/content/fop/dev/design/renderers.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/design/renderers.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/design/renderers.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/design/renderers.mdtext Thu Dec  6 14:10:09 2012
@@ -3,7 +3,7 @@ Title: Apache(tm) FOP Design: Renderers
 #Apache&trade; FOP Design: Renderers
 <authors><person email="keiron@aftexsw.com" name="Keiron Liddle"></person></authors>
-## Introduction <a id="intro"></a>
+## Introduction {#intro}
 A renderer is primarily designed to convert a given area tree into the output document format. It should be able to produce pages and fill the pages with the text and graphical content. Usually the output is sent to an output stream.
@@ -13,33 +13,33 @@ Each renderer is given an area tree to r
 The renderer will be given each page as it is ready and an output stream to write the data out. All pages are supplied in the order they appear in the document. In order to save memory it is possble to render the pages out of order. Any page that is not ready to be rendered is setup by the renderer first so that it can reserve a space or reference for when the page is ready to be rendered.The renderer is responsible for managing the output format and associated data and flow.
-## Design Issues <a id="issues"></a>
+## Design Issues {#issues}
-### Renderers are Responsible <a id="issue-renderers-responsible"></a>
+### Renderers are Responsible {#issue-renderers-responsible}
 Each renderer is totally responsible for its output format.
-### Send Output to a Stream <a id="issue-output-stream"></a>
+### Send Output to a Stream {#issue-output-stream}
-## Fonts <a id="fonts"></a>
+## Fonts {#fonts}
 Because font metrics (and therefore layout) are obtained in two different ways depending on the renderer, the renderer actually sets up the fonts being used. The font metrics are used during the layout process to determine the size of characters.
-## Render Context <a id="context"></a>
+## Render Context {#context}
 The render context is used by handlers. It contains information about the current state of the renderer, such as the page, the position, and any other miscellanous objects that are required to draw into the page.
-## XML Handling <a id="XML+Handling"></a>
+## XML Handling {#XML+Handling}
 A document may contain information in the form of XML for an image or instream foreign object. This XML is handled through the user agent. A standard extension for PDF is the SVG handler.
 If there is XML in the SVG namespace it is given to the handler which renders the SVG into the pdf document at the given location. This separation means that other XML handlers can easily be added.
-## Extensions <a id="Extensions"></a>
+## Extensions {#Extensions}
 Document level extensions are handled with an extension handler. This handles the information from the AreaTree and adds renders it to the document. An example is the pdf bookmarks. This information first needs to have all references resolved. Then the extension handler is ready to put the information into the pdf document.
-## Renderer Implementations <a id="implement"></a>
+## Renderer Implementations {#implement}
 | Name | Type | Font Source | Font Embedding? | Out of Order Rendering? | Notes |
@@ -54,7 +54,7 @@ Document level extensions are handled wi
 | RTF | Structural | N/A | N/A | No | Structural format uses a different rendering mechanism. |
 | MIF | Structural | N/A | N/A | No | Structural format uses a different rendering mechanism. |
-## Adding a Renderer <a id="add"></a>
+## Adding a Renderer {#add}
 You can add other renderers by implementing the Renderer interface. However, the AbstractRenderer does most of what is needed, including iterating through the tree parts, so it is probably better to extend this. This means that you only need to implement the basic functionality such as text, images, and lines. AbstractRenderer's methods can easily be overridden to handle things in a different way or do some extra processing.
@@ -86,17 +86,17 @@ A renderer implementation does the follo
 - draw various lines and rectangles
-## Multiple Renderers <a id="multiple"></a>
+## Multiple Renderers {#multiple}
 The layout of the document depends mainly on the font being used. If two renderers have the same font metrics then it is possible to use the same Area Tree to render both. This can be handled by the AreaTree Handler.
-## Status <a id="status"></a>
+## Status {#status}
-### To Do <a id="status-todo"></a>
+### To Do {#status-todo}
-### Work In Progress <a id="status-wip"></a>
+### Work In Progress {#status-wip}
-### Completed <a id="status-complete"></a>
+### Completed {#status-complete}
 - new renderer model

Modified: xmlgraphics/site/trunk/content/fop/dev/design/startup.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/design/startup.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/design/startup.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/design/startup.mdtext Thu Dec  6 14:10:09 2012
@@ -3,13 +3,13 @@ Title: Apache(tm) FOP Design: Startup, E
 #Apache&trade; FOP Design: Startup, Environment, Control
-## Introduction <a id="intro"></a>
+## Introduction {#intro}
 Startup is the process of getting Apache&trade; FOP bootstrapped and creating basic objects. Environment includes acquiring user options, instantiating any frameworks, setting up logging, etc. Control includes the basic logic for tieing the various subsystems together properly.
-## Status <a id="status"></a>
+## Status {#status}
-### To Do <a id="status-todo"></a>
+### To Do {#status-todo}
 - avalon integration - logging, configuration, component management, caching, uri resolver
@@ -23,9 +23,9 @@ Startup is the process of getting Apache
 - better commandline handling
-### Work In Progress <a id="status-wip"></a>
+### Work In Progress {#status-wip}
-### Completed <a id="status-complete"></a>
+### Completed {#status-complete}
 -  **better image handling** - redone so it can use a cache and synchronizes properly only on the current image while loading

Modified: xmlgraphics/site/trunk/content/fop/dev/design/svg.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/design/svg.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/design/svg.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/design/svg.mdtext Thu Dec  6 14:10:09 2012
@@ -3,7 +3,7 @@ Title: Apache(tm) FOP Design: SVG
 #Apache&trade; FOP Design: SVG
-## Introduction <a id="intro"></a>
+## Introduction {#intro}
 SVG is rendered through Apache&trade; Batik.
@@ -17,7 +17,7 @@ This creates the necessary PDF informati
 Most of the work is done in the PDFGraphics2D class. There are also a few bridges that are plugged into batik to provide different behaviour for some SVG elements.
-## Text Drawing <a id="Text+Drawing"></a>
+## Text Drawing {#Text+Drawing}
 Normally batik converts text into a set of curved shapes.
@@ -27,23 +27,23 @@ To handle this there is a PDFTextElement
 Text is considered simple if the font is available, the font size is useable and there are no tspans or other complications. This can make the resulting PDF significantly smaller.
-## PDF Links <a id="PDF+Links"></a>
+## PDF Links {#PDF+Links}
 To support links in PDF another batik element bridge is used. The PDFAElementBridge creates a PDFANode which inserts a link into the PDF document via the PDFGraphics2D.
 Since links are positioned on the page without any transforms then we need to transform the coordinates of the link area so that they match the current position of the a element area. This transform may also need to account for the svg being positioned on the page.
-## Images <a id="Images"></a>
+## Images {#Images}
 Images are normally drawn into the PDFGraphics2D. This then creates a bitmap of the image data that can be inserted into the PDF document.
 As PDF can support jpeg images then another element bridge is used so that the jpeg can be directly inserted into the PDF.
-## PDF Transcoder <a id="PDF+Transcoder"></a>
+## PDF Transcoder {#PDF+Transcoder}
 Batik provides a mechanism to convert SVG into various formats. Through FOP we can convert an SVG document into a single paged PDF document. The page contains the SVG drawn as best as possible on the page. There is a PDFDocumentGraphics2D that creates a standalone PDF document with a single page. This is then drawn into by batik in the same way as with the PDFGraphics2D.
-## Other Outputs <a id="Other+Outputs"></a>
+## Other Outputs {#Other+Outputs}
 When rendering to AWT the SVG is simply drawn onto the awt canvas using batik.

Modified: xmlgraphics/site/trunk/content/fop/dev/design/useragent.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/design/useragent.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/design/useragent.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/design/useragent.mdtext Thu Dec  6 14:10:09 2012
@@ -3,7 +3,7 @@ Title: Apache(tm) FOP Design: User Agent
 #Apache&trade; FOP Design: User Agent
 <authors><person email="keiron@aftexsw.com" name="Keiron Liddle"></person></authors>
-## Introduction <a id="intro"></a>
+## Introduction {#intro}
 Technically the user agent is Apache&trade; FOP in the role of determining the output format and when resolving various attributes. The user agent is represented by a class that is available to others to specify how FOP should behave.

Modified: xmlgraphics/site/trunk/content/fop/dev/doc.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/doc.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/doc.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/doc.mdtext Thu Dec  6 14:10:09 2012
@@ -4,32 +4,32 @@ Title: Apache(tm) FOP Development: Manag
 <warning>This page is obsolete. Do not follow this to make FOP documentation.</warning>
-## General Information <a id="general"></a>
+## General Information {#general}
 All raw documentation content is managed in the Apache&trade; FOP SVN repository. Updates should be committed to the repository, then the repository files are used to generate usable output. The remaining discussions on this page assume that the SVN repository is the starting place for processing. The path to the documentation is src/documentation/content/xdocs.
 All documentation is maintained on the trunk.
 Basic documents are stored in XML files, and use DTDs provided by Apache Forrest.
-## Design Principles <a id="design"></a>
+## Design Principles {#design}
 These principles are not written in stone, but reflect the current philosophy, and are documented here primarily to help achieve consistency. These principles should be changed if better or more practical ones are found, but they should probably be discussed and changed by common consent.
-### Where <a id="where"></a>
+### Where {#where}
 - To the extent possible, keep user content separate from developer content, primarily so the user doesn't have to filter out technical information.
 - To the extent possible, try to document a topic exactly once, in the place the user is most likely to look for it, then link to that from other locations as appropriate. This is somewhat contrary to the principle above, which should be applied as a higher priority.
-### When <a id="design-when"></a>
+### When {#design-when}
 The documentation and the product are in a constant state of change, and there is some difficulty in deciding what product state the website content should reflect. The current thinking is that the website should reflect the current state of the repository code branch from which releases are made. Features or other documentation that applies to unreleased code should be marked in such a way within the content that the user can determine whether and how it applies to the version they are using. For example, "Feature xyz is first available in Release n.nn.n".
 Other approaches were considered, but all seemed to have significantly higher costs both to the users and the developers. From the user's standpoint, the choice is either that they potentially have to look multiple places to get the information they need (which was rejected), or they have to filter out an occasional feature that is in code available subsequent to their release (which was accepted).
-## Website <a id="web"></a>
+## Website {#web}
-### Background <a id="web-background"></a>
+### Background {#web-background}
 The FOP web site and documentation are generated using [Apache Forrest](http://forrest.apache.org).
@@ -42,7 +42,7 @@ The following table summarizes the flow 
 | Cron job runs rsync to synchronize the website with the real web server (runs every few hours). | Infrastructure knows. :-) | web-ready |  [FOP Web Site](http://xmlgraphics.apache.org/fop)  |
 Server-side ForrestBot is currently not available for website publishing. We use it locally and with manual invocation.
-### ForrestBot "publish" Step-by-Step <a id="web-forrestbot-publish"></a>
+### ForrestBot "publish" Step-by-Step {#web-forrestbot-publish}
 We're using ForrestBot for build and deploy the FOP website. ForrestBot comes with Apache Forrest 0.8. The root directory of your FOP checkout contains the file "publish.xml" which is an Ant build file that manages the build and the deployment of the FOP website. Please look into this file for further instructions to set up ForrestBot on your machine. Basically, we're simply running ForrestBot manually by typing "ant -f publish.xml" once we're happy with our changes to the site. Step-by-step instructions for the deployment process again:
 Please make sure you use Forrest from the Trunk (revision 632959 or later) for the time being. You will need to download it directly from SVN: [http://svn.apache.org/repos/asf/forrest/trunk](http://svn.apache.org/repos/asf/forrest/trunk)
@@ -57,7 +57,7 @@ Please make sure you use Forrest from th
 The reason for putting the generated website in the SVN repository: The infrastructure people want to be able to restore the websites themselves in case of a crash.
-### Using a Local Forrest <a id="web-local-forrest"></a>
+### Using a Local Forrest {#web-local-forrest}
 To use a local Forrest (during website development, not for deployment):
@@ -75,13 +75,13 @@ To use a local Forrest (during website d
 - run forrest(.bat), which will build the web-site documents in xml-fop/build/site.
 You can use "forrest run" to start a local web server. That improves development speed as you can simply refresh in the browser after a change.
-### Updating Distribution Files <a id="distribution"></a>
+### Updating Distribution Files {#distribution}
 The Apache distribution system mirrors distributions around the world. Since it uses [Apache httpd](http://httpd.apache.org/) Module [mod_autoindex](http://httpd.apache.org/docs/2.2/mod/mod_autoindex.html#headername) you also need to manually update the HEADER.html & READER.html files on `people.apache.org` in `/www/www.apache.org/dist/xmlgraphics/fop/`.
 Please be careful when doing stuff like that.
-### Deleting Documentation Files <a id="delete"></a>
+### Deleting Documentation Files {#delete}
 ForrestBot simply uploads the whole generated site. It doesn't delete obsolete files. You can do that manually in the /www/xmlgraphics.apache.org/fop folder on cvs.apache.org. Be careful when doing stuff like that.
 Please make sure you always have **group rw permissions on all files** under the /www directory!
\ No newline at end of file

Modified: xmlgraphics/site/trunk/content/fop/dev/extensions.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/extensions.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/extensions.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/extensions.mdtext Thu Dec  6 14:10:09 2012
@@ -3,7 +3,7 @@ Title: Apache(tm) FOP Development: Addin
 #Apache&trade; FOP Development: Adding an Extension
-## Overview <a id="overview"></a>
+## Overview {#overview}
 For documentation of standard Apache&trade; FOP extensions, see the [User FOP Extensions](../trunk/extensions.html) document.
@@ -18,7 +18,7 @@ There are three types of extensions poss
 - an fo extension that creates an area in the area tree where normal xsl:fo is not possible
-## Adding Your Own <a id="adding"></a>
+## Adding Your Own {#adding}
 To add your own extension you need to do the following things.

Modified: xmlgraphics/site/trunk/content/fop/dev/faq.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/faq.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/faq.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/faq.mdtext Thu Dec  6 14:10:09 2012
@@ -3,9 +3,9 @@ Title: Apache(tm) FOP Development: FAQ
 #Apache&trade; FOP Development: FAQ
-## 1. General Questions <a id="part_general"></a>
+## 1. General Questions {#part_general}
-### 1.1. How can I contribute?<a id="faq-N1000D"></a>
+### 1.1. How can I contribute? {#faq-N1000D}
 There are many ways that you can help:
@@ -18,18 +18,18 @@ There are many ways that you can help:
 - You can help us document FOP better.
-## 2. Documentation <a id="part_documentation"></a>
+## 2. Documentation {#part_documentation}
-### 2.1. How do I get the javadocs for FOP?<a id="javadoc_location"></a>
+### 2.1. How do I get the javadocs for FOP? {#javadoc_location}
 Currently, the only way to get FOP javadocs is to [Download the source code](../download.html) and then [Build FOP](../trunk/compiling.html) using the ant build task "javadocs".
-### 2.2. Where can I learn how the FOP docs and web site are built?<a id="doc-mgt"></a>
+### 2.2. Where can I learn how the FOP docs and web site are built? {#doc-mgt}
 See FOP [Doc Management](doc.html). ;-)
-## 3. Further Help <a id="part_further_help"></a>
+## 3. Further Help {#part_further_help}
-### 3.1. I don't see my question addressed here. Are there other FAQs?<a id="other_faqs"></a>
+### 3.1. I don't see my question addressed here. Are there other FAQs? {#other_faqs}
 Yes. See also the [FOP General FAQs](../faq.html).

Modified: xmlgraphics/site/trunk/content/fop/dev/implement.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/implement.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/implement.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/implement.mdtext Thu Dec  6 14:10:09 2012
@@ -5,11 +5,11 @@ Title: Apache(tm) FOP Development: Imple
 The purpose of this document is to tie together the Apache&trade; FOP design (interface) with some of the key points where control is passed within FOP (implementation), so that developers can quickly find the section of code that is relevant to their needs. The process described is for a "typical" command-line document. All classes are in org.apache.fop unless otherwise designated.
-## Overview <a id="Overview"></a>
+## Overview {#Overview}
 The input FO document is sent to the FO tree builder via SAX events. Fragments of an FO Tree are built from this process. As each page-sequence element is completed, it is passed to a layout processor, which in turn converts it into an Area Tree. The Area Tree is then given to the Renderer, which converts it into a stream of data containing the output document. The sections below will provide additional details. Where needed differences between the trunk and maintenance branches are shown in tabular format.
-## Startup <a id="Startup"></a>
+## Startup {#Startup}
 - The job starts in *apps.Fop.main()*.
@@ -18,7 +18,7 @@ The input FO document is sent to the FO 
 - Control is passed to *apps.Driver.render()*. This class fires up a SAX parser, the events from which indirectly control the remaining processing, including building the FO Tree, building the Area Tree, rendering, output and logging.
-## Formatting Object Tree <a id="Formatting+Object+Tree"></a>
+## Formatting Object Tree {#Formatting+Object+Tree}
 | Trunk | Maintenance |
@@ -28,17 +28,17 @@ The input FO document is sent to the FO 
 | . |  `fo.pagination.PageSequence.makePage()` creates a BodyArea and passes it to *fo.Flow.layout*  |
 | . | the layout process is then driven from `fo.pagination.PageSequence.format()`. |
-## Layout <a id="Layout"></a>
+## Layout {#Layout}
 There are layout managers for each type of layout decision. They take an FO Tree as input and build a laid-out Area Tree from it. The layout process involves finding out where line breaks and page breaks should be made, then creating the areas on the page. Static areas can then be added for any static regions. As pages are completed, they are added to the Area Tree.
-## Area Tree <a id="Area+Tree"></a>
+## Area Tree {#Area+Tree}
 The area tree is a data structure designed to hold the page areas. These pages are then filled with the page regions and various areas. The area tree is used primarily as a minimal structure that can be rendered by the renderers.
 The area tree is supported by an area tree model. This model handles the adding of pages to the area tree. It also handles page sequence starts, document level extensions, id references and unresolved id areas. This model allows the pages to be handled directly by a renderer or to store the pages for later use.
-## Rendering <a id="Rendering"></a>
+## Rendering {#Rendering}
 The renderer receives pages from the area tree and renders those pages. If a renderer supports out of order rendering then it will either render or prepare a page in the correct order. Otherwise the pages are rendered in order. The task of the renderer is to take the pages and output them to the requested type. In the case of the AWTRenderer it needs to be able to view any page.

Modified: xmlgraphics/site/trunk/content/fop/dev/index.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/index.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/index.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/index.mdtext Thu Dec  6 14:10:09 2012
@@ -3,13 +3,13 @@ Title: Apache(tm) FOP Development: Gener
 #Apache&trade; FOP Development: General Information
-## Introduction <a id="intro"></a>
+## Introduction {#intro}
 These pages contain information that should be helpful for those developing Apache&trade; FOP. This certainly includes programmers, but may also include those contributing to the project in other ways.
 For basic and user information on FOP, please visit the [Apache&trade; FOP homepage](http://xml.apache.org/fop).
-## Development <a id="lines"></a>
+## Development {#lines}
 The main development happens on "FOP Trunk".
@@ -17,13 +17,13 @@ The SVN repository URL for the trunk is:
-## Getting Involved <a id="involved"></a>
+## Getting Involved {#involved}
-### Understand Apache Roles <a id="apache-roles"></a>
+### Understand Apache Roles {#apache-roles}
 Review the [Apache Project Roles and Responsibilities](http://xml.apache.org/roles.html) document for an understanding of the various roles of contributors within the community.
-### How you can help <a id="fop-tasks"></a>
+### How you can help {#fop-tasks}
 There are many different ways that you can help with FOP development. The following is a non-exhaustive list of ways that *non-programmers* can help. Remember that an hour spent on the tasks below is an hour that a programmer can devote to fixing bugs or adding features instead:
@@ -51,20 +51,20 @@ Of course, we're glad to have programmer
 - Implementing new features.
-### Understand FOP-related standards <a id="fop-standards"></a>
+### Understand FOP-related standards {#fop-standards}
 At the moment FOP is mainly a tool to render XSL-FO files to pdf. Therefore if you want to contribute to FOP you should become familiar with these standards. You can find links at [Specifications](../resources.html#specs).
-### Review the Developer Documentation <a id="doc"></a>
+### Review the Developer Documentation {#doc}
-### Understand FOP's Design <a id="design"></a>
+### Understand FOP's Design {#design}
 The design for FOP is specified under the [Design](design/index.html) section. This is where the information on how FOP is developed and designed internally will be kept.
 Another place where we write design documentation is the [FOP Wiki](http://wiki.apache.org/xmlgraphics-fop/DeveloperPages).
 Our design documentation may not always be up to date!
-### Subscribe to the fop-dev Mailing List <a id="mail-fop-dev"></a>
+### Subscribe to the fop-dev Mailing List {#mail-fop-dev}
 Use this forum to discuss topics related to FOP development, including patch submissions, bug reports, and design issues. Please *do not* use it for XML support, XSLT support, XSL-FO support, or even FOP support. Appropriate mailing lists for these topics can be found on the [FOP Mailing List](../maillist.html) page.
@@ -98,7 +98,7 @@ Use this forum to discuss topics related
 - To unsubscribe: Send email to [fop-dev-unsubscribe@xmlgraphics.apache.org](mailto:fop-dev-unsubscribe@xmlgraphics.apache.org).
-### Subscribe to the fop-commits Mailing List <a id="mail-fop-cvs"></a>
+### Subscribe to the fop-commits Mailing List {#mail-fop-cvs}
 When changes are committed to the code repository, a record of the diffs is emailed to the fop-cvs mailing list. FOP developers are encouraged to subscribe to this list because it helps in following the progress of the project.
@@ -120,11 +120,11 @@ When changes are committed to the code r
 - Subscribe by sending an email to [fop-commits-subscribe@xmlgraphics.apache.org](mailto:fop-commits-subscribe@xmlgraphics.apache.org).
-### Download and Use the Developers' Code Using Subversion <a id="dev-code"></a>
+### Download and Use the Developers' Code Using Subversion {#dev-code}
 Between releases the newest code can be accessed via SVN. To do this you need to install a SVN client on your computer, if it is not already there. An explanation how to connect to the FOP source repository can be found at [http://xmlgraphics.apache.org/repo.html](http://xmlgraphics.apache.org/repo.html). More information can be found on the [Tools page](tools.html).
-### Submitting Patches <a id="patches"></a>
+### Submitting Patches {#patches}
 If you have useful changes to source code (bugfixes or enhancements), test files, or documentation that you would like to contribute to the project, please do the following:

Modified: xmlgraphics/site/trunk/content/fop/dev/release.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/release.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/release.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/release.mdtext Thu Dec  6 14:10:09 2012
@@ -3,13 +3,13 @@ Title: Apache(tm) FOP Development: Relea
 #Apache&trade; FOP Development: Release Mechanics
-## Introduction <a id="intro"></a>
+## Introduction {#intro}
 This page documents the process of creating a Apache&trade; FOP release. FOP releases are coordinated by some designated member of the team. The purpose of documenting it here is to facilitate consistency, ensure that the process is captured, and to allow others to comment on the process.
 The checklist below is based on a combination of input from from Christian Geisert and Simon Pepping.
-## Checklist <a id="checklist"></a>
+## Checklist {#checklist}
 - Determine which open bugs must be solved before a release can take place (release critical bugs). Make this bug depend on each release critical bug and write a short argument why the bug is release critical.
@@ -90,7 +90,7 @@ The checklist below is based on a combin
 - Deploy the maven bundle.
-## Resources <a id="other-checklists"></a>
+## Resources {#other-checklists}
 The following is a sample of some other project release checklists, which might be consulted for ideas:
@@ -110,7 +110,7 @@ Following are links with information abo
 - Stefan Bodewig's <a href="http://people.apache.org/~bodewig/mirror.html">Making your Downloads Mirrorable</a>
-## Announcing the release <a id="announcements"></a>
+## Announcing the release {#announcements}
 Here's a suggested list of places where to announce new FOP releases:

Modified: xmlgraphics/site/trunk/content/fop/dev/rtflib.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/rtflib.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/rtflib.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/rtflib.mdtext Thu Dec  6 14:10:09 2012
@@ -3,9 +3,9 @@ Title: Apache(tm) FOP Development: RTFLi
 #Apache&trade; FOP Development: RTFLib (jfor)
-## General Information <a id="general"></a>
+## General Information {#general}
-### Introduction <a id="intro"></a>
+### Introduction {#intro}
 The RTFLib package is an open-source, *independent* package suitable for writing RTF files in a java environment. By *independent* we mean:
@@ -16,17 +16,17 @@ The RTFLib package is an open-source, *i
 The FOP development team intends to keep the RTFLib package independent so that it can be used for other purposes.
-### History <a id="history"></a>
+### History {#history}
 RTFLib was originally developed by [Bertrand Delacrétaz](mailto:bdelacretaz@apache.org) and the [jfor](http://www.jfor.org) team. jfor was written under an Apache-style license, and the jfor team contributed the code to the Apache Software Foundation in June, 2003. RTFLib is a subset of the original jfor project, which also includes an XSL-FO parsing mechanism for a complete XSL-FO to RTF solution.
-### Status <a id="status"></a>
+### Status {#status}
 Although FOP's implementation of the RTFLib package is very incomplete, the RTFLib package itself is relatively mature. RTFLib is only available in the trunk [line of FOP development](index.html#lines).
 <warning>This documentation is a work in progress. If you see errors or omissions, please report them to the [fop-dev mailing list](index.html#mail-fop-dev).</warning>
-# User Documentation <a id="userdoc"></a>
+# User Documentation {#userdoc}
-### Overview <a id="userdoc-overview"></a>
+### Overview {#userdoc-overview}
 Perhaps the easiest way to see how to use RTFLib is by looking at an example. A set of test documents is part of the package, and can be [viewed online](http://cvs.apache.org/viewcvs.cgi/xml-fop/src/java/org/apache/fop/rtf/rtflib/testdocs/). A quick look at the Abstract [TestDocument](http://cvs.apache.org/viewcvs.cgi/xml-fop/src/java/org/apache/fop/rtf/rtflib/testdocs/TestDocument.java?rev=HEAD&content-type=text/vnd.viewcvs-markup) class, and one of the Concrete subclasses, [SimpleDocument](http://cvs.apache.org/viewcvs.cgi/xml-fop/src/java/org/apache/fop/rtf/rtflib/testdocs/SimpleDocument.java?rev=HEAD&content-type=text/vnd.viewcvs-markup) will provide the basics of how to use the package.
@@ -39,7 +39,7 @@ There are two basic concepts you will ne
 RTFLib handles the process of converting to and writing the RTF content as the document is created. All you need to do is flush the document at the end to make sure that the last pieces get written.
-### Document Structure <a id="userdoc-structure"></a>
+### Document Structure {#userdoc-structure}
 <warning>This section is very incomplete.</warning>
 The documentation in this section is intended to provide a high-level view of the process of building an RTF document. For more detailed API documentation of the various methods, be sure to consult the Javadocs for RTFLib.
@@ -59,24 +59,24 @@ The following table summarizes the vario
 | JforCmd | RtfSection.newJforCmd | . | . |
 | Text | RtfParagraph.newText() | Character Formatting | N/A |
-### Attributes <a id="userdoc-attributes"></a>
+### Attributes {#userdoc-attributes}
 <warning>This section is very incomplete.</warning>
 Attributes can be set for each container and piece of content in the document. The general approach is to build an RtfAttributes object containing the various attributes, then pass that RtfAttributes object to the method that creates the new container or content. See the Javadoc API documentation for RtfAttributes for details on the syntax for creating an RtfAttributes object. The following information lists the various attributes that can be set for each type of container.
-#### Information Group<a id="userdoc-attr-ig"></a>
+#### Information Group {#userdoc-attr-ig}
 These attributes are set when creating a Document.
-#### Document Formatting<a id="userdoc-attr-df"></a>
+#### Document Formatting {#userdoc-attr-df}
 These attributes are set when creating a Document.
-#### Section Formatting<a id="userdoc-attr-sf"></a>
+#### Section Formatting {#userdoc-attr-sf}
 These attributes are set when creating a Section.
-#### Paragraph Formatting<a id="userdoc-attr-pf"></a>
+#### Paragraph Formatting {#userdoc-attr-pf}
 These attributes are set when creating a Paragraph.
@@ -104,7 +104,7 @@ These attributes are set when creating a
 | bottom dotted border | RtfText.BDR_BOTTOM_DOTTED | Boolean? | brdrb\\brsp40\\brdrdot |
 | bottom dashed border | RtfText.BDR_BOTTOM_DASH | Boolean? | brdrb\\brsp40\\brdrdash |
-#### Character Formatting<a id="userdoc-attr-cf"></a>
+#### Character Formatting {#userdoc-attr-cf}
 These attributes are set when creating a Paragraph, or Text.

Modified: xmlgraphics/site/trunk/content/fop/dev/svg.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/svg.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/svg.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/svg.mdtext Thu Dec  6 14:10:09 2012
@@ -5,7 +5,7 @@ Title: Apache(tm) FOP Development: SVG I
 See also [SVG User Documentation](../trunk/graphics.html#svg) for more information.
-## Examples <a id="Examples"></a>
+## Examples {#Examples}
 These examples illustrate a number of issues relating to conversion to PDF:
@@ -24,11 +24,11 @@ You will need Acrobat 5.0 to see transpa
 | embedding svg |  [embedding.fo](fo/embedding.fo)  |  [embedding.fo.pdf](fo/embedding.fo.pdf)  |
-## Developer Notes <a id="Developer+Notes"></a>
+## Developer Notes {#Developer+Notes}
 For most output formats in FOP the SVG is simply drawn into an image with Batik. For PDF there are a set of classes to handle drawing the [GVT (Graphic Vector Toolkit)](http://xml.apache.org/batik/architecture.html) into PDF markup.
-### Classes <a id="Classes"></a>
+### Classes {#Classes}
 These are the relevant classes, found in the package org.apache.fop.svg:
@@ -39,6 +39,6 @@ These are the relevant classes, found in
 -  *PDFTranscoder* <br></br>used by Batik to transcode an svg document into a standalone pdf, via PDFDocumentGraphics2D.
-### Ideas <a id="Ideas"></a>
+### Ideas {#Ideas}
 Batik can convert ttf to svg font. This svg font could be converted into a pdf stroked font (type 3 font).

Modified: xmlgraphics/site/trunk/content/fop/dev/testing.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/testing.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/testing.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/testing.mdtext Thu Dec  6 14:10:09 2012
@@ -3,7 +3,7 @@ Title: Apache(tm) FOP Development: Testi
 #Apache&trade; FOP Development: Testing
-## "Build" Testing <a id="build"></a>
+## "Build" Testing {#build}
 Apache&trade; projects use an automated build tool called "gump" to create nightly builds from the SVN repository. Gump sends "nag" messages if the build fails. This can be considered a sort of basic test of the build process. To view the most recent logs of the gump builds:
@@ -12,17 +12,17 @@ Apache&trade; projects use an automated 
 -  [Gump build for the Maintenance Branch](http://gump.cocoondev.org/xml-fop-maintenance.html)
-## Basic/API Testing <a id="basic"></a>
+## Basic/API Testing {#basic}
 There is a group of basic API tests that are included in the build process. For these tests to occur, JUnit must be available to Ant (simply copy junit.jar into Ant's lib directory). The build will then report error(s) if the high-level APIs for Driver and the Transcoders fail. The tests do not check the output, but only ensure that something is generated and without exceptions.
-## Layout Engine Testing <a id="layoutengine"></a>
+## Layout Engine Testing {#layoutengine}
 The [http://svn.apache.org/viewcvs.cgi/xmlgraphics/fop/trunk/test/layoutengine/](http://svn.apache.org/viewcvs.cgi/xmlgraphics/fop/trunk/test/layoutengine/) directory in the repository contains a test suite for checking the functionality of Apache&trade; FOP's layout engine. For information on how to create test cases for the layout engine, please visit the [Wiki page](http://wiki.apache.org/xmlgraphics-fop/HowToCreateLayoutEngineTests).
-## Functional Testing <a id="functional"></a>
+## Functional Testing {#functional}
 <warning>The "functional" testing section on this page is currently inoperative.</warning>
-## Running and Using Tests <a id="Running+and+Using+Tests"></a>
+## Running and Using Tests {#Running+and+Using+Tests}
 Testing is an important part of getting FOP to operate correctly and conform to the necessary standards.
@@ -30,11 +30,11 @@ A testing system has been set up that wo
 To setup the testing the developer must place a reference fop.jar in the "<cvs_repository>/test/reference/" directory. This jar will be dynamically loaded to create the reference output.
-### W3C TestSuite <a id="W3C+TestSuite"></a>
+### W3C TestSuite {#W3C+TestSuite}
 The testing is set up so that you can download the testsuite from <a href="http://www.w3.org/Style/XSL/TestSuite/">http://www.w3.org/Style/XSL/TestSuite/</a>, unzip the file into the base directory of FOP. Then you can uncomment the lines in the build.xml file in the test target and itwill run through all the tests in the testsuite distribution.
-### Writing a Test <a id="Writing+a+Test"></a>
+### Writing a Test {#Writing+a+Test}
 A test belongs to one of a few catagories. A basic test should excercise one element in a number of situations such as changing a property. This should have at least one normal value, one border value and one invalid value. If the property can be of different types then this should also be included.
@@ -44,11 +44,11 @@ A system test is one that tests the abit
 A test can consist of a complete fo document or a part of the document such as some elements that will be placed into the flow of a standard document.
-### Submitting a Test <a id="Submitting+a+Test"></a>
+### Submitting a Test {#Submitting+a+Test}
 If you have a test which you think would be useful you should supply the test and a diff to the appropriate test suite xml file. Make sure that the test works as would be expected against the current build.
-### How Testing Works <a id="How+Testing+Works"></a>
+### How Testing Works {#How+Testing+Works}
 The tests are stored in the "<svn_repository>/test" directory.
@@ -60,6 +60,6 @@ The testing is done by reading a test su
 For FOP the testing is done by rendering all the testing documents using the XML renderer. The XML files are then compared to see if there are any differences.
-### SVG Testing <a id="SVG+Testing"></a>
+### SVG Testing {#SVG+Testing}
 The testing of SVG is not part of this testing system. SVG is tested for its rendering accuracy by using the transcoding mechanism via [Apache Batik](http://xmlgraphics.apache.org/batik/). So that the only part that needs testing is how the SVG image is embedded inside the flow of the fo document.

Modified: xmlgraphics/site/trunk/content/fop/dev/tools.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/dev/tools.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/dev/tools.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/dev/tools.mdtext Thu Dec  6 14:10:09 2012
@@ -5,7 +5,7 @@ Title: Apache(tm) FOP Development: Devel
 This page documents items that may be helpful to other developers, especially to those who are new to Apache&trade; FOP. Exhaustive treatment of these topics is better suited to other fora, but the information presented here is intended to deal with FOP-specific issues related to these tools, especially "gotchas", and to help developers get jump-started.
-## Developer Checklist <a id="checklist"></a>
+## Developer Checklist {#checklist}
 Here is a (probably not comprehensive) list of tools you will need to be a successful FOP developer:
@@ -20,19 +20,19 @@ Here is a (probably not comprehensive) l
 - JUnit (see [Basic Testing](testing.html#basic)).
-## General Developer Information <a id="general"></a>
+## General Developer Information {#general}
 See [the Apache Contributors Tech Guide](http://www.apache.org/dev/contributors.html) for useful information and links for Apache developers, including help with tools and procedures.
-## Subversion (SVN) <a id="svn"></a>
+## Subversion (SVN) {#svn}
-### General <a id="svn_general"></a>
+### General {#svn_general}
 Visit [Apache XML Graphics Code Repositories](http://xmlgraphics.apache.org/repo.html) for useful information.
 You will need a SVN client to be able to gain access to the FOP repository. For general SVN information, visit [Subversion Home](http://subversion.tigris.org). A comprehensive list of clients for all operating systems and many IDEs can be found at [the Subversion Links page](http://subversion.tigris.org/project_links.html). For Microsoft Windows we recommend [TortoiseSVN](http://tortoisesvn.tigris.org). The command-line client that comes with Subversion is also very easy to use.
-### Step-by-step instruction for downloading FOP using the SVN command-line client <a id="svn_download"></a>
+### Step-by-step instruction for downloading FOP using the SVN command-line client {#svn_download}
 On the command-line (Windows or Unix), simply run:
@@ -40,7 +40,7 @@ On the command-line (Windows or Unix), s
 This will download the FOP trunk into the directory "fop-trunk".
-### Step-by-step instructions for downloading FOP using TortoiseSVN (on Windows) <a id="tortoisesvn_download"></a>
+### Step-by-step instructions for downloading FOP using TortoiseSVN (on Windows) {#tortoisesvn_download}
 - Create a new, empty directory in a place of your choice.
@@ -51,7 +51,7 @@ This will download the FOP trunk into th
 - Click "OK" and the download should begin.
-### Creating Patches <a id="patches"></a>
+### Creating Patches {#patches}
 -  `cd` to a directory that contains all of the changes that you wish to include in the patch. To comprehend the entire distribution, `cd` to the top directory where you checked out the sources.
@@ -62,7 +62,7 @@ This will download the FOP trunk into th
 - If you are running TortoiseSVN, you can select "Create Patch..." in the TortoiseSVN context menu.
-### Documentation <a id="svn-doc"></a>
+### Documentation {#svn-doc}
 - [online resource] <a href="http://subversion.tigris.org">The Subversion Home Page</a>.
@@ -71,7 +71,7 @@ This will download the FOP trunk into th
 - [online resource] <a href="http://subversion.tigris.org/project_links.html">Comprehensive list of links to documentation and Subversion clients and plugins.</a>
-## Integrated Development Environments (IDEs) <a id="ide"></a>
+## Integrated Development Environments (IDEs) {#ide}
 An IDE is not required, but will generally be found to be helpful, especially for serious debugging and refactoring.

Modified: xmlgraphics/site/trunk/content/fop/download.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/download.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/download.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/download.mdtext Thu Dec  6 14:10:09 2012
@@ -3,7 +3,7 @@ Title: Apache(tm) FOP: Downloading A Dis
 #Apache&trade; FOP: Downloading A Distribution
-## Binary or Source? <a id="dist-type"></a>
+## Binary or Source? {#dist-type}
 Most Apache&trade; FOP users will want to download the latest binary distribution, which is ready to run "out of the box." However, a source distribution will be preferable if you fall into one of the following categories:
@@ -14,11 +14,11 @@ Most Apache&trade; FOP users will want t
 - You wish to build a local copy of the API documentation (javadocs).
-## Binary Download <a id="binary"></a>
+## Binary Download {#binary}
 Binary distributions include "-bin" in their names, and can be downloaded from a [FOP Distribution mirror](http://www.apache.org/dyn/closer.cgi/xmlgraphics/fop). Nightly builds of trunk code can be downloaded here: [Nightly Snapshots](http://ci.apache.org/projects/xmlgraphics/fop/snapshots/).
-## Source Download <a id="source"></a>
+## Source Download {#source}
 There are several ways to obtain a source distribution. Please note that they are listed from least current to most current:
@@ -56,6 +56,6 @@ There are several ways to obtain a sourc
 With any source distribution, you will need to build FOP from the source files. For details please see the "Build" page on the documentation tab for the version you've downloaded.
-## Archive Download <a id="archives"></a>
+## Archive Download {#archives}
 FOP Archive distributions are linked from the upper portion of the Apache FOP Download Mirror Page and can be downloaded from the FOP Archives [binaries](http://archive.apache.org/dist/xmlgraphics/fop/binaries/) & [source](http://archive.apache.org/dist/xmlgraphics/fop/source/) links.

Modified: xmlgraphics/site/trunk/content/fop/examples.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/examples.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/examples.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/examples.mdtext Thu Dec  6 14:10:09 2012
@@ -3,7 +3,7 @@ Title: Apache(tm) FOP Examples
 #Apache&trade; FOP Examples
-## Example Documents Using Apache&trade; FOP <a id="Example+Documents+Using+Apache%E2%84%A2+FOP"></a>
+## Example Documents Using Apache&trade; FOP {#Example+Documents+Using+Apache%E2%84%A2+FOP}
 These examples have been rendered using Apache&trade; FOP:
@@ -33,7 +33,7 @@ Also, in the directory examples/fo/pagin
 Developers will find the first steps to a test suite for all implemented formatting objects and properties in test/xml in the source distribution.
-## Images Examples <a id="Images+Examples"></a>
+## Images Examples {#Images+Examples}
 Embedding images in FO:
@@ -45,7 +45,7 @@ Embedding images in FO:
 Look also into the directory examples/fo/svg. There you find some very extensive SVG examples.
-## Instream Foreign Object Examples <a id="Instream+Foreign+Object+Examples"></a>
+## Instream Foreign Object Examples {#Instream+Foreign+Object+Examples}
 Instream Foreign Object images in FO, there are more on the [SVG Page](dev/svg.html):

Modified: xmlgraphics/site/trunk/content/fop/fo.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/fo.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/fo.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/fo.mdtext Thu Dec  6 14:10:09 2012
@@ -3,13 +3,13 @@ Title: Apache(tm) FOP: XSL-FO Input
 #Apache&trade; FOP: XSL-FO Input
 <subtitle>Basic Help for Using XML, XSLT, and XSL-FO</subtitle>
-## Overview <a id="overview"></a>
+## Overview {#overview}
 Apache&trade; FOP uses XSL-FO as input. It is the responsibility of the user to make sure that the XSL-FO submitted to FOP is correct. The tutorial items presented here are not comprehensive, but are of the FAQ variety. Another good FAQ is<fork href="http://www.dpawson.co.uk/xsl/">Dave Pawson's XSL FAQ</fork>.
-## XML Issues <a id="xml"></a>
+## XML Issues {#xml}
-### Special Characters <a id="xml-special-chars"></a>
+### Special Characters {#xml-special-chars}
 When entering special (non-ASCII) characters in XML, the general rule is to use the applicable Unicode character instead of trying to use a character entity as you would with HTML. Remember that HTML is an SGML document type. SGML has a limited character set, which requires it to use character entities to represent special characters. One of the improvements of XML over SGML (and thus HTML) is native support for Unicode. Basic XML has only a handful of character entities, primarily because it doesn't really need more.
@@ -25,7 +25,7 @@ Getting your XML correctly encoded is on
 An alternative to encoding the character and making it available through a font is to use an embedded graphic to represent the character: GIF, PNG, SVG, etc.
-### Entity Characters <a id="xml-entity-chars"></a>
+### Entity Characters {#xml-entity-chars}
 The handful of basic XML character entities that do exist are the ampersand, apostrophe, less-than, greater-than, and single-quote characters. These are needed to distinguish markup tags from content, and to distinguish character entities from content. To avoid parser complaints about illegal characters and entities in your input, ensure that ampersands in text and attributes are written as &amp;, "<" is written as &lt;, and ">" as &gt;. It is not necessary everywhere, but it is wise to do so anyway, just to be sure.
@@ -33,13 +33,13 @@ Most XML parsers will provide a line num
 Review the [XML Specification](http://www.w3.org/XML/) or a good tutorial for details of the XML file format.
-### Encoding Issues <a id="xml-encoding"></a>
+### Encoding Issues {#xml-encoding}
 If the parser complains about illegal bytes or characters in the input, or there are unexpected characters in the output, this is usually the result of a character encoding problem. See the [XSL FAQ](http://www.dpawson.co.uk/xsl) for additional information. Many software packages that produce XML, including XSLT processors, use UTF-8 encoding as a default. If you view their output with something not aware of the encoding, like Notepad for Win95/98/ME/NT, funny characters are displayed. A � is a giveaway.
-## XSLT Issues <a id="xslt"></a>
+## XSLT Issues {#xslt}
-### Current Date and Time <a id="xslt-date"></a>
+### Current Date and Time {#xslt-date}
 XSL-FO does not currently have a function for retrieving the current date and time. However, in some cases, XSLT can be used to place the current date and time into the XSL-FO document as it is generated.
@@ -62,9 +62,9 @@ Next, use the java language to retrieve 
             ('MMMM d, yyyy, h:mm:ss a (zz)'), java:java.util.Date.new())"/>
-## XSL-FO Issues <a id="xsl-fo"></a>
+## XSL-FO Issues {#xsl-fo}
-### Vertical Centering <a id="fo-center-vertical"></a>
+### Vertical Centering {#fo-center-vertical}
 To vertically center an image, table, or other item, use display-align="center". See [display-align Compliance](compliance.html#fo-property-display-align) for implementation status. Here is a small, self-contained document centering an image on a page:
@@ -95,7 +95,7 @@ To vertically center an image, table, or
-### Horizontal Centering (Tables) <a id="fo-center-table-horizon"></a>
+### Horizontal Centering (Tables) {#fo-center-table-horizon}
 To center a table horizontally, one possibility is to add one column on the left and one on the right which pad the table so that the visible part is centered:
@@ -128,11 +128,11 @@ To center a table horizontally, one poss
 If your table is more complicated, or if defining borders on individual cells becomes too much work, use the code above and nest your table within the middle cell.
-### Right-Aligning (Tables) <a id="fo-right-align-table-horizon"></a>
+### Right-Aligning (Tables) {#fo-right-align-table-horizon}
 To right-align a table, you can use the same approach as above for centering tables. Just remove the last table-column element which causes all the left-over space not used by the columns with a fixed column-width to be assigned to the first column which effectively right-aligns the table.
-### Recto/Verso Static Content Differences <a id="fo-oddeven"></a>
+### Recto/Verso Static Content Differences {#fo-oddeven}
 One frequent request is that static content be different between recto pages (right-side or odd-numbered pages typically) and verso pages(left-side or even-numbered pages typically). For example, you may wish to place the page number on the "outer" side of each page. There are examples in the FO distribution and in the [XSL FAQ FO section](http://www.dpawson.co.uk/xsl/sect3/index.html).
@@ -179,7 +179,7 @@ First, define a page master with alterna
-### Making the First Page Special <a id="fo-first-page"></a>
+### Making the First Page Special {#fo-first-page}
 To get a special header on the first page, one possibility is to insert it into the flow instead of the static content. Alternatively, use a page master referring to different page masters for the first page and the rest. Here is a code sample:
@@ -225,7 +225,7 @@ To get a special header on the first pag
-### Blank Pages <a id="fo-blank-pages"></a>
+### Blank Pages {#fo-blank-pages}
 Sometimes it is desirable to insert blank pages within your output, starting, for example, a new chapter on an odd page or an even page. A blank page can be forced by using `break-before="page-even"` or similar properties, or by a force-page-count="end-on-odd" on a page sequence.
@@ -272,11 +272,11 @@ To write "This page is intentionally lef
-### Preformatting Content <a id="fo-preformat"></a>
+### Preformatting Content {#fo-preformat}
 Sometimes it is desirable to retain linebreaks and hard spaces, and to get preformatted text to pass through without being changed. The XSL-FO specification provides some properties for this: [white-space-collapse](http://www.w3.org/TR/xsl11/#white-space-collapse) and [linefeed-treatment](http://www.w3.org/TR/2001/REC-xsl-20011015/slice7.html#white-space-collapse). In FOP, use white-space-collapse="false" on an enclosing block.
-### Total Document Pages <a id="fo-total-pages"></a>
+### Total Document Pages {#fo-total-pages}
 It is frequently desirable to know the total number of pages in a document and to use that number within the document. For example, you might wish to show the page number on the first page as being "page 1 of 12".
@@ -365,13 +365,13 @@ Declare and use the parameter "page-coun
 <warning>It is possible to run into a convergence problem with this solution. Replacing the "#" placeholder in the first run with the actual page count in the second run, may change the total number of pages in the document.</warning>
-### Aligning Regions <a id="fo-region-align"></a>
+### Aligning Regions {#fo-region-align}
 Although it may seem counterintuitive, the regions on a page may overlap. Defining a certain body region does not automatically constrain other regions. Instead, this has to be done explicitly. Sometimes for creative reasons it may be desirable to have the regions overlap. Otherwise, you will want to set them up so that the header does not overlap body content or the body extend into the footer.
 Assuming you wish to keep the regions separate, if you have a header region with an extent of 20mm, you should define a margin for the body region of at least 20mm too. Otherwise the header content may overwrite some stuff in the body region. This applies similarly to the extent of the after region and the bottom margin of the body region.
-### Drawing Lines <a id="fo-lines"></a>
+### Drawing Lines {#fo-lines}
 It is frequently desirable to draw lines in a document, as separators, side bars or folding marks. There are several possibilities:
@@ -382,13 +382,13 @@ It is frequently desirable to draw lines
 - Insert a graphic. GIF, PNG SVG, whatever.
-### Validating XSL-FO <a id="fo-validate"></a>
+### Validating XSL-FO {#fo-validate}
  [RenderX](http://www.renderx.com) has provided an [Unofficial DTD for FO Documents](http://www.renderx.com/Tests/validator/fo.dtd.html), which may be helpful in validating general FO issues.
 FOP also maintains an [Unofficial FOP Schema](http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/foschema/fop.xsd?view=co) in the FOP Subversion Repository. This document can be used either to validate against the FO standard, or against the actual FOP implementation. See the notes near the beginning of the document for instructions on how to use it.
-### Producing landscape pages <a id="landscape"></a>
+### Producing landscape pages {#landscape}
 Pages in landscape format can easily be produced by exchanging the page-height and page-width values of a simple-page-master element.
@@ -402,7 +402,7 @@ Pages in landscape format can easily be 
-### External Resources <a id="external-resources"></a>
+### External Resources {#external-resources}
 Resources needed by an XSL-FO file that are external to it (graphics, for example), are defined in the XSL-FO standard as being of type "uri-specification". This is defined in the standard at <a href="http://www.w3.org/TR/xsl11/#datatype">Section 5.11 Property Datatypes</a>, which includes a link to the URI standard itself. Refer to the XSL-FO and URI standards themselves for more detailed instructions.

Modified: xmlgraphics/site/trunk/content/fop/fop-pdf-images.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/fop-pdf-images.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/fop-pdf-images.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/fop-pdf-images.mdtext Thu Dec  6 14:10:09 2012
@@ -18,7 +18,7 @@ Notice:    Licensed to the Apache Softwa
 #Apache&trade; FOP: PDF Images Plug-In
-## Overview <a id="overview"></a>
+## Overview {#overview}
 The *fop-pdf-images* plug-in extends FOP in order to add support for using PDF images in fo:external-graphic elements when
 generating PDF files. This means one can write something like:
@@ -31,14 +31,14 @@ and
     <fox:external-document src="my-doc.pdf"/>
-## Download <a id="download"></a>
+## Download {#download}
 Snapshot development source and binary packages are available [here](https://dist.apache.org/repos/dist/dev/xmlgraphics/). If using
 the binary package, the four jar files should be placed in the *lib* directory of your FOP installation.
 The current source can also be retrieved from the [svn repository](http://svn.apache.org/repos/asf/xmlgraphics/fop-pdf-images/).
-## Older Releases <a id="older_releases"></a>
+## Older Releases {#older_releases}
 The fop-pdf-images plug-in was donated by Jeremias M&auml;rki to the XMLGraphics project in 2012. Older releases can
 be obtained from his plug-in [page](http://www.jeremias-maerki.ch/development/fop/index.html).
\ No newline at end of file

Modified: xmlgraphics/site/trunk/content/fop/gethelp.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/gethelp.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/gethelp.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/gethelp.mdtext Thu Dec  6 14:10:09 2012
@@ -5,11 +5,11 @@ Title: Apache(tm) FOP: Getting Help
 The Apache&trade; FOP developer community is eager to help you maximize the usefulness of FOP. However, to make wise use of its limited resources, support must be primarily self-service. Go through the following checklist sequentially to determine what kind of help you need, and where to get it:
-## Understand Underlying Technologies <a id="underlying"></a>
+## Understand Underlying Technologies {#underlying}
 If you have a questions about XML, XSLT, or XSL-FO that are not directly related to FOP, please consult resources that are appropriate for those questions. FOP is an implementation of these technologies, and when you use FOP, there is a presumption that you have a working understanding of them. We have included several useful links on our [Resources](resources.html) page that may help you get started.
-## Understand FOP's Limitations <a id="limitations"></a>
+## Understand FOP's Limitations {#limitations}
 FOP is a work in progress, and has some limitations.
@@ -17,34 +17,34 @@ FOP does not yet fully comply with the W
 Please especially do not submit questions asking when a particular feature will be implemented. There are too many unknowns to make even a reasonable estimate. Every time a developer stops to answer such a question, the answer will inevitably be "I don't know", but the time taken to respond is time spent away from development. The only sure way to get a feature implemented is to [pitch in and help](#how-to-help).
-## Read the Documentation <a id="doc"></a>
+## Read the Documentation {#doc}
 Review the documentation pages on this site. There is information about how to run FOP, how to embed it, how to add custom fonts etc.
-## Check the FAQs <a id="faq"></a>
+## Check the FAQs {#faq}
 Consult the [Frequently Asked Questions (FAQ)](faq.html) to see if your question has already been answered.
-## Review FOP User Mailing List Archive <a id="user-archive"></a>
+## Review FOP User Mailing List Archive {#user-archive}
 It is possible that your question has already been answered but has not yet found its way into the FAQ. Links to the FOP User mailing list archives are on the [Mailing List](maillist.html#fop-user) page.
-## Look for an Existing Issue Report <a id="existing-issue"></a>
+## Look for an Existing Issue Report {#existing-issue}
 See [Reported Issues](bugs.html#issues_existing) for instructions on how to use the list of open issues. Review these open issues to see if any match your concerns. If so, please do not post a mailing list question or report another issue, as these will only slow the development team down.
-## Submit Question to FOP User Mailing List <a id="user-mailing-list"></a>
+## Submit Question to FOP User Mailing List {#user-mailing-list}
 See [FOP User Mailing List](maillist.html#fop-user) for details.
 Please don't write to any developer directly. Only if you submit questions to the [FOP User Mailing List](maillist.html#fop-user) will other FOP users be able to profit from answers given to your question. Another point is that a developer may have gone inactive or is on holidays in which case you may not get an answer in time.
-## Enter an Issue Report <a id="enter-issue"></a>
+## Enter an Issue Report {#enter-issue}
 If, and only if, you have followed all of the above steps, and believe that there is a bug or needed feature that you would like to report, please enter an issue in Bugzilla. Never use Bugzilla to post questions, only to enter issues that have already been asked on the user mailing list.
 See [Reporting New Issues](bugs.html#issues_new) for detailed instructions on how to enter an issue.
-## Find Out How You Can Help <a id="how-to-help"></a>
+## Find Out How You Can Help {#how-to-help}
 As stated above, the FOP development team is a limited resource. Most make their livings doing things other than writing and supporting FOP. Perhaps you need a feature from the XSL-FO standard to be implemented right away, or a bug fixed, or a new output format, or .... If so, there are several ways that you can help:

Modified: xmlgraphics/site/trunk/content/fop/index.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/index.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/index.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/index.mdtext Thu Dec  6 14:10:09 2012
@@ -2,7 +2,7 @@ Title: Apache(tm) FOP - a print formatte
 #Apache&trade; FOP
-## Introduction <a id="intro"></a>
+## Introduction {#intro}
 Apache&trade; FOP (Formatting Objects Processor) is a print formatter driven by XSL formatting objects (XSL-FO) and an output independent formatter. It is a Java application that reads a formatting object (FO) tree and renders the resulting pages to a specified output. [Output formats](1.0/output.html) currently supported include PDF, PS, PCL, AFP, XML (area tree representation), Print, AWT and PNG, and to a lesser extent, RTF and TXT. The primary output target is PDF.
@@ -16,7 +16,7 @@ Support for each of the standard's objec
 FOP is proud to be part of [Apache's XML Graphics project](http://xmlgraphics.apache.org).
-## Demonstration <a id="demo"></a>
+## Demonstration {#demo}
 ![Formatting Diagram](images/layout.jpg)
@@ -24,7 +24,7 @@ This image is a demonstration of a real 
 FOP uses the standard XSL-FO file format as input, lays the content out into pages, then renders it to the requested output. One great advantage of using XSL-FO as input is that XSL-FO is itself an XML file, which means that it can be conveniently created from a variety of sources. The most common method is to convert semantic XML to XSL-FO, using an XSLT transformation.
-## FOP Objectives <a id="objectives"></a>
+## FOP Objectives {#objectives}
 The goals of the Apache FOP project are to deliver an XSL-FO to PDF formatter that is compliant to at least the Basic conformance level described in the W3C Recommendation from 05 December 2006, and that complies with the November 2001 Portable Document Format Specification (Version 1.4) from Adobe Systems.

Modified: xmlgraphics/site/trunk/content/fop/knownissues.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/knownissues.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/knownissues.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/knownissues.mdtext Thu Dec  6 14:10:09 2012
@@ -3,7 +3,7 @@ Title: Apache(tm) FOP: Known Issues
 #Apache&trade; FOP: Known Issues
-## Known issues <a id="Known+issues"></a>
+## Known issues {#Known+issues}
 This page lists currently known issues in the Apache&trade; FOP codebase. Please note that this list is generated from data in FOP's code repository (Trunk) and may not exactly represent the list of issues in the latest release.
@@ -16,7 +16,7 @@ For additional information on known issu
 Apache&trade; FOP has an extensive automated testing infrastructure. Parts of this infrastructure are several sets of test cases. When a test case is listed in disabled-testcases.xml it is disabled in the JUnit tests during the normal build process. This indicates a problem in the current codebase. When a bug is fixed or a missing feature is added the entry for the relevant test case(s) are removed.
-### FO Tree <a id="FO+Tree"></a>
+### FO Tree {#FO+Tree}
 This section lists currently disabled test cases in the test suite for the FO tree tests. The data for this section comes from [test/fotree/disabled-testcases.xml](http://svn.apache.org/repos/asf/xmlgraphics/fop/trunk/test/fotree/disabled-testcases.xml).
@@ -28,7 +28,7 @@ This section lists currently disabled te
-### Layout Engine <a id="Layout+Engine"></a>
+### Layout Engine {#Layout+Engine}
 This section lists currently disabled test cases in the test suite for the layout engine tests. The data for this section comes from [test/layoutengine/disabled-testcases.xml](http://svn.apache.org/repos/asf/xmlgraphics/fop/trunk/test/layoutengine/disabled-testcases.xml).
@@ -168,7 +168,7 @@ This section lists currently disabled te
-### Other known issues <a id="Other+known+issues"></a>
+### Other known issues {#Other+known+issues}
 This section lists other known issues.

Modified: xmlgraphics/site/trunk/content/fop/license.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/fop/license.mdtext?rev=1417895&r1=1417894&r2=1417895&view=diff
--- xmlgraphics/site/trunk/content/fop/license.mdtext (original)
+++ xmlgraphics/site/trunk/content/fop/license.mdtext Thu Dec  6 14:10:09 2012
@@ -3,7 +3,7 @@ Title: Apache(tm) FOP License
 #Apache&trade; FOP License
-## License <a id="License"></a>
+## License {#License}
 All new Apache&trade; FOP releases will be licensed under the **Apache&trade; License, version 2.0**. Releases until version 0.20.5 are released unter the Apache&trade; License, version 1.1.

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

View raw message