mirror of
https://github.com/python-escpos/python-escpos
synced 2025-08-24 09:03:34 +00:00
update read the docs config (#520)
* update read the docs config * add hints on black code style * add link to black * fix path to requirements * include submodules in build * add submodule capabilities-data * format as list * post on execution on RTD * use sphinx rtd theme 1.2.0 * add apt dependencies
This commit is contained in:
@@ -17,23 +17,20 @@ Author-list
|
||||
|
||||
This project keeps a list of authors. This can be auto-generated by calling `./doc/generate-authors.sh`.
|
||||
When contributing the first time, please include a commit with the output of this script in place.
|
||||
Otherwise the integration-check will fail.
|
||||
|
||||
When you change your username or mail-address, please also update the `.mailmap` and the authors-list.
|
||||
You can find a good documentation on the mapping-feature in the `documentation of git-shortlog <https://git-scm.com/docs/git-shortlog#_mapping_authors>`_.
|
||||
You can find a good documentation on the mapping-feature in the
|
||||
`documentation of git-shortlog <https://git-scm.com/docs/git-shortlog#_mapping_authors>`_.
|
||||
|
||||
Style-Guide
|
||||
-----------
|
||||
|
||||
When writing code please try to stick to these rules.
|
||||
|
||||
PEP8
|
||||
^^^^
|
||||
The entire codebase adheres to the rules of PEP8.
|
||||
These rules are enforced by running `flake8` in the integration-checks.
|
||||
Please adhere to these rules as your contribution can only be merged if the check succeeds.
|
||||
You can use flake8 or similar tools locally in order to check your code.
|
||||
Apart from that the travis-log and the check by Landscape will provide you with hints.
|
||||
Black Code Style
|
||||
^^^^^^^^^^^^^^^^
|
||||
This project is formatted with the auto formatter `black <https://github.com/psf/black>`_.
|
||||
Please format your contributions with black, otherwise they will be rejected.
|
||||
|
||||
GIT
|
||||
^^^
|
||||
|
Reference in New Issue
Block a user