##########################
sphinxcontrib-issuetracker
##########################
.. image:: https://secure.travis-ci.org/lunaryorn/sphinxcontrib-issuetracker.png
:target: http://travis-ci.org/lunaryorn/sphinxcontrib-issuetracker
http://sphinxcontrib-issuetracker.readthedocs.org/
A Sphinx_ extension to reference issues in issue trackers, either explicitly
with an "issue" role or optionally implicitly by issue ids like ``#10`` in
plaintext.
Currently the following issue trackers are supported:
- `GitHub <http://github.com>`_
- `BitBucket <http://bitbucket.org>`_
- `Launchpad <https://launchpad.net>`_
- `Google Code <http://code.google.com>`_
- `Debian BTS <http://bugs.debian.org>`_
- `Jira <http://www.atlassian.com/software/jira/>`_
A simple API is provided to add support for other issue trackers. If you added
support for a new tracker, please consider sending a patch to make your work
available to other users of this extension.
Installation
------------
This extension can be installed from the `Python Package Index`_::
pip install sphinxcontrib-issuetracker
This extension requires Sphinx 1.1 and Pythonn 2.6 or Python 3.1.
Usage
-----
Just add this extension to ``extensions`` and configure your issue tracker::
extensions = ['sphinxcontrib.issuetracker']
issuetracker = 'github'
issuetracker_project = 'lunaryorn/sphinxcontrib-issuetracker'
Now issue references like ``#10`` are replaced with links to the issue tracker
of this extension, unless the reference occurs in literal text like inline
literals or code blocks.
You can disable this magic behaviour by setting issuetracker_plaintext_issues
to ``False``::
issuetracker_plaintext_issues = False
Now textual references are no longer replaced. However, you can still explicitly
reference issues with the ``issue`` role.
For more details refer to the documentation_.
Support
-------
Please report issues to the `issue tracker`_ if you have trouble, found a bug in
this extension or lack support for a specific issue tracker, but respect the
following rules:
- Check that the issue has not already been reported.
- Check that the issue is not already fixed in the ``master`` branch.
- Open issues with clear title and a detailed description in grammatically
correct, complete sentences.
Development
-----------
The source code is hosted on Github_:
git clone https://github.com/lunaryorn/sphinxcontrib-issuetracker
Please fork the repository and send pull requests with your fixes or cool new
features, but respect the following rules:
- Read `how to properly contribute to open source projects on GitHub
<http://gun.io/blog/how-to-github-fork-branch-and-pull-request/>`_.
- Use a topic branch to easily amend a pull request later, if necessary.
- Write `good commit messages
<http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html>`_.
- Squash commits on the topic branch before opening a pull request.
- Respect :pep:`8` (use `pep8`_ to check your coding style compliance)
- Add unit tests
- Open a `pull request <https://help.github.com/articles/using-pull-requests>`_
that relates to but one subject with a clear title and description in
grammatically correct, complete sentences.
.. _Sphinx: http://sphinx.pocoo.org/latest
.. _documentation: http://sphinxcontrib-issuetracker.readthedocs.org
.. _Python package index: http://pypi.python.org/pypi/sphinxcontrib-issuetracker
.. _issue tracker: https://github.com/lunaryorn/sphinxcontrib-issuetracker/issues/
.. _pep8: http://pypi.python.org/pypi/pep8/
Raw data
{
"_id": null,
"home_page": "http://sphinxcontrib-issuetracker.readthedocs.org/",
"name": "sphinxcontrib-issuetracker",
"maintainer": null,
"docs_url": "https://pythonhosted.org/sphinxcontrib-issuetracker/",
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Sebastian Wiesner",
"author_email": "lunaryorn@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/bd/dc/7802f5cb801e9af00372dd95dc58de6f3b3821082b33acae1b159789f939/sphinxcontrib-issuetracker-0.11.tar.gz",
"platform": "any",
"description": "##########################\nsphinxcontrib-issuetracker\n##########################\n\n.. image:: https://secure.travis-ci.org/lunaryorn/sphinxcontrib-issuetracker.png\n :target: http://travis-ci.org/lunaryorn/sphinxcontrib-issuetracker\n\nhttp://sphinxcontrib-issuetracker.readthedocs.org/\n\nA Sphinx_ extension to reference issues in issue trackers, either explicitly\nwith an \"issue\" role or optionally implicitly by issue ids like ``#10`` in\nplaintext.\n\nCurrently the following issue trackers are supported:\n\n- `GitHub <http://github.com>`_\n- `BitBucket <http://bitbucket.org>`_\n- `Launchpad <https://launchpad.net>`_\n- `Google Code <http://code.google.com>`_\n- `Debian BTS <http://bugs.debian.org>`_\n- `Jira <http://www.atlassian.com/software/jira/>`_\n\nA simple API is provided to add support for other issue trackers. If you added\nsupport for a new tracker, please consider sending a patch to make your work\navailable to other users of this extension.\n\n\nInstallation\n------------\n\nThis extension can be installed from the `Python Package Index`_::\n\n pip install sphinxcontrib-issuetracker\n\nThis extension requires Sphinx 1.1 and Pythonn 2.6 or Python 3.1.\n\n\nUsage\n-----\n\nJust add this extension to ``extensions`` and configure your issue tracker::\n\n extensions = ['sphinxcontrib.issuetracker']\n\n issuetracker = 'github'\n issuetracker_project = 'lunaryorn/sphinxcontrib-issuetracker'\n\nNow issue references like ``#10`` are replaced with links to the issue tracker\nof this extension, unless the reference occurs in literal text like inline\nliterals or code blocks.\n\nYou can disable this magic behaviour by setting issuetracker_plaintext_issues\nto ``False``::\n\n issuetracker_plaintext_issues = False\n\nNow textual references are no longer replaced. However, you can still explicitly\nreference issues with the ``issue`` role.\n\nFor more details refer to the documentation_.\n\n\nSupport\n-------\n\nPlease report issues to the `issue tracker`_ if you have trouble, found a bug in\nthis extension or lack support for a specific issue tracker, but respect the\nfollowing rules:\n\n- Check that the issue has not already been reported.\n- Check that the issue is not already fixed in the ``master`` branch.\n- Open issues with clear title and a detailed description in grammatically\n correct, complete sentences.\n\n\nDevelopment\n-----------\n\nThe source code is hosted on Github_:\n\n git clone https://github.com/lunaryorn/sphinxcontrib-issuetracker\n\nPlease fork the repository and send pull requests with your fixes or cool new\nfeatures, but respect the following rules:\n\n- Read `how to properly contribute to open source projects on GitHub\n <http://gun.io/blog/how-to-github-fork-branch-and-pull-request/>`_.\n- Use a topic branch to easily amend a pull request later, if necessary.\n- Write `good commit messages\n <http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html>`_.\n- Squash commits on the topic branch before opening a pull request.\n- Respect :pep:`8` (use `pep8`_ to check your coding style compliance)\n- Add unit tests\n- Open a `pull request <https://help.github.com/articles/using-pull-requests>`_\n that relates to but one subject with a clear title and description in\n grammatically correct, complete sentences.\n\n\n.. _Sphinx: http://sphinx.pocoo.org/latest\n.. _documentation: http://sphinxcontrib-issuetracker.readthedocs.org\n.. _Python package index: http://pypi.python.org/pypi/sphinxcontrib-issuetracker\n.. _issue tracker: https://github.com/lunaryorn/sphinxcontrib-issuetracker/issues/\n.. _pep8: http://pypi.python.org/pypi/pep8/",
"bugtrack_url": null,
"license": "BSD",
"summary": "Sphinx integration with different issuetrackers",
"version": "0.11",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "69c2f0e5770c5d7bad73f60f8d764e28",
"sha256": "843753d8b5e989116378ab45ecccb368fb78dc56eaa1554ed25e4fbf22745f4e"
},
"downloads": -1,
"filename": "sphinxcontrib-issuetracker-0.11.tar.gz",
"has_sig": false,
"md5_digest": "69c2f0e5770c5d7bad73f60f8d764e28",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 30351,
"upload_time": "2013-01-17T11:21:34",
"upload_time_iso_8601": "2013-01-17T11:21:34.966872Z",
"url": "https://files.pythonhosted.org/packages/bd/dc/7802f5cb801e9af00372dd95dc58de6f3b3821082b33acae1b159789f939/sphinxcontrib-issuetracker-0.11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2013-01-17 11:21:34",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "sphinxcontrib-issuetracker"
}
JSON