diff --git a/src/doc/README_SETUP.md b/src/doc/README_SETUP.md deleted file mode 120000 index 88332e357f5e06f3de522768ccdcd9e513c15f62..0000000000000000000000000000000000000000 --- a/src/doc/README_SETUP.md +++ /dev/null @@ -1 +0,0 @@ -../../README_SETUP.md \ No newline at end of file diff --git a/src/doc/genindex.rst b/src/doc/genindex.rst new file mode 100644 index 0000000000000000000000000000000000000000..48ab71fd283bb48564ac30e4c69e62bbd463cd77 --- /dev/null +++ b/src/doc/genindex.rst @@ -0,0 +1,4 @@ +.. This file is a placeholder and will be replaced. + +Index +===== diff --git a/src/doc/getting_started.md b/src/doc/getting_started.md deleted file mode 100644 index 6805181e73a7f338fbacb74bdd9f734360404372..0000000000000000000000000000000000000000 --- a/src/doc/getting_started.md +++ /dev/null @@ -1,5 +0,0 @@ -# Getting started with pycaosdb # - -1. Install -2. import -3. enjoy diff --git a/src/doc/getting_started.md b/src/doc/getting_started.md new file mode 120000 index 0000000000000000000000000000000000000000..88332e357f5e06f3de522768ccdcd9e513c15f62 --- /dev/null +++ b/src/doc/getting_started.md @@ -0,0 +1 @@ +../../README_SETUP.md \ No newline at end of file diff --git a/src/doc/index.rst b/src/doc/index.rst index 4c6c572a1784ec74ab2db06bea2792c45d75877d..b3a26c96df4f13e22f4b01a6cb0a9f00a1d33981 100644 --- a/src/doc/index.rst +++ b/src/doc/index.rst @@ -1,23 +1,25 @@ -Welcome to caosdb-webui's documentation! -========================================= +Welcome to the documentation of CaosDB's web UI! +================================================ .. toctree:: :maxdepth: 2 :caption: Contents: :hidden: - Getting started <README_SETUP> + Getting started <getting_started> Concepts <concepts> tutorials - API documentation<autoapi> + API Index<genindex> -This documentation helps you to :doc:`get started<README_SETUP>`, explains the most important + +This documentation helps you to :doc:`get started<getting_started>`, explains the most important :doc:`concepts<concepts>` and offers a range of :doc:`tutorials<tutorials>`. .. note:: - TODO: Build the index (manually?) like here: https://github.com/mozilla/fathom/edit/master/docs/ + TODO: Build the index (manually?) like here: https://github.com/mozilla/fathom/edit/master/docs/. + Note that :doc:`autoapi/index` still does not have any content. .. js:autofunction:: input2caosdbDate @@ -29,5 +31,4 @@ Indices and tables ================== * :ref:`genindex` -* :ref:`modindex` * :ref:`search` diff --git a/test/docker/Dockerfile b/test/docker/Dockerfile index 35a3918e40688002de701678a220b54be73f90c0..7340ee5a7bb94aacc13ff582f1d05221419a312b 100644 --- a/test/docker/Dockerfile +++ b/test/docker/Dockerfile @@ -4,7 +4,6 @@ RUN echo "deb http://deb.debian.org/debian buster-backports main" >> /etc/apt/so && apt-get install -y \ firefox-esr gettext-base pylint3 python3-pip \ python3-httpbin git curl x11-apps xvfb unzip python3-pytest \ - python3-recommonmark \ && apt-get install -y -t buster-backports \ npm @@ -13,4 +12,4 @@ RUN pip3 install pandas xlrd RUN pip3 install git+https://gitlab.com/caosdb/caosdb-advanced-user-tools.git@dev # For automatic documentation RUN npm install -g jsdoc -RUN pip3 install sphinx-js sphinx-autoapi sphinx-rtd-theme +RUN pip3 install sphinx-js sphinx-autoapi recommonmark sphinx-rtd-theme