Comments (4)
The proposed implementation is as follows.
- Add
categoryLayout
option tometadata
section. - If
"categoryLayout": "nested"
option is enabled.
Reorganize TOC structure as described at #9933 (comment).
If there seems to be no particular problems. I'll create PR later.
Config document to be added
categoryLayout
Specifies how categories in TOC are organized:
flattened
(default): Renders namespaces as a plain label.nested
: Renders category in a nested tree form.
Note
This setting is is available when using ApiPage
or Markdown
output format. mref
format don't support categories.
from docfx.
We could incorporate this change if there is sufficient interest. Please upvote if you find this useful.
from docfx.
What is the best way to Upvote? In this issue or in the original discussion thread?
from docfx.
Also, I want to also add that -
when I use outputFormat = apiPage, my custom template is not being used. I lose the ability to customize the site with my template (partial files, main.js, etc).
If there is a workaround for this, please let me know.
from docfx.
Related Issues (20)
- [Bug] Unable to find package docs.validation, Microsoft.Docs.MetadataService.Models, docs.validation.analyzer HOT 1
- [Bug] .NET API bug - Nullable project throws error telling I should enable nullable HOT 3
- [Bug] Build-time TOC customization with `toc.extension.js` is not works when using `modern` template HOT 1
- [Bug] DocfxException: Cannot find .NET Core SDK to compile the project (but .net core 8.0.300 sdk is installed) HOT 1
- [Feature Request] Include Markdown Files by UID
- [Bug] Opening angle bracket not escaped in Markdown output HOT 1
- [Bug] Navigation area left-margin is changed when navigating between pages
- [Feature Request] Supports MPA View Transition
- [Feature Request] Unable to customize the "Inherited members" section using class.header.tmpl.partial when using apiPage outputFormat.
- [Feature Request] Add MarkdownContext to BuildOptions.ConfigureMarkdig
- [Feature Request] Support faster deserialization of `OneOf` based types
- [Bug] Ignoring global namespace prevents metadata to generate api folder HOT 5
- [Feature Request] Generate docs ONLY for stuff with the /// comment. HOT 2
- [Feature Request] Additional Schemas HOT 1
- [Feature Request] Support `Overwrite Files` feature for `"outputFormat": "apiPage"`
- [Bug] DotnetApiCatalog.GenerateManagedReferenceYamlFiles() hangs indefinitely on 2.76.0 HOT 2
- [Feature Request] My awesome feature
- [Feature Request] Allow SourceLink support to be disabled
- [Feature Request] Create Categories or Tags for search
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from docfx.