byte to pdf c# : Adding bookmarks to pdf document application Library tool html asp.net azure online DocToHelp2014UserGuide2012v226-part1633

Doc-To-Help 2014 User Guide 
Customizing Your Project  
251 
NetHelp Theme Wizard 
The NetHelp Theme Wizard takes you step-by-step through the process of creating your own custom theme. It allows 
you to: 
create a new or update an existing theme, 
specify a layout and style sheet, 
brand your output, and 
set some of the most commonly used properties for the NetHelp target. 
To use the wizard, follow these steps: 
1.
On the Doc-To-Help 
Home
tab, click 
Select Target
and choose a NetHelp target. 
2.
Click the 
Theme button
drop-down arrow and select 
Theme Wizard
. If you click the paintbrush and paint 
palette icon in the top of the 
Theme
button, this also opens the wizard. 
3.
In the first window, choose a layout for the theme by selecting 
Accordion
Responsive
, or 
Tabs
from the drop-
down text box. A preview of the layout appears below the box, or you can use the arrows on the left and right 
side of the window to scroll and choose a layout.  
Adding bookmarks to pdf document - 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
create bookmarks pdf files; how to add bookmarks to pdf document
Adding bookmarks to pdf document - 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
excel pdf bookmarks; delete bookmarks pdf
252  
Customizing Your Project 
Doc-To-Help 2014 User Guide 
4.
Click 
Next
5.
Choose a style sheet from the drop-down box. A preview of the style sheet appears below the box, or you can 
use the arrows on the left and right side of the window to scroll and choose a style sheet.  
Note:
You can edit the style sheet in the theme designer later or you can roll your own with the jQuery Theme 
Roller
6.
Click 
Next
C# Create PDF Library SDK to convert PDF from other file formats
Create and save editable PDF with a blank page, bookmarks, links, signatures, etc. Besides, using this PDF document metadata adding control, you can
how to add a bookmark in pdf; pdf bookmark
.NET PDF SDK - Description of All PDF Processing Control Feastures
Full page navigation, zooming & rotation; Outlines, bookmarks, & thumbnail display; Support adding and inserting hyperlink (link) to PDF document; Allow to
add bookmarks pdf; adding bookmarks to a pdf
Doc-To-Help 2014 User Guide 
Customizing Your Project  
253 
7.
Choose 
*New Theme*
to create a new theme or select an existing theme from the drop-down box.  
8.
Click 
Next
9.
In the 
Basic Branding
window, select a FavIcon and logo, specify whether to show the title in the output, and 
customize the text area of your output. A preview of your output appears on the right side of the window as you 
set the properties. 
FavIcon
Click 
Choose your icon
and select an icon (.ico). The icon will appear in 
254  
Customizing Your Project 
Doc-To-Help 2014 User Guide 
browser tabs, address bars, and in 
Favorites
lists. 
Logo
Click 
Choose your logo
and select an image. It will appear in the upper-left 
corner of your theme header. 
Header area (Title 
bar)
To make a title appear in the title bar of your output, select 
Show the Title of 
your NetHelp output in the top title bar
and enter a height for the header 
area. 
Text area
Select 
Fit text to window width
or enter a 
Maximum text width
in the text 
box. 
Note:
If you chose a pre-defined theme in the 
Choose Theme
window, you cannot change the branding 
properties in this window. 
10.
Click 
Next
11.
In the 
Finishing Touches
window, enter a title to appear in the output 
Title bar
, select a localization language 
for the NetHelp interface, and select the 
Create Section 508 compliant output
check box if you need 
compliancy. 
12.
Click 
Next
13.
In the 
Confirmation
window, enter a theme name and review the sample theme to make sure it is correct. You 
will not be able to enter a theme name if you chose an existing theme in the 
Choose Theme
window. 
Doc-To-Help 2014 User Guide 
Customizing Your Project  
255 
14.
Click 
Finish
. If you used an existing theme, a dialog box appears, explaining the 
Properties of the "NetHelp" 
target have been updated
. If you created a new theme, a dialog box appears, explaining the theme has been 
created and assigned to your NetHelp target. 
15.
Click 
OK
. The theme appears in the 
Theme button
drop-down list on the 
Home
tab. You can select it and 
build the target to apply the theme. 
Doc-To-Help 2014 User Guide 
Customizing Your Project  
257 
Customizing Topics with the Transformation Wizard 
Using the 
Transformation Wizard
, you can easily insert boilerplate content or code into every Help topic in your 
Targets. Examples include: headers, footers, or code needed for technology such as analytics. 
You can add transformations to 
NetHelp 2.0
NetHelp Classic
HTML Help
EPUB
JavaHelp
Eclipse Help
Microsoft Help Viewer
, and 
Microsoft Help 2.0
Help Targets. Your source documents can be Word, HTML5, or 
HTML. 
Transformation files created with the Wizard can be used in any project.  
Custom HTML5 code can be defined for the following places in a topic: 
Inside the <head> element (for example: scripts, CSS, metadata, etc.) 
At the beginning of topic text (above the topic title) 
At the end of  topic text 
To open the Transformation Wizard 
1.
First, open the 
Help Targets
dialog box from the 
Home 
tab. Click the 
Target 
ribbon group dialog box 
launcher. The 
Help Targets 
dialog box will open. 
2.
In the Advanced section, click the 
Wizard
button next to the 
XML Transformation
field. The 
Transformation Wizard
will open. 
To insert a transformation 
1.
Enter your custom code in the appropriate section(s): <head> element, beginning of topic, or end of topic.  
2.
Click 
Save
. You will be prompted to name and save the file. The transformation file created (*.config) will be 
stored at the root of your Doc-To-Help project folder. (This location is the default, you can store it anywhere.) 
3.
Build your Target. The code will be inserted in each topic of the Target. 
If would like to reuse the file in another project, simply open the 
Help Target 
dialog box in that project and click the 
ellipsis 
button next to the 
XML Transformation
field. You can then navigate to the *.config file and select it. 
There is an example transformation named timestamp.config that will add timestamp text to each topic of a Target. It is 
located at: 
32-bit machine: C:\Program Files\MadCap Software\DocToHelp\Tranforms\Examples\Timestamp 
64-bit machine: C:\Program Files (x86)\MadCap Software\DocToHelp\Tranforms\Examples\Timestamp 
Note
: Verify that the 
Generate XHTML
check box is selected in the 
Help Targets
dialog box before building your 
Target. It is selected by default in most Targets. Transformations cannot be used with WinHelp or Manual Targets. 
Code examples 
To insert keywords in the <head> element of each topic, add this to the first field of the Transformation Wizard: 
258  
Customizing Your Project 
Doc-To-Help 2014 User Guide 
<meta name="keywords" content="help authoring tool, doc-to-help, doctohelp, 
online help"/> 
To insert a distinctive header (green, bold, and italic) in each topic, add this to the middle field of the Transformation 
Wizard: 
<div style="font-size:large; font-style:italic; color:green; font-weight:bold" > 
Draft Version 1.1, for Internal Review Only  
</div> 
To insert a footer with a logo and hyperlink in each topic, add this to the last field of the Transformation Wizard: 
<div style="width:90%"> 
<hr style="color:#CCCCCC" /> 
<div style="float: left"> 
<img 
src="http://www.componentone.com/newimages/company/nav_c1icon.png" 
alt="ComponentOne Logo" /> 
</div>  
<div style="float: right"> 
Doc-To-Help 2014 User Guide 
Customizing Your Project  
259 
ComponentOne, a division of GrapeCity, inc. <br /> 
Pittsburgh, PA <br /> 
<a href="http://www.componentone.com" target="_blank">ComponentOne.com</a> 
</div> 
</div> 
You can add programmatic and XSLT transformations to your projects also, see Advanced XML Transformations on 
page 259. 
Advanced XML Transformations 
Programmatic and XSLT transformations can be added to outputs to manipulate content. Programmatic transformations 
can be written in any .NET language, such as C# or VB.NET. This advanced feature gives you great flexibility, because 
it allows for post-build modification in virtually any imaginable custom way. 
You can use the Transformation Wizard to insert boilerplate content or code into every Help topic in your Targets, see 
Customizing Topics with the Transformation Wizard on page 257 for details. 
Examples of advanced transformations include: 
Replacing some text (tag) with variable text depending on a parameter specified in that tag. 
The Expanding/Collapsing Sections on page 316 feature in Doc-To-Help.  
To use a custom transformation 
1.
Open the 
Help Targets
dialog box from the 
Home 
tab. Click the 
Target 
ribbon group dialog box launcher. The 
Help Targets 
dialog box will open. 
2.
In the Advanced section, click the ellipsis button in the 
XML Transformation
field and navigate to the file. 
Click 
Open
3.
Click 
OK
in the 
Help Targets
dialog box and build your Target. 
To create a custom transformation, refer to the notes below, and the two examples provided with Doc-To-Help: 
The expanding sections functionality (see Creating Expanding/Collapsing Sections on page 316) is 
implemented as an XML transformation (a programmatic one). Its full source code can be found in \\Program 
Files [or Program Files (x86)]\MadCap Software\DocToHelp\Transforms\BuiltIn\Source\XMLInternal. (Don’t 
modify these files; they are used in Target compilation.) 
There is an example transformation named 
timestamp.config
that will add timestamp text to each topic of a 
Target. It is located at C:\Program Files [or Program Files (x86)]\ MadCap 
Software\DocToHelp\Tranforms\Examples\Timestamp 
Notes on creating XML transformations: 
Transformations registered in the configuration file are applied to every topic in the order of their appearance in the 
configuration file. 
A configuration file is XML where every transformation is registered with a <transform> element with the following 
elements inside: 
<description>
— Arbitrary string describing the transformation, for explanatory purpose only. 
<assembly>
— File name of the transformation assembly (including the .dll extension). For an XSLT 
transformation that assembly should always be C1D2HXMLInternal.dll. For programmatic transformations, it is 
260  
Customizing Your Project 
Doc-To-Help 2014 User Guide 
a path to the file, not the file name. The path is relative to the configuration file (where transform assembly is 
specified). 
<type>
— Full class name in the assembly that implements the IXMLTransform interface. That is the class 
whose methods are called to perform the transformation. For an XSLT transformation that element should 
always be as follows: <type>C1.D2H.XMLTransform.XSLTTransform</type> 
<params>
— This element contains whatever elements the transformation may need as its parameters. All 
specific parameters will be passed to the transformation assembly when it is executed. For programmatic 
transformations, their interpretation is entirely dependent on the code implementing the transformation methods. 
XSLT transformations should be contained in one XSLT file that receives parameter values. The path to an 
XSL file is relative to the configuration file, so only the file name needs to be specified, for example: <xsl-
file>C1D2HXMLInternal.xsl</xsl-file>. 
Notes on creating programmatic transformations: 
A programmatic transformation assembly contains a class implementing the interface 
C1.D2H.XMLTransform.IXMLTransform. That interface is defined in the C1XHTML.dll assembly residing in the 
DocToHelp directory. It contains three methods (note that you do not need to implement this interface if you are creating 
an XSLT transformation; creating XSLT transformations requires programming only in XSLT; no .NET programming is 
required): 
void IXMLTransform.ReadParams(XmlNode node) 
This method is called before executing the transformation, to initialize the transformation class with parameter 
values specified in the <params> tag in the configuration file. This method is called once in Doc-To-Help build, 
before this transformation is applied to any topics. The 'node' parameter passed to this method contains the 
XmlDocument whose root element is the <params> element of the configuration file. 
void IXMLTransform.Execute(XmlDocument doc) 
This method executes the transformation, applies it to a topic. The 'doc' parameter is the topic XML before 
applying the transformation (all transformations preceding this transformation in the configuration file have 
already been applied to it. This method implementation modifies the XmlDocument passed to it. 
void IXMLTransform.CopyRequiredFiles(string targetPath) 
This method is used to copy any files that may be needed in the help target to support this transformation's 
functionality (these are usually resource files, such as graphics, scripts, style sheets, etc). If you don't need any 
files, leave this method empty. The 'targetPath' parameter contains the path to the TransformFiles subdirectory 
of the Help target directory (for example, \MyProject\MyHTMLHelpTarget\TransformFiles). This method 
implementation copies required files (if any) to that subdirectory (possibly creating subdirectories inside it, if 
needed). 
Documents you may be interested
Documents you may be interested