HowTo Wiki

Ein kleiner Überblick zum Lesen, Schreiben und zurechtfinden in diesem Wiki. Dieses Wiki basiert auf der Software namens Bookstack. Die Sortierung ist angelehnt an der Idee von Büchern.

Wichtige Hinweise

Lizensierte Inhalte: Wenn ihr Seiten im Wiki erstellt, achtet bitte auf das Copyright beim kopieren von Inhalten. Das gilt sowohl für Texte, als auch Bilder, Videos, PDFs und sonstige Anhänge.  Es gilt:

- Es dürfen nur selbsterstellte Inhalte, oder
- fremde Inhalte nur mit freien Linzenzen in diesem Wiki veröffentlicht werden. Bitte gebt in diesem Fall immer auch die Lizenz mit an!
- Bitte gebt bei eigenen Bildern auch immer die Lizenz mit an. Ihr könnt z.B. "Bild: haecksen.org" oder euren eigenen Namen/Nickname in den Bildbeschreibungstext reinschreiben. (Image Options > Image Description)

Du musst nicht den ganzen Text auf dieser Seite durchlesen, aber es wäre schön, wenn du einmal durchscrollen würdest und alle Infoboxen und Warnhinweise beachtest.

Bücher und Regale: Was ist hier was?

 Es gibt Bücherregale ("Shelves"), Bücher ("Books"), optionale Kapitel ("Chapter") und Seiten ("Pages").

Einzelne Seiten ohne Zuordnung gibt es in diesem Wiki nicht, d.h. es ist nicht möglich eine Seite direkt in einem Bücherregal zu erstellen. Seiten stehen immer in Büchern, Bücher stehen auf Regalen.

Im Wiki navigieren und Zurechtfinden

Im Hauptmenü kannst du über Regale/Shelves zu thematisch sortierten Büchern finden, oder durch Klick auf Bücher/Books direkt eine Liste aller Bücher bekommen.

Des Weiteren kannst du im Menü über LightMode und DarkMode die Farbdarstellung wechseln. Im Mobilen Menü findest du die Option auf der Startseite (oben links auf unser Logo klicken), dann unter Info > Actions.

Die Option LightMode/DarkMode ist im Menü leider nur(!) auf der Startseite zu finden, oder wenn du eingeloggt bist und auf dein Profil klickst.

Die wichtigsten Bücherregale

... ohne Anspruch auf Vollständigkeit, da das Wiki ständig wächst und lebt:

Haecksen-Interne Inhalte, wie z.B. Plenumsprotokolle, sind nur sichtbar, wenn du eingeloggt bist!

Wie bekomme ich einen Wiki-Account?

Wenn du einen Haecksen-SSO-Account hast, hast du damit automatisch Zugang zum Wiki. Auf Tools&Accounts steht wie du einen bekommst.

Account-Einstellungen

Die Sprache ist standardmäßig auf Englisch gesetzt. Falls du damit nicht gut zurecht kommst, kannst du die Sprache in deinen Accountsettings anpassen, sowie dein Passwort ändern oder ein Profilbild hochladen. Es gibt keine persönlichen Links oder  Infos auf Profilseiten, d.h. du findest dort nur ein paar Statistikinfos zu der Nutzer*in.

Sprache anpassen: Klicke auf deinen Accountnamen oben rechts, dann "Edit Profile" und unter "Preferred Language" kannst du dann Deutsch oder eine andere Sprache auswählen.

Wie erstelle oder editiere ich Inhalte?

Inhalte können natürlich nur erstellt oder editiert werden, wenn du eingeloggt bist und für den entsprechenden Bereich auch die nötigen Rechte hast. Mehr zu Berechtigungen im Abschnitt Permissions.

Die nachfolgende Beschreibung ist mit Screenshots im DarkMode aufgeommen und mit englischer Spracheinstellung erstellt worden. 

Regale erstellen, bearbeiten, löschen

Neue Regale solltest du nur anlegen, wenn es wirklich nötig ist und deine Inhalte nirgendwo anders hineinpassen. Die Ansicht der Regale ist die wichtigste und sollte möglichst übersichtlich bleiben. Im Zweifelsfall kannst du im #adminfoo oder #Wiki Channel im Rocketchat bei uns nachfragen.

wikimenu-shelve-new.png     oder wikimenu-shelve-edit.png

Bitte erstelle immer ein aussagekräftiges Coverimage für Regale!

Reihenfolge der angezeigten Bücher auf dem Regal bearbeiten/sortieren

Die Reihenfolge der Bücher, die auf einem Regal stehen, ist nicht alphabetisch sortiert, sondern ist einstellbar. Um die Reihenfolge zu ändern, können die Bücher einfach per Drag+Drop links auf der "Edit Bookshelf"-Seite verschoben werden.

wikimenu-shelfedit.png

Bücher erstellen, bearbeiten, löschen

Neue Bücher anlegen oder editieren

Neue Bücher können unter Bücher ("+ Create New Book") oder besser direkt innerhalb eines Regals ("+ New Book") neu erstellt werden. Wenn du ein Buch direkt über "Books" erstellst, dann achte bitte darauf es später mindestens einem Regal hinzuzufügen. Wenn du ein Buch innerhalb eines Regals erstellst, wird es automatisch (am Ende des Regals) hinzugefügt. Die Reihenfolge der Bücher auf einem Regal kannst du in den Regaleigenschaften editieren.

Bitte achte bei der Erstellung von Büchern darauf, dass du sie mindestens einem Bücherregal zuordnest! Das passiert nicht automatisch!

wikimenu-book-newedit.png  

Das Menü sieht ähnlich aus wie bei den Regalen. Du kannst einen aussagekräftigen Buchnamen sowie eine Kurzbeschreibung angeben. Außerdem wäre es gut, wenn du ein Buchcover erstellen würdest. Hierzu kannst du unsere Vorlagen verwenden, siehe Abschnitt Coverimage. Im Moment verwenden wir "Tags" nicht.

Bücher bearbeiten, Kapitel oder Seiten hinzufügen, Buch löschen

Um ein existierendes Buch zu editieren wählst du zuerst das Buch aus und klickst dann rechts im Menü auf "Edit". In diesem Menü kannst du auch direkt neue Seiten oder Kapitel für dieses Buch erstellen.

wikimenu-bookedit.png

Buchinhalte (Kapitel und Seiten) sortieren

Die Reihenfolge der Buchinhalte ist nicht automatisch alphabetisch oder anderweitig sortiert, sondern kann verändert werden. Klicke hierzu zuerst das Buch an und dann rechts im Menü auf "Sort".

Hier hast du wieder ein Drag+Drop Menü auf der linken Seite:

Außerdem kannst du Inhalte auch mit den entsprechenden Buttons automatisch sortieren lassen:

wikimenu-book-sort.png

Buch auf ein anderes Regal verschieben

Soll ein Buch von einem Regal auf ein anderes "verschoben" werden, muss es dem neuen Regal hinzugefügt und vom alten Regal entfernt werden. Das sind zwei unabhängige Arbeitsschritte. Das sind Regaleigenschaften und keine Bucheigenschaften!

Kapitel erstellen, bearbeiten, löschen, verschieben

Innerhalb von Büchern können Kapitel erstellt, bearbeitet oder gelöscht werden. Wähle hierzu das entsprechende Buch oder Kapitel aus und klicke dann auf "+ New Chapter" im Buch oder auf "Edit" im Kapitel. Genau wie Seiten können Kapitel auch woanders hinverschoben werden mit Klick auf "Move" im Menü rechts.

Seiten erstellen, bearbeiten, löschen, verschieben

Um eine existierende Seite zu bearbeiten oder zu löschen klickst du die Seite an und dann auf "Edit" oder "Delete" rechts im Menü. Seiten können auch in andere Bücher verschoben werden mit "Move". Außerdem kannst du dir die Bearbeitungshistorie über "Revisions" anzeigen lassen.

wikimenu-page.png

Seiten können nur in Büchern oder in Kapiteln innerhalb von Büchern erstellt werden, aber nicht in Regalen. Wähle ein existierendes Buch aus oder lege ein neues an um dort eine Seite zu erstellen. Klicke im ausgewählten Buch rechts auf "+ New Page".

Du bekommst dann einen WYSIWYG Editor angezeigt. Ganz oben trägst du den Seitennamen ein, der im Buch angezeigt werden soll. Die Oberfläche ist relativ selbsterklärend. Es gibt jedoch ein paar Kleinigkeiten zu beachten, die unten beschrieben sind.

wikimenu-page-edit.png

Header für Überschriften verwenden

Bitte verwende für Überschriften immer die Vorlagen unter Format > Header Large/Medium/Small/Tiny entsprechend der Hierarchie.

Daraus wird später das Inhaltsverzeichnis erstellt, das in der Leseansicht  auf der linken Seite zu sehen ist. Wenn du einfach nur die Schriftgrößen per Hand änderst, dann erscheinen die Überschriften später nicht im Inhaltsverzeichnis der Seite.

Links zu Webseiten

Verlinkungen kannst du bearbeiten oder erstellen, indem du den Text markierst und dann auf das Linksymbol (Kettensymbol) klickst. Bitte achte bei Verlinkungen auf andere Webseiten darauf sie in neuen Fenstern zu öffnen.

Infoboxen und Warnhinweise

... findest du unter Formats > Callouts >.

Code einfügen

... kannst du unter Formats >  Inline Code oder Formats > Code Block.

Bilder, Videos und andere Anhänge einfügen

Bitte unbedingt immer das Copyright mit angeben! Siehe Wichtige Hinweise.

Bilder oder kleine Videoclips kannst du über das Menü des Editors einfügen. Klicke auf "Insert an image" oder auf "Insert/edit media". Für Bilder erscheint dann folgendes Popup. Neue Bilder fügst du hinzu durch Drag&Drop an der rechten Seite. Das neu eingefügte Bild erscheint dann an erster Stelle in der Bildvorschau. Klicke die Bildvorschau auf der linken Seiten an und dann rechts auf "Select Image". Das fügt das Bild an der Stelle im Text ein wo der Curser positioniert war.

wikimenu-insertimage.png

Die angezeigte Größe des Bildes kannst du auch durch Doppelklick auf das Bild und dann verschieben der Eckpunkte verändern. Durch Doppelklick auf das Bild und dann unten auf das Burgermenü kannst du dann weitere Eigenschaften des Bildes bearbeiten.