doc: proofread of the all reST sources (no content change)

Normalize reST sources with best practice and KISS in mind.

to name a few points:

- simplify reST tables
- make use of ``literal`` markup for monospace rendering
- fix code-blocks for better rendering in HTML
- normalize section header markup
- limit all lines to a maximum of 79 characters
- add option -H to the sudo command used in code blocks
- drop useless indentation of lists
- ...

[1] https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html

Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>

1 files changed, 6 insertions, 2 deletions

diff --git a/docs/conf.py b/docs/conf.py
index ee60e46e3..5186d0123 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -20,12 +20,16 @@ master_doc = "index"
 source_suffix = '.rst'
 
 # usage::   lorem :patch:`f373169` ipsum
-
 extlinks = {}
+
+# upstream links
+extlinks['wiki'] = ('https://github.com/asciimoo/searx/wiki/%s', ' ')
+extlinks['pull'] = ('https://github.com/asciimoo/searx/pull/%s', 'PR ')
+
+# links to custom brand
 extlinks['origin'] = (GIT_URL + '/blob/master/%s', 'git://')
 extlinks['patch'] = (GIT_URL + '/commit/%s', '#')
 extlinks['search'] = (SEARX_URL + '/%s', '#')
-extlinks['wiki'] = ('https://github.com/asciimoo/searx/wiki/%s', ' ')
 
 extensions = [
     'sphinx.ext.extlinks',