From 4f96b9c3f39213a5f6ae631c7c820f63fc2219d5 Mon Sep 17 00:00:00 2001 From: Daniel Schadt Date: Fri, 5 Apr 2024 22:34:08 +0200 Subject: documentation improvements --- doc/administration/installation.rst | 38 ++++++++++++++++++++++++++++++------- 1 file changed, 31 insertions(+), 7 deletions(-) (limited to 'doc/administration/installation.rst') diff --git a/doc/administration/installation.rst b/doc/administration/installation.rst index fd0def5..c21af59 100644 --- a/doc/administration/installation.rst +++ b/doc/administration/installation.rst @@ -50,17 +50,41 @@ Installing the Python Modules ----------------------------- The Python package manager takes care of installing all dependencies, all you -need to do is tell it to install Fietsboek: +need to do is tell it to install Fietsboek. How exactly depends on your way of +acquiring Fietsboek. + +Via PIP +^^^^^^^ + +Fietsboek is available in the Python Package Index as `fietsboek +`__ and can be installed directly via +``pip``: .. code:: bash - # Assuming that we are in the Fietsboek folder - .venv/bin/pip install . - # Alternatively - .venv/bin/pip path/to/fietsboek/repository + .venv/bin/pip install fietsboek + +Via Git +^^^^^^^ + +If you prefer to work with the source version (e.g. for development purposes), +you should use Git to clone the repository from one of its mirrors: + +* Main on Gitlab: https://gitlab.com/dunj3/fietsboek +* Mirror on Codeberg: https://codeberg.org/dunj3/fietsboek + +.. code:: bash + + git clone https://gitlab.com/dunj3/fietsboek + .venv/bin/pip install ./fietsboek + # For development, you can use -e for an editable installation: + .venv/bin/pip install -e ./fietsboek + +Optional: Install lxml +^^^^^^^^^^^^^^^^^^^^^^ -Optionally, you can install ``lxml``, which provides a faster XML parser to -process the GPX files: +In any case, you can optionally install ``lxml``, which provides a faster XML +parser to process the GPX files: .. code:: bash -- cgit v1.2.3