1-click AWS Deployment 1-click Azure Deployment
Overview
HelpNDoc is a modern help authoring tool with an intuitive user interface. Write or import your content and produce more than 7 documentation formats including help files, web sites, user manuals, documents, eBooks…
(a) “HelpNDoc” and “Software” refers to IBE Software’s HelpNDoc program, in each case, supplied by IBE Software herewith, and corresponding documentation, associated media, and online or electronic documentation.
(b) “IBE Software” means IBE Software.
(c) “Free Version” or “Freeware Version” or “Freeware Edition” or “Personal Edition” means a free version of the Software for personal use only, so identified, to be used only for non-profit projects. The Free Version is fully functional, without restrictions of any kind but may contain messages in the end product stating that they have been created using the Free Version of the Software.
(d) “Registered Version” means a version which has been bought to IBE Software.
(e) “Educational Version” means a version which has been bought to IBE Software by an educational institution and may only be provided to students and employees of the institution. The Educational Version may have limited functionalities and/or usage restrictions.
How To Use :
HelpNDoc’s straight-forward user interface provides easy and fast creation of new documentation projects: only a few simple steps are necessary to get up and running with a new HelpNDoc project.
HelpNDoc gives you the flexibility of adding new topics in two easy steps and putting them in any order within your table of contents.
HelpNDoc gives you the ability to create subtopics (i.e. child topics) to any topic to create a logical structure in your table of contents.
Once topics are created within the table of contents, it is possible to rapidly change their name to fine-tune your documentation layout.
HelpNDoc allows you to easily move and organize your topics and their children topics. You can place topics in any order using the tree structure of your table of contents
Topics can easily be added and organized in the table of contents but, over time, they can become obsolete or unwanted. Deleting them from your HelpNDoc projects just takes a few clicks.
HelpNDoc provides an easy-to-use organizational feature that allows you to select from various icons to classify your topics. Let’s see how easy it is to pick the right icon to categorize them.
HelpNDoc offers four kinds of topics. When you assign topic kind, your topic’s behavior will change thus providing greater flexibility to create sophisticated documentation projects.
HelpNDoc assigns a header when you create a new topic. It is easy to update this header. You can also hide the header if you don’t want it displayed when you publish your documentation.
HelpNDoc assigns a footer when you create a new topic. There’s an easy way to update this footer. Or, you can hide the footer if you don’t want it displayed when you publish your documentation.
Each topic in HelpNDoc is uniquely identified by an Help ID and an Help Context so that it can easily be referenced from a Web or Windows application.
HelpNDoc’s user interface is very flexible: it is possible to show or hide some panels to save some space and avoid distractions. Let’s see how to access the keywords panel.
You can use keywords to index your topics to help users to find the information they are looking for. When you create keywords in HelpNDoc, users can access them on the Index tab when you publish CHM and HTML versions of your documentation.
HelpNDoc gives you tremendous flexibility in updating keywords: once a keyword has been added and associated with some topics, it is possible to rename it without losing anything.
When a keyword becomes obsolete, it is possible to delete it from the keywords list. This removes the keywords as well as its association with topics.
Keywords are displayed in alphabetical order in your keywords panel. To help users more readily find information when they use your CHM and HTML documentation, HelpNDoc allows you to define an organizational hierarchy by forming parent-child relationships among your keywords.
To allow users to take full advantage of keywords in your CHM and HTML documentation, it’s recommended that you create an association between your keywords and each relevant topic. There’s one simple step for creating this association, and it’s easy to remove the association. Both are outlined below.
After you create keywords, they are available on the Index tab on published documentation on both the CHM and HTML documentation formats. Providing keywords helps users find the information they’re looking for as they can be associated with multiple topics to group them together when they share a specific theme.
Your library in HelpNDoc is a central storage area for your entire project where you maintain your multimedia files including images, photographs, videos, documents, HTML code, variables and snippets.
Your library in HelpNDoc is a central storage area where you maintain your multimedia files for your entire project: once added to the library, items can be used throughout the documentation project.
Once items are added to the library, they can easily be renamed without losing any other property such as where they are added in your project’s topics.
When a library item isn’t used anymore, it may be removed from the project’s library: deleting a library item will remove it from your library thus saving space in your project file.
The library is a central repository where you maintain your multimedia files. When you insert a library item into your documentation, you are actually inserting a pointer to that item in your library. As a result, when you update an item in the library, your update is automatically reflected throughout your entire project.
In order to insert an image or another media element into your documentation, you must first place it into the library. The library is a central repository where you maintain your multimedia files. After you add the item to the library, it can be inserted into one or multiple topics.
HelpNDoc makes it easy to create image maps that allow readers to click on regions of an image to access hyperlinks. An image map can be used to document parts of a screenshot, a photography, a road map… by allowing readers to click parts of the image to access greater details about it.
HelpNDoc affords you tremendous flexibility to support dynamic requirements when you publish your documentation. After you’ve completed your documentation, you can publish it in a variety of formats using a range of options.
Your HelpNDoc documentation can be published in multiple formats. It can also be published multiple times with different content and settings in each of those formats. Let’s see how easily this can be done.
You can define the outputs that are generated when you publish your documentation. After you’ve created a publishing output, it is displayed in your build list. When you publish your documentation, it is displayed with its assigned name. To support your specific requirements, you may update this name for any output at any time.
You can define the builds that are generated when you publish your documentation. These builds are displayed in your build list and can be enabled or disabled at will. When a build becomes obsolete, it is possible to remove it from your build list.
You can define the order of your outputs in your build list. This order determines the order in which your documentation is generated. This order can also dictate which settings are applied when you publish documentation using ‘Quick generate.’
HelpNDoc gives you the flexibility and control to determine which of your builds are published when you generate documentation. When you enable a build, it is generated when you use your build list. You also have the option to temporarily disable a build to prevent it from being generated. This flexibility permits you to maintain builds in your build list without requiring you to publish them each time you generate documentation.
When you’re ready to generate documentation, HelpNDoc allows you to define the location of your output files and select the templates that are used to generate your documentation. In addition, you can further customize settings such as color, font size, numbering style, and create conditional tags to tailor your documentation to support specific requirements.
Some templates include hard-coded English terms (such as “Table of contents”, “Index”, “Search”) which needs to be translated when you generate your documentation in another language. This can easily be done on a build by build basis in HelpNDoc’s generate documentation window.
By default, HelpNDoc automatically expands the table of contents when publishing documentation in HTML, displaying all topics. It is simple to modify this setting to automatically collapse topics, displaying only parent-level topics in the table of contents. Readers can then click a parent topic, expanding it to view the children topics.
ePub and Kindle eBook readers can use a cover image to display a representation of the eBook in its virtual library. It is easy to define that cover picture in HelpNDoc.
You can create a template to control the format when you publish your documentation using Word and PDF, instructing HelpNDoc to begin each new topic on a new page. This new template is then available to you and can be used when publishing all of your projects.
Producing a document which shouldn’t be viewable by everyone or should contain restrictions is extremely easy with HelpNDoc. A few options let you define the level of encryption, passwords and user permissions for your generated PDF documents.
In order to generate documentation in CHM format, you must first download and install Microsoft’s HTML Help Workshop compiler. This free compiler allows you to use HelpNDoc to generate CHM help files on Windows.
In order to generate Mobipocket and Kindle eBooks, you must first download and install Amazon’s KindleGen software. This free compiler is available from Amazon’s web-site and allows you to generate eBooks compatible with the Amazon Kindle eReader.
HelpNDoc provides a flexible multi-language live spell checker that puts you in control of the dictionaries and settings that are used. It checks spelling as you enter content into your editor, add new topics into your table of contents, create new keywords, post new items to your library… Your whole project is covered from spelling errors.
To support your specific requirements, HelpNDoc allows you to select the dictionaries that are used by the live spell checker. You may activate one or more dictionaries at a time. It is also easy to deactivate a dictionary.
HelpNDoc provides over fifteen default dictionaries that you may use to spell check your help and manuals. You can also install new dictionaries from Apache’s OpenOffice.org. These open source dictionaries are free and support the spectrum of international languages and a variety of dialects as well as specific requirements such as medical terminology, grammar rules, and common names.
HelpNDoc puts you in control of the spell checker settings. It is easy to view and maintain your dictionary settings, update your custom dictionary, and activate the dictionaries that you’d like to use to spell check your projects.
Manage hyperlinks
HelpNDoc offers you the option of inserting anchors in your topics to further enhance the usefulness of your hyperlinks. By default, hyperlinks take readers to the beginning of specific topics. When you insert anchors within topics you get the added benefit of being able to create hyperlinks to those embedded anchors. As a result, readers can be taken to exact locations within topics, rather than the beginning of topics.
Using hyperlinks can help you enhance the value of your documentation by putting readers in control and allowing them to interact with your documentation. Rather than forcing readers through documentation linearly from beginning to end, HelpNDoc makes it easy for readers to click links to access information they are interested in. Using hyperlinks can also help readers follow steps of a process.
HelpNDoc makes it simple for you to make your documentation more interactive by giving readers hyperlinks so they can learn more about topics that they are interested in and follow steps of a process. You can select any topic from your table of contents to establish a hyperlink to that topic. You can also select to link to anchors embedded within your topics.
HelpNDoc allows you to define hyperlinks that are relative to the position of the topics that readers are viewing when they click the hyperlinks. For example, hyperlinks defined to take readers to the “next topic” would display the topics that immediately follow the ones readers are currently viewing. This permits you to maintain the relative position of hyperlinks when you change the order of topics without needing to update the specific hyperlinks.
HelpNDoc makes it easy to create hyperlinks that display web pages and create e-mail messages. Simply enter or paste in the address that you’d like to use. You can also define the subject heading for the e-mail message.
To improve the usefulness of your documentation, you can provide hyperlinks to supplemental files that are located outside your documentation. You can display these documents or make them available to download.
Using the report template editor :
When you publish your PDF and Word documentation, HelpNDoc follows instructions in templates when generating the documentation. You can create PDF and Word templates that define the cover, paper size, orientation of the page, margins, headers, and footers as well as the appearance of your table of contents and topic titles. HelpNDoc makes it easy to create new templates from scratch. After creating a new template, you can then tailor it to support specific requirements.
As easy as it is to create a new template for Word and PDF documentation formats from scratch, you can save time by copying an existing template. After you copy a template, you can then tailor the settings and properties to create customized documentation that supports your specific needs.
It’s recommended that you assign a name that helps you remember the purpose of a template. As you update the settings and properties of your templates, it may become necessary to update the names of your templates as well. This is quite simple to do.
When a template becomes obsolete, it is simple to delete it. When you delete a template, you are permanently removing the template as well as its settings and properties.
HelpNDoc offers you an intuitive template editor that makes it easy to customize the look and feel of your PDF and Word documentation to support specific requirements. You can tailor any of the settings and properties of the PDF and Word templates that you’ve created from scratch as well as those that you’ve copied from other templates.
Using the project analyzer :
HelpNDoc has a project management tool called Project Analyzer that makes it easy to evaluate the overall structure and integrity of your project. Plus, you can drill-down to resolve specific issues. It provides an integrated view of key stats and insights about hyperlinks and library items used throughout the entire project.
The Project Analyzer makes it easy to evaluate the hyperlinks used throughout your project. You can use the Project Analyzer to sort hyperlinks by their properties (i.e. type, caption, target, and topic) and drill-down to resolve issues such as broken and duplicate links.
The Project Analyzer is a flexible and powerful tool that allows you to manage the items in your library and evaluate their usage throughout your entire project. It lists all occurrences of library items as well as any topics that use them. You can sort items by type, caption, source, and topics. You can also use the Project Analyzer to eliminate unnecessary and outdated duplicates to streamline your updating processes.
By default, all content in all topics is included when the documentation is published. HelpNDoc makes it easy to generate conditional content, giving you complete control over what is included in each of your outputs.
It is possible to create an unlimited number of build outputs in HelpNDoc and for each of those, it is possible to indicate which conditional tags needs to be included. Content and topics tagged with included tags will be generated for that build while content tagged with others tags will be excluded.
By default, all topics are included in all builds when documentation is generated. HelpNDoc makes it easy to include specific topics only in selected builds by tagging them.
By default, the content of each topic is included in all builds when the documentation is generated. HelpNDoc gives you the option of defining rules to include selected sections of topics in specific outputs.
HelpNDoc provides powerful scripting capability that utilizes the HelpNDoc API to automate repetitive tasks. This advanced feature allows you to create new scripts and load existing ones, execute and build scripts, and save scripts for future use.
You can define the default styles that will be used in new projects. This makes it simple to define your preferences once and then use them repeatedly without manually defining styles each time you create a new project.
You can create a style specifically designed to highlight sections of your documentation such as notes or warnings. Once the style is created, it can rapidly be re-used throughout the project.
Format conversion
The Microsoft WinHelp HLP file format was introduced with Windows 3.0 in 1990 as the default help file format for the Windows operating system. As of Windows 10, Microsoft doesn’t provide any HLP file viewer anymore, making this legacy help file format unusable. Fortunately, HelpNDoc can import existing WinHelp HLP file and convert them to the standard Windows Compiled HTML Help (CHM) file format.
You can use HelpNDoc to import and convert a CHM help file into a PDF document. The PDF document contains not only the content from the CHM file, but also the images, hyperlinks and organizational structure, including the table of contents. After importing the CHM help file, you have the option of updating the content.
Users expect their documentation to be easily accessible from the wide variety of devices available to them such as the popular eBook readers. Unfortunately, those eReaders can’t handle the CHM file format. Using HelpNDoc, it is easy to import an existing CHM help file and convert it to an ePub or Kindle eBook.
You can use HelpNDoc to convert a Word Doc or DocX document into an ePub or Kindle eBook. The ePub and Kindle eBooks contain not only the content from the Word document, but also the images, hyperlinks and organizational structure. After importing the Word document, you have the option of updating the content.
You can use HelpNDoc to convert an ePub eBook into a PDF or Word document. The PDF and Word documents contain not only the content from the ePub file, but also the images, hyperlinks and organizational structure, including the table of contents. After importing the ePub file, you have the option of updating the content.
License management
A named license can only be used by one specific person and installed on her own computer. To validate the correct use of the license, HelpNDoc needs to be activated on the computer where it will be used.
Named licenses can only be installed on a limited number of computers you own. If you need to move your license to another computer, you’ll need to deactivate it first from the old computer before activating it on the new one.
Floating licenses can be installed on any number of computers. A floating license server needs to be installed on an accessible server and will be responsible for leasing the licenses to HelpNDoc users.
A floating license of HelpNDoc can be installed on any number of computers. Once launched, it will request a lease from the floating license server to make sure it is allowed to run.
How to install a new dictionary in HelpNDoc:
HelpNDoc provides over fifteen default dictionaries that you may use to spell check your help and manuals. You can also install new dictionaries from Apache’s OpenOffice.org. These open source dictionaries are free and support the spectrum of international languages and a variety of dialects as well as specific requirements such as medical terminology, grammar rules, and common names.
Step 1
The currently activated dictionaries are displayed in the lower left-hand corner of your page. To install a new dictionary, click the downward arrow to the right of these dictionaries. This displays a popup menu of dictionaries that are currently available.
Step 2
Click Install more dictionaries at the bottom of this menu. This displays a window that helps you download open source dictionaries from the OpenOffice.org web-site and install them in HelpNDoc.
Step 3
You must first download a dictionary to your computer or network before you can install it on HelpNDoc. If you have already downloaded the dictionary that you’d like to use, proceed to Step 4 below.
To download open source dictionaries from the OpenOffice.org web-site, click the link at the bottom of this window. This takes you to the page where you can review and download open source dictionaries.
Step 4
To install a dictionary, click the button to the far right of the Local OpenOffice.org dictionary file location. This displays a window that allows you to navigate to the dictionary that you’d like to install in HelpNDoc: select the dictionary and then click Open.
This closes the navigation window and displays the path and file name on your page. Click Install dictionary.
After the dictionary has been installed, a confirmation message is displayed. Click OK to close the message as well as the installation window.
The new dictionary you just installed is now displayed in the menu of available dictionaries, ready to be used in your documentation projects. By default, the newly installed dictionary is not enabled so there is no check mark next to it. The steps for activating a dictionary are outlined in another step-by-step guide: How to activate and deactivate a dictionary in HelpNDoc.
-Easy to use yet powerful help authoring environment which can generate various documentation formats from a single source. HelpNDoc provides all the tools necessary to write complete help files, manuals, documentations and eBooks in a user friendly and very easy to use environment.
HelpNDoc can generate standard Windows CHM help files, WEB based documentation, iPhone specific websites, printable PDF and Word documents as well as ePub and Kindle eBooks and cross platform Qt Help files.
HelpNDoc is completely free for personal use and evaluation purposes.
Features
-Major Features of HelpNDoc :
- Smart and stunning user interface
- Everything has been integrated
- State of the art word processor
- Powerful media library system
- Generate multiple formats
- Generate complete iPhone websites and documentation pages
- Generate cross-platform Qt Help manuals Rapidly spot and solve problems in your documentation
Videos
How to create new HelpNDoc projects