diff options
author | Benjamin Kellermann <Benjamin.Kellermann@mgm-sp.de> | 2016-02-21 12:07:33 +0100 |
---|---|---|
committer | Benjamin Kellermann <Benjamin.Kellermann@mgm-sp.de> | 2016-02-21 12:07:33 +0100 |
commit | 7f466b65c6b0038d8265768e58932d2e1c009253 (patch) | |
tree | 50ac052f22b67fdbf49d5ead51fad60f61f51f02 | |
parent | 8d2c1abf4e59b605a18eb419b07239d4131022f7 (diff) | |
parent | 66c8bbe0fc135fa0be13f5448371cdc3852a7dfc (diff) |
Merge branch 'arminfelder-master'
-rw-r--r-- | README.md (renamed from README) | 83 |
1 files changed, 54 insertions, 29 deletions
@@ -1,14 +1,19 @@ -Author: - Benjamin Kellermann <Benjamin dot Kellermann at gmx in Germany> -Requirements: +# Authors + * Benjamin Kellermann <Benjamin dot Kellermann at gmx in Germany> + * a lot of contributers of small code pieces + +# License +GNU AGPL v3 or higher (see file License) + +# Requirements * ruby >=1.8 * git >=1.6.5 (preferred and default setting) or bzr * libgettext-ruby (for localization) -License: - GNU AGPL v3 or higher - see file License + * gettext (for generating localization files) + + -=== Installation === +# Installation 1. Place this application into a directory where cgi-scripts are evaluated. 2. If you want to change some configuration, state it in the file »config.rb« (see config_sample.rb for help) @@ -16,41 +21,57 @@ License: 3. The webserver needs the permission to write into the directory 4. You need .mo files in order to use localisations. You have 2 possibilities: - a. Run this small script to fetch the files from the main server: - cd $DUDLE_INSTALLATION_PATH - for i in locale/??; do - wget -O $i/dudle.mo https://dudle.inf.tu-dresden.de/locale/`basename $i`/dudle.mo - done - b. Build them on your own. This requires libgettext-ruby-util, potool, and make to be installed. - sudo aptitude install libgettext-ruby-util potool make - make + 1. Run this small script to fetch the files from the main server: + ```sh + cd $DUDLE_INSTALLATION_PATH + for i in locale/??; do + wget -O $i/dudle.mo https://dudle.inf.tu-dresden.de/locale/`basename $i`/dudle.mo + done + ``` + 2. Build them on your own. This requires gettext, libgettext-ruby-util, potool, and make to be installed. + ```sh + sudo aptitude install gettect libgettext-ruby-util potool make + make + ``` 5. In order to let access control work correctly, the webserver needs auth_digest support. It therefore may help to type: - sudo a2enmod auth_digest + ```sh + sudo a2enmod auth_digest + ``` 6. In order to get atom-feed support you need ruby-ratom to be installed. E.g.: - sudo aptitude install rubygems ruby-dev libxml2-dev zlib1g-dev - sudo gem install ratom + ```sh + sudo aptitude install rubygems ruby-dev libxml2-dev zlib1g-dev + sudo gem install ratom + ``` 7. for RUBY 1.9 you need to add - SetEnv RUBYLIB $DUDLE_INSTALLATION_PATH + ```sh + SetEnv RUBYLIB $DUDLE_INSTALLATION_PATH + ``` to your .htaccess 8. to make titles with umlauts working you need to set the encoding e.g. by adding - SetEnv RUBYOPT "-E UTF-8:UTF-8" + ```sh + SetEnv RUBYOPT "-E UTF-8:UTF-8" + ``` to your .htaccess 9. It might be the case, that you have to set some additional Variables in your .htaccess: - SetEnv GIT_AUTHOR_NAME="http user" + ```sh + SetEnv GIT_AUTHOR_NAME="http user" SetEnv GIT_AUTHOR_EMAIL=foo@example.org SetEnv GIT_COMMITTER_NAME="$GIT_AUTHOR_NAME" SetEnv GIT_COMMITTER_EMAIL="$GIT_AUTHOR_EMAIL" + ``` 10. Try to open http://$YOUR_SERVER/check.cgi to check if your config seems to work. - -=== Pimp your Installation === + +# Pimp your Installation * If you want to create your own Stylesheet, you just have to put it in the folder »$DUDLE_HOME_FOLDER/css/«. Afterwards you may config this one to be the default Stylesheet. Examples can be found here: https://dudle.inf.tu-dresden.de/css/ This is a bazaar repository as well, so you may branch it if you want… - cd $DUDLE_HOME_FOLDER/css - bzr branch https://dudle.inf.tu-dresden.de/css/ . + ```sh + cd $DUDLE_HOME_FOLDER/css + bzr branch https://dudle.inf.tu-dresden.de/css/ . + ``` Send me your Stylesheet if you want it to appear at https://dudle.inf.tu-dresden.de * If you want to extend the functionality you might want to place a file @@ -58,13 +79,17 @@ License: Examples can be found here: https://dudle.inf.tu-dresden.de/unstable/extensions/ which again are repositories ;--) e.g.: + ```sh cd $DUDLE_HOME_FOLDER/dudle/extensions/ bzr branch https://dudle.inf.tu-dresden.de/unstable/extensions/10_participate/ bzr branch https://dudle.inf.tu-dresden.de/unstable/extensions/symcrypt/ + ``` -=== Translators === +# Translators If you set $DUDLE_POEDIT_AUTO to your lang, poedit will launch automatically when building the application. E.g.: - export DUDLE_POEDIT_AUTO=fr - bzr pull - make # will launch poedit if new french strings are to be translated +```sh +export DUDLE_POEDIT_AUTO=fr +bzr pull +make # will launch poedit if new french strings are to be translated +``` |