OwlBurst/Ponysearch
1
0
Fork 0
forked from Ponysearch/Ponysearch
Code Pull requests Activity

edoc: -- makefile.rst fix typo and add extlinks['man']

Browse source 
Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
This commit is contained in:
Markus Heiser 2019-12-18 18:32:42 +01:00
parent f09459b98a
commit 2b4526916d
2 changed files with 9 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
docs/conf.py
View file

@ -33,6 +33,7 @@ extlinks['patch'] = (GIT_URL + '/commit/%s', '#')
extlinks['search'] = (SEARX_URL + '/%s', '#') extlinks['search'] = (SEARX_URL + '/%s', '#')
extlinks['docs'] = (DOCS_URL + '/%s', 'docs: ') extlinks['docs'] = (DOCS_URL + '/%s', 'docs: ')
extlinks['pypi'] = ('https://pypi.org/project/%s', 'PyPi: ') extlinks['pypi'] = ('https://pypi.org/project/%s', 'PyPi: ')
extlinks['man'] = ('https://manpages.debian.org/jump?q=%s', '')
extensions = [ extensions = [
'sphinx.ext.extlinks', 'sphinx.ext.extlinks',

12
docs/dev/makefile.rst
View file

@ -4,13 +4,16 @@
Makefile Targets Makefile Targets
================ ================
.. _gnu-make: https://www.gnu.org/software/make/manual/make.html#Introduction
.. sidebar:: build environment .. sidebar:: build environment
Before looking deeper at the targets, first read about :ref:`makefile setup` Before looking deeper at the targets, first read about :ref:`makefile setup`
and :ref:`make pyenv`. and :ref:`make pyenv`.
With the aim to simplify development cycles, started with :pull:`1756` a With the aim to simplify development cycles, started with :pull:`1756` a
``Makefile`` based boilerplate was added. ``Makefile`` based boilerplate was added. If you are not familiar with
Makefiles, we recommend to read gnu-make_ introduction.
The usage is simple, just type ``make {target-name}`` to *build* a target. The usage is simple, just type ``make {target-name}`` to *build* a target.
Calling the ``help`` target gives a first overview:: Calling the ``help`` target gives a first overview::
@ -77,7 +80,7 @@ and release a ``make pyenv``:
... ...
With target ``pyenv`` a development environment (aka virtualenv) was build up in With target ``pyenv`` a development environment (aka virtualenv) was build up in
``./local/py3/``. To make a *developer install** of searx (:origin:`setup.py`) ``./local/py3/``. To make a *developer install* of searx (:origin:`setup.py`)
into this environment make target ``install`` into this environment make target ``install``
.. code:: sh .. code:: sh
@ -108,8 +111,9 @@ the :origin:`setup.py` file (or the requirements listed in
============ ============
To get up a running a developer instance simply call ``make run``. This enables To get up a running a developer instance simply call ``make run``. This enables
*debug* option in :origin:`searx/settings.yml`, starts ``./searx/webapp.py`` *debug* option in :origin:`searx/settings.yml`, starts a ``./searx/webapp.py``
instance, disables *debug* option and opens the site (xdg-open): instance, disables *debug* option again and opens the URL in your favorite WEB
browser (:man:`xdg-open`):
.. code:: sh .. code:: sh