Herzlich willkommen auf dem Makerspace Darmstadt Wiki!

Diese Seite stellt ein paar Informationen insbesondere für diejenigen zusammen, die aktiv am Wiki arbeiten möchten. Das Wiki ist so gedacht, dass jedes Mitglied mitarbeiten kann. Das Wiki lebt von deiner Mitarbeit! Bitte beachte jedoch die unterstehenden Regeln und Best Practices.

Fällt dir irgendwas auf, was falsch ist? Korrigiere es gerne!
Fehlt dir irgendwas? Füge es gerne hinzu!

Inhaltsverzeichnis

Aufbau des Wikis

Wiki Übersicht

Als Software des Wikis kommt eine Community-Version von Atlassian Confluence zum Einsatz, die uns als Makerspace kostenfrei zur Verfügung gestellt wird.

Spaces

Das Wiki ist in verschiedene so genannte Spaces eingeteilt, je einen für einen Werkstattbereich sowie einige interne Bereiche. Der Zugriff auf manche internen Bereiche ist geschützt. Übersicht:

Pages

Innerhalb der Spaces werden Seiten erstellt, die hierarchisch aufgebaut werden. Folgende Regeln gelten für die Seiten (Pages):

• Der Page-Name muss innerhalb eines Spaces eindeutig sein
• Der Page-Name darf keine Sonderzeichen enthalten
• Es darf innerhalb eines Spaces maximal 3 Level geben, darunter darf keine weitere Seite angelegt werden
• Es existieren zwei Templates ein allgemeines und eins für die Beschreibung von Maschinen. Letzteres ist beim Erstellen neuer Maschinen zu verwenden

Der Aufbau und die Struktur innerhalb eines Bereichs (Holz, Metall, Laser, ...) ist immer gleich und wird hier am Beispiel der Holzwerkstatt gezeigt:

Die Seiten sind:

• Holzwerkstatt Home: Bereichsübersicht, Fotos, Bereichsleiter, ... alles was den Bereich im allgemeinen Betrifft
• Maschinen: Eine Seite pro Maschine, die in diesem Bereich ist
• Maschinen => Unterseite: Unterhalb jeder Maschine können weitere Seiten mit Details oder Anleitungen bezüglich dieser speziellen Maschine angelegt werden. Als Beispiel könnte dort eine Anleitung erstellt werden, wie bei der Holz-CNC die Z-Achse korrekt eingestellt wird.
• Kleinwerkzeuge: Eine Seite pro Kleinwerkzeug in diesem Bereich
• Kleinwerkzeuge => Unterseite: Unterhalb können weitere Seiten mit Details oder Anleitungen/Tutorials angelegt werden. Als Beispiel könnte dort eine Anleitung erstellt werden, wie zb mit dem Exzenterschleifer zu arbeiten ist oder wie man Stemmeisen verwendet.
• Anleitungen: Sammelpunkt der Links zu allen an Maschinen/Kleingeräte angehängter Betriebsanleitungen. Zeigt alle files mit den tags 'holz' und 'anleitung'
• Arbeitsabläufe und Sicherheit: Material zum korrekten Arbeiten mit gerätekategorien, hauptsächlich der Berufsgenossenschaft. Wird in den jeweiligen Maschinen und Kleingeräten durch die tags 'holz' 'sicherheit' und die kategorie (zb 'kreissäge') verlinkt.

Was kommt Wohin?

Grundsätzlich gibt es verschiedene Arten von Inhalt, die an unterschiedlichen Stellen im Wiki ihren Platz haben. Die folgende Tabelle gibt eine Übersicht:

Benutzung des Wikis

Learning by Doing - vermutlich der effektivste Weg, dich ins Wiki einzufinden. Probier gerne aus, du kannst immer in der Version der Seite zurückspringen und Änderungen rückgängig machen. Auf zwei wichtige Dinge soll jedoch hingewiesen werden:

Wie bearbeite ich eine Seite?

Das ist leider nicht ganz so intuitiv, wie man es sich wünschen würde. Der einfachste Weg ist, einen der vielen Shortcuts (einfach oben rechts am Rand mal das Fragezeichen drücken) zu verwenden. Drücke einfach "e" auf deiner Tastatur und du kannst die Seite bearbeiten. Natürlich geht es aber auch per Maus - der Screenshot erklärt, wie.

Personal Space

Wenn Du oben Rechts auf dein Icon klickst, kannst Du einen "Personal Space" erstellen. Dieser gehört völlig dir, außer Dir hat niemand Zugriff darauf. Du kannst ihn für persönliche Notizen verwenden, oder - gerade wenn du am Anfang noch unsicher bist - als Playground, um erweiterte Funktionen des Wikis wie Macros und Links auszuprobieren. Du kannst auch anderen Leuten nachträglich Zugriff auf bestimmte Seiten in diesem persönlichen Space geben oder die Seite zu einem öffentlichen Bereich verschieben - probier es einfach aus!

Maschinen vs. Kleinwerkzeuge

Wir unterscheiden zwischen Maschinen und Kleinwerkzeuge. Maschinen haben eine eigene Wiki-Seite direkt unterhalb der jeweiligen Werkstatt. Für Kleinwerkzeuge gibt es in jedem Werkstatt-Bereich eine eigene Seite für deren Beschreibung und Auflistung. Für jedes Kleinwerkzeug ist hier eine "Heading 1" Überschrift zu wählen.

Es gibt derzeit noch keine allgemeine Definition, was eine Maschine und was ein Kleinwerkzeug ist. Als Daumenregel: Wenn es sich lohnt, für irgendetwas eine eigene Wiki-Seite zu erstellen, dann kann es als Maschine angesehen werden.

Links erstellen

Beim erstellen von Links zu Seiten im Wiki ist darauf zu achten, dass nicht einfach die Adresszeile des Browsers kopiert wird. Wird die Seite umbenannt, sind die Links nicht mehr gültig! Stattdessen sollte wie auf dem folgenden Screenshot zu sehen ein Link zur Seite generiert werden. Dieser ist kürzer und bleibt auch nach dem Umbenennen einer Seite konsistent.

Tags

Confluence verwendet Tags für die Organisation von Inhalten. So können beispielsweise automatisch Inhalte mit einem bestimmten Tag an einer anderen Stelle zusammengefasst werden. Folgende Tags werden aktuell verwendet:

Lizenz

Um die kommerzielle Verwendung der hier erstellten Inhalte zu verhindern, wird der Inhalt unter die Creative Commons Attribution-NonCommercial-ShareAlike Lizenz gestellt. Durch deine Mitarbeit erkennst Du an, dass diese Lizenz auch für von dir veröffentliche Inhalte im Wiki gilt.

Plugins

Es sind einige Plugins in Verwendung, um die Features oder des Aussehen des Wikis anzupassen:

• Refined und Refined Mobile: Theme sowie Einführung des Space-Kategorien. Bessere Unterstützung für mobile Endgeräte
• No Email Storm: Anpassung der Notification und Watcher Einstellungen in Confluence 
• SAML Single Sign On: Anbindung an unser Anmeldesystem Keycloak
• Sketch for Confluence: Add-on zur Bearbeitung von Bildern und Fotos direkt während des Uploads
• Scroll Exporter for Confluence: Gut aussehender Export von Confluence Seiten in Word Dokumente
• Google Drive / Docs for Confluence: Plugin zum Einbinden von Google Docs direkt in Confluence
• Draw.io: Plugin zum Zeichnen von Graphen und technischen Zeichnungen