Skip to content
Snippets Groups Projects
Commit 2a820739 authored by Henrik tom Wörden's avatar Henrik tom Wörden
Browse files

DOC: add README_SETUP to doc

parent 8f1ab3b0
Branches
Tags
No related merge requests found
......@@ -21,12 +21,14 @@
* ** end header
-->
# Folder Structure
# Getting Started with the Web Interface
* The `src` folder contains all source code for the webinterface.
## Folder Structure
* The `src` folder contains all source code for the web interface.
* The `libs` folder contains all necessary third-party libraries as zip files.
* The `test` folder contains the unittests for the webinterface.
* The `ext` folder contains extension for the webinterface. The make file will
* The `test` folder contains the unittests for the web interface.
* The `ext` folder contains extension for the web interface. The make file will
copy all javascript files from `ext/js/` into the public folder and links the
javascript in the `public/xsl/main.xsl`.
* The `misc` folder contains a simple http server which is used for running the
......@@ -34,7 +36,7 @@
* The `build.properties.d/` folder contains configuration files for the build.
# Build Configuration
## Build Configuration
The default configuration is defined in
`build.properties.d/00_default.properties`.
......@@ -49,31 +51,31 @@ files in there which override the default values from `00_default.properties`.
See `build.properties.d/00_default.properties` for more
information.
# Setup
## Setup
* Run `make install` to compile/copy the webinterface to a newly created
* Run `make install` to compile/copy the web interface to a newly created
`public` folder.
* Also, `make install` will copy the scripts from `src/server_side_scripting/`
to `sss_bin/`. If you want to make the server-side scripts callable for the
server as server-side scripts you need to include the `sss_bin/` directory
into the server property `SERVER_SIDE_SCRIPTING_BIN_DIRS`.
# Test
## Test
* Run `make test` to compile/copy the webinterface and the tests to a newly
* Run `make test` to compile/copy the web interface and the tests to a newly
created `public` folder.
* Run `make run-test-server` to start a python http server.
* The test suite can be started with `firefox http://localhost:8000/`.
# Clean
## Clean
* Run `make clean` to clean up everything.
# Documentation #
## Documentation #
Build documentation in `build/` with `make doc`.
## Requirements ##
### Requirements ##
- sphinx
- sphinx-autoapi
......
......@@ -95,7 +95,7 @@ html_theme = "sphinx_rtd_theme"
# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = ['_static']
# html_static_path = ['_static']
# Custom sidebar templates, must be a dictionary that maps document names
# to template names.
......
......@@ -7,14 +7,14 @@ Welcome to caosdb-server's documentation!
:caption: Contents:
:hidden:
Getting started <getting_started>
Getting started <README_SETUP>
Concepts <concepts>
tutorials
API documentation<autoapi>
Welcome to the WebUI for CaosDB, ``pycaosdb``!
This documentation helps you to :doc:`get started<getting_started>`, explains the most important
This documentation helps you to :doc:`get started<README_SETUP>`, explains the most important
:doc:`concepts<concepts>` and offers a range of :doc:`tutorials<tutorials>`.
.. note::
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment