-
Notifications
You must be signed in to change notification settings - Fork 25
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
Add git_commit_detail directive. #21
Conversation
This directive inserts information about the state of the repository when sphinx is run to generate documentation. The following options are available: branch -- show the name of the branch commit -- show the commit hash sha_length -- number of (hex) characters to show for the commit uncommitted -- show a warning if there are uncommited changes untracked -- show a warning if there are untracked files Update documentation to include git_commit_detail. Add link to GitHub commit, with option to disable, and update the doc.
I should add that if this doesn't fit with your vision of where sphinx-git is going, I'm fine just keeping my own fork. |
I'd definitely love to merge this; let me review the PR. First up: Could you look at adding some tests? |
--------------------------- | ||
|
||
The ``git_commit_detail`` directive produces information about the current commit in the | ||
repository against which the documentation is being built. The following options are availiable: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
s/availiable/available/
Have had a quick scan through and, broadly, this looks good. Just gimme some tests. :) |
Yes of course. I got so excited I forgot about tests. :) |
OK, if the tests look good to you I can squash the commits or you can take them as is. |
Any chance this can get pulled in? |
Add git_commit_detail directive.
Merged. Thanks @pomalley! |
My pleasure. |
This directive inserts information about the state of the repository
when sphinx is run to generate documentation.
The following options are available:
branch -- show the name of the branch
commit -- show the commit hash
sha_length -- number of (hex) characters to show for the commit
uncommitted -- show a warning if there are uncommited changes
untracked -- show a warning if there are untracked files
Update documentation to include git_commit_detail.
Add link to GitHub commit, with option to disable, and update the doc.