Section 5.1 Creating Help Pages
Morph helpME displays the Pages window by default. Each Help system automatically has an index document when the Help system is created. The Index document can be edited and deleted just like any other page. For example, for this guide we edited the index to contain the title and content for the first chapter, Chapter 1 About the Morph helpME User Guide. Once a user accesses the Morph helpME User Guide, this page is first displayed.
Follow these steps to create new pages:
1. In the menu bar, click Pages. This displays:
2. In the upper right corner of the Help Page table, click Create New. The window displays the Create Help Page form:
3. Enter a unique name in the Name field. You must enter the text in this format:
chapter_number_title.
4. Type the page title in the Title field. The Title field will be displayed at the top of your help pages.
Example:
Chapter 3.1 Creating Help Pages
5. Enter a Chapter name in the field provided. The Chapter field is used to create the Table of Contents. By default, the Table of Contents is displayed to the left of the help pages, as you see is this guide. The Chapter field typically contains the chapter number and chapter title.
Example:
3.1 Creating Help Pages
You must manually enter your section numbers and chapter numbers into the Chapter field, which is explained in this chapter. Morph helpME will then automatically sort them into the correct order.
6. To include tags, enter Tags in the field provided. If you wish to add Tags in the list, refer to Section 7.1 Creating Tags.
You can enter tags by doing any of the following:
- Select and enter tags which were added using the Tags menu. Once you type a letter, the saved tags are displayed on a drop-down list. For more information on this, refer to Chapter 7 Using Tags .
- You can also automatically create new tags by entering any text in the Tags field.
Tags refer to labels or keywords that you add to a help page. When you create new pages, you should add tags to help group similar content and make it easier for your end-user to find information.
7. Enter Content in the field provided. The Preview is shown below the Content box.
8. If you wish to format your content, you may use the various menu buttons shown across the top of the Content box. Alternatively, you can use the Textile Markup Language which allows you more control and has more features. With Textile, you can embed markup characters in the text to format the document. For example, to bold a word the text in the Content box would look like this:
This is *BOLD*.
The Textile Markup Language is explained in a later section.
The formatting menu buttons are explained as follows:
- Bold – This will change the selected text into boldface.
- Italicize – This prints text in italics.
- Underline – This places a horizontal line below the text.
- Strikethrough – This marks a horizontal line through the center of the text.
- Numbered List – This adds numbers in your list.
- Bulleted List – This adds bullets in your list.
- Paragraph – Use the Paragraph button to create a new paragraph.
- Heading 1 – Select this to use the heading 1 style.
- Heading 2 – Select this to use the heading 2 style.
- Heading 3 – Select this to use the heading 3 style.
- Heading 4 – Select this to use the heading 4 style.
- Blockquote – Use this button to set off a quotation that renders an indented text.
- Outdent – Use this button to increase the left margin.
- Indent – Use this button to increase the right margin.
- Left Align – Select this button to align text to the left.
- Center – Select this button to align text to the center.
- Right Align – Select this button to align text to the right.
- Justify – Select this button to align text on both edges.
- Insert Image – To add images, select this menu button. Refer to Section 5.1.1 Inserting Images for a detailed procedure.
- Insert Resource – To add resources, select this menu button. Refer to Section 5.1.2 Inserting Resources for a detailed procedure.
- Insert Movie – To add movies, select this button. Refer to Section 5.1.3 Inserting Movies for a detailed procedure.
- Insert Page Link – To insert a link to another page, select this menu button. Refer to Section 5.1.4 Inserting Page Links for a detailed procedure.
9. If you wish to see the Textile Quick Reference, select textile markup (see the circled items on the figure below). You may also click detailed reference to see the detailed textile reference guide. For more information, refer to Section 5.1.6 Using Textile Markup.
10. Click Create to save and add the help page. Otherwise, click Cancel.
Morph helpME automatically publishes your help pages and makes them publicly available. To preview your help site, click Preview Site or refer to Chapter 12 Previewing Site for more information. You may also refer to Chapter 6.1 Adding a Subscription of the Morph eXchange User Guide.