pdf generation with css - oxygen xml editor · 2015-12-08 · css-based pdf publishing advantages:...

PDF generation with CSS

Presenter:

Radu [email protected]@radu_coravu

Copyright @ Syncro Soft, 2014. All rights reserved.Copyright @ Syncro Soft, 2014. All rights reserved.

DITA for Software Documentation DITA for Software Documentation

Problems with XSL-FO PDF generation

You need:● Good XSLT knowledge to make customizations● Know how to create a plugin or a customization

folder for the DITA OT● Where to find various parameters and

templates which need to be overwritten● XSL-FO knowledge to make customizations● Compatibility problems with various DITA OT

versions



Our particular problem with XSL-FO PDF generation

● Lots of customization questions from our users● For each question we lose a lot of time hunting

down particular changes which should be made● Some users just give up either the publishing or

the editing solution



CSS-based PDF publishing

Advantages:● Lots more end users are comfortable with CSS● Use CSS both for XHTML and PDF styling● CSS is much easier to learn than XSL-FO● Majority of users do not need completely

different styling for the Web or print outputs● Consistent editing/publishing solution



CSS-based PDF publishing

Disadvantages:● Only commercial engines like Antenna House

and Prince XML are available



Steps of current DITA OT PDF publishing solution

1.Creates a single file containing the resolved, or merged DITA map with all its topics

2.Creates a file derived from the "merged" DITA map file, containing also the indexterms

3.Apply XSLT processing to get the final FO file and uses PDF processor to convert the FO file into PDF.



1. Create a single file containing the resolved, or "merged" DITA map with all its topics



2. Create a file derived from the "merged" DITA map file, containing also the indexterms



3. Apply XSLT processing to get the final FO file



Steps of the CSS PDF generator plugin

● Duplicate and re-use first two steps from the existing PDF publishing

● Extra XSLT stage● Add CSSs to the merged XML output and

process



XSLT stage

TOC processing:● Mark every topic reference to a chapter● Cleaning the TOC, keeping only the navtitles.● Creates an entry in the TOC pointing to the ID

of the index section.



XSLT stage

Content processing:● Mark each chapter● If there are relative image references, makes

them absolute

● Convert the comments and change tracking processing instructions to elements



XSLT stage

Index preparation:● Generates an ID to each of the indexterm from

the content.● Makes a reference to the generated ID from the

index structure.



CSS styling examples (1)

Setting page margins and size:

@page{ padding-top:0.2em; padding-bottom:0.2em; size: 8.27in 11.69in; margin: 0.75in 0.25in 0.75in 1in; }




Page breaks:

*[class ~= "topic/topic"][is-chapter = "true"]{ page-break-before:always; }



CSS styling examples (3)Page numbers:

@page :left{ @top-left { content: string(maptitle) " | " string(chaptertitle) " | " counter(page); font-size:8pt; } }@page :right{ @top-right { content: string(maptitle) " | " string(chaptertitle) " | " counter(page); font-size:8pt; }}




Setting the image resolution:

@media print{ *[class ~= "map/map"] { prince-image-resolution: 196dpi; } }




Links:

*[class ~= "topic/xref"][href]:after { content: " [page " target-counter(attr(href), page) "]"; link: attr(href); }




Table of contents:

*[class ~= "map/map"] > map { display: block; page: table-of-contents; counter-reset: page 1; }



Publishing Capabilities

● Publish with Prince XML.● Publish with Antenna House Formatter.



Availability

https://github.com/oxygenxml/dita-css



Future plans● Try to establish a community to share the work

load

● Bring the new plugin's output quality to the same level of compliance with the current PDF generation plugin

● Write some decent documentation for it



Thank You!

Radu [email protected]@radu_coravu

Questions?

pdf generation with css - oxygen xml editor · 2015-12-08 · css-based pdf publishing advantages:...

Documents

HTML, XHTML, CSS, & JAVAScript ~ an introduction ~

XHTML y CSS - Deustoe-ghost.deusto.es/docs/2008/cursillos/xhtml/xhtml-css... · 2017-03-03 · 6/07/08 3 Introducción (I) HTML: HyperText Markup Language – Lenguaje de etiquetas

_ HTML, XHTML & CSS

Cmsc 100 xhtml and css

Html css-xhtml

HTML, XHTML, and CSS Sixth Edition Chapter 1 Introduction to HTML, XHTML, and CSS

HTML, XHTML, CSS, & JAVAScript ~ an introduction ~

Appunti e reference di XHTML e CSS

HTML, Javascript, Xhtml & Css

XHTML and How to Write It€¦ · Because CSS is a mechanism for styling XHTML, you can’t start using CSS until you have a solid grounding in XHTML. And what, exactly, is XHTML?

xhtml y css

CSS for Styling

Beginning XHTML and CSS

XHTML, CSS & Templates - webgui.org · • XHTML 1.1 • Based off of the Strict doctype from XHTML 1.0 • All layout and style is controlled with CSS • Breaks tags into modules

XHTML & CSS

CSS Styling Introduction - ucg.ac.me › skladiste › blog_4051 › objava...CSS Styling Introduction About the Course CSS Styling 1. CSS Overview 2. CSS Presentation 3. CSS Display

XHTML and CSS

1 HTML-CSS-XHTML. 2 HTML: HyperText Markup Language (Markup balisage). Sert à structurer les pages html4.01 XHTML: eXtensible HTML xhtml 1.0 CSS: Cascading

03 Tutorial XHTML CSS - Ivailo Chakarov- Resources · Using and Applying CSS to XHTML The purpose of this tutorial is to build upon the introduction to XHTML 1.0 ... Tutorial 03 XHTML

Livro Html With Css e Xhtml

Hlml, Xhtml and Css 4

Introduction to XML, XHTML and CSS

XHTML and CSS Introduction to XHTML and CSS Bharti Patel 1 phones off (please)

Styling with CSS

Html, xhtml, and css bible, 3rd edition

CSS Dasar #4 : Font Styling

CSS Styling

XHTML/CSS Week 3. This Week Quiz to revise last week (XHTML and DW) CSS - Part 2 Using HTML Tables

Beginning HTML with CSS and XHTML€¦ · Beginning HTML with CSS and XHTML Modern Guide and Reference David Schultz and Craig Cook

M0114002012012407302_Understanding HTML, XHTML, CSS, JavaScript2

Intro to XHTML/CSS

MELJUN CORTES CSS Styling

Cascading Style Sheets (CSS) David Pinto. Web Standards XHTML 1.0 or higher XHTML 1.0 or higher CSS Level 1 & CSS Level 2 CSS Level 1 & CSS Level 2 DOM

Web Sites with XHTML and CSS

css and xhtml