Neue Icons hinzugefügt, Anleitung weiter geschrieben

doc/manual-de.md

@@ -7,7 +7,7 @@ Diese Anwendung soll helfen
 * sich wiederholende Scan-Vorgänge zu erleichtern
 * mehrseitige PDFs mit aus gescannten Einzelseiten zu erstellen
 
-### Beispiel 1
+### Beispiel 1: wiederkehrendes Dokument mit wechselndem Datum
 
 #### Aufgabenstellung
 Die die regelmäig per Brief kommende Lohnsteuerbescheinigung soll als PDF eingescannt
@@ -59,13 +59,134 @@ Sofort wird das Speicher-_Schema_ sowie die weiteren Einstellungen geladen. Man
 
 ## Platzhalter
 
+Wie schon erwähnt dienen Profile dazu, gleichartige oder ähnliche Dokumente an einem _gleich aufgebauten_ Pfad abzulegen.
+_Gleich aufgebaut_ meint dabei, dass zum Beispiel der Pfad zum Ablageodner immer gleich ist, und sich die Dateinamen nur im Datum, dem Betreff oder einer sonstigen Eigenschaft unterscheiden.
+
+Damit aber nicht jedes mal, wenn ein Dokument erfasst werden soll, der Pfad angepasst werden muss gibt es Platzhalter:
+
+Wird in einem Pfad ein Dollarzeichen, gefolgt von einem Wort eingegeben, so wird ein entsprechender Platzhalter mit einem separaten Eingabefeld erzeugt.
+
+### Beispiel 2: Belege mit benutzerdefinierten Platzhaltern
+
+Quittungen von wichtigen Einkäufen sollen archiviert werden.
+Die Ablage soll im Ordner „Belege“, nach Jahr und Monat gruppiert abgelegt werden.
+Innerhalb des Monats-Ordners sollen die Belege dem folgenden Namen-Schema folgen:
+<Tag>-<Monat>-<Jahr> - <Produkt> von <Händler>.
+
+Wenn also am 1.2.2023 ein Gummihuhn im Obi gekaut wurde, soll der Pfad zum Dokument am Ende sein:
+
+`<Benutzerordner>/Belege/2023/02/01.02.2023 - Gummihuhn von Obi.pdf`
+
+Und der Beleg zum Kontinummtransfunktiniator, den man zu Weihnachten von Oma bekommt, soll unter
+
+`<Benutzerordner>/Belege/1987/12/24.12.1987 - Kontinuumtransfunktionator von Oma.pdf` abgelegt werden.
+
+Um das zu erreichen kann man ein neues Profil _Belege_ anlegen und dazu folgenden Pfad eingeben:
+
+`$HOME/$PROFIL/$JAHR/$MONAT/$TAG.$MONAT.$JAHR - $Produkt von $Händler`
+
+Dieser Pfad ist voll mit Platzhaltern:
+
+* das schon bekannte `$HOME` steht für den Benutzerordner
+* `$PROFIL` wird durch den Profil-Namen, in diesem Fall _Belege_ ersetzt.
+* `$JAHR`, `$MONAT` sind schon von oben bekannt, `$TAG` wird entsprechend durch den Tag des Monats, der im Kalender gewählt ist, ersetzt.
+* `$Produkt` und `$Händler` sind sogenannte nutzerdefinierte Platzhalter.
+
+Dadurch muss beim nächsten mal, wenn ein Beleg gescannt wird nur das entsprechende Datum und Profil ausgewählt werden und Produkt und Händler eingetragen werden.
+
+### nutzerdefinierte Platzhalter
+
+Immer wenn im Pfad ein Dollarzeichen ($), gefolgt von einem Wort, verwendet wird, handelt es sich dabei um einen Platzhalter.
+Steht das wort nicht für einen → _vordefinierten Platzhalter_, wird automatisch ein _nutzerdefinierter Platzhalter_ erzeugt.
+
+D.h. für das Wort wird ein neues Eingabefeld erzeugt und der Platzhalter wird letztlich durch den Wert des Eingabefeldes ersetzt.
+
+Im letzten Beispiel würden also zwei Eingabefelder erzeugt: eines für _Produkt_ und eines für _Händler_.
+
+Die Platzhalter im Pfad werden dann durch die Werte der Eingabefelder ersetzt.
+
+### vordefinierte Platzhalter
+
+Neben der Möglichkeit neue Platzhalter zu erzeugen können auch folgende vordefinierte Platzhalter benutzt werden:
+
+| Platzhalter | wir ersetzt durch                                         | Beispiel                 |
+|-------------|-----------------------------------------------------------|--------------------------|
+| $HOME | Heimatverzeichnis des Benutzers                         | `/home/christiane_meise` |
+| $PROFIL | Name des Profils                                         | `Rechnungen`             |
+| $SEITE | aktuelle Seitennummer im Projekt | `5` |
+| $JAHR | Jahr des im Kalender gewählten Datums                    | `2023`                   |
+| $MONTH | Monat des im Kalender gewählten Datums (2-stellig)       | `08`                     |
+| $Month | Name des im Kalender gewählten Monats                    | `August`                 |
+| $month | Name des im Kalender gewählten Monats (kleingeschrieben)  | `august`                 |
+| $Mon | Kürzel des im Kalender gewählten Monats                   | `Aug`                    |
+| $mon | Kürzel des im Kalender gewählten Monats (kleingeschrieben) | `aug`                    |
+| $DAY | Tag des im Kalender gewählten Monats (2-stellig)          |  `27`                    |
+
+
+## mehrseitige Dokumente
+
+Alle bisherigen Beispiele gingen davon aus, dass ein Projekt nur aus einer einzelnen Seite besteht.
+Oft ist es aber notwendig, mehrere Einzel-Seiten als Bilder abzulegen oder gar ein PDF daraus zu binden.
+
+### Beispiel 3: mehrere Einzel-Seiten
+
+Ein Freund auf Reisen schickt regelmäßig Postkarten, deren Vorder- und Rückseite digitalisiert werden sollen.
+
+Für jede Postkarte soll im Ordner `Post` ein Unterordner für den Monat (ausgeschrieben) und darin für das Datum erzeugt werden.
+Darin sollen die Vorder- und Rückseite als `Seite 1.jpg` bzw. `Seite 2.jpg` abgelegt werden.
+
+Hierzu empfiehlt sich folgendes Schema:
+
+`$HOME/Post/$Monat/$TAG.$MONAT/Seite $SEITE`
+
+Wird dann der 18.9. im Kalender und `jpeg` als Format gewählt, so würde die erste gescannte Seite als
+
+`<Benutzerordner>/Post/September/18.9./Seite 1.jpg` und die zweite als `<Benutzerordner>/Post/September/18.9./Seite 2.jpg` gespeichert.
+
+### Beispiel 4: mehrseitiges PDF
+
+Eine Bank schickt monatlich Kontoauszüge, die mehrere Seiten lang sein können.
+
+Diese sollen unter `Kontoauszüge/<Jahr>/<Jahr>-<Monat> Kontoauszug.pdf` abgelegt werden.
+
+Hier empfielt es sich, ein Profil `Kontoauszug` anzulegen und folgenden _Pfad_ zu setzen:
+
+`$HOME/Kontoauszuüge/$JAHR/$JAHR-$MONAT - $PROFIL $SEITE`.
+
+Das `$PROFIL` im Pfad wird durch den Profil-Namen `Kontoauszug` ersetzt werden.
+Der Platzhalter `$SEITE` ist notwendig, da das Einscannen Seite für Seite erfolgt und die einzelnen Seiten erstmal unter verschiedenen Namen abgelegt werden – diese Seitennummer kann beim nachfolgenden Binden des PDFs entfernt werden, dazu gleich mehr.
+
+Um den mehrseitigen Kontoauszug für März 2023 zu scannen muss man also einen Tag im März 2023 im Kalender und
+das Profil `Kontoauszug` und als Typ `pdf` oder `pdf+ocr` auswählen.
+
+Beim ersten Klick auf _Scannen_ wird dann im oberen Bereich der Anwendung
+ein Projekt `<Benutzerordner>/Kontoauszuüge/2023/2023-03 - Kontoauszug [Seite]` angelegt
+und nach dem Scannen eine Datei `2023-03 - Kontoauszug 1.pdf` erzeugt.
+Beim nächsten Klick dann die Datei `2023-03 - Kontoauszug 2.pdf` und so weiter.
+
+<img src="../src/main/resources/img/join.png" style="height: 50px; float: right;" />
+Nachdem alle Seiten des Projektes gescannt wurden, kann in der Projektzeile am oberen Rand der Anwendung der Button _PDFs binden_ derükt werden.
+
+
+Dies wird alle PDF-Dateien des Projekts (nicht aber die _jpg_-Dateien) zu einem mehrseitigen PDF vereinen.
+Wenn der Kontoauszug vorher fünf seiten hatte, die alle gescannt wurden, so wird das gebundene PDF wie folgt benannt:
+`2023-03 - Kontoauszug 1…5.pdf`.
+
+Falls die Seitenangabe `1…5` nicht erwünscht ist, kann vor dem Binden die Option `[Seite] beim Zusammenfügen entfernen` gewählt werden.
+Dann wäre der Seitenname des gebundenen PDFs `2023-03 - Kontoauszug.pdf`.
+
+### Löschen von einzelnen Seiten beim Scannen
+
+Manchmal passiert es, das man versehentlich eine Seite doppelt scannt oder die aktuelle gescannte Seite nicht richtig ausgerichtet war.
+Da jede gescannte Seite im Vorschaufenster angezeigt wird, sollte dies schnell auffallen.
+
+<img src="../src/main/resources/img/trash.png" style="height: 50px; float: right" />
+In so einem Fall kann man die letzte Seite des aktuellen Projekts einfach löschen, indem man auf den entsprechenden Button klickt:
 
 ## TODOs
 
 * Zusatzfelder zum aktuellen Profile mit speichern
-* diese Anleitung vervollständigen
-  * vordefinierte Platzhalter
-  * nutzerdefinierte Platzhalter
-  * Löschen von Profilen
-  * Beispiele für Profile
-  * Funktion der Projekt-Knöpfe
+* diese Anleitung vervollständigen  
+    * Löschen von Profilen
+    * Funktion der Projekt-Knöpfe
+    * Buttons deaktivieren, die von der Logik keinen Sinn ergeben