You have a variety of ways to manage your pages as you edit them.
You can preview a page by clicking on the preview page icon next to the save button. It will open up the page in a new tab, and works for Public and Hidden (unlisted) pages.
When pages are created, they will go live instantly. If you do not want your page to go live, make sure the page is set to Hidden.
To unlist a published doc, go to the Public/Hidden dropdown and ensure that it's set to Hidden.
There is no confirmation box when unlisting pages. Changes will take effect immediately.
Hidden pages are hidden from the site navigation, but users with direct links will still be able to access the pages.
Click the three dot menu above your page's title and select the Edit Metadata option. The Page Slug section is located at the bottom of the Edit Metadata pop-up menu, where you can edit the page URL. Don't forget to hit OK to save the change.
You can create three levels of pages in total: a parent page, a first-level subpage, and a second-level subpage. Hovering over any page reveals two options:
- A three dot menu where you can duplicate the page, move the page to another category, or delete the page. If the page has any related subpages, you'll need to move or delete the subpages in order to delete the page
- A plus icon which allows you to add a related Subpage. From a parent page, you can add a first-level subpage. If you click the plus icon on a first-level subpage, you can add second-level subpages. Second-level subpages do not have a plus icon because you can not add additional subpages underneath.
There are two levels of subpages: first-level and second-level. First-level subpages are nested within the parent page. You can add a first-level subpage by clicking the "+" icon next to any parent page. To create a second-level subpage which can be nested under any first-level subpage, click the "+" icon next to any subpage. To create a new parent page, click the "+" icon next to the Category name.
The "+" icon is not available on second-level subpages.
If the duplicate page is saved with the same Page Title, ReadMe will add "-1" to the page URL.
Original Page URL: /docs/introduction
Duplicate Page URL: /docs/introduction-1
You must confirm that you want to delete the page, as it we cannot recover it if deleted.
Press and hold to drag a page to any other location, including other categories, and then drop it in its desired location. First- and second-level subpages will move with the page being dragged.
You can also use the Move to function located in the three dot menu next to each page to move a page or subpage between categories.
There is no confirmation box when reordering pages. Changes will take effect immediately.
There is a three dot menu next to each category name. Within that menu there's an option to Move to API Reference if you're in the Guides section and Move to Guides if you're in the API Reference section.
You can also manage your docs using our Docs API, which allows you to return, update, delete, create, and search documentation pages.
Our rdme CLI tool can help sync your Markdown docs. This is useful for CI, or customers who may keep their documents hosted in a repository. There are a few things to remember when sync'ing your Markdown docs with rdme:
Make sure you're using a flat directory structure:
❯ ls -l
-rw-r--r-- 1 jyowell staff 165 Mar 11 15:21 file-test.md
-rw-r--r-- 1 jyowell staff 180 Mar 11 15:21 home.md
-rw-r--r-- 1 jyowell staff 125 Mar 11 15:21 settings.md
We only accept files within a directory, but no subdirectories underneath that.
excerpt: "these are my files"
This is body text for the page
Make sure each file has the following required header fields in the above format: title, slug, and category. You can add other headers too such as
hidden (boolean) to hide your document when sync'ing. Please visit https://docs.readme.com/reference/updatedoc for more header fields.
Make sure that your slug matches the actual Markdown file name.
If my page slug is file-test then the file name itself will need to be named file-test.md
If the slugs differ from the file name, we will upload a new file and cause duplicates!
Use the following commands to sync your files:
$ rdme docs <directory name> --version="<version>" --key="<project_api_key>"
Updated about 1 month ago