mirror of
				https://github.com/searxng/searxng.git
				synced 2025-11-03 19:17:07 -05:00 
			
		
		
		
	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>
		
			
				
	
	
		
			44 lines
		
	
	
		
			1.5 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
			
		
		
	
	
			44 lines
		
	
	
		
			1.5 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
=============================================================
 | 
						|
Searx admin interface
 | 
						|
=============================================================
 | 
						|
 | 
						|
.. _searx-admin: https://github.com/kvch/searx-admin#searx-admin
 | 
						|
.. _NLnet Foundation: https://nlnet.nl/
 | 
						|
 | 
						|
  manage your instance from your browser
 | 
						|
 | 
						|
.. sidebar:: Installation
 | 
						|
 | 
						|
   Installation guide can be found in the repository of searx-admin_.
 | 
						|
 | 
						|
One of the biggest advantages of searx is being extremely customizable. But at
 | 
						|
first it can be daunting to newcomers.  A barrier of taking advantage of this
 | 
						|
feature is our ugly settings file which is sometimes hard to understand and
 | 
						|
edit.
 | 
						|
 | 
						|
To make self-hosting searx more accessible a new tool is introduced, called
 | 
						|
``searx-admin``.  It is a web application which is capable of managing your
 | 
						|
instance and manipulating its settings via a web UI.  It aims to replace editing
 | 
						|
of ``settings.yml`` for less experienced administrators or people who prefer
 | 
						|
graphical admin interfaces.
 | 
						|
 | 
						|
.. figure:: searx-admin-engines.png
 | 
						|
   :alt: Screenshot of engine list
 | 
						|
 | 
						|
   Configuration page of engines
 | 
						|
 | 
						|
Since ``searx-admin`` acts as a supervisor for searx, we have decided to
 | 
						|
implement it as a standalone tool instead of part of searx.  Another reason for
 | 
						|
making it a standalone tool is that the codebase and dependencies of searx
 | 
						|
should not grow because of a fully optional feature, which does not affect
 | 
						|
existing instances.
 | 
						|
 | 
						|
 | 
						|
Acknowledgements
 | 
						|
================
 | 
						|
 | 
						|
This development was sponsored by `NLnet Foundation`_.
 | 
						|
 | 
						|
| Happy hacking.
 | 
						|
| kvch // 2017.08.22 21:25
 |