Replies: 3 comments
-
+1! Also, if we could add subcommand support, that'd be really powerful! As a theme and plugin author, I'd really love if MkDocs could offer all of the following extension capabilities:
For instance, subcommands would allow the blog plugin of Material for MkDocs to make it easy to scaffold a new post. Custom YAML tags would allow to solve things like #3331. I've thought about creating a CLI for Material for MkDocs, but hooking into the |
Beta Was this translation helpful? Give feedback.
-
As for log levels (#2876 ) and overall better debugging while developing, I have created a plugin for that, called pub-debugger. This is core functionality for development, but not sure if we want to invest much time in it since default console logging is usefull for normal user. More in depth view is only needed during development phase. |
Beta Was this translation helpful? Give feedback.
-
Hey @tomchristie, we were experimenting with this board, but you're right that this is a meta-issue and therefore more suited to discussions 👍 |
Beta Was this translation helpful? Give feedback.
-
MkDocs could gain at better exposing and documenting its API.
Some of it could help plugin/extension authors (reusing Markdown treeprocessors), but is not exposed. Some of it must be imported for integration within other Python tools, but is not exposed (entrypoints in
__main__
). Some of it is documented under API reference, some of it under Plugins, some of it is not documented.Side note: One reason I started using MkDocs and writing mkdocstrings was to have all auto-documented objects (API autodoc) appear in the table of contents. But the default
mkdocs
theme does not allow that 😢Relevant issues:
Beta Was this translation helpful? Give feedback.
All reactions