diff --git a/docs/de/manual/README.md b/docs/de/manual/README.md index 4c2b0e4..b1ab8e0 100644 --- a/docs/de/manual/README.md +++ b/docs/de/manual/README.md @@ -5,6 +5,12 @@ _Englisches Original: [docs/manual/README.md](../../manual/README.md)_ Nutzer-Dokumentation, nach Zielgruppe. (Das englische Original ist bei Abweichungen maßgeblich.) +**Neu hier?** Das Einsteiger-Tutorial +[Dorfteich Schritt für Schritt](../tutorial/README.md) führt ohne +Vorkenntnisse in 21 kurzen Kapiteln durch alle Funktionen — anhand +eines echten Beispiel-Teichs. (Deutsch zuerst; anders als die übrigen +Handbücher ist hier die deutsche Fassung das Original.) + | Handbuch | Für | | ----------------------------------------------- | ----------------------------------------------- | | [Feature-Überblick](../features.md) | alle, die wissen wollen, was Dorfteich ist | diff --git a/docs/de/tutorial/01-was-ist-dorfteich.md b/docs/de/tutorial/01-was-ist-dorfteich.md new file mode 100644 index 0000000..6f73cbb --- /dev/null +++ b/docs/de/tutorial/01-was-ist-dorfteich.md @@ -0,0 +1,53 @@ +# Was ist Dorfteich? + +Stell dir einen Teich vor: ein überschaubares Gewässer, in dem sich nach +und nach Leben ansammelt. Genau so funktioniert Dorfteich — nur dass sich +dort kein Wasser sammelt, sondern **dein Wissen**. Ein **Teich** ist deine +Sammlung, und jede Notiz darin ist eine **Seite**. Seiten können +aufeinander verweisen, und aus vielen kleinen Seiten wächst mit der Zeit +ein Netz, in dem du dich erstaunlich gut zurechtfindest. + +Dorfteich läuft komplett im Browser. Du musst nichts installieren und +nichts einrichten — Konto anlegen, anmelden, lostippen. + +## Wofür Menschen Dorfteich benutzen + +- **Notizen und Gedanken**, die mehr verdienen als einen Zettel: Rezepte, + Reisepläne, Projektideen. +- **Wissenssammlungen** zu Hobbys und Interessen, in denen alles mit allem + zusammenhängen darf. +- **Gemeinsames Schreiben** mit Familie, Verein oder Team — mehrere + Personen, ein Text, keine Dateiversionen per E-Mail. + +## Schau dir ein echtes Beispiel an + +Am schnellsten versteht man Dorfteich, wenn man einen bewohnten Teich +besucht. Nadia Morgenstern sammelt in ihrem Teich alles über ihre vier +großen Interessen: Musik, Literatur, Sport und Filme. Ihr Teich ist +öffentlich lesbar — du brauchst kein Konto: + +- Starte auf ihrer Seite + [Musik](https://dorfteich.online/public/nadia-morgenstern/musik) und + folge einfach den Links im Text. +- Über die Band + [DOTA](https://dorfteich.online/public/nadia-morgenstern/dota) landest + du bei der Dichterin + [Mascha Kaléko](https://dorfteich.online/public/nadia-morgenstern/mascha-kaleko) + — von der Musik in die Literatur, mit einem Klick. + +Genau das ist die Idee: Nadia hat nicht vier getrennte Ordner angelegt, +sondern ein Netz, in dem ihre Interessen zusammenhängen. Wie sie das +gebaut hat — und wie du dir dein eigenes Netz baust — zeigen dir die +nächsten Kapitel, Schritt für Schritt. + +## Probier es aus + +Nimm dir fünf Minuten und klick dich durch Nadias Teich. Beginne bei +[Musik](https://dorfteich.online/public/nadia-morgenstern/musik) und +folge nur den Links im Text — ohne Menüs, ohne Suche. Achte darauf, wie +oft dich ein Link in ein ganz anderes Thema trägt. + +--- + +Weiter: [Kapitel 2 — Dein Konto und dein erster Teich](02-konto-und-teich.md) +· [Zum Überblick](README.md) diff --git a/docs/de/tutorial/02-konto-und-teich.md b/docs/de/tutorial/02-konto-und-teich.md new file mode 100644 index 0000000..030e2f4 --- /dev/null +++ b/docs/de/tutorial/02-konto-und-teich.md @@ -0,0 +1,56 @@ +# Dein Konto und dein erster Teich + +In diesem Kapitel legst du dir ein Konto an — und bekommst dabei, ohne +etwas dafür zu tun, deinen ersten eigenen Teich geschenkt. + +## Registrieren + +1. Öffne die Startseite deiner Dorfteich-Instanz (zum Beispiel + [dorfteich.online](https://dorfteich.online)) und wähle + **Registrieren**. +2. Du brauchst nur vier Dinge: einen **Benutzernamen**, deine + **E-Mail-Adresse**, einen **Anzeigenamen** (so heißt du für andere) + und ein **Passwort**. Auch die Sprache der Oberfläche wählst du hier — + Deutsch oder Englisch, und du kannst sie jederzeit wieder umstellen. +3. Dorfteich schickt dir eine **Bestätigungsmail**. Klick auf den Link + darin — fertig. + +_[Screenshot folgt: das Registrierungsformular]_ + +Mit der Bestätigung passiert etwas Schönes im Hintergrund: Dein +**persönlicher Teich** wird angelegt. Das ist dein eigener Raum. Niemand +außer dir kann ihn sehen, bis du dich irgendwann entscheidest, etwas +daraus zu teilen. Nadias Teich aus Kapitel 1 ist genau so ein +persönlicher Teich — sie hat ihn nur später öffentlich gemacht (wie das +geht, kommt in Kapitel 15). + +## Anmelden + +Melde dich mit deinem Benutzernamen **oder** deiner E-Mail-Adresse an. +Solltest du dein Passwort einmal vergessen: Die Anmeldeseite hat einen +Link zum Zurücksetzen. + +Nach der Anmeldung landest du in deinem persönlichen Teich. Noch ist er +leer — ein stiller Teich, in den noch niemand etwas hineingeworfen hat. +Das ändern wir im nächsten Kapitel. + +## Gut zu wissen + +- **Sprache umstellen:** oben rechts auf deinen Namen → **Einstellungen** + → **Profil**. Die Inhalte deiner Seiten bleiben natürlich, wie du sie + geschrieben hast — nur Menüs und Knöpfe wechseln die Sprache. +- **Mehrere Geräte:** Du kannst dich auf Handy, Tablet und Rechner + gleichzeitig anmelden. Unter **Einstellungen → Aktive Sitzungen** + siehst du alle Geräte und kannst jedes einzeln abmelden. + +## Probier es aus + +Leg dir ein Konto an, bestätige deine E-Mail und melde dich an. Wirf +einen ersten Blick in deinen persönlichen Teich — und stell, wenn du +magst, die Sprache einmal um und wieder zurück, nur um zu sehen, wo der +Schalter wohnt. + +--- + +Weiter: [Kapitel 3 — Deine erste Seite](03-deine-erste-seite.md) · +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/03-deine-erste-seite.md b/docs/de/tutorial/03-deine-erste-seite.md new file mode 100644 index 0000000..bbbcb5d --- /dev/null +++ b/docs/de/tutorial/03-deine-erste-seite.md @@ -0,0 +1,57 @@ +# Deine erste Seite + +Zeit, den Teich zu beleben. In diesem Kapitel legst du deine erste Seite +an und lernst dabei die wichtigste Eigenheit von Dorfteich kennen: Es +gibt **keinen Speichern-Knopf** — und das ist ein Feature. + +## Eine Seite anlegen + +1. Links siehst du die **Seitenleiste** — dort wird später die Liste + deiner Seiten wohnen. Ganz unten sitzt eine kleine Leiste mit + Symbolen; wähle **+ Neue Seite**. +2. Gib der Seite einen Titel. Nimm etwas, worüber du wirklich gern + schreibst — dein Lieblingshobby, ein Buch, ein Rezept. Nadia hat mit + einer schlichten Seite namens + [Musik](https://dorfteich.online/public/nadia-morgenstern/musik) + angefangen: ein Absatz Begrüßung, was sie hier sammeln will. Mehr + braucht eine erste Seite nicht. +3. Tippe los. + +_[Screenshot folgt: leere neue Seite im Bearbeitungsmodus]_ + +## Es gibt keinen Speichern-Knopf + +Du kannst suchen, so lange du willst — er ist nicht da. Dorfteich +speichert **jeden Tastendruck sofort**. Mach die Probe: Schreib einen +Satz, schließ den Browser-Tab, öffne die Seite wieder. Alles noch da. + +Das heißt auch: Du kannst nichts „vergessen zu speichern". Später (in +Kapitel 10) lernst du, wie du zusätzlich bewusste Zwischenstände +festhältst — aber verlieren kannst du ab jetzt nichts mehr. + +## Titel und Adresse + +Jede Seite bekommt aus ihrem Titel eine lesbare **Adresse** (das Stück +nach dem letzten Schrägstrich in der Browser-Zeile). Aus Nadias Titel +„Musik" wurde die Adresse `musik`. Umlaute und Sonderzeichen werden +dabei automatisch übersetzt — aus „Sachbücher" wird `sachbuecher`. Du +musst dir darüber keine Gedanken machen; es ist nur gut zu wissen, dass +es diese Adressen gibt, denn im übernächsten Kapitel begegnen sie dir +bei den Wikilinks wieder. + +Zum Umschalten zwischen **Lesen und Bearbeiten** dient das +**Stift-Symbol** oben in der Kopfleiste (oder die Taste `e`). Im +Lesemodus ist die Seite aufgeräumt und ohne Werkzeugleiste — so sehen +Besucher sie später. + +## Probier es aus + +Leg eine Seite zu deinem liebsten Hobby an und schreib drei Sätze: +worum es geht, warum es dich begeistert, und was du hier sammeln +möchtest. Schalte dann mit dem Stift-Symbol in den Lesemodus und schau +dir dein Werk an. + +--- + +Weiter: [Kapitel 4 — Text gestalten](04-text-gestalten.md) · +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/04-text-gestalten.md b/docs/de/tutorial/04-text-gestalten.md new file mode 100644 index 0000000..4724433 --- /dev/null +++ b/docs/de/tutorial/04-text-gestalten.md @@ -0,0 +1,62 @@ +# Text gestalten + +Drei Sätze Fließtext sind ein Anfang — aber Seiten werden lesbarer, wenn +du sie gestaltest. Im Bearbeitungsmodus sitzt dafür oben die +**Werkzeugleiste**. Sie bleibt beim Scrollen sichtbar, du hast sie also +immer griffbereit. + +## Was die Werkzeugleiste kann + +- **Überschriften** (Ebene 1 bis 4) gliedern lange Seiten in Abschnitte. +- **Fett**, _kursiv_ und durchgestrichen betonen einzelne Wörter. +- **Aufzählungen** und **nummerierte Listen** für alles, was sich + aufzählen lässt. +- **Aufgabenlisten** mit echten Häkchen-Kästchen — perfekt für + Checklisten, die du nach und nach abhakst. +- **Zitate** rücken einen Absatz ein und heben ihn ab. +- **Tabellen** für alles, was Spalten verdient. +- **Trennlinien** setzen einen ruhigen Strich zwischen zwei Gedanken. + +Ein Tipp für alle, die Markdown kennen: Du kannst es einfach tippen +(`**fett**`, `- Liste` …) — Dorfteich versteht es. Wenn dir Markdown +nichts sagt: völlig egal, die Werkzeugleiste kann alles Gleiche per +Klick. + +## Bilder und Anhänge + +Ein Bild einzufügen ist absichtlich unspektakulär: **Kopiere es und füge +es ein**, oder **zieh die Bilddatei einfach in den Text**. Andere +Dateien (etwa PDFs) hängst du über das **Büroklammer-Symbol** an die +Seite. + +## Wie das bei Nadia aussieht + +Nadia hat einige ihrer Seiten genau mit diesen Werkzeugen ausgebaut: + +- Auf + [Wartung und Schrauberei](https://dorfteich.online/public/nadia-morgenstern/wartung-und-schrauberei) + wurde aus dem Absatz über Kettenpflege und Reifendruck eine + **Aufgabenliste** zum Abhaken vor der nächsten Ausfahrt. +- [Tour de France](https://dorfteich.online/public/nadia-morgenstern/tour-de-france) + bekam eine kleine **Tabelle**. +- Auf [Literatur](https://dorfteich.online/public/nadia-morgenstern/literatur) + und [Sport](https://dorfteich.online/public/nadia-morgenstern/sport) + begrüßen dich jetzt **Fotos** — eine alte Schreibmaschine für die + Literatur und ein sehr direkter Trainingsbefehl für den Sport. + +_[Screenshot folgt: Vorher/Nachher von „Wartung und Schrauberei" — +Fließtext gegen Checkliste]_ + +_[Screenshot folgt: die Werkzeugleiste im Bearbeitungsmodus, beschriftet]_ + +## Probier es aus + +Bau deine Hobby-Seite aus Kapitel 3 aus: eine **Überschrift**, darunter +eine **Liste** mit drei Punkten, und ein **Bild** — am besten ein +eigenes Foto. (Warum ein eigenes? Bilder aus dem Netz gehören meistens +jemandem. Bei eigenen Fotos bist du immer auf der sicheren Seite.) + +--- + +Weiter: [Kapitel 5 — Seiten verbinden: Wikilinks](05-wikilinks.md) · +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/05-wikilinks.md b/docs/de/tutorial/05-wikilinks.md new file mode 100644 index 0000000..ede8d2c --- /dev/null +++ b/docs/de/tutorial/05-wikilinks.md @@ -0,0 +1,68 @@ +# Seiten verbinden: Wikilinks + +Jetzt kommt das Herzstück von Dorfteich. Alles bisher — Seiten anlegen, +Text gestalten — kann jedes Schreibprogramm. **Wikilinks** sind der +Moment, in dem aus einzelnen Seiten ein Netz wird. + +## So setzt du einen Wikilink + +Tippe im Bearbeitungsmodus zwei eckige Klammern: `[[`. Sofort öffnet +sich eine **Vorschlagsliste** mit deinen Seiten. Tipp ein paar +Buchstaben, wähle die Seite mit den Pfeiltasten oder der Maus, drück +Enter — fertig. Der Link erscheint im Text und führt ab jetzt mit einem +Klick zur anderen Seite. + +Der angezeigte Text lässt sich anpassen: Aus `[[mascha-kaleko]]` kannst +du im Fließtext auch „die Dichterin Mascha Kaléko" machen — der Link +bleibt derselbe. + +_[Screenshot folgt: die Vorschlagsliste nach dem Tippen von „[["]_ + +## Verlinken, was es noch gar nicht gibt + +Das klingt erst einmal seltsam, ist aber einer der nützlichsten Tricks: +Du darfst auf Seiten verlinken, **die noch nicht existieren**. Schreibst +du über dein Lieblingsalbum und erwähnst die Band — setz den Link +einfach jetzt, auch wenn die Band-Seite noch fehlt. Dorfteich führt +solche Ziele als **fehlende Seiten** — die Startseite deines Teichs +listet sie sogar eigens auf, als freundliche Erinnerung. Folgst du so +einem Link, bietet Dorfteich dir an, die Seite **direkt an Ort und +Stelle anzulegen** — und in dem Moment funktionieren automatisch alle +Links, die je auf diese Adresse gezeigt haben. + +Erst verlinken, später schreiben: So wächst ein Netz, ohne dass du je +„Linkpflege" betreiben musst. + +## Und rückwärts? Backlinks! + +Unter jeder Seite (im Lesemodus) findest du das Panel **„Verlinkt +von"** — es zeigt alle Seiten, die auf die aktuelle verweisen. Du setzt +also nur Links in eine Richtung, und Dorfteich schenkt dir die +Rückrichtung dazu. + +## Wie das bei Nadia aussieht + +Nadias schönste Verbindung ist ein Dreieck quer durch drei Themen: + +- Die Band [DOTA](https://dorfteich.online/public/nadia-morgenstern/dota) + (Musik) vertont Gedichte von + [Mascha Kaléko](https://dorfteich.online/public/nadia-morgenstern/mascha-kaleko) + (Literatur) — +- und auf ihrer [Rennrad](https://dorfteich.online/public/nadia-morgenstern/rennrad)-Seite + (Sport) erzählt Nadia, dass sie beim Fahren am liebsten DOTA hört. + +Drei Themen, drei Seiten, und jede führt zur nächsten. Schau dir auf +einer der Seiten auch die Rubrik „Verlinkt von" an — dort siehst du die +Rückseite des Netzes. + +## Probier es aus + +Leg eine zweite Seite an, die zu deiner Hobby-Seite passt, und verlinke +beide **gegenseitig** (auf jeder Seite `[[` tippen). Setz außerdem einen +Link auf etwas, worüber du erst später schreiben willst — deine erste +fehlende Seite. Sie wird dir im nächsten Kapitel wieder begegnen. + +--- + +Weiter: [Kapitel 6 — Der Wissensgraph](06-wissensgraph.md) · +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/06-wissensgraph.md b/docs/de/tutorial/06-wissensgraph.md new file mode 100644 index 0000000..bcee753 --- /dev/null +++ b/docs/de/tutorial/06-wissensgraph.md @@ -0,0 +1,60 @@ +# Der Wissensgraph + +Im letzten Kapitel hast du Links gesetzt. Jetzt bekommst du die Belohnung +dafür: Dorfteich kann dir dein Netz **zeichnen**. + +## Die Landkarte deines Teichs + +Unten in der Seitenleiste findest du den Link **Graph**. Er öffnet den +**Wissensgraphen** deines Teichs: Jede Seite ist ein Punkt, jeder +Wikilink eine Linie. Die Punkte ordnen sich von selbst an — eng +verlinkte Seiten rücken zusammen, und plötzlich siehst du, welche Themen +bei dir Inseln bilden und wo die Brücken verlaufen. + +Du kannst im Graph: + +- **klicken** — ein Klick auf einen Punkt öffnet die Seite, +- **ziehen** — Punkte festhalten und anordnen, wie es dir gefällt, +- **zoomen** — mit dem Mausrad oder zwei Fingern hinein- und + hinauszoomen. + +_[Screenshot folgt: Nadias Wissensgraph mit den vier Themen-Wolken]_ + +Nadias Graph ist ein schönes Beispiel: 58 Seiten, 173 Verbindungen. Man +erkennt vier Wolken — Musik, Literatur, Sport, Filme — und dazwischen +genau die Brücken, die du in Kapitel 5 kennengelernt hast, etwa +DOTA–Kaléko–Rennrad. + +## Gestrichelte Punkte: fehlende Seiten + +Erinnerst du dich an den Link auf die noch nicht existierende Seite? +Im Graph taucht sie als **gestrichelter Punkt** auf (die Legende nennt +das „Fehlende Seite"). Der Graph vergisst nichts, was du dir +vorgenommen hast. Ein Klick auf einen gestrichelten Punkt legt die +Seite an — aus der fehlenden Seite wird eine echte, und der Punkt wird +ausgemalt. + +## Der kleine Bruder: der lokale Graph + +Auch unter jeder einzelnen Seite (im Lesemodus, neben „Verlinkt von") +wohnt ein **lokaler Graph**: die unmittelbare Nachbarschaft der Seite, +umschaltbar zwischen **einer und zwei Ebenen**. Eine Ebene zeigt die +direkten Nachbarn; zwei Ebenen zeigen auch die Nachbarn der Nachbarn — +oft die interessantere Ansicht, weil man Querverbindungen entdeckt, an +die man selbst nicht gedacht hat. + +Die Farben der Punkte haben übrigens eine Bedeutung — sie kommen von den +**Labels**, die du in Kapitel 8 kennenlernst. Noch zwei Kapitel Geduld. + +## Probier es aus + +Öffne den Graph deines Teichs. Viel ist da noch nicht — zwei, drei +Punkte und dein gestrichelter Punkt aus Kapitel 5. Klick ihn an und leg +die Seite an. Dann schau in Nadias Teich, wie so ein Graph nach ein paar +Monaten Sammeln aussieht: Öffne eine ihrer Seiten und wirf einen Blick +auf den lokalen Graphen mit zwei Ebenen. + +--- + +Weiter: [Kapitel 7 — Der Seitenbaum](07-seitenbaum.md) · +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/07-seitenbaum.md b/docs/de/tutorial/07-seitenbaum.md new file mode 100644 index 0000000..b8c1adb --- /dev/null +++ b/docs/de/tutorial/07-seitenbaum.md @@ -0,0 +1,69 @@ +# Der Seitenbaum + +Links verbinden deine Seiten inhaltlich. Aber manchmal will man schlicht +**Ordnung**: Dieses gehört zu jenem. Dafür bilden die Seiten in +Dorfteich einen **Baum** — Seiten können Unterseiten haben, bis zu sechs +Ebenen tief. + +## Wie bei Nadia sortiert wird + +Wirf einen Blick auf Nadias Seitenleiste (in der öffentlichen Ansicht +links): Vier Bäume tragen ihren Teich — +[Musik](https://dorfteich.online/public/nadia-morgenstern/musik), +[Literatur](https://dorfteich.online/public/nadia-morgenstern/literatur), +[Sport](https://dorfteich.online/public/nadia-morgenstern/sport) und +[Filme](https://dorfteich.online/public/nadia-morgenstern/filme). +Darunter geht es geordnet weiter: Musik → Rock & Pop → +[U2](https://dorfteich.online/public/nadia-morgenstern/u2). Jede Seite +hat genau einen Platz, und die kleinen Pfeile in der Seitenleiste +klappen die Äste auf und zu. + +## Unterseiten anlegen + +Das geht ganz nebenbei: Legst du eine neue Seite an, **während eine +andere geöffnet ist**, wird sie deren Unterseite — das Formular sagt es +dir an. Du kannst den Vorschlag annehmen oder die Seite stattdessen auf +die oberste Ebene setzen. + +## Seiten verschieben + +Zwei Wege führen zum Ziel: + +- **Ziehen:** Pack eine Seite in der Seitenleiste mit der Maus und zieh + sie **auf** eine andere — sie wird deren Unterseite. Ziehst du sie + **zwischen** zwei Seiten, ändert sich stattdessen die Reihenfolge. +- **Der sichere Weg:** Öffne die Seite und wähle im **…**-Menü + **Verschieben nach…** — ein Dialog zeigt den ganzen Baum, und du + wählst den neuen Platz in Ruhe aus. + +Wichtig zu wissen: **Verschieben ändert nie die Adresse einer Seite.** +Alle Links und Wikilinks funktionieren danach weiter, als wäre nichts +gewesen. + +_[Screenshot folgt: Nadias aufgeklappter Seitenbaum in der Seitenleiste]_ + +## Sortierung + +Wie Geschwister-Seiten untereinander geordnet sind, ist einstellbar: +alphabetisch, nach Datum — oder **manuell**, dann bestimmt deine +Zieh-Reihenfolge. Für den Anfang ist die automatische Sortierung völlig +in Ordnung. + +## Baum oder Links — was denn nun? + +Beides, und zwar ohne Widerspruch: Der **Baum** beantwortet „Wo ist die +Seite abgelegt?", die **Wikilinks** beantworten „Womit hängt sie +zusammen?". Nadias U2-Seite _steht_ unter Rock & Pop, aber sie _verweist_ +quer durch den Teich. Du musst dich nie zwischen Ordnung und Vernetzung +entscheiden. + +## Probier es aus + +Leg unter deiner Hobby-Seite zwei Unterseiten an (öffne dafür zuerst die +Hobby-Seite). Verschieb dann eine davon probeweise auf die oberste Ebene +und wieder zurück — einmal per Ziehen, einmal per **Verschieben nach…**. + +--- + +Weiter: [Kapitel 8 — Labels: Themen quer durch den Teich](08-labels.md) · +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/08-labels.md b/docs/de/tutorial/08-labels.md new file mode 100644 index 0000000..ae3d153 --- /dev/null +++ b/docs/de/tutorial/08-labels.md @@ -0,0 +1,71 @@ +# Labels: Themen quer durch den Teich + +Der Seitenbaum aus dem letzten Kapitel hat eine eingebaute Grenze: Jede +Seite steht an **genau einem** Platz. Aber Themen halten sich nicht an +Ordnergrenzen. Nadias Seite über Mascha Kaléko steht unter Literatur — +sie handelt aber genauso von Berlin, und Berlin taucht auch in der Musik +wieder auf. Für solche Querbezüge gibt es **Labels**. + +## Was ein Label ist + +Ein Label ist ein Schlagwort, das du an Seiten heftest. Der Unterschied +zum Ordner: Eine Seite hat **einen** Platz im Baum, kann aber **viele** +Labels tragen. Ordner beantworten „Wo liegt das?", Labels beantworten +„Wovon handelt das noch?". + +## Labels vergeben + +Öffne eine Seite und klick in der Kopfleiste auf das **Label-Symbol**. +Du siehst die vorhandenen Labels des Teichs, wählst passende aus — oder +legst direkt ein neues an. + +## Wie das bei Nadia aussieht + +Nadia benutzt sechs Labels, und keines davon hält sich an ihre vier +Bäume: **Berlin**, **Klassiker**, **Empfehlung**, **Draußen**, +**English** und **Poesie**. Ihr Label „Berlin" zum Beispiel verbindet + +- [DOTA](https://dorfteich.online/public/nadia-morgenstern/dota) und + [Element of Crime](https://dorfteich.online/public/nadia-morgenstern/element-of-crime) + aus der Musik mit +- [Mascha Kaléko](https://dorfteich.online/public/nadia-morgenstern/mascha-kaleko) + aus der Literatur. + +Und „Draußen" sammelt Sport-Seiten wie +[Rennrad](https://dorfteich.online/public/nadia-morgenstern/rennrad) und +[Trailrunning](https://dorfteich.online/public/nadia-morgenstern/trailrunning) +zusammen mit +[Musik unterwegs](https://dorfteich.online/public/nadia-morgenstern/musik-unterwegs) +— Seiten, die im Baum nichts miteinander zu tun haben. + +## Labels in der Seitenleiste + +Labels sind mehr als Deko, du kannst mit ihnen arbeiten: + +- **Filtern:** Über der Seitenliste sitzt **Nach Label filtern** — die + Liste zeigt dann nur noch Seiten mit dem gewählten Label. +- **Umschalten:** Die Seitenleiste hat zwei Ansichten, **Ordner** und + **Labels**. In der Label-Ansicht gruppiert sich die Seitenliste unter + den Labels statt unter dem Baum (Seiten mit mehreren Labels erscheinen + mehrfach, Seiten ohne Label sammeln sich unter „Ohne Label"). Der + Umschalter gilt nur für dich. + +_[Screenshot folgt: dieselbe Seitenleiste in Ordner- und Label-Ansicht +nebeneinander]_ + +Und noch ein Versprechen wird eingelöst: **Die Farben im Wissensgraphen +aus Kapitel 6 sind Label-Farben.** Öffne Nadias Graph noch einmal — die +Punkte tragen die Farbe ihres ersten Labels, und die Legende schlüsselt +sie auf. Ordnung, die man sehen kann. + +## Probier es aus + +Erfinde zwei Labels für deinen Teich und vergib sie quer über deine +Seiten — mindestens ein Label sollte auf Seiten aus verschiedenen Ästen +deines Baums landen. Schalte dann die Seitenleiste auf die +Label-Ansicht und wieder zurück. + +--- + +Weiter: [Kapitel 9 — Favoriten und Suche](09-favoriten-und-suche.md) · +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/09-favoriten-und-suche.md b/docs/de/tutorial/09-favoriten-und-suche.md new file mode 100644 index 0000000..1ca4d97 --- /dev/null +++ b/docs/de/tutorial/09-favoriten-und-suche.md @@ -0,0 +1,53 @@ +# Favoriten und Suche + +Je mehr sich in deinem Teich ansammelt, desto wichtiger werden zwei +Handgriffe: das Wichtige markieren und alles andere wiederfinden. + +## Der goldene Stern + +In der Kopfleiste jeder Seite sitzt ein **Stern**. Ein Klick, und die +Seite ist dein **Favorit**: Der Stern füllt sich golden, und auch das +Symbol der Seite in der Seitenleiste leuchtet ab jetzt golden — du +siehst deine wichtigen Seiten also schon im Baum. + +Das Schöne daran: **Favoriten sind persönlich.** Deine Sterne gehören +nur dir. Selbst wenn du später einen Teich mit anderen teilst, sieht +niemand, was du dir markiert hast — und die Sterne der anderen stören +dich nicht. + +Neben der Ansichts-Umschaltung der Seitenleiste findest du den Knopf +**Favoriten**: Er filtert die Seitenliste auf deine markierten Seiten. +So wird aus hundert Seiten wieder eine Handvoll. + +_[Screenshot folgt: gefüllter Stern in der Kopfleiste + goldene +Seiten-Symbole im Baum]_ + +## Die Suche + +Das Suchfeld in der Kopfleiste (oder einfach die Taste `/`) durchsucht +den **Volltext** aller Seiten, die du lesen darfst — auf Wunsch über +alle deine Teiche hinweg („Dieser Teich" / „Alle meine Teiche"). + +Die Suche ist bewusst gutmütig: + +- **Umlaute egal:** „Baume" findet „Bäume", „kaleko" findet „Kaléko". +- **Teilwörter zählen:** „rad" findet auch „Radsport" und „Rennrad". +- **Letzte Suchen** werden gemerkt, damit du gestern Gesuchtes heute + mit einem Klick wiederholst. + +Probier es in Nadias Teich: Eine Suche nach „Kaléko" bringt Treffer aus +der **Musik** (das Album der Band DOTA) und aus der **Literatur** (die +Dichterin selbst) — die Suche kümmert sich nicht um Baumgrenzen, genau +wie die Labels. + +## Probier es aus + +Markiere zwei deiner Seiten mit dem Stern und filtere die Seitenleiste +mit dem **Favoriten**-Knopf. Such danach über das Suchfeld nach einem +Wort, das in deiner ersten Seite vorkommt — einmal mit und einmal ohne +Umlaut, wenn sich eines anbietet. + +--- + +Weiter: [Kapitel 10 — Versionen: die Zeitmaschine](10-versionen.md) · +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/10-versionen.md b/docs/de/tutorial/10-versionen.md new file mode 100644 index 0000000..f401598 --- /dev/null +++ b/docs/de/tutorial/10-versionen.md @@ -0,0 +1,58 @@ +# Versionen: die Zeitmaschine + +In Kapitel 3 hast du gelernt: Dorfteich speichert jeden Tastendruck, es +gibt nichts zu verlieren. Aber was, wenn du etwas **bewusst loswerden** +willst — einen ganzen Absatz umschreibst und es hinterher bereust? +Dafür hat jede Seite eine eingebaute Zeitmaschine: den +**Versionsverlauf**. + +## Automatisch im Hintergrund + +Während du schreibst, legt Dorfteich von selbst in regelmäßigen +Abständen Schnappschüsse deiner Seite an. Du musst dafür nichts tun. +Öffne das **Verlauf-Symbol** in der Kopfleiste einer Seite: Dort liegt +die Liste aller Versionen — jede mit Zeitpunkt und den Personen, die +mitgeschrieben haben. + +## Bewusste Zwischenstände + +Vor einem größeren Umbau lohnt es sich, einen Zwischenstand mit Namen +festzuhalten. Stell dir vor, Nadia will ihre +[Rennrad](https://dorfteich.online/public/nadia-morgenstern/rennrad)-Seite +radikal straffen. Vorher klickt sie im Bearbeitungsmodus auf das +**Speichern-Symbol** (**Version speichern**) und nennt den Stand „vor +der Kürzung". Dann kürzt sie beherzt — und weiß dabei: Der alte Text +ist keine Erinnerung, sondern ein Klick. + +Für Tastatur-Freunde: `Strg/Cmd+S` speichert eine unbenannte Version, +`Strg/Cmd+Shift+S` fragt nach einem Namen. Ein kurzer **Toast** unten +im Bild bestätigt jedes Speichern („Version ‚vor der Kürzung' +gespeichert"). + +## Ansehen, vergleichen, zurückholen + +Im **Versionsverlauf** kannst du jede Version in einer **Vorschau** +ansehen und dir die **Änderungen von dieser Version bis heute** zeigen +lassen — was dazukam, was verschwand. Und wenn der alte Stand doch der +bessere war: **Diese Version wiederherstellen.** + +Das Wichtigste dabei: **Wiederherstellen löscht nie den Verlauf.** Die +Wiederherstellung wird selbst nur ein weiterer Eintrag in der Liste. Du +kannst also auch das Wiederherstellen rückgängig machen. Es gibt in +diesem System keinen Weg, sich wirklich in die Sackgasse zu manövrieren +— und genau deshalb darfst du beim Schreiben mutig sein. + +_[Screenshot folgt: der Versionsverlauf mit benannter Version und +Wiederherstellen-Knopf]_ + +## Probier es aus + +Öffne eine deiner Seiten im Bearbeitungsmodus und speichere eine +benannte Version („mein erster Zwischenstand"). Ändere dann kräftig +etwas — lösch ruhig einen ganzen Absatz. Öffne den Verlauf, schau dir +die Änderungen an und stell deinen Zwischenstand wieder her. + +--- + +Weiter: [Kapitel 11 — Der Papierkorb](11-papierkorb.md) · +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/11-papierkorb.md b/docs/de/tutorial/11-papierkorb.md new file mode 100644 index 0000000..e9b0a9c --- /dev/null +++ b/docs/de/tutorial/11-papierkorb.md @@ -0,0 +1,59 @@ +# Der Papierkorb + +Manche Seiten überleben sich. Der Entwurf, aus dem nichts wurde; die +Liste, die längst woanders steht. Löschen gehört zum Aufräumen — und +damit du dabei nie etwas bereuen musst, löscht Dorfteich grundsätzlich +**mit Netz**: Erst kommt der Papierkorb, dann erst das Vergessen. + +## Eine Seite löschen + +Öffne die Seite und wähle im **…**-Menü **In den Papierkorb +verschieben**. Die Seite verschwindet aus der Seitenleiste und aus der +Suche — aber sie ist nicht weg, sie liegt im **Papierkorb** des Teichs +(der Link dazu sitzt ganz unten in der Seitenleiste). + +Hat die Seite **Unterseiten**, fragt Dorfteich nach, was mit ihnen +passieren soll: + +- **Nur diese Seite löschen** — die Unterseiten rücken eine Ebene hoch + und bleiben erhalten. Das ist die sanfte Variante. +- **Seite samt allen Unterseiten löschen** — der ganze Ast wandert + gemeinsam in den Papierkorb. + +## Wiederherstellen + +Im Papierkorb hat jede Seite einen **Wiederherstellen**-Knopf. Die +Seite kehrt an ihren alten Platz im Baum zurück (falls es den +Elternknoten nicht mehr gibt, an die nächsthöhere noch vorhandene +Stelle) — und sogar dein Favoriten-Stern ist noch dran. + +Zum Aufräumen in größerem Stil gibt es **Checkboxen**: Wähle mehrere +Seiten aus (oder **Alle auswählen**) und stelle sie gesammelt wieder +her — oder lösche sie gesammelt endgültig. + +_[Screenshot folgt: der Papierkorb mit ausgewählten Seiten und den +Sammel-Knöpfen]_ + +## Endgültig löschen + +**Endgültig löschen** heißt, was es sagt: Danach ist die Seite wirklich +weg, mitsamt Verlauf. Deshalb fragt Dorfteich vorher noch einmal nach. +Und auch wer nichts tut, muss nicht ewig aufräumen: Nach einer +Aufbewahrungsfrist leert sich der Papierkorb von selbst. + +Ein Szenario aus Nadias Alltag: Sie löscht einen verwaisten +Konzert-Entwurf, merkt eine Woche später, dass eine gute Formulierung +darin steckte — Papierkorb auf, wiederherstellen, Formulierung +retten, Seite wieder löschen. Genau dafür ist das Netz da. + +## Probier es aus + +Leg eine Wegwerf-Seite an („Testseite"), lösch sie über das +**…**-Menü, öffne den Papierkorb und stell sie wieder her. Wenn du +magst: Lösch sie danach endgültig — einmal das ganze Ritual von vorn +bis hinten. + +--- + +Weiter: [Kapitel 12 — Auf dem Laufenden bleiben](12-auf-dem-laufenden.md) +· [Zum Überblick](README.md) diff --git a/docs/de/tutorial/12-auf-dem-laufenden.md b/docs/de/tutorial/12-auf-dem-laufenden.md new file mode 100644 index 0000000..13f5fe7 --- /dev/null +++ b/docs/de/tutorial/12-auf-dem-laufenden.md @@ -0,0 +1,54 @@ +# Auf dem Laufenden bleiben + +Bisher warst du allein in deinem Teich — da weißt du selbst am besten, +was sich geändert hat. Aber spätestens ab dem nächsten Kapitel, wenn +mehrere Menschen in einem Teich schreiben, willst du es mitbekommen, +ohne jeden Tag alle Seiten abzuklappern. Dafür gibt es das +**Beobachten**. + +## Seiten und Teiche beobachten + +- **Eine Seite beobachten:** Klick auf **Beobachten** (die Glocke in + der Kopfleiste der Seite). Ab jetzt wirst du benachrichtigt, wenn + jemand die Seite ändert oder kommentiert. Der Knopf zeigt danach + **Beobachtet**. +- **Einen ganzen Teich beobachten:** Die Glocke im Kopf der + Teich-Einstellungen tut dasselbe für alle Seiten des Teichs. + +Zwei Dinge beobachtest du übrigens automatisch, ohne etwas zu tun: +Seiten, die du **selbst anlegst**, und Seiten, die du **kommentierst**. +(Beides lässt sich unter **Einstellungen → Profil** abschalten.) + +## Die Glocke: dein Posteingang + +Oben in der Kopfleiste wohnt die **Glocke** — dein +Benachrichtigungs-Posteingang. Ein kleiner Zähler zeigt Ungelesenes; +jeder Eintrag führt mit einem Klick direkt zur Änderung oder zum +Kommentar. Mit **Alle als gelesen markieren** räumst du auf. + +_[Screenshot folgt: geöffneter Benachrichtigungs-Posteingang mit +Einträgen]_ + +## E-Mail-Zusammenfassungen + +Wer nicht ständig im Browser lebt, lässt sich die Neuigkeiten schicken: +Unter den Einstellungen wählst du beim **E-Mail-Digest** zwischen +**stündlicher** oder **täglicher Zusammenfassung** — oder **keinen +Digest-Mails**. Die Mail bündelt alles Ungelesene; abbestellen geht +direkt aus jeder Mail heraus. + +So findest du dein Maß: Wer mitten im Geschehen ist, braucht vielleicht +gar keine Mails (die Glocke reicht). Wer nur ab und zu vorbeischaut, +fährt mit der täglichen Zusammenfassung gut. + +## Probier es aus + +Das lässt sich wunderbar allein testen: **Beobachte** eine deiner +Seiten, öffne dieselbe Seite in einem zweiten Browser-Tab und ändere +dort etwas. Zurück im ersten Tab meldet sich die Glocke. Wirf danach +einen Blick in die Digest-Einstellung und wähle, was zu dir passt. + +--- + +Weiter: [Kapitel 13 — Gemeinsame Teiche](13-gemeinsame-teiche.md) · +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/13-gemeinsame-teiche.md b/docs/de/tutorial/13-gemeinsame-teiche.md new file mode 100644 index 0000000..46faff3 --- /dev/null +++ b/docs/de/tutorial/13-gemeinsame-teiche.md @@ -0,0 +1,61 @@ +# Gemeinsame Teiche + +Bis hierher war dein Teich ein privater Ort. Jetzt kommt der Schritt, +für den Dorfteich eigentlich gebaut ist: **gemeinsam schreiben** — mit +der Familie am Urlaubsplan, mit dem Verein am Vereinswissen, mit +Kolleginnen an der Projektdoku. + +## Einen gemeinsamen Teich anlegen + +Dein persönlicher Teich bleibt immer deiner. Für Gemeinsames legst du +einen **neuen Teich** an: Öffne den **Teich-Umschalter** in der +Kopfleiste und wähle ganz unten **+ Neuer Teich**. Name, optional eine +Beschreibung — **Teich anlegen**, fertig. Mit dem Umschalter springst +du ab jetzt zwischen deinen Teichen hin und her. + +## Mitglieder einladen — und die drei Rollen + +In den **Teich-Einstellungen** unter **Mitglieder** holst du andere +dazu. Für jedes Mitglied wählst du eine Rolle, und die drei Rollen sind +schnell erklärt: + +- **Leser** — darf alles lesen, nichts ändern. +- **Bearbeiter** — darf lesen und schreiben. +- **Admin** — darf zusätzlich verwalten: Mitglieder, Einstellungen, + Labels. + +Für den Anfang reicht diese Faustregel völlig. (Wer es später feiner +braucht — etwa einzelne Bereiche nur für bestimmte Personen —, findet +im Teich unter **Zugriffsregeln** ein mächtigeres Werkzeug; das +[Teich-Admin-Handbuch](../manual/pond-admin-guide.md) erklärt es.) + +## Gleichzeitig schreiben — ohne Angst + +Und jetzt das Beste: Öffnen zwei Personen dieselbe Seite, sehen sie +sich **gegenseitig tippen** — jede mit einem benannten Cursor in ihrer +Farbe, die Anwesenden erscheinen oben in der Kopfleiste. Es gibt kein +„Datei ist gesperrt", kein „Konflikt bitte auflösen", kein Überschreiben. + +_[Screenshot folgt: zwei benannte Cursor gleichzeitig auf einer Seite]_ + +Das gilt sogar **offline**: Schreibst du im Zug ohne Empfang weiter, +fließen deine Änderungen beim nächsten Kontakt sauber mit denen der +anderen zusammen. Das kleine Status-Symbol unten links zeigt dir, ob du +gerade verbunden bist. + +Zusammen mit Kapitel 10 ergibt das ein beruhigendes Gesamtbild: Alle +schreiben gleichzeitig, nichts geht verloren, und der Versionsverlauf +hält fest, wer was beigetragen hat. + +## Probier es aus + +Leg einen gemeinsamen Teich an und lade jemanden ein — Partnerin, +Freund, Kollegin (als **Bearbeiter**). Öffnet dieselbe Seite auf zwei +Geräten und schreibt gleichzeitig ein paar Sätze. Der Moment, in dem +der fremde Cursor zum ersten Mal über die eigene Seite wandert, +verkauft das Feature besser als jedes Handbuch. + +--- + +Weiter: [Kapitel 14 — Kommentare](14-kommentare.md) · +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/14-kommentare.md b/docs/de/tutorial/14-kommentare.md new file mode 100644 index 0000000..782d7ba --- /dev/null +++ b/docs/de/tutorial/14-kommentare.md @@ -0,0 +1,55 @@ +# Kommentare + +Gemeinsames Schreiben braucht neben dem Text noch eine zweite Ebene: +das **Reden über den Text**. Nicht jede Anmerkung gehört in die Seite +selbst — „Sollte das nicht woandershin?" ist eine Frage an die anderen, +keine Änderung. Genau dafür gibt es Kommentare. + +## Kommentieren statt hineinschreiben + +Das **Sprechblasen-Symbol** in der Kopfleiste öffnet das +Kommentar-Panel der Seite. Schreib deine Anmerkung („Kommentar +schreiben…" → **Kommentieren**) — sie erscheint neben dem Text, nicht +darin. + +Ein Beispiel aus dem gemeinsamen Teich, den du in Kapitel 13 angelegt +hast: Jemand findet, die Trainingsplan-Seite gehöre eher unter „Sport" +als unter „Allgemeines". Falsch wäre, sie einfach stillschweigend zu +verschieben. Besser: ein Kommentar — „Sollte die nicht unter Sport? +Dann finden sie die Läufer schneller." Die anderen sehen die Frage, +antworten, und **dann** wird verschoben. + +## Antworten und erledigen + +- Auf jeden Kommentar kann man **antworten** — so entsteht ein kleiner + Gesprächsfaden direkt an der Seite. +- Ist eine Frage geklärt, klickt jemand **Erledigen**: Der Faden klappt + zusammen und wandert in die Rubrik „Erledigt". Nichts wird gelöscht — + wer später wissen will, warum die Seite verschoben wurde, kann es + nachlesen. (Und **Wieder öffnen** geht auch.) +- Eigene Kommentare kannst du nachträglich bearbeiten oder löschen. + +Die Sprechblase in der Kopfleiste zeigt übrigens einen Zähler für +ungelesene Kommentare — und weil du Seiten, die du kommentierst, +automatisch beobachtest (Kapitel 12), verpasst du Antworten nicht. + +_[Screenshot folgt: Kommentar-Panel mit einem Faden und +Erledigen-Knopf]_ + +## Wer darf kommentieren? + +Das entscheidet der Teich-Admin in den Teich-Einstellungen: **Alle mit +Lesezugriff** oder **nur Bearbeitende**. In deinem eigenen Teich bist +du der Admin — dir steht das Panel immer offen. + +## Probier es aus + +Schreib im gemeinsamen Teich aus Kapitel 13 einen Kommentar unter eine +Seite der anderen Person — am besten eine echte Frage. Lass sie +antworten und markiere den Faden danach als **erledigt**. Schau dir an, +wie die Benachrichtigung dazu bei euch beiden ankommt. + +--- + +Weiter: [Kapitel 15 — Seiten für alle veröffentlichen](15-veroeffentlichen.md) +· [Zum Überblick](README.md) diff --git a/docs/de/tutorial/15-veroeffentlichen.md b/docs/de/tutorial/15-veroeffentlichen.md new file mode 100644 index 0000000..9b5da32 --- /dev/null +++ b/docs/de/tutorial/15-veroeffentlichen.md @@ -0,0 +1,59 @@ +# Seiten für alle veröffentlichen + +Zeit für einen Kreisschluss. Das ganze Tutorial über hast du Nadias +Teich gelesen — **ohne Konto, ohne Anmeldung**, einfach über einen +Link. Diese Ansicht war kein Sonderfall für Handbücher: Das ist die +**öffentliche Freigabe**, und in diesem Kapitel lernst du, wie du sie +selbst benutzt. + +## Was Besucher sehen + +Eine öffentlich freigegebene Seite ist unter einer einfachen Adresse +erreichbar: `/public//` — bei Nadia zum Beispiel +`dorfteich.online/public/nadia-morgenstern/musik`. Besucher bekommen: + +- die Seite im **Lesemodus**, hübsch gesetzt in der Schrift des Teichs, +- **klickbare Wikilinks** — das Netz funktioniert auch für Gäste, sie + können sich genau wie du von Seite zu Seite treiben lassen, +- einen Hinweis **„Öffentliche Seite · nur Lesen"** und einen Link auf + die Rechtsseiten der Instanz (Impressum, Datenschutzerklärung). + +Und was Besucher **nicht** bekommen: keinen Stift, keine Kommentare, +keinen Papierkorb, keinen Verlauf. Lesen, nicht anfassen. + +## So gibst du etwas frei + +Die Freigabe ist eine **Zugriffsregel** des Teichs (Teich-Einstellungen +→ **Zugriffsregeln**): Du erlaubst „**Alle (öffentlich)**" das Lesen — +wahlweise für den ganzen Teich, nur für ein Label oder nur für einzelne +Seiten. In deinem persönlichen Teich entscheidest das du; in +gemeinsamen Teichen die Admins. + +Dorfteich nimmt diesen Schritt ernst und fragt mit deutlichen Worten +nach: **Damit werden Inhalte für alle im Internet sichtbar.** Das ist +keine Bürokratie — öffentlich heißt wirklich öffentlich, auch für +Suchmaschinen. Die gute Nachricht: Es gilt **nur, was du freigibst**. +Alles andere bleibt so privat wie vorher, und du kannst die Regel +jederzeit wieder entfernen. + +_[Screenshot folgt: der Zugriffsregeln-Dialog mit der +Öffentlich-Warnung]_ + +## Wie das bei Nadia aussieht + +Nadia hat ihren ganzen Teich zum Lesen freigegeben — deshalb konntest +du seit Kapitel 1 darin stöbern. Ihre Adresse gibt sie einfach weiter: +Wer den Link hat, kann lesen; ändern kann nur sie. + +## Probier es aus + +Gib etwas aus deinem Teich öffentlich frei — den ganzen Teich oder erst +mal eine einzelne Seite. Öffne dann die `/public/`-Adresse in einem +**privaten Browserfenster** (dort bist du nicht angemeldet): So siehst +du deine Seite exakt mit den Augen eines Besuchers. Danach darfst du +die Regel gern wieder löschen — nichts daran ist endgültig. + +--- + +Weiter: [Kapitel 16 — Dokumente importieren](16-importieren.md) · +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/16-importieren.md b/docs/de/tutorial/16-importieren.md new file mode 100644 index 0000000..34a3c2c --- /dev/null +++ b/docs/de/tutorial/16-importieren.md @@ -0,0 +1,51 @@ +# Dokumente importieren + +Dein Wissen fängt selten bei null an. Irgendwo liegen Word-Dateien, +Notizen, halbe Sammlungen aus anderen Programmen. Die musst du nicht +abtippen: Dorfteich holt sie als Seiten herein. + +## Eine Datei wird eine Seite + +Unten in der Seitenleiste findest du **Dokument importieren**. Drei +Formate versteht der Import: **Word (.docx), OpenDocument (.odt) oder +Markdown (.md)**. + +1. Datei auswählen (oder ins Fenster ziehen). +2. Dorfteich lädt hoch und wandelt um — du siehst den Fortschritt + („Wird hochgeladen…", „Wird konvertiert…", „Importiert"). +3. Fertig: Aus dem Dokument ist eine neue Seite geworden. Der + Seitentitel kommt aus der ersten Überschrift des Dokuments, und + **eingebettete Bilder kommen mit**. + +Danach ist die Seite eine ganz normale Dorfteich-Seite: Du kannst sie +in den Baum einsortieren (Kapitel 7), verschlagworten (Kapitel 8) und +mit Wikilinks ins Netz einweben (Kapitel 5). + +_[Screenshot folgt: der Import-Dialog mit Fortschrittsanzeige]_ + +Ein Szenario aus Nadias Teich: Ihre alten Konzert-Notizen lebten als +Word-Datei auf der Festplatte. Ein Import später stehen sie als Seite +unter +[Konzerte & Live](https://dorfteich.online/public/nadia-morgenstern/konzerte-live) +— und sind zum ersten Mal mit dem Rest ihrer Musikwelt verlinkbar. + +## Für Umsteiger: ganze Sammlungen + +Wer aus dem Notiz-Programm **Obsidian** kommt, muss nicht Datei für +Datei importieren: Ein Teich-Admin kann in den Teich-Einstellungen +einen kompletten **Obsidian-Vault** (als ZIP) auf einmal hereinholen — +Ordnerstruktur wird zum Seitenbaum, Schlagworte werden zu Labels, die +internen Links bleiben heil. Die Einzelheiten stehen im +[Teich-Admin-Handbuch](../manual/pond-admin-guide.md). + +## Probier es aus + +Nimm ein eigenes Dokument — ein Rezept, ein Protokoll, irgendeine +`.docx` oder `.md`, die zu deinem Teich passt — und importiere es. +Räum die neue Seite anschließend an ihren Platz im Baum und setz einen +Wikilink von einer bestehenden Seite darauf. + +--- + +Weiter: [Kapitel 17 — Exportieren und Mitnehmen](17-exportieren.md) · +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/17-exportieren.md b/docs/de/tutorial/17-exportieren.md new file mode 100644 index 0000000..e820d9d --- /dev/null +++ b/docs/de/tutorial/17-exportieren.md @@ -0,0 +1,56 @@ +# Exportieren und Mitnehmen + +Der Import hat eine Schwester, und sie ist mindestens so wichtig: der +**Export**. Denn ein Ort, in den man viel hineinsteckt, muss eine +ehrliche Antwort auf die Frage haben: „Und wie bekomme ich das wieder +heraus?" Bei Dorfteich lautet sie: **jederzeit, vollständig, in +offenen Formaten.** + +## Eine Seite mitnehmen + +Im **…**-Menü jeder Seite findest du: + +- **Als Markdown kopieren / herunterladen** — der Text als schlichte, + überall lesbare Textdatei. +- **Word (.docx)** und **OpenDocument (.odt)** — zum Weiterbearbeiten + in der Textverarbeitung. +- **PDF** — zum Drucken, Weitergeben, Archivieren. + +Nadia zum Beispiel zieht sich ihre +[Radsport-Bücher](https://dorfteich.online/public/nadia-morgenstern/radsport-buecher) +als PDF aufs Tablet, bevor sie in den Urlaub fährt — Lesestoff-Liste +ohne Internet. + +## Einen ganzen Teich mitnehmen + +In den Teich-Einstellungen gibt es **Teich als ZIP herunterladen**: ein +Archiv mit allen Seiten (als Markdown) samt Bildern und Anhängen. Gut +als persönliche Sicherung — und gut als Beweis, dass deine Sammlung dir +gehört und nicht dem Programm. + +## Deine Daten, komplett + +Unter **Einstellungen → Meine Daten exportieren** bekommst du ein ZIP +mit deinen Profildaten und dem vollständigen Inhalt deiner eigenen +Teiche. Das ist dein Datenauszug im Sinne der DSGVO — kein Antrag, +kein Warten, ein Knopf. + +Auch das Aufhören ist geregelt: Ein Konto kann **gelöscht** werden — +wende dich dafür an den Betreiber deiner Instanz. Deine persönlichen +Daten verschwinden dabei; was du in gemeinsamen Teichen beigetragen +hast, bleibt für die anderen erhalten, trägt aber nicht mehr deinen +Namen. + +_[Screenshot folgt: das …-Menü mit den Export-Formaten]_ + +## Probier es aus + +Exportiere eine deiner Seiten einmal als **PDF** und einmal als +**Markdown** und öffne beide. Lade danach in den Teich-Einstellungen +das **ZIP deines Teichs** herunter und wirf einen Blick hinein — es ist +ein gutes Gefühl zu wissen, wie die eigene Sammlung von außen aussieht. + +--- + +Weiter: [Kapitel 18 — Bausteine für besondere Inhalte](18-bausteine.md) +· [Zum Überblick](README.md) diff --git a/docs/de/tutorial/18-bausteine.md b/docs/de/tutorial/18-bausteine.md new file mode 100644 index 0000000..9161d30 --- /dev/null +++ b/docs/de/tutorial/18-bausteine.md @@ -0,0 +1,56 @@ +# Bausteine für besondere Inhalte + +Text, Bilder, Tabellen — damit kommt man weit. Aber manche Inhalte +wollen mehr können als stillhalten: ein Diagramm, das aus einer +Beschreibung entsteht; ein Inhaltsverzeichnis, das sich selbst aktuell +hält. Dafür hat Dorfteich **Bausteine** (technisch heißen sie Plugins). + +## Was ein Baustein ist + +Ein Baustein ist ein **besonderer Block in einer Seite**. Er steht +zwischen deinen Absätzen wie ein Bild — aber er hat Fähigkeiten: Er +kann etwas zeichnen, zusammenstellen oder hervorheben. Du musst dafür +nichts installieren und nichts können; wenn ein Baustein im Teich +verfügbar ist, benutzt du ihn einfach. + +## Einen Baustein einfügen + +Im Bearbeitungsmodus findest du in der Werkzeugleiste den Punkt +**Block einfügen …** — dahinter verbirgt sich die Liste der Bausteine, +die in deinem Teich bereitstehen. Einen auswählen, und der Block +erscheint an der Cursor-Position. Im Lesemodus zeigt er dann sein +Ergebnis: das fertige Diagramm, das Verzeichnis, den Kasten. + +_[Screenshot folgt: das „Block einfügen"-Menü in der Werkzeugleiste]_ + +## Wer schaltet Bausteine frei? + +Welche Bausteine es in einem Teich gibt, entscheidet der +**Teich-Admin**: In den Teich-Einstellungen unter **Plugins** lassen +sich die vom Betreiber installierten Bausteine je Teich aktivieren. In +deinem persönlichen Teich bist du selbst der Admin — wirf ruhig einen +Blick in die Sektion. + +Und falls du dich fragst, ob so ein Baustein Unfug anstellen kann: +Bausteine laufen in Dorfteich **abgeschottet** in einem eigenen +Bereich. Sie sehen nur, was ihnen die Seite gibt, und können weder an +deinen anderen Seiten noch an deinem Konto etwas ändern. + +## Ein Blick voraus + +Dorfteich bringt fünf Standard-Bausteine mit — vom Diagramm-Zeichner +bis zum automatischen Inhaltsverzeichnis. Die stellen wir im nächsten +Kapitel einzeln vor, und du wirst sie dort auch in Nadias Teich im +Einsatz sehen. + +## Probier es aus + +Öffne eine Seite im Bearbeitungsmodus und klapp **Block einfügen …** +in der Werkzeugleiste auf. Nur schauen, noch nichts einfügen: Welche +Bausteine stehen in deinem Teich bereit? Im nächsten Kapitel erfährst +du, was jeder davon kann. + +--- + +Weiter: [Kapitel 19 — Die Standard-Bausteine im Schaufenster](19-standard-bausteine.md) +· [Zum Überblick](README.md) diff --git a/docs/de/tutorial/19-standard-bausteine.md b/docs/de/tutorial/19-standard-bausteine.md new file mode 100644 index 0000000..4438cfe --- /dev/null +++ b/docs/de/tutorial/19-standard-bausteine.md @@ -0,0 +1,67 @@ +# Die Standard-Bausteine im Schaufenster + +Dorfteich bringt fünf Bausteine mit. Dieses Kapitel ist ein +Schaufensterbummel: je ein Blick, wofür jeder gut ist — ohne +Bedienungsanleitung. (Die Diagramm-Bausteine haben eigene kleine +Welten; hier geht es nur darum, dass du weißt, was es gibt.) + +## Mermaid-Diagramm — Diagramme aus Text + +Du beschreibst in Textform, was zusammenhängt („A führt zu B, B führt +zu C") — der Baustein zeichnet daraus ein sauberes Diagramm: +Ablaufpläne, Zeitleisten, Organigramme. Ideal, wenn das Diagramm mit +dem Inhalt mitwachsen soll: Text ändern, Zeichnung folgt. + +In Nadias Teich zeichnet ein Mermaid-Baustein den Wochenplan auf ihrer +Seite +[Marathon-Training](https://dorfteich.online/public/nadia-morgenstern/marathon-training). + +_[Screenshot folgt: das Trainingsplan-Diagramm auf Nadias Seite]_ + +## draw.io-Diagramm — frei zeichnen + +Das Gegenstück für alle, die lieber **zeichnen statt beschreiben**: Ein +vollwertiges Zeichenprogramm öffnet sich im Vollbild — Kästen, Pfeile, +Formen, alles frei platzierbar. Gut für Skizzen, Lagepläne, +Schaubilder. Beim Schließen landet die Zeichnung als Bild in der Seite; +zum Weiterzeichnen öffnest du sie einfach wieder. + +Nadia hat damit die Route ihrer liebsten Schotterrunde auf der Seite +[Gravel](https://dorfteich.online/public/nadia-morgenstern/gravel) +skizziert. + +## Inhaltsverzeichnis — lange Seiten gliedern + +Der unscheinbarste und vielleicht nützlichste: Der Baustein liest die +**Überschriften deiner Seite** und baut daraus ein klickbares +Inhaltsverzeichnis. Schreibst du einen neuen Abschnitt, taucht er von +selbst darin auf. Nie wieder von Hand pflegen. + +## Seitenindex — Unterseiten auflisten + +Dieser Baustein listet die **Unterseiten** der aktuellen Seite +automatisch auf. Perfekt für Übersichts-Seiten wie Nadias +[Musik](https://dorfteich.online/public/nadia-morgenstern/musik): Kommt +ein neuer Ordner dazu, steht er in der Übersicht — ohne dass jemand +daran denken muss. + +## Hervorhebungen — Kästen mit Charakter + +Eine kleine Familie von Schmuck-Blöcken: **Info-Kasten**, **Warnung**, +**Hervorhebung**, **Farbige Box**. Damit hebst du das Wichtige vom +Beiläufigen ab — der Hinweis, der nicht überlesen werden soll, bekommt +einen farbigen Rahmen. + +## Probier es aus + +Such dir **einen** Baustein aus diesem Schaufenster aus — für den +Anfang empfehlen sich das **Inhaltsverzeichnis** (auf deiner längsten +Seite) oder ein **Info-Kasten** — und setz ihn über **Block +einfügen …** auf eine deiner Seiten. Mehr als einen brauchst du heute +nicht; die anderen laufen dir wieder über den Weg, wenn du sie +brauchst. + +--- + +Weiter: [Kapitel 20 — Dein Profil und deine Einstellungen](20-profil-einstellungen.md) +· [Zum Überblick](README.md) diff --git a/docs/de/tutorial/20-profil-einstellungen.md b/docs/de/tutorial/20-profil-einstellungen.md new file mode 100644 index 0000000..d15568e --- /dev/null +++ b/docs/de/tutorial/20-profil-einstellungen.md @@ -0,0 +1,60 @@ +# Dein Profil und deine Einstellungen + +Zum Schluss der Rundgang durch dein eigenes Konto. Alles Folgende wohnt +an einem Ort: oben rechts auf deinen Namen klicken → +**Einstellungen**. + +## Profil + +Unter **Profil** stellst du ein, wie du auftrittst und wie Dorfteich +sich dir gegenüber verhält: + +- **Anzeigename** — so heißt du für andere, etwa am Cursor beim + gemeinsamen Schreiben. +- **Sprache** — Deutsch oder English, wirkt sofort auf die ganze + Oberfläche. +- **Beobachten-Voreinstellungen** — ob du Seiten, die du anlegst oder + kommentierst, automatisch beobachtest (Kapitel 12). +- **E-Mail-Digest** — stündliche Zusammenfassung, tägliche oder keine. + +## Sicherheit + +- **Passwort ändern** — regelmäßig kein Muss, aber gut zu wissen, wo. +- **Aktive Sitzungen** — die Liste aller Geräte, auf denen du + angemeldet bist. Das Handy von neulich, der Rechner im Büro: Jede + Sitzung lässt sich einzeln **abmelden**, oder alle anderen auf einen + Schlag. Wenn dir je ein Gerät abhandenkommt, ist das der Knopf, den + du suchst. + +_[Screenshot folgt: die Einstellungen mit Profil und Aktiven +Sitzungen]_ + +## Deine beobachteten Seiten + +Die Einstellungen zeigen auch die Liste von allem, was du +**beobachtest** — Seiten wie Teiche. Praktisch zum Aufräumen, wenn die +Glocke zu gesprächig geworden ist: Hier bestellst du einzelne +Beobachtungen wieder ab. + +## Für später: API-Tokens und Datenexport + +Zwei Sektionen wirst du als Einsteiger selten brauchen, aber du +solltest wissen, dass es sie gibt: + +- **API-Tokens** — Schlüssel, mit denen Skripte oder KI-Assistenten + (mit deiner Erlaubnis!) auf deine Teiche zugreifen können. Mehr dazu + im letzten Kapitel. +- **Meine Daten exportieren** — dein kompletter Datenauszug als ZIP, + wie in Kapitel 17 beschrieben. + +## Probier es aus + +Öffne deine **Aktiven Sitzungen** und schau, welche Geräte dort +stehen — erkennst du alle wieder? Stell danach die Oberfläche einmal +auf Englisch und zurück, nur damit du den Weg im Ernstfall kennst +(**Settings → Profile → Language**, falls du dich aussperrst). + +--- + +Weiter: [Kapitel 21 — Wie es weitergeht](21-wie-es-weitergeht.md) · +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/21-wie-es-weitergeht.md b/docs/de/tutorial/21-wie-es-weitergeht.md new file mode 100644 index 0000000..0719f71 --- /dev/null +++ b/docs/de/tutorial/21-wie-es-weitergeht.md @@ -0,0 +1,54 @@ +# Wie es weitergeht + +Geschafft — du kennst jetzt alles, was man als Bewohnerin oder Bewohner +eines Dorfteichs im Alltag braucht: Seiten schreiben und gestalten, +verlinken, ordnen, wiederfinden, gemeinsam arbeiten, veröffentlichen, +importieren und exportieren. Ab hier wächst dein Teich von allein — du +musst nur regelmäßig etwas hineinwerfen. + +Für alles, was über den Alltag hinausgeht, zeigen wir dir zum Abschied +die Wegweiser: + +## Zum Nachschlagen + +Das **[Benutzerhandbuch](../manual/user-guide.md)** ist die kompakte +Referenz zu allem, was du in diesem Tutorial gelernt hast — gut, wenn +du später ein Detail sucht („Wie war das mit den Digest-Mails?"), +ohne Kapitel zu blättern. + +## Einen Teich verwalten + +Sobald du einen gemeinsamen Teich betreibst, wirst du Fragen haben, die +dieses Tutorial nur gestreift hat: feine **Zugriffsregeln** (einzelne +Bereiche nur für bestimmte Personen), das **Erscheinungsbild** des +Teichs, der **Obsidian-Import**, Plugins verwalten. All das steht im +**[Teich-Admin-Handbuch](../manual/pond-admin-guide.md)**. + +## Eine eigene Instanz betreiben + +Dorfteich kannst du auf einem eigenen Server laufen lassen — dann +gehört wirklich alles dir, vom Konto bis zum Backup. Die Anleitung +dafür ist das +**[Site-Admin-Handbuch](../manual/site-admin-guide.md)** (auf +Englisch, wie die gesamte Betriebs-Dokumentation). + +## Skripte und KI-Assistenten + +Wenn du magst, können Programme mit deinem Teich arbeiten — mit deiner +ausdrücklichen Erlaubnis über die **API-Tokens** aus Kapitel 20. Die +**[API-Anleitung](../manual/api-guide.md)** beschreibt die +Schnittstelle für Skripte, die +**[MCP-Anleitung](../manual/mcp-guide.md)** zeigt, wie du einen +KI-Assistenten wie Claude mit deinem Teich verbindest — lesen, suchen, +sogar Seiten anlegen, alles im Rahmen deiner Freigaben. + +## Und sonst? + +Fragen, Wünsche, gefundene Fehler: Wende dich an den Betreiber deiner +Instanz. Und wenn dir das Tutorial geholfen hat — der schönste Dank ist +ein gepflegter Teich. Wirf regelmäßig etwas hinein; um die Ringe an der +Oberfläche kümmert sich Dorfteich. + +--- + +[Zum Überblick](README.md) diff --git a/docs/de/tutorial/README.md b/docs/de/tutorial/README.md new file mode 100644 index 0000000..a70c5bc --- /dev/null +++ b/docs/de/tutorial/README.md @@ -0,0 +1,56 @@ +# Dorfteich Schritt für Schritt + +Ein Einsteiger-Tutorial in 21 kurzen Kapiteln — geschrieben für Menschen, +die **keine Technik-Vorkenntnisse** mitbringen. Es führt dich vom ersten +Konto bis zum veröffentlichten Teich, immer ein Feature nach dem anderen. + +Als roten Faden benutzen wir einen echten Teich: **Nadia Morgenstern** +sammelt auf [dorfteich.online](https://dorfteich.online) ihr Wissen über +Musik, Literatur, Sport und Filme. Ihr Teich ist öffentlich — du kannst +jedes Beispiel ohne Konto ansehen, zum Beispiel ihre Seite +[Musik](https://dorfteich.online/public/nadia-morgenstern/musik). Jedes +Kapitel endet mit **„Probier es aus"**: einer kleinen Übung für deinen +eigenen Teich. + +_Hinweis: Dieses Tutorial entsteht zuerst auf Deutsch; eine englische +Übersetzung kann später folgen. Zum Nachschlagen einzelner Funktionen +gibt es außerdem das kompakte [Benutzerhandbuch](../manual/user-guide.md)._ + +## Teil 1 — Willkommen im Dorfteich + +1. [Was ist Dorfteich?](01-was-ist-dorfteich.md) +2. [Dein Konto und dein erster Teich](02-konto-und-teich.md) +3. [Deine erste Seite](03-deine-erste-seite.md) + +## Teil 2 — Schreiben und Verknüpfen + +4. [Text gestalten](04-text-gestalten.md) +5. [Seiten verbinden: Wikilinks](05-wikilinks.md) +6. [Der Wissensgraph](06-wissensgraph.md) + +## Teil 3 — Ordnung halten + +7. [Der Seitenbaum](07-seitenbaum.md) +8. [Labels: Themen quer durch den Teich](08-labels.md) +9. [Favoriten und Suche](09-favoriten-und-suche.md) + +## Teil 4 — Nichts verlieren, nichts verpassen + +10. [Versionen: die Zeitmaschine](10-versionen.md) +11. [Der Papierkorb](11-papierkorb.md) +12. [Auf dem Laufenden bleiben](12-auf-dem-laufenden.md) + +## Teil 5 — Gemeinsam und öffentlich + +13. [Gemeinsame Teiche](13-gemeinsame-teiche.md) +14. [Kommentare](14-kommentare.md) +15. [Seiten für alle veröffentlichen](15-veroeffentlichen.md) + +## Teil 6 — Daten rein, Daten raus, und weiter + +16. [Dokumente importieren](16-importieren.md) +17. [Exportieren und Mitnehmen](17-exportieren.md) +18. [Bausteine für besondere Inhalte](18-bausteine.md) +19. [Die Standard-Bausteine im Schaufenster](19-standard-bausteine.md) +20. [Dein Profil und deine Einstellungen](20-profil-einstellungen.md) +21. [Wie es weitergeht](21-wie-es-weitergeht.md) diff --git a/docs/manual/README.md b/docs/manual/README.md index 99af3e5..ddea1bf 100644 --- a/docs/manual/README.md +++ b/docs/manual/README.md @@ -4,6 +4,11 @@ User-facing documentation, by audience. German translations live in [`docs/de/`](../de/manual/README.md); English is authoritative when the two diverge. +**New to Dorfteich?** There is a step-by-step beginner tutorial, +[Dorfteich Schritt für Schritt](../de/tutorial/README.md) — currently +German-first (unlike the manuals, the German edition is the original; +an English translation may follow). + | Guide | For | | -------------------------------------------- | ------------------------------------ | | [Feature overview](../features.md) | anyone wondering what Dorfteich is |