Browse Source

Update documentation

master
Nils 6 years ago
parent
commit
b585a2ead0
  1. 2
      README.md
  2. 17
      documentation/english.adoc
  3. 16
      documentation/german.adoc
  4. 24
      documentation/out/english.html
  5. 18
      documentation/out/german.html

2
README.md

@ -43,9 +43,9 @@ You will not be able to push your changes.
* Nuitka >= 0.6 (maybe earlier)
* GCC (development is done on 8.2, but most likely you can use a much earlier version)
### Environment:
* Jack Audio Connection Kit must be running
* Non Session Manager
## Build
The default prefix is /usr/local

17
documentation/english.adoc

@ -230,30 +230,30 @@ With a little experience you will be able to estimate what error handling you ne
Patroneo is exclusive for Linux. The best way to install is to use your package manager.
If it is not there, or only in an outdated version, please ask your Linux distribution to provide a recent version.
If available in the package repository, please continue reading directly at "Start <shortname> from Non Session Manager".
If available in the package repository, please continue reading directly at "Start patroneo from Non Session Manager".
If not, you can build Patroneo yourself.
.Build and Install
* Please check the supplied README.md for dependencies.
* You can download a release or clone the git version
** Download the latest version from https://www.laborejo.org/downloads and extract it.
** `git clone https://laborejo.org/<shortname>.git`
** `git clone https://laborejo.org/patroneo.git`
* Change into the new directory and use these commands:
* `./configure --prefix=/usr`
** The default prefix is /usr/local
* `make`
* `sudo make install`
.Start <shortname> from Non Session Manager (NSM)
.Start patroneo from Non Session Manager (NSM)
* Run `non-session-manager`
* Press the `New` button, and enter a name for your piece of music.
* Press the `Add Client to Session` button, enter `<shortname>` here, in lower case.
* Press the `Add Client to Session` button, enter `patroneo` here, in lower case.
* Add Client again, this time `jackpatch`.
* Add any compatible programs, e.g. synthesizers.
** See the list of NSM compatible programs: http://non.tuxfamily.org/wiki/ApplicationsSupportingNsm
** And the NSM manual: http://non.tuxfamily.org/nsm/
Please read README.md for other ways of starting <shortname>, which are impractical for actual use but can
Please read README.md for other ways of starting patroneo, which are impractical for actual use but can
be helpful for testing and development.
== Help and Development
@ -281,7 +281,7 @@ However, here are the complete instructions for doing a translation completely o
The program is split in two parts. A shared "template" between the Laborejo Software Suite and the actual program.
The process is the same for both parts, but needs to be done in different directories:
`template/qtgui`and plain `/qtgui`, relative to the root directory, where the <shortname> executable is.
`template/qtgui`and plain `/qtgui`, relative to the root directory, where the patroneo executable is.
Everytime you see "template/qtgui" below you can substitute that with just "qtgui" to translate the other part of Patroneo.
@ -306,5 +306,6 @@ You can also incorporate the translation into Patroneo for testing purposes. Thi
** To find out your language string (German, Esperanto etc.) open the `python3` interpreter in a terminal and run the following command:
** `from PyQt5 import QtCore;QtCore.QLocale().languageToString(QtCore.QLocale().language())`
To test the new translation you can either run the program normally, if your system is set to that language. Alternatively start <shortname> via the terminal:
* `LANGUAGE=de_DE.UTF-8 ./<shortname> -V --save /dev/null`
To test the new translation you can either run the program normally, if your system is set to that language. Alternatively start patroneo via the terminal:
* `LANGUAGE=de_DE.UTF-8 ./patroneo -V --save /dev/null`

16
documentation/german.adoc

@ -235,30 +235,30 @@ Mit ein wenig Erfahrung wird man abschätzen können, was man braucht.
Patroneo ist exklusiv für Linux. Am besten installierst du Patroneo über deinen Paketmanager.
Falls es dort nicht vorhanden ist, oder nur in einer veralteten Version, bitte deine Linuxdistribution Patroneo bereitzustellen.
Falls in den Paketquellen vorhanden bitte direkt bei "<shortname> im Non Session Manager starten" weiterlesen.
Falls in den Paketquellen vorhanden bitte direkt bei "patroneo im Non Session Manager starten" weiterlesen.
Falls nicht kann man Patroneo auch selbst "bauen".
.Abhängigkeiten*
* Eine Liste der Abhängigkeit befindet sich in der README.md
* Kompilieren und Installieren geht entweder mit einem Releasedownload oder mit der Git-Version:
** Lade von https://www.laborejo.org/downloads die aktuelle Version herunter und entpacke sie.
** `git clone https://laborejo.org/<shortname>.git`
** `git clone https://laborejo.org/patroneo.git`
* Wechsele in das neue Verzeichnis und benutze diese Befehle:
*`./configure --prefix=/usr`
** Das Standardprefix is /usr/local
* `make`
* `sudo make install`
.<shortname> im Non Session Manager (NSM) starten
.patroneo im Non Session Manager (NSM) starten
* Starte `non-session-manager`
* Knopf `New`, gib einen Namen für dein Musikstück ein.
* Knopf `Add Client to Session`, gib hier `<shortname>` ein, kleingeschrieben.
* Knopf `Add Client to Session`, gib hier `patroneo` ein, kleingeschrieben.
* Nochmal Add Client, diesmal `jackpatch`.
* Füge beliebige kompatible Programme hinzu, z.B. Synthesizer.
** Siehe auch das NSM Handbuch: http://non.tuxfamily.org/nsm/
** Und die Liste der NSM kompatiblen Programme: http://non.tuxfamily.org/wiki/ApplicationsSupportingNsm
In der Datei README.md befinden sich weitere Möglichkeiten <shortname> zu starten. Diese sind zum Musikmachen nicht praktikabel,
In der Datei README.md befinden sich weitere Möglichkeiten patroneo zu starten. Diese sind zum Musikmachen nicht praktikabel,
aber nützlich für Tests und Entwicklung.
== Helfen und Entwicklung
@ -311,7 +311,7 @@ Hier ist dennoch die komplette Anleitung, um eine Übersetzung komplett alleine
Das Programm ist in zwei Teile aufgeteilt: Ein gemeinsames "Template" (für alle Laborejo Software Suit Programme) sowie das eigentliche Programm.
Der Übersetzungsprozess ist der gleiche für beide Teile, man muss ihn jedoch in unterschiedlichen Verzeichnissen durchführen:
`template/qtgui` und nur `/qtgui`, relativ zum Stammverzeichnis, wo sich die ausführbare Datei <shortname> befindet.
`template/qtgui` und nur `/qtgui`, relativ zum Stammverzeichnis, wo sich die ausführbare Datei patroneo befindet.
Jedes "template/qtgui" hier kann durch nur "qtgui" ersetzt werden um den zweiten Teil zu übersetzen.
@ -337,6 +337,6 @@ Die Übersetzung kannst du auch selbst, zum Testen, in Patroneo einbinden. Dafü
** `from PyQt5 import QtCore;QtCore.QLocale().languageToString(QtCore.QLocale().language())`
Um deine neue Übersetzung zu testen starte dein Programm, falls dein System bereits auf diese Sprache eingstellt ist. Ansonsten starte <shortname> mit diesem Befehl vom Terminal aus:
Um deine neue Übersetzung zu testen starte dein Programm, falls dein System bereits auf diese Sprache eingstellt ist. Ansonsten starte patroneo mit diesem Befehl vom Terminal aus:
* `LANGUAGE=de_DE.UTF-8 ./<shortname> -V --save /dev/null`
* `LANGUAGE=de_DE.UTF-8 ./patroneo -V --save /dev/null`

24
documentation/out/english.html

@ -894,7 +894,7 @@ To help you, it is possible to display other tracks as <strong>[2] Shadows</stro
If it is not there, or only in an outdated version, please ask your Linux distribution to provide a recent version.</p>
</div>
<div class="paragraph">
<p>If available in the package repository, please continue reading directly at "Start &lt;shortname&gt; from Non Session Manager".
<p>If available in the package repository, please continue reading directly at "Start patroneo from Non Session Manager".
If not, you can build Patroneo yourself.</p>
</div>
<div class="ulist">
@ -911,7 +911,7 @@ If not, you can build Patroneo yourself.</p>
<p>Download the latest version from <a href="https://www.laborejo.org/downloads" class="bare">https://www.laborejo.org/downloads</a> and extract it.</p>
</li>
<li>
<p><code>git clone <a href="https://laborejo.org/&lt;shortname&gt;.git" class="bare">https://laborejo.org/&lt;shortname&gt;.git</a></code></p>
<p><code>git clone <a href="https://laborejo.org/patroneo.git" class="bare">https://laborejo.org/patroneo.git</a></code></p>
</li>
</ul>
</div>
@ -938,7 +938,7 @@ If not, you can build Patroneo yourself.</p>
</ul>
</div>
<div class="ulist">
<div class="title">Start &lt;shortname&gt; from Non Session Manager (NSM)</div>
<div class="title">Start patroneo from Non Session Manager (NSM)</div>
<ul>
<li>
<p>Run <code>non-session-manager</code></p>
@ -947,7 +947,7 @@ If not, you can build Patroneo yourself.</p>
<p>Press the <code>New</code> button, and enter a name for your piece of music.</p>
</li>
<li>
<p>Press the <code>Add Client to Session</code> button, enter <code>&lt;shortname&gt;</code> here, in lower case.</p>
<p>Press the <code>Add Client to Session</code> button, enter <code>patroneo</code> here, in lower case.</p>
</li>
<li>
<p>Add Client again, this time <code>jackpatch</code>.</p>
@ -968,7 +968,7 @@ If not, you can build Patroneo yourself.</p>
</ul>
</div>
<div class="paragraph">
<p>Please read README.md for other ways of starting &lt;shortname&gt;, which are impractical for actual use but can
<p>Please read README.md for other ways of starting patroneo, which are impractical for actual use but can
be helpful for testing and development.</p>
</div>
</div>
@ -1022,7 +1022,7 @@ The program is split in two parts. A shared "template" between the Laborejo Soft
</div>
<div class="paragraph">
<p>The process is the same for both parts, but needs to be done in different directories:
<code>template/qtgui`and plain `/qtgui</code>, relative to the root directory, where the &lt;shortname&gt; executable is.</p>
<code>template/qtgui`and plain `/qtgui</code>, relative to the root directory, where the patroneo executable is.</p>
</div>
<div class="paragraph">
<p>Everytime you see "template/qtgui" below you can substitute that with just "qtgui" to translate the other part of Patroneo.</p>
@ -1099,8 +1099,14 @@ The program is split in two parts. A shared "template" between the Laborejo Soft
</ul>
</div>
<div class="paragraph">
<p>To test the new translation you can either run the program normally, if your system is set to that language. Alternatively start &lt;shortname&gt; via the terminal:
* <code>LANGUAGE=de_DE.UTF-8 ./&lt;shortname&gt; -V --save /dev/null</code></p>
<p>To test the new translation you can either run the program normally, if your system is set to that language. Alternatively start patroneo via the terminal:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>LANGUAGE=de_DE.UTF-8 ./patroneo -V --save /dev/null</code></p>
</li>
</ul>
</div>
</div>
</div>
@ -1108,7 +1114,7 @@ The program is split in two parts. A shared "template" between the Laborejo Soft
</div>
<div id="footer">
<div id="footer-text">
Last updated 2019-01-26 18:51:50 +0100
Last updated 2019-01-26 18:52:55 +0100
</div>
</div>
</body>

18
documentation/out/german.html

@ -898,7 +898,7 @@ Als Hilfe gibt es die Möglichkeit sich andere Spuren als <strong>[2] Schatten</
Falls es dort nicht vorhanden ist, oder nur in einer veralteten Version, bitte deine Linuxdistribution Patroneo bereitzustellen.</p>
</div>
<div class="paragraph">
<p>Falls in den Paketquellen vorhanden bitte direkt bei "&lt;shortname&gt; im Non Session Manager starten" weiterlesen.
<p>Falls in den Paketquellen vorhanden bitte direkt bei "patroneo im Non Session Manager starten" weiterlesen.
Falls nicht kann man Patroneo auch selbst "bauen".</p>
</div>
<div class="ulist">
@ -915,7 +915,7 @@ Falls nicht kann man Patroneo auch selbst "bauen".</p>
<p>Lade von <a href="https://www.laborejo.org/downloads" class="bare">https://www.laborejo.org/downloads</a> die aktuelle Version herunter und entpacke sie.</p>
</li>
<li>
<p><code>git clone <a href="https://laborejo.org/&lt;shortname&gt;.git" class="bare">https://laborejo.org/&lt;shortname&gt;.git</a></code></p>
<p><code>git clone <a href="https://laborejo.org/patroneo.git" class="bare">https://laborejo.org/patroneo.git</a></code></p>
</li>
</ul>
</div>
@ -940,7 +940,7 @@ Falls nicht kann man Patroneo auch selbst "bauen".</p>
</ul>
</div>
<div class="ulist">
<div class="title">&lt;shortname&gt; im Non Session Manager (NSM) starten</div>
<div class="title">patroneo im Non Session Manager (NSM) starten</div>
<ul>
<li>
<p>Starte <code>non-session-manager</code></p>
@ -949,7 +949,7 @@ Falls nicht kann man Patroneo auch selbst "bauen".</p>
<p>Knopf <code>New</code>, gib einen Namen für dein Musikstück ein.</p>
</li>
<li>
<p>Knopf <code>Add Client to Session</code>, gib hier <code>&lt;shortname&gt;</code> ein, kleingeschrieben.</p>
<p>Knopf <code>Add Client to Session</code>, gib hier <code>patroneo</code> ein, kleingeschrieben.</p>
</li>
<li>
<p>Nochmal Add Client, diesmal <code>jackpatch</code>.</p>
@ -970,7 +970,7 @@ Falls nicht kann man Patroneo auch selbst "bauen".</p>
</ul>
</div>
<div class="paragraph">
<p>In der Datei README.md befinden sich weitere Möglichkeiten &lt;shortname&gt; zu starten. Diese sind zum Musikmachen nicht praktikabel,
<p>In der Datei README.md befinden sich weitere Möglichkeiten patroneo zu starten. Diese sind zum Musikmachen nicht praktikabel,
aber nützlich für Tests und Entwicklung.</p>
</div>
</div>
@ -1103,7 +1103,7 @@ Das Programm ist in zwei Teile aufgeteilt: Ein gemeinsames "Template" (für alle
</div>
<div class="paragraph">
<p>Der Übersetzungsprozess ist der gleiche für beide Teile, man muss ihn jedoch in unterschiedlichen Verzeichnissen durchführen:
<code>template/qtgui</code> und nur <code>/qtgui</code>, relativ zum Stammverzeichnis, wo sich die ausführbare Datei &lt;shortname&gt; befindet.</p>
<code>template/qtgui</code> und nur <code>/qtgui</code>, relativ zum Stammverzeichnis, wo sich die ausführbare Datei patroneo befindet.</p>
</div>
<div class="paragraph">
<p>Jedes "template/qtgui" hier kann durch nur "qtgui" ersetzt werden um den zweiten Teil zu übersetzen.</p>
@ -1180,12 +1180,12 @@ Das Programm ist in zwei Teile aufgeteilt: Ein gemeinsames "Template" (für alle
</ul>
</div>
<div class="paragraph">
<p>Um deine neue Übersetzung zu testen starte dein Programm, falls dein System bereits auf diese Sprache eingstellt ist. Ansonsten starte &lt;shortname&gt; mit diesem Befehl vom Terminal aus:</p>
<p>Um deine neue Übersetzung zu testen starte dein Programm, falls dein System bereits auf diese Sprache eingstellt ist. Ansonsten starte patroneo mit diesem Befehl vom Terminal aus:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>LANGUAGE=de_DE.UTF-8 ./&lt;shortname&gt; -V --save /dev/null</code></p>
<p><code>LANGUAGE=de_DE.UTF-8 ./patroneo -V --save /dev/null</code></p>
</li>
</ul>
</div>
@ -1195,7 +1195,7 @@ Das Programm ist in zwei Teile aufgeteilt: Ein gemeinsames "Template" (für alle
</div>
<div id="footer">
<div id="footer-text">
Last updated 2019-01-26 18:51:50 +0100
Last updated 2019-01-26 18:52:55 +0100
</div>
</div>
</body>

Loading…
Cancel
Save