mirror of
https://github.com/searx/searx
synced 2025-08-31 06:26:28 +00:00
doc: add note about docs-clean target
BTW: fix some typos Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
This commit is contained in:
@@ -93,7 +93,7 @@ The documentation is built using Sphinx_. So in order to be able to generate
|
||||
the required files, you have to install it on your system. Much easier, use
|
||||
Makefile our targets.
|
||||
|
||||
Here is an example which makes complete rebuild:
|
||||
Here is an example which makes a complete rebuild:
|
||||
|
||||
.. code:: sh
|
||||
|
||||
@@ -105,13 +105,18 @@ Here is an example which makes complete rebuild:
|
||||
live build
|
||||
----------
|
||||
|
||||
.. sidebar:: docs-clean
|
||||
|
||||
It is recommended to assert a complete rebuild before deploying (use
|
||||
``docs-clean``).
|
||||
|
||||
Live build is like WYSIWYG, If you want to edit the documentation, its
|
||||
recommended to use. The Makefile target ``docs-live`` builds the docs, opens URL
|
||||
in your favorite browser and rebuilds every time a reST file has been changed.
|
||||
|
||||
.. code:: sh
|
||||
|
||||
$ make docs-clean docs-clean
|
||||
$ make docs-live
|
||||
...
|
||||
The HTML pages are in dist/docs.
|
||||
... Serving on http://0.0.0.0:8080
|
||||
@@ -129,7 +134,7 @@ needed git add, commit and push:
|
||||
|
||||
.. code:: sh
|
||||
|
||||
$ make gh-pages
|
||||
$ make docs-clean gh-pages
|
||||
...
|
||||
SPHINX docs --> file://<...>/dist/docs
|
||||
The HTML pages are in dist/docs.
|
||||
|
Reference in New Issue
Block a user