diff options
| author | Markus Heiser <markus.heiser@darmarit.de> | 2020-10-29 13:31:11 +0100 |
|---|---|---|
| committer | Alexandre Flament <alex@al-f.net> | 2020-10-30 20:30:20 +0100 |
| commit | e697d78d5a907014252df9aec79d981b800aac91 (patch) | |
| tree | 9b8f94fcf13da458a96d69a2347b942a67880fc5 /docs | |
| parent | 54afe37e18cdbf4fd858907f0a6e83c6cb1c4157 (diff) | |
| download | searxng-e697d78d5a907014252df9aec79d981b800aac91.tar.gz searxng-e697d78d5a907014252df9aec79d981b800aac91.zip | |
[mod] make docs-live - remove --port option from sphinx-autobuild
Setting port fixed to 8080 has drawbacks when this port is already in use from
another application [1]. Removing this option from the command line offers the
use of the sphinx-autobuild defaults which are much more flexible [2].
[1] https://github.com/searx/searx/issues/2282
[2] https://github.com/executablebooks/sphinx-autobuild/blob/master/README.md
Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/dev/contribution_guide.rst | 17 |
1 files changed, 16 insertions, 1 deletions
diff --git a/docs/dev/contribution_guide.rst b/docs/dev/contribution_guide.rst index 5012dea21..26f8d2bb7 100644 --- a/docs/dev/contribution_guide.rst +++ b/docs/dev/contribution_guide.rst @@ -141,6 +141,9 @@ Here is an example which makes a complete rebuild: live build ---------- +.. _sphinx-autobuild: + https://github.com/executablebooks/sphinx-autobuild/blob/master/README.md + .. sidebar:: docs-clean It is recommended to assert a complete rebuild before deploying (use @@ -156,9 +159,21 @@ changed. $ make docs-live ... The HTML pages are in dist/docs. - ... Serving on http://0.0.0.0:8080 + ... Serving on http://0.0.0.0:8000 ... Start watching changes +Live builds are implemented by sphinx-autobuild_. Use environment +``$(SPHINXOPTS)`` to pass arguments to the sphinx-autobuild_ command. Except +option ``--host`` (which is always set to ``0.0.0.0``) you can pass any +argument. E.g to find and use a free port, use: + +.. code:: sh + + $ SPHINXOPTS="--port 0" make docs-live + ... + ... Serving on http://0.0.0.0:50593 + ... + .. _deploy on github.io: |