From 692163a3282a6fc706f3e31e0884378b4bb0f464 Mon Sep 17 00:00:00 2001 From: Daniel Teichmann Date: Tue, 21 Feb 2023 11:46:43 +0000 Subject: README.rst: Add 'Getting Started' section + Update copyright. --- README.rst | 40 +++++++++++++++++++++++++++++++++++++--- 1 file changed, 37 insertions(+), 3 deletions(-) diff --git a/README.rst b/README.rst index a436ec7..e932f28 100644 --- a/README.rst +++ b/README.rst @@ -3,14 +3,48 @@ RWA.Support.SessionService D-Bus service, written in Python 3, for managing sessions with Django and as a backend for GUI applications +Getting started +--------------- + +Step 1: Clone repository +^^^^^^^^^^^^^^^^^^^^^^^^ + +Clone the source code repository via Git (sudo apt install git). + +>>> $ git clone https://gitlab.das-netzwerkteam.de/remotewebapp/rwa.support.sessionservice.git + +Step 2: Build documentation +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Go into the docs directory and build the html files. + +>>> $ cd rwa.support.sessionservice/docs + +Use the `Makefile` to build documentation with Sphinx. + +>>> $ make html + +You have now a bunch of HTML files in `_build/html`. +You can make the files available via a small local webserver. We are using PHP as an example. + +You can also just open the `_build/html/index.html` file in your browser (if your browser is allowed to access those files). + +>>> $ php -S localhost:8080 -t "_build/html" + +Step 3: Follow installation instructions there +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +http://localhost:8080/admin/01_installation.html + + Licence ------- :: - Copyright © 2020, 2021 Jonathan Weth - Copyright © 2020 Mike Gabriel - Copyright © 2020 Daniel Teichmann + Copyright © 2020-2023 Jonathan Weth + Copyright © 2020-2023 Mike Gabriel + Copyright © 2020-2023 Daniel Teichmann Licenced under the GPL, version 2.0 or later -- cgit v1.2.3