byte to pdf c# : Excel pdf bookmarks software control dll winforms azure html web forms DocBook-OpenJade-SGML-XML-HOWTO0-part1613

DocBook XML/SGML Processing Using OpenJade
Saqib Ali
<saqib@seagate.com>
Revision History
Revision v2.2.8
2003−07−16
Revised by: es
Added info about keeping JREs up−to−date forCocoon
Revision v2.2.7
2003−07−09
Revised by: es
Fixed broken links to LDP XSL and other LDP XSL spefic filenames.
Revision v2.2.6
2003−06−16
Revised by: sa
Verified the instruction against docbook XSL 1.57.
Revision v2.2.5
2003−05−16
Revised by: sa
Fixed the broken links in the external resources section.
Revision v2.2.4
2003−04−20
Revised by: sa
Updated links to the new Demo Site. Added new links to the resources section.
Revision v2.2.3
2002−11−22
Revised by: sa
Added the suggestion made by users. Added new links to the resources section.
Revision v2.2.2
2002−10−09
Revised by: as
This update fixes a few more typos, removes a couple of spaces that make the HTML rendering look odd.
Revision v2.2.1
2002−10−09
Revised by: sa
Fixed the URL to the Sample Files.
Revision v2.2
2002−09−29
Revised by: as
Minor corrections to the Cocoon section.
Revision v2.1
2002−09−15
Revised by: sa
Minor corrections to the Cocoon section.
Revision v2.0
2002−09−10
Revised by: sa
Added the section on serving DocBook XML 4.1.2 content using Tomcat + Cocoon.
Revision v1.5
2002−08−11
Revised by: sa
Added the XML section and the sample XML file.
Revision v1.4
2002−08−08
Revised by: sa
Many valuable modifications/corrections suggested by Lloyd D Budd. Thanks Lloyd. :)
Revision v1.3
2002−08−02
Revised by: sa
Added the "Additional Resources" section.
Revision v1.2
2002−07−23
Revised by: sa
Added the section on converting HTML −> PDF using HTMLDOC. Thanks to Luc De Louw for the
suggestion.
Excel pdf bookmarks - add, remove, update PDF bookmarks in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your C# Project with Rapid PDF Internal Navigation Via Bookmark and Outline
add bookmarks to pdf; convert word to pdf with bookmarks
Excel pdf bookmarks - VB.NET PDF bookmark library: add, remove, update PDF bookmarks in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your VB.NET Project with Rapid PDF Internal Navigation Via Bookmark and Outline
adding bookmarks in pdf; adding bookmarks to pdf reader
Revision v1.1
2002−07−19
Revised by: KET
Fixed grammatical errors, numbered processes.
Revision v1.0
2002−06−29
Revised by: sa
Initial public release.
This HOWTO explains setting up OpenJade to process SGML/XML DocBook documents.
VB.NET PDF File Compress Library: Compress reduce PDF size in vb.
document file. Remove bookmarks, annotations, watermark, page labels and article threads from PDF while compressing. Also a preview
add bookmark to pdf reader; how to bookmark a pdf file in acrobat
C# PDF File Split Library: Split, seperate PDF into multiple files
Split PDF file by top level bookmarks. The following C# codes explain how to split a PDF file into multiple ones by PDF bookmarks or outlines.
create bookmarks pdf; split pdf by bookmark
Table of Contents
1. Introduction.....................................................................................................................................................1
1.1. Copyright and License......................................................................................................................1
1.2. Credits...............................................................................................................................................1
1.3. What is DocBook?............................................................................................................................1
1.4. What is DSSSL?...............................................................................................................................2
1.5. What do we need?.............................................................................................................................2
1.6. Assumptions......................................................................................................................................2
2. Requirements...................................................................................................................................................3
2.1. Pre−requirements..............................................................................................................................3
2.2. OpenJade...........................................................................................................................................3
2.3. DocBook DTDs................................................................................................................................3
2.4. ISO Entities.......................................................................................................................................3
2.5. Norman Walsh's DSSSL...................................................................................................................3
2.6. LDP customized DSL stylesheets.....................................................................................................3
2.7. HTMLDOC (Optional).....................................................................................................................4
2.8. Norman Walsh's XSL (Optional)......................................................................................................4
2.9. LDP Customized XSL (Optional).....................................................................................................4
3. Installing Processing Tools − OpenJade.......................................................................................................5
3.1. Installing OpenJade...........................................................................................................................5
3.2. Installing Norman Walsh's DSSSL...................................................................................................5
3.3. Installing DocBook DTDs................................................................................................................6
3.4. Installing the ISO Entities.................................................................................................................6
3.5. Installing the LDP DSL....................................................................................................................7
3.6. Installing HTMLDOC.......................................................................................................................7
4. Using OpenJade..............................................................................................................................................9
4.1. Processing SGML.............................................................................................................................9
4.1.1. Setting the SGML_CATALOG_FILES Environmental Variable for SGML.........................9
4.1.2. SGML to HTML.....................................................................................................................9
4.1.3. SGML to RTF.........................................................................................................................9
4.2. Processing XML...............................................................................................................................9
4.2.1. Setting the SGML_CATALOG_FILES Environmental Variable for XML...........................9
4.2.2. XML to HTML......................................................................................................................10
4.2.3. XML to RTF..........................................................................................................................10
4.3. HTML to PDF (optional)................................................................................................................10
5. Serving DocBook 4.1.2 XML........................................................................................................................11
5.1. Tomcat + Cocoon............................................................................................................................11
5.2. Installing Norman Walsh's XSL.....................................................................................................12
5.3. Installing LDP XSL........................................................................................................................12
5.4. Setting up sitemap.xmap.................................................................................................................12
5.5. Accessing DocBook 4.1.2 XML Content from a Web Browser.....................................................13
6. Further Information.....................................................................................................................................14
6.1. News groups....................................................................................................................................14
6.2. Mailing Lists...................................................................................................................................14
DocBook XML/SGML Processing Using OpenJade
i
VB.NET PDF File Split Library: Split, seperate PDF into multiple
Demo Code in VB.NET. The following VB.NET codes explain how to split a PDF file into multiple ones by PDF bookmarks or outlines.
create bookmarks pdf files; create bookmark pdf file
C# PDF File Compress Library: Compress reduce PDF size in C#.net
NET framework. Remove bookmarks, annotations, watermark, page labels and article threads from PDF while compressing. C# class demo
acrobat split pdf bookmark; how to add bookmarks to pdf files
Table of Contents
6. Further Information
6.3. IRC..................................................................................................................................................14
6.4. Web Sites........................................................................................................................................14
6.5. XML Authoring / Modeling Applications......................................................................................15
DocBook XML/SGML Processing Using OpenJade
ii
XDoc.Excel for .NET, Comprehensive .NET Excel Imaging Features
zooming & rotation; Outlines, bookmarks, & thumbnail display; Integrated annotation; More about Web Viewer ▶. Excel Convert. Convert Excel to PDF; Convert Excel
add bookmarks to pdf preview; export pdf bookmarks
.NET PDF SDK - Description of All PDF Processing Control Feastures
bookmarks, & thumbnail display; Integrated annotation; More about Web Viewer ▶. Conversion. PDF Create. Create PDF from Word (docx, doc); Create PDF from Excel
how to add a bookmark in pdf; create bookmarks in pdf
1. Introduction
Some Acronyms:
SGML − Standard Generalized Markup Language
1. 
XML − Extensible Markup Language
2. 
RTF − Rich Text Format
3. 
HTML − HyperText Markup Language
4. 
PDF − Portable Document Format
5. 
The objective of this document is to setup OpenJade to convert DocBook 3.2 and 4.2 Standard Generalized
Markup Language (SGML) and Extensible Markup Language (XML) documents to HyperText Markup
Language (HTML), Rich Text Format (RTF), and Portable Document Format (PDF).
1.1. Copyright and License
This document is Copyright 2001 by Saqib Ali. Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, Version 1.1 or any later version
published by the Free Software Foundation; with no Invariant Sections, with no Front−Cover Texts, and with
no Back−Cover Texts. A copy of the license is available at http://www.gnu.org/copyleft/fdl.html.
1.2. Credits
All praise is due to Allah, The Lord of the Worlds. All credits go to Allah. Any mistake in this document is
my own fault.
Additionally, I would like to acknowledge the following people for their valuable contributions to this
document:
Eric Safern <esafern (at) lrn.com> − For updates related to Cocoon and JRE.
http://www.timebytes.com/
1. 
Greg Ferguson <gferg (at) hoop.timonium.sgi.com> − for very helpful
hints/suggestions on the docbook mailing list
2. 
Kristin Thomas <kristint (at) us.ibm.com> − For the initial review of this document.
3. 
Luc de Louw <luc (@) delouw.ch> − For suggesting the HTMLDOC (PDF −> HTML)
section.
4. 
Lloyd D Budd <ldp (@) foolswisdom.org> − For suggestions on improving most of the
sections of the document.
5. 
Andrew Shugg <andrew (@) neep.com.au> − For fixing errors in the ver 2.0 of this
document. Neep Consulting
6. 
1.3. What is DocBook?
DocBook is a document type definition (DTD). A DTD defines the syntax of a document. DocBook describes
the types of structure and formats to use in technical documents. It is commonly used because of its simplicity
and completeness.
1. Introduction
1
XDoc.Word for .NET, Advanced .NET Word Processing Features
& rotation; Outlines, bookmarks, & thumbnail display; Integrated annotation; More about Web Viewer ▶. Conversion. Word Create. Create Word from PDF; Create Word
bookmark a pdf file; bookmarks in pdf
XDoc.PowerPoint for .NET, All Mature Features Introductions
& rotation; Outlines, bookmarks, & thumbnail display; Integrated annotation; More about Web Viewer ▶. PowerPoint Convert. Convert PowerPoint to PDF; Convert
pdf bookmark; how to create bookmark in pdf with
A DTD defines the syntax of a document − essentially it is a 'rule book' that describes the sets of tags and
attributes that will be used to describe specific kinds of content. So DocBook is a "rule book" that is used for
writing documents. Every tag that is used in writing the document, must be defined very specifically and
formally in the DTD.
1.4. What is DSSSL?
A Document Style Semantics and Specification Language (DSSSL) defines how to convert an Standard
Generalized Markup Language (SGML) document into a human−readable viewing format such as HTML,
RTF and PDF.
1.5. What do we need?
The tools needed to set up OpenJade for converting SGML and XML are:
OpenJade
• 
DocBook DTDs
• 
ISO Entities
• 
Norman Walsh's DSSSL
• 
LDP DSL
• 
HTMLDOC (optional)
• 
Norman Walsh's XSL (optional)
• 
LDP XSL (optional)
• 
Note
All of these packages are free and available for download on the net. The next chapter explains how to
download these packages.
1.6. Assumptions
This document assumes that you have the following already installed on your system.
gzip − available from http://www.gnu.org/directory/
• 
gcc and GNU make − available from http://www.gnu.org/directory/
• 
unzip − available from http://www.info−zip.org/pub/infozip/
• 
Standard Unix utilities − tar, mkdir, mv ...
• 
DocBook XML/SGML Processing Using OpenJade
1. Introduction
2
2. Requirements
You'll have to download and compile only one package (OpenJade). This HOWTO will explain the
compilation process, but you should be familiar with installing from source code.
Most of the packages that we need are located at The Linux Documentation Project (TLDP) website.
2.1. Pre−requirements
Create a directory /tmp/downloads. We will use this directory to store the downloaded source code.
2.2. OpenJade
OpenJade will be used to process DocBook documents. OpenJade can be downloaded from:
http://openjade.sourceforge.net/.
At the time of writing this document OpenJade 1.3.1 was available. Download the openjade−1.3.x.tar.gz file.
2.3. DocBook DTDs
All the DocBook DTDs are available from The Linux Documentation Project website at
http://www.tldp.org/authors/index.html#resources
Please download DocBook SGML v4.1, DocBook SGML v3.1, and DocBook XML v4.1.2.
Note
Please download all the zip archives.
2.4. ISO Entities
The Linux Documentation Project has packaged all the Entities into one big tar file and placed it at
http://www.tldp.org/authors/tools/entities.tar.gz for the convenience of the users. Thanks to TLDP for this.
2.5. Norman Walsh's DSSSL
Norman Walsh's DSSSL can be downloaded from the DocBook project website at
http://sourceforge.net/project/showfiles.php?group_id=21935.
At the time of writing this document docbook−dsssl−1.7.6 was available.
2.6. LDP customized DSL stylesheets
LDP DSL is a customized style sheet used by The Linux Documentation Project (TLDP). It is an extension to
Norman Walsh's DSSSL. It add things like background and Table of Contents. It can be downloaded from
http://www.tldp.org/authors/tools/ldp.dsl.
2. Requirements
3
ldp.dsl requires Normal Walsh's DSSSL
2.7. HTMLDOC (Optional)
HTMLDOC can be used for converting the HTML to PDF. If you would like to produce PDF documents,
please download HTMLDOC from http://www.easysw.com/htmldoc/software.php
2.8. Norman Walsh's XSL (Optional)
This is not necessary. But if you would like to serve DocBook 4.1.2 XML content using Tomcat + Cocoon,
you will need Norman Walsh's XML Style Sheets.
The Style Sheets are available for download at http://sourceforge.net/projects/docbook/.
Please download the package called docbook−xsl.
Note
Recently docbook−xsl ver. 1.57.0 was released. This document is verified with the latest version, and
appropriate modifications have been made. If you still encounter any errors please email me @
<saqib@seagate.com>
2.9. LDP Customized XSL (Optional)
Also download the LDP Customized XSL from http://my.core.com/~dhorton/docbook/tldp−xsl/
DocBook XML/SGML Processing Using OpenJade
2. Requirements
4
3. Installing Processing Tools − OpenJade
In this section we will install all the tools in the appropriate directories. All the tools go in the
/usr/local/dbtools/ directory. Create this directory using the following command:
# mkdir /usr/local/dbtools
3.1. Installing OpenJade
This process is the easy part, but the most time consuming one too. Keep in mind that OpenJade take a long
time to compile. To install OpenJade, complete the following steps:
Change directories to /tmp/downloads.
# cd /tmp/downloads
1. 
Unzip the file.
# gzip −d openjade−1.3.x.tar.gz
2. 
Untar the file.
# tar −xvf openjade−1.3.x.tar
3. 
Change directories to openjade−1.3
# cd openjade−1.3.x
4. 
Run the ./configure command.
# ./configure −−prefix=/usr/local/dbtools/openjade
5. 
Run the make command.
# make
6. 
Run the make install command. After this step the OpenJade binaries will be installed under
/usr/local/dbtools/openjade.
# make install
7. 
Copy the dsssl directory from /tmp/downloads/openjade−1.3.x to
/usr/local/dbtools/openjade
# cp −dpR dsssl /usr/local/dbtools/openjade/
8. 
3.2. Installing Norman Walsh's DSSSL
In this step we will install Norman Walsh's DSSSL in an appropriate place. The DSSSL does not have to be
compiled.
Change directories to /tmp/downloads
# cd /tmp/downloads
1. 
Unzip the file.
# gzip −d docbook−dsssl−1.76.tar.gz
2. 
3. Installing Processing Tools − OpenJade
5
Untar the file.
# tar −xvf docbook−dsssl−1.76.tar
3. 
Move the file to the /usr/local/dbtools/docbook−dsssl.
# mv docbook−dsssl−1.76 /usr/local/dbtools/docbook−dsssl
4. 
3.3. Installing DocBook DTDs
In this section we will install the DocBook DTDs.
Change directories to /usr/local/dbtools.
# cd /usr/local/dbtools
1. 
Create three new directories called dtd3.1, dtd4.1, and dtd4.1.2.
# mkdir dtd3.1
# mkdir dtd4.1
# mkdir dtd4.1.2
2. 
Change directories to the dtd3.1.
# cd dtd3.1
3. 
Unzip the file DocBook SGML v3.1 in this directory.
# unzip /tmp/downloads/docbk31.zip
4. 
Change directories to the dtd4.1.
# cd ../dtd4.1
5. 
Unzip the file DocBook SGML v4.1 in this directory.
# unzip /tmp/downloads/docbk41.zip
6. 
Change directories to the dtd4.1.2.
# cd ../dtd4.1.2
7. 
Unzip the file DocBook XML v4.1.2 in this directory.
# unzip /tmp/downloads/docbk412.zip
8. 
3.4. Installing the ISO Entities
In this section we will install the ISO entities that we downloaded from the LDP website.
First we install the ISO Entities for the 3.1 SGML DTD.
Change directories to the /usr/local/dbtools/dtd3.1 directory.
# cd /usr/local/dbtools/dtd3.1
1. 
Copy /tmp/download/entities.tar.gz to this directory.
# cp /tmp/download/entities.tar.gz .
2. 
Unzip the file.
3. 
DocBook XML/SGML Processing Using OpenJade
3. Installing Processing Tools − OpenJade
6
Documents you may be interested
Documents you may be interested