You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I have a CHANGELOG.md file that doesn't fit to any particular function documentation.
I want to create an extra page in the main index listing to show this file.
Any Idea?
Proposal
No concrete ideas, maybe we can add the markdown files in the tree and add them as a "fake module" at that level?
Alternatives
Additional context
I'm documenting several packages, because this is only one project.
I extended the default template index to have a generic landing page.
I also changed the modules listing to make the top level bold (code here below, maybe useful to other).
I have a CHANGELOG.md file that doesn't fit to any particular function documentation. I want to create an extra page in the main index listing to show this file. Any Idea?
I'd just link to GitHub/... for the changelog. Alternatively, you can create a CHANGELOG.py file and include that in your pdoc invocation (pdoc your_module ./CHANGELOG.py). That feels a bit messy, but may be what you are after.
Thanks for the answer @mhils.
Your way is nice, but my project is not on github, and probably will never be (internal gitlab at work, internal bitbucket at ESA etc).
The "fake" CHANGELOG.py approach hit me too, I didn't know I can include a file like this, I'll give it a try.
first of all, thanks, pdoc is amazing!
Problem Description
I have a CHANGELOG.md file that doesn't fit to any particular function documentation.
I want to create an extra page in the main index listing to show this file.
Any Idea?
Proposal
No concrete ideas, maybe we can add the markdown files in the tree and add them as a "fake module" at that level?
Alternatives
Additional context
I'm documenting several packages, because this is only one project.
I extended the default template index to have a generic landing page.
I also changed the modules listing to make the top level bold (code here below, maybe useful to other).
Project structure :
Extra
this is my
index.html.jinja2
, this overwrites thenav
block entirely.The text was updated successfully, but these errors were encountered: