tomjoht / documentation-theme-jekyll

A Jekyll-based theme designed for documentation and help systems. See the link for detailed instructions on setting up and configuring everything.
http://idratherbewriting.com/documentation-theme-jekyll/
Other
1.17k stars 1.19k forks source link

How do I create a folder with only subfolders #192

Closed depst closed 4 years ago

depst commented 4 years ago

According to the docs:

If you need a hierarchy that has a folder that contains other folders and no loose topics, use a blank - item

I can't get that to work to create a folder that contains subfolders but no loose topics. I.e., I want the Mzone folder to contain just the Deploy, Phases, and Considerations subfolders. I want to get rid of the Start Here standalone topic.

image

Here's my sidebar.yml file. How can I get rid of the standalone topic under Mzone?

entries:
- title: sidebar-runbooks
  #product: Features
  folders:

  - title: Runbooks
    output: web
    folderitems:

    - title: Overview
      url: /rbk-overview.html
      output: web

  - title: Mzone
    output: web
    folderitems:

    - title: Start Here
      url: /searching.html
      output: web

      subfolders:
      - title: Deploy
        output: web
        subfolderitems:

        - title: Core Network
          url: /tag_formatting.html
          output: web

        - title: xCAT0
          url: /tag_navigation.html
          output: web
depst commented 4 years ago

Found the solution. To create a folder with only subfolders, first specify a blank folder item (including the attribute keys):

 - title: 
      url: 
      output: web