razonyang / hugo-theme-bootstrap-comments

1 stars 0 forks source link

v1/en/docs/getting-started/introduction/ #62

Closed utterances-bot closed 2 years ago

utterances-bot commented 2 years ago

Introduction - Hugo Theme Bootstrap Docs v1

Hugo Bootstap Theme(HBS) is a fast, responsive, multipurpose and feature-rich Hugo theme. It is used for blog and document sites typically.

https://hbs.razonyang.com/v1/en/docs/getting-started/introduction/

razonyang commented 2 years ago

Hello World.

digitalblackboard commented 2 years ago

Hi. I realize all the subfolders in the 'docs' folder are shown in the docs navigation panel on the left. For a large project, the docs-nav panel will quickly become cluttered (with perhaps unrelated topics). Is there an option to display only the subfolders that reside within the current folder I am navigating? E.g. If I am currently navigating "Getting Started", I will only see the 4 subfolders: 'Introduction', 'Prerequisites', 'Installation' and 'Upgradation'.

razonyang commented 2 years ago

Hi @digitalblackboard, I think the nav should be consistent for a same project. You may need to move the irrelevant pages to other projects, there is a way to split the nav from different projects that creating a new top section, such as project-foo, project-bar, and then specify the type as docs in page front matter. In this way, you can split the docs from different projects.

See also: https://hbs.razonyang.com/v1/en/docs/content/#content-types.

Please add your new section to mainSections.

The structure example:

├── project-foo
│   ├── _index.md
│   ├── installation
│   │   ├── _index.md
│   │   ├── linux
│   │   │   ├── _index.md
│   │   │   ├── archlinux
│   │   │   │   └── index.md
│   │   │   └── ubuntu
│   │   │       └── index.md
│   │   └── windows
│   │       └── index.md
│   └── introduction
│       └── index.md
├── project-bar
│   ├── _index.md
│   ├── installation
│   │   ├── _index.md
│   │   ├── linux
│   │   │   ├── _index.md
│   │   │   ├── archlinux
│   │   │   │   └── index.md
│   │   │   └── ubuntu
│   │   │       └── index.md
│   │   └── windows
│   │       └── index.md
│   └── introduction
│       └── index.md
digitalblackboard commented 2 years ago

Thanks. Done!