Raphael Cotty wrote:
> I am evaluating xxe using DITA framework and I am so far very impress by
> how fast I manage to work with it.
> 
> I am wondering how I can customise the front page of the pdf
> transformation.
> I'd like to add the logo of the company for example.
> 

--> Easy, document-specific, method:

Don't give your DITA map a title attribute or child element. Instead
write a topic which will act as a front page and then reference this
topic in the first topicref of your map.



--> Generic methods. Require some expertise.

XMLmind XML Editor (and also XMLmind XSL Utilty) integrates XMLmind DITA
Converter.

Therefore answering your question involves two steps:

[1] Write some code which customizes the front page.
[2] Force XMLmind XML Editor to take in account your customization.

There are two ways to do that:

Method A
--------

[1] Write a custom front page in XSL-FO (attached file may be used as an
example). Let's call this file C:\temp\font_page.fo.

[2] Open your DITA map (or bookmap), then select Options|Preferences,
"Customize Configuration" | "Change Document Conversion Parameters"

[3] Select "Convert to PDF, Postcript".

[4] Add parameter:

title-page

with value:

file:///temp/font_page.fo

[5] Convert your DITA map to PDF. Note that, for this to work, your DITA
map must *also* have a title attribute or child element (which is used
in running headers).

References:

http://www.xmlmind.com/ditac/_distrib/doc/manual/xsltParams.html#xsltParams__title-page

http://www.xmlmind.com/xmleditor/_distrib/doc/help/com.xmlmind.xmleditapp.kit.part.ConversionParametersEditor.html

--------
Method B
--------

[1] Customize the stock DITA configuration as explained in XMLmind XML
Editor - Configuration and Deployment, Customizing an existing
configuration, Customizing the XSLT style sheets used in the Convert
Document submenu

http://www.xmlmind.com/xmleditor/_distrib/doc/configure/customize_xslt.html

[2] Your customization mainly consists in a fo.xsl ``driver'' file,
which generates a more elaborate front page out of the title and
metadata of the DITA map.

The principle of this fo.xsl ``driver'' file is explained in
XMLmind DITA Converter Manual, Customizing the output of XMLmind DITA
Converter, Simple customization,  Customizing the look of the PDF files
generated by ditac

http://www.xmlmind.com/ditac/_distrib/doc/manual/manual-6.html#customAttributeSet

[3] In your case, the fo.xsl ``driver'' file must override some of the
XSLT2 templates found in
XXE_install_dir/addon/config/dita/xsl/fo/ditac_titlePage.xsl

You need to read and understand the contents of ditac_titlePage.xsl in
order to implement your fo.xsl ``driver'' file.

Method A and B are pretty complex (B much more than A) but please keep
in mind that they are generally implemented by XML/DITA/XSL experts who
are paid to do that. I mean, unfortunately method A and B are out of the
reach of a technical writer.



---
PS: See also "Customization Service" --
http://www.xmlmind.com/xmleditor/customization_service.html







-------------- next part --------------
A non-text attachment was scrubbed...
Name: pixware_title_page.fo
Type: text/x-xslfo
Size: 1633 bytes
Desc: not available
Url : 
http://www.xmlmind.com/pipermail/xmleditor-support/attachments/20100323/2b42a2df/attachment-0001.fo
 

Reply via email to