Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Adds needs/requirements to sphinx

License

NotificationsYou must be signed in to change notification settings

useblocks/sphinx-needs

Complete documentation:http://sphinx-needs.readthedocs.io/en/latest/

Attention:sphinxcontrib-needs got renamed tosphinx-needs. This affects also the URLs for documentation and repository:

Introduction

Sphinx-Needs allows the definition, linking and filtering of class-like need-objects, which are by default:

  • requirements
  • specifications
  • implementations
  • test cases.

This list can be easily customized via configuration (for instance to support bugs or user stories).

A default requirement need looks like:

https://raw.githubusercontent.com/useblocks/sphinxcontrib-needs/master/docs/_images/need_1.png

Layout and style of needs can be highly customized, so that a need can also look like:

https://raw.githubusercontent.com/useblocks/sphinxcontrib-needs/master/docs/_images/need_2.png

Take a look into ourExamples for morepictures and ideas how to useSphinx-Needs.

For filtering and analyzing needs,Sphinx-Needs provides different, powerful possibilities:

needtableneedflowneedpie
https://raw.githubusercontent.com/useblocks/sphinxcontrib-needs/master/docs/_images/needtable_1.pnghttps://raw.githubusercontent.com/useblocks/sphinxcontrib-needs/master/docs/_images/needflow_1.pnghttps://raw.githubusercontent.com/useblocks/sphinxcontrib-needs/master/docs/_images/needpie_1.png

Installation

Using pip

pip install sphinx-needs

If you wish to also use the plotting features of sphinx-needs (seeneedbar andneedpie), you need to also installmatplotlib, which is availablevia theplotting extra:

pip install sphinx-needs[plotting]

Note

Prior version1.0.1 the package was namedsphinxcontrib-needs.

Using sources

git clone https://github.com/useblocks/sphinx-needscd sphinx-needspip install.

Activation

For final activation, please add sphinx_needs to the project's extension list of yourconf.py file.

extensions= ["sphinx_needs",]

Note

Prior version1.0.1 the extensions was calledsphinxcontrib.needs.


[8]ページ先頭

©2009-2025 Movatter.jp