Webserver Configuration
=======================
:Author: cehteh
:Date: Nov 2018


Here are some annotations which websites are available. Who is
responsible for the administration and how to improve the websites.


Websites
--------

https://lumiera.org https://www.lumiera.org
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The main Website.

- Data is in '/var/www'. The Website is a git repository.
- Configuration is at '/etc/apache2/sites-available/lumiera.conf'
- cehteh cares for the administration.
- To proprose some changes clone the git repository and send a
  notfication/merge-request to the mailinglist.

Some directories symlink to other directories (see below).


https://staging.lumiera.org
~~~~~~~~~~~~~~~~~~~~~~~~~~~

Testing repository for the Website. Web development is done and
reviewed here before it gets pushed to the main Website.

- Data is in '/var/www-staging'. The Website is a git repository.
- Configuration is at '/etc/apache2/sites-available/staging.conf'
- cehteh cares for the administration.
- To proprose some changes clone the git repository and send a
  notfication/merge-request to the mailinglist.


https://git.lumiera.org
~~~~~~~~~~~~~~~~~~~~~~~

The gitweb interface to all public git repositories hosted on the server.

- Configuration is at '/etc/apache2/sites-available/gitweb.conf'
- cehteh (and sometimes ichthyo) cares for the administration.



https://issues.lumiera.org
~~~~~~~~~~~~~~~~~~~~~~~~~~

Trac issue tracker.

- Configuration is at '/etc/apache2/sites-available/trac.conf'
- ichthyo cares for the administration.


https://static.lumiera.org
~~~~~~~~~~~~~~~~~~~~~~~~~~

Hosting big static files (media, videos, pictures)

- Data is in '/var/local/www_static'. The Website is a git-annex repository.
- Configuration is at '/etc/apache2/sites-available/static.conf'
- cehteh cares for the administration.
- we have a 'sample_archive' for some test-media/video files
  there. People can contribute more media, ask on the mailinglist for
  details.
- Data will be placed there 'on-demand'. Don't forget to 'git annex add' the files.


Directories
-----------

Some noteable directories.

/git /var/local/git/
~~~~~~~~~~~~~~~~~~~~
Directories and symlinks to public git repositories served by the git
daemon and gitweb.

/var/local/tiddly/
~~~~~~~~~~~~~~~~~~
Git repository with the tiddlywiki used for some work notes during development.

/var/local/www_debian/
~~~~~~~~~~~~~~~~~~~~~~
Debian package pool maintained by ichthyo.


/var/local/doxy/
~~~~~~~~~~~~~~~~
API-Documentation generated by 'doxygen'.


/var/local/gitmob/
~~~~~~~~~~~~~~~~~~
Public writable git repositories for receiving small and easy
contributions.

/var/local/rsyncd_incoming/
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Upload directory where people can rsync data.

/var/local/www_documentation/
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Clone of the lumiera source repository to serve the documentation within.