-
-
Notifications
You must be signed in to change notification settings - Fork 625
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[FEATURE] Sphinx plugin #100
Comments
So, this would actually be a feature request for Typer CLI not for Typer itself. I'm personally not a fan of Sphinx and reStructuredText 😅 But maybe if supporting it is not very complex and can be done in a similar way as Markdown I would probably accept PRs there. |
It does not need to be reStructuredText, markdown works just fine with Sphinx 👍 |
Ah, cool! Although in that case, I'm not sure I understand what would be the feature request 🤔 |
I was thinking of the following:
|
I see. Well, discarding the title page could be done in Typer CLI, I would probably take a PR with a Having it integrated with Sphinx like |
Assuming the original issue was solved, it will be automatically closed now. But feel free to add more comments or create new issues. |
Did anyone do any work on this? I'm in the process of starting a new cli-project, and it would be very nice to have some automated docs, like |
Is your feature request related to a problem
I want to be able to integrate the generation of the CLI documentation to the documentation I build with Sphinx.
The solution you would like
A sphinx plugin seems like the perfect candidate. Something like sphinx-click.
Describe alternatives you've considered
The workaround I am using is to modify the
Makefile
provided by Sphinx to generate the Typer documentation with typer-cli:Here is the actual file.
Additional context
Here is the project I am using Typer with: tfpy. And its documentation.
The text was updated successfully, but these errors were encountered: