Benutzer-Werkzeuge

Webseiten-Werkzeuge


nutzerhandbuch

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
nutzerhandbuch [03.06.2015 13:21]
martin [Buch importieren (ouf-Datei fehlt, src-Datei vorhanden)]
nutzerhandbuch [11.08.2021 10:15] (aktuell)
Zeile 5: Zeile 5:
 ==== Vorbereitung ==== ==== Vorbereitung ====
  
-Um alle Funktionalitäten von Tingeltangel vollständig nutzen zu können, werden ein paar zusätzliche externe Tools benötigt.+Um alle Funktionalitäten von Tingeltangel vollständig nutzen zu können, werden ein paar zusätzliche externe Tools und ein Internetzugang benötigt.
  
 //**Java (JRE) (wird immer benötigt)**// //**Java (JRE) (wird immer benötigt)**//
Zeile 13: Zeile 13:
 Auf allen Betriebsystemen muss die Umgebungsvariable "JAVA_HOME" gesetzt sein und "JAVA_HOME/bin" muss der Umgebungsvariable "PATH" hinzugefügt werden. Eine Anleitung dazu findet man [[http://help.adobe.com/de_DE/enterpriseplatform/10.0/InstallSolution/WS0b373c8e7f652f14-288f6da412ff737e785-7ffe.html|hier]]. Auf allen Betriebsystemen muss die Umgebungsvariable "JAVA_HOME" gesetzt sein und "JAVA_HOME/bin" muss der Umgebungsvariable "PATH" hinzugefügt werden. Eine Anleitung dazu findet man [[http://help.adobe.com/de_DE/enterpriseplatform/10.0/InstallSolution/WS0b373c8e7f652f14-288f6da412ff737e785-7ffe.html|hier]].
  
-//**MP3 Playback**//+//**MP3 Playback (wird ab Version 0.2 nicht mehr benötigt)**//
  
 Um aus Tingeltangel MP3s wiederzugeben muss "mpg123" installiert sein. Das Windows 64 Bit Binary bekommt man [[http://www.mpg123.de/download/win64/?V=1&O=D|hier]], die 32 Bit Variante [[http://www.mpg123.de/download/win32/?V=1&O=D|hier]]. Linuxnutzer können mpg123 über Ihr zentrales Distributionsrepository installieren. Um aus Tingeltangel MP3s wiederzugeben muss "mpg123" installiert sein. Das Windows 64 Bit Binary bekommt man [[http://www.mpg123.de/download/win64/?V=1&O=D|hier]], die 32 Bit Variante [[http://www.mpg123.de/download/win32/?V=1&O=D|hier]]. Linuxnutzer können mpg123 über Ihr zentrales Distributionsrepository installieren.
Zeile 21: Zeile 21:
 Um die "Text-To-Speach" Funktionalität nutzen zu können, muss "eSpeak" und "lame" installiert sein. Um die "Text-To-Speach" Funktionalität nutzen zu können, muss "eSpeak" und "lame" installiert sein.
  
-Das Windows eSpeak-Binary bekommt man [[http://espeak.sourceforge.net/download.html|hier]]. Linuxnutzer können "mpg123" über Ihr zentrales Distributionsrepository installieren.+Das Windows eSpeak-Binary bekommt man [[http://espeak.sourceforge.net/download.html|hier]]. Linuxnutzer können "eSpeak" über Ihr zentrales Distributionsrepository installieren.
  
 Das Windows lame-Binary bekommt man [[http://www.rarewares.org/mp3-lame-bundle.php|hier]]. Linuxnutzer können "lame" über Ihr zentrales Distributionsrepository installieren. Das Windows lame-Binary bekommt man [[http://www.rarewares.org/mp3-lame-bundle.php|hier]]. Linuxnutzer können "lame" über Ihr zentrales Distributionsrepository installieren.
Zeile 87: Zeile 87:
 ==== Das Repository ==== ==== Das Repository ====
  
-<color red>fehlt!</color>+Das "Repository" bezeichnet die lokale Kopie aller offiziellen Bücher. Im Menü "Fenster"->"Repository" kann der Repository-Manager geöffnet werden. Ein doppelklick auf ein Buch 
 +lädt dieses vom Ting-Server herunter. Heruntergeladene Bücher werden grün hinterlegt.
  
 ==== MP3s extrahieren ==== ==== MP3s extrahieren ====
  
-<color red>fehlt!</color>+Im Menü "Buch"->"Importieren"->"Repository" auswählen. Danach kann ein Buch zum Import selektiert werden. Nachdem das Buch importiert ist, kann man die MP3s aus dem Verzeichniss "{Pfad zum Benutzerverzeichniss}\Dokumente\tingeltangel\books\{Buch ID (MID)}\audio" (unter Windows) oder "~/.tingeltangel/books/{Buch ID (MID)}/audio" herauskopieren. Die MP3s sind nach ihren Ting-IDs (OIDs) benannt.
  
-==== Buch auf den Stift kopieren (offizielles Buch) ==== 
  
-<color red>fehlt!</color> 
  
-==== Buch generieren und auf den Stift kopieren (selbstgemachtes Buch) ==== +===== Command Line Interface =====
- +
-<color red>fehlt!</color> +
- +
-==== Stift in den Debug-Modus versetzen ==== +
- +
-<color red>fehlt!</color> +
- +
-===== Command Line Interface [EXPERIMENTELL] =====+
  
 Windows: Windows:
- Tingeltangel.bat [<Kommando> [<Optionen>]]+ java -jar target\tingeltangel-XXX-jar-with-dependencies.jar [<Kommando> [<Optionen>]]
 Linux: Linux:
- Tingeltangel.sh [<Kommando> [<Optionen>]]+ java -jar target/tingeltangel-XXX-jar-with-dependencies.jar [<Kommando> [<Optionen>]]
   
 Wenn kein Kommando gegeben ist, wird die GUI gestartet. Wenn kein Kommando gegeben ist, wird die GUI gestartet.
  
-==== Kommandos ==== +Mittels
- assemble -i <Eingabedatei> +
- Erstellt aus einer yaml-Datei eine ouf-Datei. +
- Optionen: +
- -i <Eingabedatei>: setzt den Namen der Eingabedatei +
- +
- oid-code -i <Eingabedatei> +
- Erstellt zu einer yaml-Datei passende OID-Codes. +
- Optionen: +
- -i <Eingabedatei>: setzt den Namen der Eingabedatei +
- +
- generate-raw-code [-w <Breite>] [-f <Dateiformat>] -c <Code-ID> [-r <Auflösung>] [-o <Ausgabedatei>] [-h <Höhe>+
- Erzeugt ein png oder eps von der gegebenen Code-ID +
- Optionen: +
- -w <Breite>: Breite im mm (default: 100) +
- -f <Dateiformat>: setzt das Ausgabedateiformat. png oder eps. (default: png) +
- -c <Code-ID>: die Code-ID +
- -r <Auflösung>: setzt die Ausgabeauflösung. 600 für 600dpi oder 1200 für 1200dpi. (default: 1200) +
- -o <Ausgabedatei>: setzt den Namen der Ausgabedatei (default: <Code-ID>_raw_<Auflösung>.<Dateiformat>+
- -h <Höhe>: Höhe im mm (default: 100)+
  
- help + java -jar target\tingeltangel-XXX-jar-with-dependencies.jar help
- zeigt diese Hilfe an+
  
- books-update +bzw.
- Aktualisiert die Buchliste+
  
- generate-code [-w <Breite>] [-f <Dateiformat>-t <Ting-ID> [-r <Auflösung>] [-o <Ausgabedatei>] [-h <Höhe>+ java -jar target/tingeltangel-XXX-jar-with-dependencies.jar help
- Erzeugt ein png oder eps von der gegebenen Ting-ID +
- Optionen: +
- -w <Breite>: Breite im mm (default: 100) +
- -f <Dateiformat>: setzt das Ausgabedateiformatpng oder eps. (default: png) +
- -t <Ting-ID>: die Ting-ID +
- -r <Auflösung>: setzt die Ausgabeauflösung. 600 für 600dpi oder 1200 für 1200dpi. (default: 1200) +
- -o <Ausgabedatei>: setzt den Namen der Ausgabedatei (default: <Ting-ID>_<Auflösung>.<Dateiformat>+
- -h <Höhe>: Höhe im mm (default: 100)+
  
- import [-t <txt-Datei>] -b <Buch-Verzeichniss> [-s <src-Datei>] -o <ouf-Datei> +wird eine Liste der bekannten Kommandos ausgegeben.
- Importiert ein Buch aus einer ouf-Datei +
- Optionen: +
- -t <txt-Datei>: die zu importierende txt-Datei +
- -b <Buch-Verzeichniss>: setzt das (existierende) Zielverzeichniss im dem Buch gespeichert werden soll +
- -s <src-Datei>: die zu importierende src-Datei +
- -o <ouf-Datei>: die zu importierende ouf-Datei+
  
- books-scan 
- Aktualisiert die gesammte Buchliste (Vorsicht: kann viel Zeit beanspruchen) 
nutzerhandbuch.1433337664.txt.gz · Zuletzt geändert: 11.08.2021 10:15 (Externe Bearbeitung)