Creating Documentation Pages
After adding a page, details such as page title, page content, CSS, JavaScript, and page visibility can be set. All documentation pages are published under the path /docs. Side navigation links are generated automatically for the documentation pages.
Procedure
To create a documentation page:
- On the Content page, click New Item.
A popup menu opens with the following type of page options.
-
Custom Page
-
Documentation Page
-
Blog Post
-
Click Documentation Page.
A page is added to the Documentation folder in Draft mode.
-
Enter the page title in the Page Title field.
-
In the Body section, enter the text. Using the editor, you can format the text. For more information about the editor, see WYSIWYG Editor.
-
Click the page mode drop-down list and select Publish to publish the page on the Portal.
The users cannot view pages on the Portal that are in Draft mode. When a published page is switched to Draft mode, it is no longer public.
-
Click Save.
The page is saved and published on the Portal.
The following are the rules for organizing pages and folders in CMS under the Documentation pages section:
-
When a folder is created, a default page for the folder is added.
-
The default page name in the Advanced Options page cannot be set or be changed.
-
The default page cannot be deleted.
-
Folder name cannot be changed after it is saved.
-
A new folder cannot be created with the name of an existing page.
-
Pages with same page title can exist in different folders.
-
A page cannot be moved from one folder to another folder.
-
Page sequence can be changed by dragging the file to the new location.
-
To add a page to a folder, click the folder, and then click Create new page in "folder name" on the right panel.