byte array to pdf in c# : Acrobat split pdf bookmark SDK application API .net html wpf sharepoint DocToHelp2014UserGuide2012v241-part1650

Doc-To-Help 2014 User Guide 
Creating a Modular Help System  
401 
Before creating your child projects, set up your file system for the entire modular system. See File Organization on page 
399 for more information. 
To set up a child project 
1.
Create your child project. The project name should contain no spaces.  
2.
Click the 
Build Target
button to build the file. 
3.
Open the 
Help Targets
dialog box. (See Creating Help Targets on page 133 for more information.) 
4.
Choose the Help Target (can be HTML Help, NetHelp, Eclipse Help, or WinHelp) on the left. The hub project, 
and all of the child projects, must use the same Help Target.  
5.
Clear the 
Binary Index
check box. 
6.
Clear the 
Binary TOC
check box. 
7.
Click the 
Build Target
button to build the file. 
Cross-project links may be created between child projects. See Cross-Project Linking on page 401. 
Child projects using automatic context ID creation need to have offsets added, see Modifying Context IDs in Modular 
Projects on page 401. 
Glossaries may be used in Modular hub projects, but HTML Help and WinHelp targets require a few adjustments to 
avoid duplicate items. See Modular Help System Glossaries on page 402. 
Cross-Project Linking 
It is possible to create links from one Help file to another in a Modular Help system.  Regular topic links should be used 
for links within each Help file. 
To create cross-module links  
To create a link from 
HelpProject#2
to 
HelpProject#1
1.
Open 
HelpProject#1
2.
Create a group named 
Modules
. Assign a topic (the one you wish to link to) to that group. (See Index and 
Groups pane on page 125 to learn how to create a group.) 
3.
Build the Help Target. Close the project. 
4.
Open 
HelpProject#2
5.
Create a group named 
Modules
. This group will be empty (no topic will be assigned to it.) 
6.
Open a document, and select the desired link text. Create a link to the 
Modules
group (see Creating Links on 
page 305). 
7.
Build the Help Target. Close the project. 
8.
Open the hub project. 
9.
Build the Help Target. The link from 
HelpProject#1
to 
HelpProject#2
will work. 
Note:
You will need to create a Group name for each cross-project link pair you create. 
Modifying Context IDs in Modular Projects 
Acrobat split pdf bookmark - 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
acrobat split pdf bookmark; create pdf bookmarks from word
Acrobat split pdf bookmark - 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
how to create bookmarks in pdf file; creating bookmarks in a pdf document
402  
Creating a Modular Help System 
Doc-To-Help 2014 User Guide 
To avoid duplicate context IDs when using automatically generated context IDs, you can customize the context ID 
numbers in each child project. This will guarantee that your context-sensitive help will work properly for all of the child 
projects within your Modular hub project. 
To customize context IDs 
1.
Open a child project.  
2.
Open the 
Project Settings
dialog box. (See Setting Project Properties on page 182 for more information.) 
3.
Enter a number in the 
ID Offset
field. For example, you could make this 1000; then 1000 will be added to each 
automatic ID generated. 
4.
Click the 
Build Target
button to build the file. Close the project. 
5.
Open another child project.  
6.
Open the 
Project Settings
dialog box. (See Setting Project Properties on page 182 for more information.) 
7.
Enter a different number in the 
ID Offset
field (for example, 2000). 
8.
Click the 
Build Target
button to build the file. Close the project. 
Repeat for all child projects. 
Modular Help System Glossaries 
Glossaries may be used in Modular hub projects, but HTML Help and WinHelp targets require a few adjustments to 
avoid duplicate items in the hub Table of Contents and Index. 
In NetHelp projects, all child project glossaries are merged in the hub and duplicate glossary entries are automatically 
purged.  
To work with Glossaries in HTML Help and WinHelp files 
1.
Verify all child Help projects, and the hub project contain the same Glossary document file.  
2.
Open a child project. 
3.
Open the 
Help Targets
dialog box. (See Creating Help Targets on page 133 for more information.) 
4.
Select the 
Skip Glossary
check box. 
5.
Click the 
Build Target
button to build the file. 
6.
Repeat for all child projects. 
Modular TOC Utility 
One issue with modular HTML Help is that the child projects do not contain the entire table of contents. Generally, this 
limitation is not a problem because the hub Help file has the full table of contents and, in most cases; this is the Help file 
that is exposed to the end-user. Where the incomplete TOC can become an issue is during the use of context sensitive 
Help. In this case, the child Help file may be called, leaving the end-user with no way to navigate through the entire Help 
contents.    
The 
Modular TOC Utility
removes the table of contents limitation by automatically adding the full table of contents to 
each Help file in the modular project. The Modular TOC Utility is a stand-alone tool that can be used on any set of 
modular Help files. By simply pointing the utility at each of the component .hhp files a fully functional table of contents 
is incorporated into each modular Help file.  
To create a modular TOC for HTML Help Targets 
C# PDF Converter Library SDK to convert PDF to other file formats
manipulate & convert standard PDF documents in .NET class applications independently, without using other external third-party dependencies like Adobe Acrobat.
adding bookmarks in pdf; how to bookmark a pdf file
.NET PDF Document Viewing, Annotation, Conversion & Processing
Merge, split PDF files. Insert, delete PDF pages. Edit, update, delete PDF annotations from PDF file. Print. Support for all the print modes in Acrobat PDF.
pdf export bookmarks; bookmarks pdf reader
Doc-To-Help 2014 User Guide 
Creating a Modular Help System  
403 
Verify that you have a fully defined modular Help system before continuing with the following steps. 
1.
Open the 
Modular TOC Utility
by selecting 
Start > All Programs > MadCap Software >Doc-To-Help > 
Modular TOC Utility
. The 
Modular TOC Utility
will open. 
2.
Select the 
Create a new Modular TOC
file option and click 
Next
3.
After reading the dialog box regarding the location of the new Modular TOC file, click 
OK
4.
Browse to the directory where you want to store your .hub file. (You may want to use your 
Redistributables
folder for this file. See File Organization on page 399 for more information.) 
Note:
The Modular TOC Utility will overwrite duplicate .hub files.  
5.
Provide the Modular TOC Utility with a name for your .hub file and click 
Save
6.
The Modular TOC Utility prompts you for the hub .hhp file. 
Browse
and select the file, then click 
Open
. (This 
file is located by default in the 
HTMLHelp
sub-directory of your hub Help file.) 
The Modular TOC Utility will list all the child 
.
hhp files in your modular Help system. 
7.
Choose the first child .hhp file, then click 
Next
. Choose the location of the appropriate .hhp file and click 
Open
(This file is located by default in the 
HTMLHelp
sub-directory of your child Help file.) 
8.
Repeat until each of the child .hhp files has been located. 
9.
Click 
Next
. The Modular TOC Utility will then prompt you to verify that the path for the build project. 
10.
Click 
Next
11.
Browse to select a directory to store your new modular Help files. 
12.
Click 
Next
13.
Verify the .hub file and build paths. 
14.
Click 
Finish
to build the new modular Help files. 
After the files are built, the Modular TOC Utility Editor will open. 
15.
Close the Modular TOC Utility Editor and examine the Help files in your build directory. Note that each Help 
file (hub and child) will include the entire table of contents. 
Creating a Modular Help System for Microsoft Help 
Viewer Targets 
The Microsoft Help Viewer Target is exclusively for integration with the Microsoft Visual Studio 2010 (and above) Help 
system. MHV Targets usually include API reference documentation generated using the Doc-To-Help Sandcastle plug-
in. 
The purpose of a MHV modular project is to combine the tables of contents of multiple projects so that they appear as a 
single TOC when integrated with Visual Studio 2010 (and above) Help. For example, a company develops almost 300 
controls for Visual Studio. These controls are grouped into several studios. In order to create a single TOC for the 
products within Visual Studio's Help system, we create a MHV Modular Help project. Not only is a merged TOC 
created, but the multiple MHV 1.x setups (HelpContentSetup.msha files) are merged into a single setup.  (See Doc-To-
Help Outputs and Deliverables on page 13 for information about MHV setups and deliverable files.) 
C# Windows Viewer - Image and Document Conversion & Rendering in
standard image and document in .NET class applications independently, without using other external third-party dependencies like Adobe Acrobat. Convert to PDF.
create bookmarks in pdf; how to bookmark a pdf document
C# Word - Word Conversion in C#.NET
Word documents in .NET class applications independently, without using other external third-party dependencies like Adobe Acrobat. Word to PDF Conversion.
creating bookmarks in pdf documents; bookmarks pdf files
404  
Creating a Modular Help System 
Doc-To-Help 2014 User Guide 
To create a MHV Modular Help project 
1.
Set up your modular Help file structure in Windows Explorer (see File Organization on page 399). You will not 
need the 
Redistributables
folder.  
If you have already created your child projects, simply drag them into this file structure. Make sure all of the 
child projects have their Microsoft Help Viewer targets built. 
2.
Create a new Help project that will serve as the hub or parent project. The project name should contain no 
spaces. 
3.
Open the 
Project Settings
dialog box for the hub project. (See Setting Project Properties on page 182 for more 
information.) 
4.
Select the 
Is modular hub project
check box to designate this project as a Modular Hub Project. 
5.
Close the 
Project Settings
dialog box. 
6.
Open the hub project's source document and create placeholder topics for each of the child topics you wish to 
associate with the hub.  The example project above includes the "ComponentOne Help" topic, as well as a topic 
for each of the studios listed.  The "ComponentOne Help" topic uses the Heading 1 style; the studio topics use the 
Heading 2 style. 
7.
Build the Microsoft Help Viewer target. 
8.
Open the 
Topics
window, right-click on each of the topics, and select 
Properties
from the menu. In the 
Topic 
Properties
dialog box, set the following in the 
Module Link
section: 
In the 
Module file
field, choose the manifest file (.msha) that the Topic should link to. 
If you would like the topic chosen to be the parent of all the topics in the child project, select the 
Use first 
topic as parent
check box. 
If you would like 
Product name
listed in the 
Help Targets
dialog box for your project to be inherited by 
all the children, select the 
Inherit Product name
check box. (It is selected by default.) 
If you would like the 
Book name
property listed in the 
Help Targets
dialog box for your project to be 
inherited by all the children, select the 
Inherit Book name
check box. 
9.
Rebuild the Microsoft Help Viewer target. 
Notes:  
Doc-To-Help 2014 User Guide 
Creating a Modular Help System  
405 
You can map a Topic to ".msha" files that were created in another modular hub project. This makes it possible 
to create nested (multi-level) hub projects. 
All files in the MHV target folders (
MSHelpViewer
by default) are required to create a successful setup. 
Limitations: 
The content of child setups must contain ".mshc" files (not ".cab" files). 
Breadcrumbs are not supported in the parent and child setups.  
Manifest list file format: 
If you don't want to use an ".msha" file built by Doc-To-Help, you can manually create a ".msha" file with any list of 
child setups and use it. See the example below.  
A manifest list file is used to list all child setup manifests for a single hub topic. 
This file is a standard XHTML file but must have the ".msha" extension. 
Example: 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title>ComponentOne Studio for WinForms Help</title> 
</head> 
<body class="manifest-list"> 
<div class="manifest"> 
<a class="manifest-link" 
href="C1BarCode/HelpContentSetup.msha">ComponentOne BarCode for .NET Help</a> 
</div> 
<div class="manifest"> 
<a class="manifest-link" href="C1Zip/HelpContentSetup.msha">ComponentOne 
Zip for .NET Help</a> 
</div> 
</body> 
</html> 
Elements used in the file: 
<html xmlns="http://www.w3.org/1999/xhtml"> - required. 
<head> - optional (not used). 
<title> - optional (not used). 
<body class="manifest-list"> - required . 
<div class="manifest"> - required (one or more). 
406  
Creating a Modular Help System 
Doc-To-Help 2014 User Guide 
<a class="manifest-link" href="HelpContentSetup.msha">ComponentOne BarCode for 
.NET Help</a> - required (only one in a manifest div). Its text is optional, not 
used. 
MHV resources: 
MSHelpWiki.com
http://www.mshelpwiki.com/wiki/tiki-index.php?page=Help3 
MSDN Forum
http://social.msdn.microsoft.com/Forums/en-US/devdocs/threads 
Yahoo! Group
http://tech.groups.yahoo.com/group/MSHelpViewer/ 
Doc-To-Help 2014 User Guide 
Creating a Modular Help System  
407 
Doc-To-Help 2014 User Guide 
Documenting Your Class Library with Microsoft® Sandcastle  
409 
Documenting Your Class Library 
with Microsoft® Sandcastle 
Microsoft's Sandcastle utility automatically creates MSDN style reference documentation from .NET assemblies and 
XML comment files. This makes it possible for you to document a class library — plus add narrative information — 
quickly and efficiently. Doc-To-Help integrates Sandcastle's XML output into your projects, automatically creating 
topics, index, TOC, and other Help elements. With this information added to your project, you can edit/add your own 
topics, and easily link to namespaces. 
Doc-To-Help is the first Help Authoring tool to integrate with Microsoft Sandcastle. This integration extends the 
functionality of the Sandcastle plug-in by providing an interface for Sandcastle, and giving authors more power to 
connect narrative and reference content.  
To use the Doc-To-Help Sandcastle plug-in, you must first install Sandcastle and the Sandcastle patch. If you have an 
older version of Sandcastle on your machine, uninstall that version first. 
1.
Download the 
Sandcastle Help File Builder version 1.9.5.0 
from 
http://shfb.codeplex.com/releases/view/92191, then run InstallResources\Sandcastle_2710.msi.  
2.
After you have completed the 
Sandcastle Help File Builder
installation, go to  
32-bit machine: C:\Program Files\MadCap Software\DocToHelp\Plugins\Sandcastle 
64-bit machine: C:\Program Files (x86)\MadCap Software\DocToHelp\Plugins\Sandcastle 
and double-click on 
SandcastlePatch.exe
to install it.  
Note
: Class libraries cannot be exported to Manual or EPUB Targets. It is suggested you exclude the Sandcastle plug-in 
from those outputs using a condition. See Setting Document Properties on page 297 for more information. 
If you have reference documentation originally created in Doc-To-Help’s Documenter for .NET, you can convert those 
projects to Sandcastle, see Converting Documenter for .NET projects to Sandcastle Projects on page 410.
Creating a Project with Sandcastle 
There is a sample project you can test drive in 
\\Users\<username>\Documents\My Doc-To-Help 
Projects\Samples\MSSandcastle 
(Windows® 7/8 and Vista);
\\Documents and Settings\<username>\My 
Documents\My Doc-To-Help Projects\Samples\MSSandcastle 
(Windows XP). 
To create a new Sandcastle project  
1.
Create a new Doc-To-Help project using the 
New Project Wizard
(
File 
tab
> New Project
). 
410  
Documenting Your Class Library with Microsoft® Sandcastle 
Doc-To-Help 2014 User Guide 
2.
In Doc-To-Help, click the 
Project tab > Project Styles
button
. The 
Project Styles
dialog box will open. For 
Paragraph Styles
Heading 1-Heading 5, change the 
Topic Type
to 
Conceptual
. (See Defining 
Character/Paragraph Styles and Topic Types on page 168 for more information.) 
3.
Click the 
Project tab > Plugins button
and choose 
Create New Plugin Document
to add a new Sandcastle 
plug-in document. 
4.
Enter a name, such as 
Reference
, for the .xmlprop file in the 
XMLDocuments
subdirectory.  
5.
From the 
Choose Plugin Type
dialog box, select the 
Sandcastle plugin type
. Click 
OK
, and a new document 
will be created, 
XMLDocuments\Reference
6.
Double-click on 
Reference
. The Properties for Generating Reference dialog box on page 411 will open. Select 
the assemblies you want to document and the source XML comment file(s) for them. You can also specify the 
framework version, the types and members to include, and the syntax to include. 
7.
Right-click on 
Reference
in the Documents pane and choose 
Generate
. This will generate the Reference.xml 
file. (If any of the dependent properties are changed later, Doc-To-Help will automatically regenerate the 
reference section when the  plug-in is closed, or when building the Target.) 
8.
Open the file your narrative will reside in. (If it is not using the 
C1_sandcastle_src.dot
template, you should 
apply it now. See Using styles to create links from narrative to reference text on page 424 for more 
information.) Add text. If you would like to create a link from the narrative document to the reference 
document, highlight the text to link and select the appropriate toolbar button or style. 
9.
In Doc-To-Help, click the 
Home
tab > Select Target button
to choose the Help target. Click the 
Rebuild 
Target
button. 
The target will be formatted with the MSDN reference style.  
Converting Documenter for .NET projects to Sandcastle 
projects 
To convert a legacy project 
1.
Make a backup copy of your entire project before conversion. 
2.
Open the Doc-To-Help project (.d2h) 
3.
Right-click the Word document generated by Documenter for .NET and choose 
Remove Document
to remove 
it from the project. Delete the Word document file from your project folder. 
4.
Using the 
Project Styles
dialog box (see Defining Character/Paragraph Styles and Topic Types on page 168), 
delete the character styles that are used for creating links from narrative to reference. They are: all Link ... styles 
(Link Class, Link Constructor,..., Link Type - 15 styles) and two additional styles: "MSDN Link style" and 
"Block Key." (17 character styles total). Be careful not to delete any other styles. 
5.
In all narrative Word source documents change the attached template from C1H_dotnet_src.dot to 
C1H_sandcastle_src.dot. 
6.
Add the plugin document: in Doc-To-Help choose 
Project tab > Plugins button
and select 
Create New 
Plugin Document
. Enter its name in the 
New Plugin Document
dialog box in the 
XMLDocuments
folder 
("Reference" is the suggested name, but any name is OK). 
7.
Double-click the plugin document, which will open the 
Properties for Generating Reference
dialog box. 
8.
Select 
Import
, click the 
Browse
button, and select the 
Documenter for .NET
project file (.d2hdotnet) that you 
are converting.  
9.
This is the main point in the conversion process: the converter scans your Documenter for .NET project 
(.d2hdotnet) and converts its settings to properties of the plugin document (.xmlprop).  
Documents you may be interested
Documents you may be interested