Icycoide/searxng
1
0
Fork 1
mirror of https://github.com/searxng/searxng.git synced 2025-07-24 13:49:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

[mod] make docs-live - remove --port option from sphinx-autobuild

Browse source 
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>
This commit is contained in:
Markus Heiser 2020-10-29 13:31:11 +01:00 • committed by Alexandre Flament
parent 54afe37e18
commit e697d78d5a
2 changed files with 17 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

17
docs/dev/contribution_guide.rst
View file

@ -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: