Ability to have sub sections broken out in pages
ryan-perry opened this issue · 6 comments
Like others posting, this is a great app.
I'm trying to break out sections into separate pages. So I could have a category but then have sub-categories all be separate pages.
Components /components.html
- Buttons /components-buttons.html
- Banners /components-banners.html
When I try to create pages for the sub sections the components-buttons.html page is blank and since I'm referencing the sectionof those sub sections get displayed on whatever the parent section is.
Could you provide a code example of what you're currently doing? If I understand you correctly, you're trying to do something like this:
/**
* @page Components
*/
/**
* @page Buttons
*/
/**
* @page Banners
*/
But then have the Buttons and Banners also be linked from the Components page?
That's exactly it. Essentially I was trying to use the following snippet. The banner and button content is displayed on the Components page while the separate pages are blank. I'm wonder if creating a new tag might work.
/**
* @section Components
* @page Components
*/
/**
* @section Buttons
* @sectionof Components
* @page Buttons
*/
/**
* @section Banners
* @sectionof Components
* @page Banners
*/
Sorry this is taking a bit, I've been trying to get an npm install running on this project but it keeps failing.
What exactly do you want the output to look like? Does the component page just contain links to the other 2 pages or does it contain the entirety of the Buttons and Banner sections (essentially duplicating the section content in both pages)?
No worries. Having the parent category page be a listing page for its child sections and each child section be an individual page would be great. Thanks for investigating.
If that's the case, since the logic to create a page is just name.html
, you could use links in the description.
/**
* [Buttons](/buttons.html)
* [Banners](/banners.html)
*
* @section Components
* @page Components
*/
/**
*@section Buttons
* @page Buttons
*/
/**
* @section Banners
* @page Banners
*/
I know it's not as automatic, but from the code it seems a new tag would have to be created to just create links on the parent page while showing full sections on the children pages
Closing due to inactivity. Please reopen if you wish to continue the discussion.