forked from Archives/searxng
05149db4c1
Currently we have two kinds of user documentation: * the about page[1] which is written in HTML and part of the web application and can therefore link instance-specific pages (like e.g. the preferences) via Jinja variables * the Sphinx documentation[2] which is written in reStructuredText and cannot link instance-specific pages since it doesn't know which instance the user is using The plan is to integrate the user documentation currently in Sphinx into the application, so that it can also link instance specific pages. We also want to enable the user documentation to be translated. This commit implements the first step in this endeavor (see #722). [1]: searx/templates/__common__/about.html [2]: docs/user/ (currently served at https://docs.searxng.org/user/)
39 lines
1.3 KiB
Python
39 lines
1.3 KiB
Python
from typing import Dict
|
|
import os.path
|
|
import pkg_resources
|
|
|
|
import flask
|
|
|
|
from . import get_setting
|
|
from .version import GIT_URL
|
|
|
|
HELP: Dict[str, str] = {}
|
|
""" Maps a filename under help/ without the file extension to the rendered HTML. """
|
|
|
|
|
|
def render(app: flask.Flask):
|
|
"""
|
|
Renders the user documentation. Must be called after all Flask routes have been
|
|
registered, because the documentation might try to link to them with Flask's `url_for`.
|
|
|
|
We render the user documentation once on startup to improve performance.
|
|
"""
|
|
for filename in pkg_resources.resource_listdir(__name__, 'help'):
|
|
rootname, ext = os.path.splitext(filename)
|
|
if ext != '.html':
|
|
continue
|
|
|
|
text = pkg_resources.resource_string(__name__, 'help/' + filename).decode()
|
|
|
|
base_url = get_setting('server.base_url') or None
|
|
# we specify base_url so that url_for works for base_urls that have a non-root path
|
|
|
|
with app.test_request_context(base_url=base_url):
|
|
# the request context is needed for Flask's url_for
|
|
# (otherwise we'd need to set app.config['SERVER_NAME'],
|
|
# which we don't want)
|
|
|
|
interpolated = flask.render_template_string(text, get_setting=get_setting, searx_git_url=GIT_URL)
|
|
|
|
HELP[rootname] = interpolated
|