feat: Implement configurable independent community sub-sites with modular navigation base on verl#111
feat: Implement configurable independent community sub-sites with modular navigation base on verl#111justbin-coder wants to merge 1 commit intoAscend:mainfrom
Conversation
CLA Signature Passjustbin-coder, thanks for your pull request. All authors of the commits have signed the CLA. 👍 |
1 similar comment
CLA Signature Passjustbin-coder, thanks for your pull request. All authors of the commits have signed the CLA. 👍 |
389eddf to
86defb6
Compare
CLA Signature Passjustbin-coder, thanks for your pull request. All authors of the commits have signed the CLA. 👍 |
86defb6 to
2bd7f4a
Compare
CLA Signature Passjustbin-coder, thanks for your pull request. All authors of the commits have signed the CLA. 👍 |
2bd7f4a to
2b1830a
Compare
CLA Signature Passjustbin-coder, thanks for your pull request. All authors of the commits have signed the CLA. 👍 |
1 similar comment
CLA Signature Passjustbin-coder, thanks for your pull request. All authors of the commits have signed the CLA. 👍 |
9cd7dbc to
c0e794d
Compare
CLA Signature Passjustbin-coder, thanks for your pull request. All authors of the commits have signed the CLA. 👍 |
c0e794d to
f786fde
Compare
CLA Signature Passjustbin-coder, thanks for your pull request. All authors of the commits have signed the CLA. 👍 |
1 similar comment
CLA Signature Passjustbin-coder, thanks for your pull request. All authors of the commits have signed the CLA. 👍 |
4b63b32 to
5a2e814
Compare
CLA Signature Passjustbin-coder, thanks for your pull request. All authors of the commits have signed the CLA. 👍 |
…ular navigation base on verl docs: add myst_parser dependency and FAQ section to documentation - Add myst_parser to environment dependencies - Implement FAQ module in the documentation pages
5a2e814 to
48c102e
Compare
CLA Signature Passjustbin-coder, thanks for your pull request. All authors of the commits have signed the CLA. 👍 |
|
What's in _static/ascend_config.json, such a huge change |
verview
This PR introduces a generic, highly extensible solution for "independent community sub-sites". Using the
verlcommunity as the first use case, it achieves sidebar content isolation, modular navigation based on the developer journey, and dynamic extraction of in-page TOCs for long documents. Future communities can be onboarded seamlessly by simply updating a configuration dict without any code changes.Core Modifications
conf.py: Added theindependent_communitiesdictionary and anupdate_page_contexthook to intercept paths during build and dynamically inject community configs to the frontend._templates/layout.html: Utilized JS to dynamically reconstruct the DOM. It extracts the current community's directory tree, generates native-compliant category captions, and smartly elevates deep TOC levels to display inner headings._static/custom.css: Added dedicated styles for#independent-sidebar, perfectly inheriting the active highlights and collapsible interactions of the native Sphinx RTD theme.include) to resolve duplicate H1 conflicts and blank rendering issues.Testing & Effects
verlcommunity exclusively displays its own documents in the left sidebar, successfully hiding global unrelated content.