An OASIS White Paper 
Best Practices Guide for Delivering DITA-Authored Help  
OASIS DITA Technical Committee Online Help Subcommittee 
November 20, 2008 
Pdf page to powerpoint - C# Create PDF from PowerPoint Library to convert pptx, ppt to PDF in C#.net, ASP.NET MVC, WinForms, WPF
Online C# Tutorial for Creating PDF from Microsoft PowerPoint Presentation
adding pdf to powerpoint slide; how to convert pdf into powerpoint
Pdf page to powerpoint - VB.NET Create PDF from PowerPoint Library to convert pptx, ppt to PDF in vb.net, ASP.NET MVC, WinForms, WPF
VB.NET Tutorial for Export PDF file from Microsoft Office PowerPoint
convert pdf to powerpoint; convert pdf file to powerpoint online
2$
6
,
6
2
U
JDQ
L
]D
WL
RQ
I
R
U
W
KH
$GYDQFHPHQ
W
R
I6
WU
XF
W
X
UHG
,Q
I
R
U
PD
WL
RQ
6
W
DQGDU
GV
LV
D
QR
W
I
R
U
S
U
R
I
LW

L
Q
W
HU
QD
WL
RQD
O
FRQV
R
UWL
XP
W
KD
W
G
UL
YHV
W
KH
GHYH
O
R
S
PHQ
W

FRQYHU
JHQFH

DQG
DGR
S
WL
RQ
R
I
H
E
XVL
QHVV
V
W
DQGDU
GV
0HP
E
HUV
W
KHPVH
O
YHV
VH
W
W
KH
2$
6
,
6
W
HFKQ
L
FD
O
DJHQGD

XVL
QJ
D
OL
JK
W
Z
HL
JK
W

R
S
HQ
S
U
RFHVV
H[
S
UHVVO\
GHVL
JQHG
W
R
S
U
RPR
W
H
L
QGXV
WU\
FRQVHQVXV
DQG
XQ
LW
H
G
LV
S
DUD
W
H
H
II
R
UW
V
7
KH
FRQV
R
UWL
XP
S
U
RGXFHV
R
S
HQ
V
W
DQGDU
GV
I
R
U
:
H
E
VHU
Y
L
FHV

VHFX
ULW
\

H
E
XVL
QHVV

DQG
V
W
DQGDU
G
L
]D
WL
RQ
H
II
R
UW
V
L
Q
W
KH
S
X
E
OL
F
VHF
W
R
U
DQG
I
R
U
D
SS
OL
FD
WL
RQ

V
S
HF
L
I
L
F
PDU
NH
W
V
2$
6
,
6Z
DV
I
RXQGHG
L
Q

0R
UH
L
Q
I
R
U
PD
WL
RQ
FDQ
E
H
I
RXQG
RQ
W
KH
2$
6
,
6Z
H
E
VLW
H
D
W
K
WW
S ZZZ
RDVLV

R
S
HQR
U
J
7
KH
S
X
U
S
R
VH
R
I
W
KH
2$
6
,
6
'
,
7
$
7
HFKQ
L
FD
O
&
RPP
LWW
HH
7&
LV
W
R
GH
I
L
QH
DQG
PDL
Q
W
DL
Q
W
KH
'
DU
Z
L
Q
,Q
I
R
U
PD
WL
RQ
7
\
S
L
QJ
$
U
FK
LW
HF
W
X
UH
'
,
7
$
DQG
W
R
S
U
RPR
W
H
W
KH
XVH
R
I
W
KH
DU
FK
LW
HF
W
X
UH
I
R
U
F
UHD
WL
QJ
V
W
DQGDU
G
L
Q
I
R
U
PD
WL
RQ
W
\
S
HV
DQG
GRPDL
Q

V
S
HF
L
I
L
F
PDU
NX
S
YRFD
E
X
O
DULHV
7
KH
7
UDQVO
D
WL
RQ
6
X
E
FRPP
LWW
HH
GH
I
L
QHV
E
HV
W
S
UDF
WL
FHV
DQG
JX
L
GH
OL
QHV
I
R
U
'
,
7
$
DX
W
KR
UL
QJ

WUDQVO
D
WL
RQ
DQG
O
RFD
OL
]D
WL
RQ

DQG
UHFRPPHQGV
V
R
O
X
WL
RQV
I
R
U
L
QGXV
WU\
UH
T
X
LUHPHQ
W
V
I
R
U
FRQVL
GHUD
WL
RQ
E
\
W
KH
2$
6
,
6
'
,
7
$
7& 7
KH
J
U
RX
S
UHFRPPHQGV
Z
L
GHV
S
UHDG
DGR
S
WL
RQ
R
I
W
KHVH
FRQFH
S
W
V
W
K
U
RXJK
OLDLV
RQV
Z
LW
K
L
QGXV
WU\

R
W
KHU
V
W
DQGDU
GV

DQG
S
U
RY
L
GHUV
R
I
FRPPHU
F
LD
O
DQG
R
S
HQ
V
RX
U
FH
W
RR
OV
  

'
,
7
$
+H
O
S
VB.NET PDF Page Delete Library: remove PDF pages in vb.net, ASP.
XDoc.PDF ›› VB.NET PDF: Delete PDF Page. using RasterEdge.Imaging.Basic; using RasterEdge.XDoc.PDF; How to VB.NET: Delete a Single PDF Page from PDF File.
convert pdf to powerpoint slides; how to convert pdf into powerpoint on
C# PDF Page Insert Library: insert pages into PDF file in C#.net
C# programmers are capable of adding and inserting (empty) PDF page or pages from various file formats, such as PDF, Tiff, Word, Excel, PowerPoint, Bmp, Jpeg
convert pdf slides to powerpoint online; how to convert pdf file to powerpoint presentation
Contents
Introduction to the DITA Help Best Practices Guide........................................................2
DITA and User Assistance....................................................................................................3
Definition of DITA Help..........................................................................................................................3
Developing DITA-based Help for Existing Help Environments.......................................4
Arbortext Digital Media Publisher...........................................................................................................4
Eclipse Help.............................................................................................................................................9
CSHelp Plug-in............................................................................................................................9
Eclipse_CSH Plug-in for Dynamic Context-Sensitive Help......................................................11
Eclipse Help...............................................................................................................................16
Leximation AIR Help Plug-in................................................................................................................19
Microsoft HTMLHelp............................................................................................................................22
Context-Sensitive Help using the Enhanced HTML (htmlhelp2) Plug-In.................................22
The DITA Open Toolkit HTMLHelp Transform .......................................................................23
Developing Custom DITA-based Help Systems...............................................................26
DHTML Effects in HTML Generated from DITA.................................................................................26
DITA-OT Plug-ins..................................................................................................................................28
HTMLSearch Plug-in.................................................................................................................28
TOCJS and TOCJSBIS Plug-ins................................................................................................36
Dynamic Rendering of DITA into XHTML...........................................................................................41
JavaScript-Based Context Sensitive Help..............................................................................................42
WinANT Options Supporting HTML-Based Output.............................................................................45
WinANT Options Supporting Microsoft
®
HTML Help .......................................................................47
Developing DITA-based Help for Existing Help Authoring Tools..................................50
Converting DITA Content to WebHelp using RoboHelp
®
....................................................................50
Draft | TOC | 1
VB.NET PDF Page Insert Library: insert pages into PDF file in vb.
PDF Pages. |. Home ›› XDoc.PDF ›› VB.NET PDF: Insert PDF Page. Professional .NET PDF control for inserting PDF page in Visual Basic .NET class application.
convert pdf slides to powerpoint; converting pdf to powerpoint slides
C# PDF Page Delete Library: remove PDF pages in C#.net, ASP.NET
Pages. |. Home ›› XDoc.PDF ›› C# PDF: Delete PDF Page. Demo Code: How to Delete a Single PDF Page from PDF File in C#.NET. How
how to change pdf to powerpoint format; how to convert pdf into powerpoint presentation
Introduction to the DITA Help Best Practices Guide
This topic introduces the DITA Help Best Practices Guide.
When DITA was first described to the world in the article Introduction to the Darwin Information Typing Architecture
by Don Day, Michael Priestley, and Dave A. Schell, specific reference was made to Help in the opening definition: “and
for using that content in delivery modes such as online help”. DITA was designed with Help systems in mind.
Indeed, from the release of OASIS DITA 1.0, Help outputs have been supported as an output. However, Help is a
somewhat amorphous term; it means different things to different people. Early adopters of DITA found that while Help
documents in common formats like Microsoft
®
HTML Help, HTML and Eclipse Help could be created, some of the
accustomed features were absent. Popups couldn't be easily implemented, window layouts couldn't be easily defined,
and a tri-pane HTML output seemed impossible. Most importantly, context-sensitivity for most Help formats didn't
seem to be supported.
The OASIS DITA Help Subcommittee was formed to address some of the perceived shortcomings of DITA for authoring
Help content. The Subcommittee will recommend changes to the DITA standard to further improve functionality in time
for DITA 1.3. In the interrim, this Best Practices Guide provides explanations of the current best practice for using DITA
for Help authoring, and makes practical recommendations that can be applied today.
2 | Draft | Introduction to the DITA Help Best Practices Guide
C# PDF File & Page Process Library SDK for C#.net, ASP.NET, MVC
PowerPoint, VB.NET Tiff, VB.NET Imaging, VB.NET OCR, VB.NET Twain, VB.NET Barcode Read, VB.NET Barcode Generator, view less. C# PDF - Modify PDF File and Page
how to change pdf to powerpoint; convert pdf to editable ppt online
How to C#: Overview of Using XDoc.PowerPoint
Create and Edit PowerPoint Page and File. Tell C# users Please click to see details. Annotate PowerPoint Page. Various annotation objects
convert pdf into powerpoint online; and paste pdf to powerpoint
DITA and User Assistance
This topic describes the relationship between DITA and forms of user assistance, Help systems in particular.
DITA can be used in the process of creating user assistance, and especially of Help systems, but is not currently (and
may never be) used as a delivery format for user assistance itself.
DITA is a storage and authoring format, not a delivery format; it is a presentation-neutral format. The separation of
content and form is fundamental to DITA's design; content is written in DITA and must be transformed to a reading
format before it can be delivered to the reader.
In principle, content written in DITA can be transformed to any reading format. In practice, it's not that simple. Before
DITA can be transformed, a transformation process has to be devised. Many DITA authoring and publishing tools come
with standard transformers for most common delivery formats, such as PDF, RTF and HTML. The DITA Open Toolkit,
an open source collection of utilities and documentation to help writers work with DITA, includes basic transformers
for PDF, RTF, HTML, DocBook, Eclipse Help, and Microsoft
®
HTML Help.
User assistance content is not defined by its format. A document in Microsoft HTML Help format isn't necessarily a
Help system; user assistance is defined by the nature of the content. Conversely, user assistance content doesn't have to
be delivered in a traditional Help format.
DITA promotes a single-source approach to documentation, so user assistance may commonly be one of a number of
deliverables produced from a repository of information topics. The process of producing simple Help systems from
DITA content using the standard DITA Open Toolkit transformers is straight-forward. It is a little more complicated to
deliver such DITA-generated content for context-sensitive Help, but still readily achievable. Likewise, in principle, it
is a trivial matter to incorporate DITA content into embedded user assistance and user interface elements using standard
XML tools and techniques. There is not yet a standard approach to user assistance, so there is also no standard way of
using DITA in this way. Different organisations tend to develop their own individual, custom approaches, using in-house
technical expertise to do so.
Moving beyond simple Help systems, however, is currently difficult, but not impossible. The DITA Technical Committee
is developing some enhancements to the DITA standard to allow these processes to be simplified. However, the apparent
simplicity or complexity of using DITA for Help authoring will be in future determined by the capabilities of DITA
editing and publishing tools. When it comes down to it, DITA is just a standard, and good tools are needed to work with
good standards.
Definition of DITA Help
This topic details how the OASIS DITA Help Subcommittee defines the term DITA Help.
DITA Help, as defined by the OASIS DITA Help SC (DHSC), is:
A set of recommendations for the design and implementation of commonly recognized user assistance components using
the DITA architecture. These components include, but are not limited to, navigation components, context-sensitive
linking, embedded Help, browse sequences, associative links and window definitions. These recommendations can be
used as a foundation for the development of authoring models and tools to support solutions in a variety of formats and
for a variety of platforms.
Draft | DITA and User Assistance | 3
C# PowerPoint - Sort PowerPoint Pages Order in C#.NET
C#.NET. Support Customizing Page Order of PowerPoint Document in C# Project. Overview. splitting. C# DLLs: Move PowerPoint Page Position. Add
pdf into powerpoint; converting pdf to powerpoint
C# PowerPoint - Delete PowerPoint Document Page in C#.NET
C# DLLs: Delete Page from PowerPoint File. Delete a Single PowerPoint Page from PowerPoint File in C#. How to delete a single page from a PowerPoint document.
how to convert pdf to powerpoint in; how to add pdf to powerpoint presentation
Developing DITA-based Help for Existing Help Environments
This topic introduces solutions for moving your DITA source content into one of several existing help run-time
environments.
If your company delivers information to a commonly used Help viewer or run-time Help environment, you have options
for authoring content in DITA and for transforming that content into ready-to-run Help deliverables.
Figure 1: DITA Source to Existing Help Environments
The following topics in this section of the Best Practices Guide explain how to use one or more of these plug-ins or
transforms to generate Help from DITA sources.
• Arbortext Digital Media Publisher on page 4
• CSHelp Plug-in on page 9
• Eclipse_CSH Plug-in for Dynamic Context-Sensitive Help on page 11
• Eclipse Help on page 16
• Leximation AIR Help Plug-in on page 19
• The DITA Open Toolkit HTMLHelp Transform  on page 23
Arbortext Digital Media Publisher
This topic provides an overview of how the Arbortext Digital Media Publisher uses DITA to create Help systems and
other types of online information systems.
Arbortext Digital Media Publisher (DMP) has been available as a standalone product for some time, but in the upcoming
release DMP provides a DITA-based integration with Arbortext Editor that enables you to create a Help system or other
online information system directly from a DITA map.
Overview
DMP enables you to take a set of documents and compose them to various types of output. The documents can be of
several different types including DITA and other types of XML documents, HTML, PDF, Microsoft Word, Microsoft
PowerPoint, Micosoft Excel, Javadoc, or just text documents. Once you have compiled your set of content, you can use
DMP to compose that content to the following types of output:
• Help systems
• Standalone knowledge bases or information systems
• Web applications
4 | Draft | Developing DITA-based Help for Existing Help Environments
DMP is a browser-based application and uses either an embedded browser (based on Internet Explorer) or the native
browser installed on a system to serve up the content. DMP is a cross-platform application and runs on Windows, Linux,
and some types of UNIX. DMP also supports multiple languages in the same image.
More information on DMP can be found on the PTC web site.
Setup and configuration
DMP can be purchased from PTC, either as a standalone product or bundled with Arbortext Publishing Engine. DMP
comes with its own installation program. To create a DMP image directly from a DITA map also requires Arbortext
Editor.
You can configure a DMP image in the following ways:
• DMP as a standalone product
DMP has some Java property files that you use to set up the application properties and a content configuration XML
file that you use to identify both the content sets to go in the application and the structure of the table of contents.
You can also apply metadata to the table of contents to filter the content displayed in the image based on any criteria
you define. Once you have completed setting up your configuration files and content sets, you can run a DMP build
to create the DMP image.
• DMP in conjunction with Arbortext Editor
You can use Arbortext Editor to edit a specialized DITA map called a “DMP Map” to construct the table of contents
and reference the associated content. In this case, you can create a DMP image directly from the map. A DMP Map
supports all of the configuration options available in the standalone DMP configuration.
Following is an example of a DMP Map:
Draft | Developing DITA-based Help for Existing Help Environments | 5
Authoring
Authors will need to learn about the specialized elements and attributes in a DMP Map to use the map. However, for
authoring regular DITA topics and maps, nothing special is required.
Integration
DMP provides both a Java API and an XML RPC API. The same features are available in both of these APIs. The API
provides several capabilities, including displaying an individual topic based on an ID and searching through HTML
metadata for strings or IDs to find the appropriate topic to display. Application developers can use the DMP API to
integrate a DMP image with their software for use as online Help.
All PTC documentation groups will be using DMP images for their products' online Help.
Output
A DMP image is highly customizable. All of the images/icons, colors, text, and features of a DMP image can be modified
or removed during configuration. The default image contains the following features:
• Table of Contents tab — Provides a table of contents for the content in the image.
• Search tab — Contains search results, arranged either by relevance or position in the table of contents.
6 | Draft | Developing DITA-based Help for Existing Help Environments
• Index Terms tab — Contains a universal index for the content in the image.
• Bookmark tab — Contains personal bookmarks and comments for individual topics.
• Configuration tab — Enables the Help Center image to be customized in various ways (for example, switching to a
different language or filtering the content based on various metadata criteria).
• Search field — Enables you to enter search terms with full Boolean, wildcard, and other standard search support.
• Advanced search — Enables you to filter search results based on various criteria.
• Toolbar — Provides access to various DMP features.
• View frame — Displays the current topic.
Following is a DMP image delivered in the embedded browser for use as online Help or a standalone knowledge base:
Following is the same image delivered as a web application:
Draft | Developing DITA-based Help for Existing Help Environments | 7
The main difference between the two images is that the bookmark and commenting feature in the standalone image is
replaced by the web browser's favorites or bookmarks capability. For either case, displaying documents other than
HTML leverages browser plug-ins. For example, PDF documents are displayed in the View frame in the Adobe Reader
plug-in.
Summary
Arbortext Digital Media Publisher enables you to go directly from a DITA map to a composed image. It is a highly
flexible product that can be customized as needed. The DMP API enables integration with other products for use as
online Help or a knowledge base.
Chris Goolsby
OASIS DITA Help Subcommittee
8 | Draft | Developing DITA-based Help for Existing Help Environments
Documents you may be interested
Documents you may be interested