That is about all that is involved with installing and configuring tocjs and tocjsbis.
Authoring
These plug-ins piggy-back whatever investment you have already made in authoring your DITA topics and map files.
Beyond setting up a new ant script for tocjs or tocjsbis, there is nothing additional required.
Integration
The tocjs and tocjs plug-ins present few integration problems or opportunites, especially as regards managing context
sensitivity between Help output and the calling software application. Many DITA Help writers customize the
frameset.html file that ships with the tocjs plug-in to personalize or brand the final product. Here's what Shawn
McKenzie does with tocjs on his Sophos corporate website.
Draft | Developing Custom DITA-based Help Systems | 39
How to add pdf 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
convert pdf into powerpoint; convert pdf to powerpoint online no email
How to add pdf 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
and paste pdf to powerpoint; convert pdf document to powerpoint
Wrapping other navigational devices around the tocjs output is not difficult. I add the conventional tabs for tri-pane
Help systems.
In terms of translation, note that all the text strings associated with entries in the TOC tree are stored in one file named
toctree.js. These files can be localized, for sure, but they are not very friendly. To make life easier on our sisters
and brothers in L10N, you can post-edit this toctree.js file to swap JavaScript resource strings for literal strings.
Output
Here again is a link to a live demo of tocjs running at Sophos.
http://ca-repo1.sophos.com/docs/ws1000/
40 | Draft | Developing Custom DITA-based Help Systems
C# PDF insert image Library: insert images into PDF in C#.net, ASP
C#.NET PDF SDK - Add Image to PDF Page in C#.NET. How to Insert & Add Image, Picture or Logo on PDF Page Using C#.NET. Add Image to PDF Page Using C#.NET.
converting pdf to powerpoint online; pdf to powerpoint converter
VB.NET PDF insert image library: insert images into PDF in vb.net
VB.NET PDF - Add Image to PDF Page in VB.NET. Guide VB.NET Programmers How to Add Images in PDF Document Using XDoc.PDF SDK for VB.NET.
convert pdf to powerpoint online for; convert pdf to powerpoint online
Summary
If you are comfortable customizing XHTML output to build an HTML-based help system, you should consider tocjs
and tocjsbis. They are sufficiently lightweight to work in Help systems or web-based portals.
Stan Doherty
OASIS DITA Help Subcommittee
OASIS DITA Technical Committee
Dynamic Rendering of DITA into XHTML
This topic describes the concept of dynamic transformation of DITA content on a web server into XHTML for delivery
to any web browser.
In many cases, Help content is best delivered as HTML. For content authored in DITA, the process is typically to
transform the content into HTML (or, more likely, XHTML), and then transfer the output files to a web browser. In
some cases, it may be desirable to host the DITA source files on the web server, and use server-side processing to
dynamically transform the content to HTML when a browser requests the information.
Overview
When DITA content is transformed to a delivery format through the DITA Open Toolkit or another publishing process,
the result is a collection of deliverable files that also need to be managed. The deliverable files (typically XHTML) must
be copied to a web server for delivery. When the source content changes, the output has to be regenerated, and then
copied once more to the web server.
Most web servers support some sort of server-side processing technology; examples are ASP.Net, PHP and JSP. Many
of these technologies are XML-aware, and are capable of handling dynamic XSL-T transformations.
It is possible to set up a system whereby Help content, written and stored in DITA format, is stored on a server, and then
dynamically transformed into HTML for delivery.
Setup and configuration
To set up a dynamic transformation system, the services of a developer or someone familiar with a server-side processing
and XSL-T is required. The developer will need to devise a menu system (perhaps derived from a ditamap file), and a
topic rendering system.
Authoring
Once the system is in place, DITA topics can be either authored directly onto the web server (perhaps through FTP,
WebDAV, or a network share).
Limitations
While it is relatively easy to set up a simple menu system and a simple topic rendering system, it is not easy to handle
more advanced DITA features such as conrefs, reltables and composite topics. For example, conref elements need to be
resolved prior to the XSL-T transformation. In the DITA Open Toolkit, the generation of output comprises a number
of stages to first resolve references to build an interim document, and then process the interim document into the output.
However, if the DITA content is simple enough, this limitation is not an impediment.
Example
The HyperWrite web site (http://www.hyperwrite.com/Articles/default.aspx) uses these techniques through ASP.Net to
generate the breadcrumb trails, navigation system, menu pages, and articles topics from a ditamap file and numerous
DITA concept topics. Some content topics are also hosted in DocBook format.
Draft | Developing Custom DITA-based Help Systems | 41
VB.NET PDF Password Library: add, remove, edit PDF file password
VB: Add Password to PDF with Permission Settings Applied. This VB.NET example shows how to add PDF file password with access permission setting.
convert pdf file into ppt; adding pdf to powerpoint slide
C# PDF Password Library: add, remove, edit PDF file password in C#
C# Sample Code: Add Password to PDF with Permission Settings Applied in C#.NET. This example shows how to add PDF file password with access permission setting.
how to change pdf to ppt on; pdf to ppt converter online
Summary
The primary advantage of the dynamic transformation approach is to minimise file management. The main disadvantage
is that the technique is practically limited to simple content structures. Some other dedicated web delivery methods,
such as Eclipse Help, Mark Logic Content Server, or other CMS solutions, provide greater support for complex content
structures.
JavaScript-Based Context Sensitive Help
This topic explains how to configure your browser-based Help system to respond to context-sensitive Help requests
from a software application.
Overview
If you are deploying a browser-based Help system in conjunction with a software application, you can configure your
main HTML Help file to display a specific target Help file when so requested by a calling software application.
Note: The following JavaScript functions do not depend technically on anything inside your DITA source files or
anything generated by the DITA Open Toolkit. They are generic functions that support generic HTML.
Single-pane Browser Help Systems
In some situations, you may not need to deploy a fancy, multiframe HTML Help solution to support a software application.
In these situations, you can add a few lines of JavaScript to the beginning of your main Help file to process incoming
hyperlink calls that target a particular HTML Help file.
For example, if my software application needed to display a particular Help screen (targetHelpTopic.html), I
could build a hyperlink that would call the main Help file (1file.html) and ask it to display my target Help topic.
Here's the HTML hyperlink call.
<a href="1file.html?targetHelpTopic.html">link</a>
Here's the JavaScript to put at in your main Help file.
<HTML>
<!-- One-pane Browser Help System 1file.html -->
<body>
<script language="javascript">
targetTopic = window.location.search.substring(1);
window.location.href=targetTopic
</script>
</body>
</html>
When the main Help file (1file.html) receives the HTML hyperlink call <a
href="1file.html?targetHelpTopic.html">link</a>, it identifies any text that follows the question
mark (?) as one or more arguments being passed to it. In this example, the script identifies targetHelpTopic.html
as that argument and makes that HTML file name the current topic to be displayed in the browser.
Note: This setup works well for captive or embedded Help systems with restrictive or highly predictable calling
procedures. If a user or an application calls the main Help file without specifying a target topic, the main Help file
will generate an Error 404 "File not found".
Multiframe Browser Help Systems
Many browser-based Help systems use mutlitple frames to provide the customer with topic navigation, search, indexing,
and other basic amenities. To get a multiframe Help system to respond to the same context-sensitive hyperlink call is a
bit more complicated becuase of some restrictions in how HTML frames and JavaScript interact..
42 | Draft | Developing Custom DITA-based Help Systems
C# PDF Sticky Note Library: add, delete, update PDF note in C#.net
C#.NET PDF SDK - Add Sticky Note to PDF Page in C#.NET. Able to add notes to PDF using C# source code in Visual Studio .NET framework.
how to change pdf to powerpoint slides; how to convert pdf into powerpoint on
C# WinForms Viewer: Load, View, Convert, Annotate and Edit
allowed to load and view PowerPoint without Microsoft Office software installed, create PDF file, Tiff image and HTML file from PowerPoint, add annotations to
add pdf to powerpoint slide; export pdf into powerpoint
Here are the elements of our little example.
Software
Application
nav
Frame
contents
Frame
dhsc_help.html
cshelp.js
default.html
target.html
dhsc_help.html?\
WebBrowser
target.html
Description
Elements
Any software application that can generate HTTP calls to a browser will work. For the sake of simplicity,
I use an HTML document that contains one hypertext link.
Software
application
<html>
<a href="dhsc_help.html?target.html" target=_blank>
Call the help system file and pass it an argument
(the name of the target help topic).</a>
</html>
The software application passes two arguments to the Help browser:
Hyperlink
• Main HTML Help file name (
dhsc_help.html
)
• Target Help file name to be displayed (
target.html
) in the main Help window.
Preserving the question mark (?) between the name of the main Help file name and the target Help
topic file name is critical.Your browser uses this question mark to delimit the name of the target Help
topic (
target.html
) from the name of the main Help file (
dhsc_help.html
).
The main Help file here contains little more than a call to a JavaScript library file that perfroms all the
real work.
Main Help file
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>DHSC CS Help Demo</title>
<!--Insert cshelp.js library -->
<script language="Javascript" src="cshelp.js">/script>
<meta http-equiv="Content-Type" content="text/html; 
charset=iso-8859-1">
</head>
<script language="javascript">
insertFrameset()
</script>
</html>
The 
cshelp.js
library contains only one JavaScript function named 
insertFrameset
.
cshelp.js
function insertFrameset ()
{
defaultTopic = "default.html";
Draft | Developing Custom DITA-based Help Systems | 43
C# HTML5 Viewer: Load, View, Convert, Annotate and Edit PowerPoint
load and view PowerPoint without Microsoft Office software installed, convert PowerPoint to PDF file, Tiff image and HTML file, as well as add annotations in
converting pdf to ppt online; convert pdf file to ppt online
RasterEdge XDoc.PowerPoint for .NET - SDK for PowerPoint Document
Convert. Convert PowerPoint to PDF. Extract, copy and paste PowerPoint Pages. Annotation & Thumbnail. Add and burn annotation to PowerPoint.
how to change pdf to powerpoint; pdf to powerpoint converter online
Description
Elements
targetTopic = window.location.search.substring(1);
if (targetTopic=="")
{
target_contentsframe=defaultTopic
}
else
{
target_contentsframe=targetTopic
}
document.write('<FRAMESET cols="20%, 80%">');
document.write('<FRAME src="nav.html" name="navframe">');
document.write('<FRAME src="'+target_contentsframe+'" 
name="contentframe">');
document.write('</FRAMESET>');
}
The variable targetTopic points to the name of the target topic (
target.html
) embedded in the
hyperlink call. If the JavaScript function receives no argument from the hyperlink that calls it, it uses
the name of the HTML topic declared as defaultTopic.The final lines of the script build the frameset
calls that specify frame dimensions and contents (HTML files).
Summary
These JavaScript functions support small-to-medium Help systems in any language because they place the entire burden
of constructing and managing context-sensitive hypertext links on the calling application. With larger Help systems or
with distributed Help systems, this overloading becomes risky or impossible.
Stan Doherty
OASIS DITA Help Subcommittee
OASIS DITA Technical Committee
44 | Draft | Developing Custom DITA-based Help Systems
WinANT Options Supporting HTML-Based Output
This topic describes how some features within the WinANT software tool can make generation of HTML-based output
from DITA content easier.
The DITA Open Toolkit provides a method for specifying a CSS style sheet, blocks of HTML code to add to the top
and bottom of each generated HTML file, and a block of code to add to the <head> section of each generated HTML
file. However, the method is cumbersome to use from a command line or terminal window invocation of the Apache
Ant build processor. The HyperWrite WinANT software tool, which acts as a Windows interface to Ant, makes this
method extremely simple.
Overview
WinANT is a Windows program, build with Microsoft Visual Studio .NET 2008 using VB.NET. It serves as an interface
to the Ant build utility, for the sole purpose of processing DITA documents.
WinANT allows a user to select build characteristics using normal Windows interface devices such as drop-down lists,
radio buttons, tabs and browse buttons. When all the required settings are in place, the program creates the Ant build
file, creates a ditaval file (if required), creates a batch file, and then executes the batch file to trigger the Ant build. When
Ant has finished the processing, WinANT displays the generated output file. The settings can be saved (as a build file)
and later recalled.
Figure 4:WinANT 1.6 - Main tab
Draft | Developing Custom DITA-based Help Systems | 45
Setup and configuration
WinANT can be downloaded without charge on a “take it as it comes” basis from http://www.helpml.com/winant_setup.exe.
It installs using a standard Windows installer, and requires .Net Framework 2.0.
The Ant arguments that can be set within WinANT include:
• The folder where the output will be created.
• The type of output.
• A CSS stylesheet to be applied to each output HTML page.
• A file containing HTML code to be added to the <head> section of each output HTML page.
• A file containing HTML code to be added to the top of the <body> section of each output HTML page.
• A file containing HTML code to be added to the bottom of the <body> section of each output HTML page.
• A list of files to be copied to the output folder (or compiled into HTML Help output).
• Some limited conditional processing rules.
• Images to be used for flagging conditional text.
• The DITA topic file extension used.
• The output HTML file extension to be used.
• Whether content marked as draft will be included in the output.
Authoring
The use of WinANT in the publishing stage does not alter the authoring method.
Publishing
When you are ready to produce HTML-based output from your DITA source, you can process your ditamap file through
WinANT.
WinANT supports the following base DITA Open Toolkit and additional plug-ins:
• HTML
• (Microsoft
®
) HTML Help
• HTML Help 2 (plug-in)
• PDF
• PDF2
• Eclipse Help
• DocBook
• Word
• HTML - tocjs (plug-in)
• XHTML with Search (plug-in)
• HTML - tocjsbis (plug-in)
• HTML with tocjs
• HTML with search
You will need to prepare the CSS stylesheet to use for presentation of the output, as well as any code blocks for the top
(Custom Header), bottom (Custom Footer), and <head> section (Custom Head Block).
Note:  Make sure your HTML code blocks are well-formed XML. If not, the block will not be included in the
output HTML.
If you are producing HTML Help output, you can also nominate an include file, which is a simple list of additional files
to be compiled into the resultant CHM, in plain text format. If your CSS file references graphics, these graphics files
should be listed in the include file .
46 | Draft | Developing Custom DITA-based Help Systems
Selecting the CSS and code files
The CSS and HTML code block files are selected on the Main tab of WinANT. These fields are:
• Custom Stylesheet
• Custom Head Block
• Custom Header
• Custom Footer
• HTML Help Include File
only active if the Output Type field on the Main tab is set to HTML Help or HTML Help 2.
Summary
WinANT provides a simpler way of controlling the HTML-based output from DITA content than the standard DITA
Open Toolkit command line. Its ability to store settings for future use also help make it a practical tool for DITA
publishing.
WinANT Options Supporting Microsoft
®
HTML Help
This topic describes how some features within the WinANT software tool can make Microsoft
®
HTML Help generation
from DITA content easier.
The DITA Open Toolkit provides a method for nominating context-sensitive Help header (or map) and alias files to be
compiled into the CHM file when a Microsoft
®
HTML Help output is being generated. The method is difficult to use
from a command line or terminal window invocation of the Apache Ant build processor. The HyperWrite WinANT
software tool, which acts as a Windows interface to Ant, makes this otherwise difficult method extremely simple.
Overview
WinANT is a Windows program, build with Microsoft Visual Studio .NET 2008 using VB.NET. It serves as an interface
to the Ant build utility, for the sole purpose of processing DITA documents.
WinANT allows a user to select build characteristics using normal Windows interface devices such as drop-down lists,
radio buttons, tabs and browse buttons. When all the required settings are in place, the program creates the Ant build
file, creates a ditaval file (if required), creates a batch file, and then executes the batch file to trigger the Ant build. When
Ant has finished the processing, WinANT displays the generated output file. The settings can be saved (as a build file)
and later recalled.
Draft | Developing Custom DITA-based Help Systems | 47
Figure 5:WinANT 1.6 - Main tab
Setup and configuration
WinANT can be downloaded without charge on a “take it as it comes” basis from http://www.helpml.com/winant_setup.exe.
It installs using a standard Windows installer, and requires .Net Framework 2.0.
To enable the incorporation of map and alias files in HTML Help output, you have to manually edit the standard
build_dita2htmlhelp.xml DITA OT, by inserting after the line:
<param name="OUTEXT" expression="${out.ext}" if="out.ext" />
the two lines:
<param name="HELPMAP" expression="${dita.map.filename.root}.map" />
<param name="HELPALIAS" expression="${dita.map.filename.root}.ali" />
Authoring
Nominating the map and alias files in the HTML Help project file effectively externalises the context hooks; the context
ids and strings are not incorporated into the DITA source files at all. The map and alias files therefore need to be separately
authored outside DITA.
Selecting the map and alias files
The map and alias files are selected in the Context-Sensitive Help panel of the Help Systems tab. These fields are only
active if the Output Type field on the Main tab is set to HTML Help or HTML Help 2.
48 | Draft | Developing Custom DITA-based Help Systems
Documents you may be interested
Documents you may be interested