@@ -18,18 +18,10 @@ With the aim to simplify development cycles, started with :pull:`1756` a
1818Makefiles, we recommend to read gnu-make_ introduction.
1919
2020The usage is simple, just type ``make {target-name}`` to *build* a target.
21−Calling the ``help`` target gives a first overview::
22−
23− $ make help
24− test - run developer tests
25− docs - build documentation
26− docs-live - autobuild HTML documentation while editing
27− run - run developer instance
28− install - developer install (./local)
29− uninstall - uninstall (./local)
30− gh-pages - build docs & deploy on gh-pages branch
31− clean - drop builds and environments
32− ...
21+Calling the ``help`` target gives a first overview (``make help``):
22+
23+.. program-output:: bash -c "cd ..; make --no-print-directory help"
24+
3325
3426.. contents:: Contents
3527 :depth: 2
@@ -44,25 +36,28 @@ Makefile setup
4436
4537.. _git stash: https://git-scm.com/docs/git-stash
4638
47−The main setup is done in the :origin:`Makefile`::
48−
49− export GIT_URL=https://github.com/asciimoo/searx
50− export GIT_BRANCH=master
51− export SEARX_URL=https://searx.me
52− export DOCS_URL=https://asciimoo.github.io/searx
53−
5439.. sidebar:: fork & upstream
5540
5641 Commit changes in your (local) branch, fork or whatever, but do not push them
5742 upstream / `git stash`_ is your friend.
5843
59−:GIT_URL: Changes this, to point to your searx fork.
44+The main setup is done in the :origin:`Makefile`.
45+
46+.. literalinclude:: ../../Makefile
47+ :start-after: START Makefile setup
48+ :end-before: END Makefile setup
6049
50+:GIT_URL: Changes this, to point to your searx fork.
6151:GIT_BRANCH: Changes this, to point to your searx branch.
52+:SEARX_URL: Changes this, to point to your searx instance.
53+:DOCS_URL: If you host your own (*brand*) documentation, change this URL.
6254
63−:SEARX_URL: Changes this, to point to your searx instance.
55+If you change any of this build environment variables, you have to run ``make
56+buildenv``::
6457
65−:DOCS_URL: If you host your own (branded) documentation, change this URL.
58+ $ make buildenv
59+ build searx/brand.py
60+ build utils/brand.env
6661
6762.. _make pyenv:
6863