Download - Tips on Online Help
![Page 1: Tips on Online Help](https://reader036.vdocument.in/reader036/viewer/2022082819/56813d34550346895da6f7c4/html5/thumbnails/1.jpg)
Tips on Online Help
Tharun Unni
![Page 2: Tips on Online Help](https://reader036.vdocument.in/reader036/viewer/2022082819/56813d34550346895da6f7c4/html5/thumbnails/2.jpg)
About this Presentation
• Access Points in Online Help
• Life Cycle
• Choosing a Delivery Format
• Authoring Tool
• Authoring Process
• Intergrating with the Software
• Platform-Specific Issues
![Page 3: Tips on Online Help](https://reader036.vdocument.in/reader036/viewer/2022082819/56813d34550346895da6f7c4/html5/thumbnails/3.jpg)
Access Points in Online Help
• Task-Oriented Topics– Table of Contents (TOC)– Topics
• Context-Sensitive Help:– Dialog Level– Field Level (What’s This Help)
• Other Modes of Access – Index – Search– Favorites
![Page 4: Tips on Online Help](https://reader036.vdocument.in/reader036/viewer/2022082819/56813d34550346895da6f7c4/html5/thumbnails/4.jpg)
Life Cycle
• Decide the Delivery Format• Choose an Authoring Tool
– Use a Help Authoring Tool– Use a Publishing Tool and convert the source
using the Help Authoring Tool
• Follow the Documentation Life Cycle• Integration and Delivery• Platform-Specific Issues
![Page 5: Tips on Online Help](https://reader036.vdocument.in/reader036/viewer/2022082819/56813d34550346895da6f7c4/html5/thumbnails/5.jpg)
Choosing a Delivery Format
• Platform-Dependent (compiled)– CHM – HLP files
• Platform-Independent – HTML/XML files – Applets – Images
![Page 6: Tips on Online Help](https://reader036.vdocument.in/reader036/viewer/2022082819/56813d34550346895da6f7c4/html5/thumbnails/6.jpg)
Choose an Authoring Tool
• HTML + Notepad + Compiler• Authoring tool
– RoboHelp: • Author in RoboHelp• Convert from other sources such as Word or
FrameMaker
– Webworks Publisher• Convert from other sources such as Word or
FrameMaker
![Page 7: Tips on Online Help](https://reader036.vdocument.in/reader036/viewer/2022082819/56813d34550346895da6f7c4/html5/thumbnails/7.jpg)
Authoring Process
• Typical documentation development life cycle• Building Blocks
– HTML, XML, or RTF
– Images
– Project Files• Build or Project File (HPJ or HHP)
• Table of Contents (CNT)
• Index (IDX)
![Page 8: Tips on Online Help](https://reader036.vdocument.in/reader036/viewer/2022082819/56813d34550346895da6f7c4/html5/thumbnails/8.jpg)
Integrating with Software
• Compiled– Decide who will assign the help topic IDs– Include MAP files in the Project File
• #define topic_name NUM
• Authoring tool may have an automatically generate MAP File option.
• If you cannot disable this, take a backup copy of your map file.
![Page 9: Tips on Online Help](https://reader036.vdocument.in/reader036/viewer/2022082819/56813d34550346895da6f7c4/html5/thumbnails/9.jpg)
Platform-Specific Issues
• On Unix and Linux:– filenames are case-sensitive– filename should not contain blank spaces– path is indicated by “/” and not “\”– directory access privileges should be
configured– use relative path for images and URLs– Netscape is a popular browser