Dear Wiki user, You have subscribed to a wiki page or wiki category on "Xmlgraphics-fop Wiki" for change notification.
The following page has been changed by JeremiasMaerki: http://wiki.apache.org/xmlgraphics-fop/HowTo/XMP The comment on the change is: Moved to main website ------------------------------------------------------------------------------ /!\ This works with FOP 0.92beta or later. ---- - == Declaring properties in an XSL-FO file == - All metadata properties can be declared in the {{{fo:declarations}}} element. - XMP specification recommends to use {{{x:xmpmeta}}}, {{{rdf:RDF}}}, and {{{rdf:Description}}} elements as shown in example below. + /!\ '''The information on this page has been moved to the main Apache FOP website:''' - Only one of the 2 first is required to make PDF to recognize metadata properties. + '''http://xmlgraphics.apache.org/fop/stable/metadata.html''' - === Example === - {{{ - [..] - </fo:layout-master-set> - <fo:declarations> - <x:xmpmeta xmlns:x="adobe:ns:meta/"> - <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#";> - <rdf:Description rdf:about="" - xmlns:dc="http://purl.org/dc/elements/1.1/";> - <!-- Dublin Core properties go here --> - <dc:title>Document title</dc:title> - <dc:creator>Document author</dc:creator> - <dc:subject>Document subject</dc:subject> - </rdf:Description> - <rdf:Description rdf:about="" - xmlns:xmp="http://ns.adobe.com/xap/1.0/";> - <!-- XMP properties go here --> - <xmp:CreatorTool>Tool used to make the PDF</xmp:CreatorTool> - </rdf:Description> - </rdf:RDF> - </x:xmpmeta> - </fo:declarations> - <fo:page-sequence ... - [..] - }}} - <!> {{{fo:declarations}}} __must__ be declared after {{{fo:layout-master-set}}} - ---- - == Implementation in Apache FOP == - - Currently, XMP support is only available for PDF output. - - Until recently, you could set some metadata information through FOP's FO!UserAgent by using its set*() methods (like setTitle(String) or setAuthor(String). These values are directly used to set value in the PDF Info object. Since PDF 1.4, adding metadata as an XMP document to a PDF is possible. That means that there are now two mechanisms in PDF that hold metadata. - - Apache FOP now synchronizes the Info and the Metadata object in PDF, i.e. when you set the title and the authort through the FO!UserAgent, the two values will end up in the (old) Info object '''and''' in the new Metadata object as XMP content. If instead of FO!UserAgent, you embed XMP metadata in the XSL-FO document (as shown above), the XMP metadata will be used as-is in the PDF Metadata object and some values from the XMP metadata will be copied to the Info object to maintain backwards-compatibility for PDF readers that don't support XMP metadata. - - The mapping between the Info and the Metadata object used by Apache FOP comes from the [http://www.iso.org/iso/en/CatalogueDetailPage.CatalogueDetail?CSNUMBER=38920&ICS1=37&ICS2=100&ICS3=99 PDF/A-1 specification]. For convenience, here's the mapping table: - - ||||'''Document information dictionary'''||||||'''XMP'''|| - ||'''Entry'''||''PDF type'''||''Property'''||'''XMP type'''||'''Category'''|| - ||Title||text string||dc:title||Text||External|| - ||Author||text string||dc:creator||seq Text||External|| - ||Subject||text string||dc:description{{{[}}}"x-default"{{{]}}}||Text||External|| - ||Keywords||text string||pdf:Keywords||Text||External|| - ||Creator||text string||xmp:!CreatorTool||Text||External|| - ||Producer||text string||pdf:Producer||Text||Internal|| - ||!CreationDate||date||xmp:!CreationDate||Date||Internal|| - ||!ModDate||date||xmp:!ModifyDate||Date||Internal|| - - Note: "Internal" in the Category column means that the user should not set this value. It is set by the application. - - Note: The "Subject" used to be mapped to '''dc:subject''' in the initial publication of PDF/A-1 (ISO 19005-1). In the "Technical Corrigendum 1" this was changed to map to '''dc:description{{{[}}}"x-default"{{{]}}}'''. - - == Properties sets == - Metadata is made of properties sets. - - Properties sets are: - ||<:>'''Set'''||<:>'''Namespace'''||<:>'''URI'''||<:>'''FOP support'''|| - ||Dublin core||dc||http://purl.org/dc/elements/1.1/||Partial|| - ||XMP basic||xmp||http://ns.adobe.com/xap/1.0/||Partial|| - ||XMP Rights Management||xmpRights||http://ns.adobe.com/xap/1.0/rights/||None|| - ||XMP Media Management||xmpMM||http://ns.adobe.com/xap/1.0/mm/||none|| - ||Adobe PDF Schema||pdf||http://ns.adobe.com/pdf/1.3/||partial|| - - === Dublin Core set === - ||<:>'''Property'''||<:>'''Comment'''||<:>'''FOP support for PDF output'''|| - ||dc:creator||refers to author||<#80FF80>Yes|| - ||dc:contributor|| ||<#FF8080>No|| - ||dc:coverage|| ||<#FF8080>No|| - ||dc:date|| ||<#FF8080>No|| - ||dc:description|| ||<#80FF80>Yes|| - ||dc:format|| ||<#FF8080>No|| - ||dc:identifier|| ||<#FF8080>No|| - ||dc:language|| ||<#FF8080>No|| - ||dc:publisher|| ||<#FF8080>No|| - ||dc:relation|| ||<#FF8080>No|| - ||dc:rights|| ||<#FF8080>No|| - ||dc:source|| ||<#FF8080>No|| - ||dc:subject|| ||<#FF8080>No|| - ||dc:title|| ||<#80FF80>Yes|| - ||dc:type|| ||<#FF8080>No|| - - === XMP basic set === - ||<:>'''Property'''||<:>'''Comment'''||<:>'''FOP support for PDF output'''|| - ||xmp:Advisory|| ||<#FF8080>No|| - ||xmp:BaseURL|| ||<#FF8080>No|| - ||xmp:!CreateDate||Generate an error (1)||<#FF8080>No|| - ||xmp:!CreatorTool|| ||<#80FF80>Yes|| - ||xmp:Identifier|| ||<#FF8080>No|| - ||xmp:Label|| ||<#FF8080>No|| - ||xmp:!MetadataDate|| ||<#FF8080>No|| - ||xmp:!ModifyDate||Generate an error (1)||<#FF8080>No|| - ||xmp:Nickname|| ||<#FF8080>No|| - ||xmp:Rating|| ||<#FF8080>No|| - ||xmp:Thumbnails|| ||<#FF8080>No|| - - (1) These properties are "Internal" properties and must not be set my the user. - - ---- - == Links == - * [http://partners.adobe.com/public/developer/en/xmp/sdk/XMPspecification.pdf XMP specification] - * http://dublincore.org/ - --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
