WWW-www.enlightenment.org pushed a commit to branch master. http://git.enlightenment.org/website/www-content.git/commit/?id=64d919509d1cb1e64781b7b886ee84230aa9a2bb
commit 64d919509d1cb1e64781b7b886ee84230aa9a2bb Author: Andrew Williams <[email protected]> Date: Thu Nov 30 06:43:12 2017 -0800 Wiki page documentation-guide.md changed with summary [sidebar -> navigation] by Andrew Williams --- pages/contrib/docs/documentation-guide.md.txt | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/pages/contrib/docs/documentation-guide.md.txt b/pages/contrib/docs/documentation-guide.md.txt index 3e28436e1..843a1e78b 100644 --- a/pages/contrib/docs/documentation-guide.md.txt +++ b/pages/contrib/docs/documentation-guide.md.txt @@ -239,11 +239,11 @@ Note that although Markdown does not require the numbers to be in the right orde At present, sub-lists are only correctly rendered in unordered bullet list format and will not display correctly in numbered list format. -## Sidebars ## +## Navigation ## -Documentation namespaces should have *sidebars*, permanent boxes visible on all pages providing quick navigation through that namespace. These sidebars exist as a page named "sidebar" in the parent namespace. +Documentation namespaces should have *navigation* sidebars, permanent boxes visible on all pages providing quick navigation through that namespace. These navigation elements are controlled by a page named "navigation" in the root of each top level namespace. Each navigation file is a hierarchical list of links for the entire namespace tree - child pages will be displayed when the parent page is being displayed so we can keep the navigation manageable. -When creating a new document in a namespace, or moving an existing document, always update the sidebar. To do so, find the sidebar file: the sidebar for the "/contrib" namespace, for example, is "/contrib/sidebar". +When creating a new document in a namespace, or moving an existing document, always update the navigation file. To do so, find the right file for the namespace: the navigation file for the "/contrib" namespace, for example, is "/contrib/navigation". The format of a sidebar is shown below: @@ -260,7 +260,7 @@ The format of a sidebar is shown below: * [[/contrib/docs/eo | Eolian File Format]] ``` -Note that these pages are in DokuWiki markup format, not Markdown Extra. Each entry in the sidebar should be in the form of a DokuWiki link; if the page to which you are linking has the DokuWiki title set in the frontmatter this will be pulled through and used as the display text. To override this title, or to link to a page which does not yet exist and thus has no title, use a pipe character followed by your preferred link text. +Note that these pages are in DokuWiki markup format, not Markdown Extra. Each entry in the navigation should be in the form of a DokuWiki link; if the page to which you are linking has the DokuWiki title set in the frontmatter this will be pulled through and used as the display text. To override this title, or to link to a page which does not yet exist and thus has no title, use a pipe character followed by your preferred link text. > **NOTE:** > Always include the ``.md`` extension when linking to a page in Markdown > format. Although the link will work without it, DokuWiki will not be able to > retrieve the title tag for sidebar display. --
