<commit_before>
DISLAIMER
=========

This software is a free (GNU Affero Licensed) open source software meant to help German Semesterticket Offices and 
therefore contains many terms and explanations only aimed at a german-speaking audience.

If you are related to a University AstA and/or Semesterticketbüro and want to use this software, please contact the
author who is reachable at <EMAIL> for consulting, initial help and support or as a courtesy.

The following steps are the bare minimum you will need to execute in order to run the software.


RUNNING SEMTIX CLIENT
======================
On each client:
- Install _openjdk-7-(jre|jdk)_ and _libreoffice_
- Setup and configure printer, so `/usr/bin/soffice -p` works
- Set `logo=0` in _sofficerc_, e.g. /etc/libreoffice/sofficerc, /usr/lib/libreoffice/program/sofficerc
- Copy **semtixconf.properties, log4j.properties and hibernate.cfg.xml to /etc/semtixdb/** and adjust them to your environment
- Create `/var/log/semtixdb/` and make accessible for users that run semtix
- Copy templates folder to the place specified in semtixconf.properties
- Execute `mvn clean install` where the _pom.xml_ file is located whenever you want to build from source with jdk7

---

### FIRST STEPS ON CLIENT
- Datenbank `->` Neues Semester Anlegen and create a new Semester
- Datenbank `->` Aktuelles Semester and select the Semester as Global Semester
- AdminTools and initialize all relevant settings. That also entails clicking on "Speichern" at the path settings in case a field is missing from your `semtixconf.properties`
- Fill other data that is frequently used (e.g. Textbausteine)
- In `DBHandlerTextbausteine.java` you may add default text blocks for daily usage and/or development/testing
- Put your letter templates in the templates folder
- In ExternalSettings.java you can specifiy the String values for these templates
- May also need to set the templates in the `semtixconf.properties` 
- While printing letters or other documents you may run into problems as the engine expects several freemarker placeholders to be present. A complete list of placeholders is, at the moment, only available by looking at the java-code. We use code like this in our odt-templates: \s\s 
      ``
      ${vorname} ${nachname}[#if co??]${"\n"}c/o ${co}[/#if]
      [#if zusatz??]${"\n"}${zusatz}[/#if] 
      ``  


--- 

### ON SERVER:
The server is only required to run the actual SQL database:
- create postgresql db (we use driver 9.1-901-1.jdbc4 from within hibernate 4.3.8)
  and make sure the db is accessible by clients (usually port 5432)
- install `postgresql-contrib` and execute `CREATE EXTENSION unaccent;` on semtix db
- Don't forget to configure `/etc/semtixdb/hibernate.cfg.xml` accordingly


---

### HINTS/FAQ:
- configure git to use odt2txt when pushing new Odt-Templates in order to avoid binary blobs
- check the tests in order to understand the determination process of how much each student will get paid
- other jdbc databases but PostgreSQL should also work but have not been tested

<commit_msg>Another change<commit_after>
DISLAIMER
=========

This software is a free (GNU Affero Licensed) open source software meant to help German Semesterticket Offices and 
therefore contains many terms and explanations only aimed at a german-speaking audience.

If you are related to a University AstA and/or Semesterticketbüro and want to use this software, please contact the
author who is reachable at <EMAIL> for consulting, initial help and support or as a courtesy.

The following steps are the bare minimum you will need to execute in order to run the software.


RUNNING SEMTIX CLIENT
======================
On each client:
- Install _openjdk-7-(jre|jdk)_ and _libreoffice_
- Setup and configure printer, so `/usr/bin/soffice -p` works
- Set `logo=0` in _sofficerc_, e.g. /etc/libreoffice/sofficerc, /usr/lib/libreoffice/program/sofficerc
- Copy **semtixconf.properties, log4j.properties and hibernate.cfg.xml to /etc/semtixdb/** and adjust them to your environment
- Create `/var/log/semtixdb/` and make accessible for users that run semtix
- Copy templates folder to the place specified in semtixconf.properties
- Execute `mvn clean install` where the _pom.xml_ file is located whenever you want to build from source with jdk7

---

### FIRST STEPS ON CLIENT
- Datenbank `->` Neues Semester Anlegen and create a new Semester
- Datenbank `->` Aktuelles Semester and select the Semester as Global Semester
- AdminTools and initialize all relevant settings. That also entails clicking on "Speichern" at the path settings in case a field is missing from your `semtixconf.properties`
- Fill other data that is frequently used (e.g. Textbausteine)
- In `DBHandlerTextbausteine.java` you may add default text blocks for daily usage and/or development/testing
- Put your letter templates in the templates folder
- In ExternalSettings.java you can specifiy the String values for these templates
- May also need to set the templates in the `semtixconf.properties` 
- While printing letters or other documents you may run into problems as the engine expects several freemarker placeholders to be present. A complete list of placeholders is, at the moment, only available by looking at the java-code. We use code like this in our odt-templates:     
      ``
      ${vorname} ${nachname}[#if co??]${"\n"}c/o ${co}[/#if]
      [#if zusatz??]${"\n"}${zusatz}[/#if] 
      ``  


--- 

### ON SERVER:
The server is only required to run the actual SQL database:
- create postgresql db (we use driver 9.1-901-1.jdbc4 from within hibernate 4.3.8)
  and make sure the db is accessible by clients (usually port 5432)
- install `postgresql-contrib` and execute `CREATE EXTENSION unaccent;` on semtix db
- Don't forget to configure `/etc/semtixdb/hibernate.cfg.xml` accordingly


---

### HINTS/FAQ:
- configure git to use odt2txt when pushing new Odt-Templates in order to avoid binary blobs
- check the tests in order to understand the determination process of how much each student will get paid
- other jdbc databases but PostgreSQL should also work but have not been tested


{'fraction_non_alphanumeric': 0.08033964728935336, 'fraction_numerical': 0.0062050947093403004, 'mean_word_length': 4.1513877207737595, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 9, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 6}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1130411', 'n_tokens_mistral': 1805, 'n_tokens_neox': 1725, 'n_words': 822}