Änderungen von Dokument How To Wiki


am 2020/01/13 22:53


am 2020/03/24 22:12
Zusammenfassung
Details
- Seiteneigenschaften
-
- Inhalt
-
... ... @@ -15,8 +15,14 @@ 15 15 16 16 = {{id name="HowToWiki-AufbaudesWikis"/}}Aufbau des Wikis = 17 17 18 - AlsSoftwaredesWikis kommt eine Community-Version von [[Atlassian Confluence>>url:https://www.atlassian.com/software/confluence||shape="rect"]] zum Einsatz, die uns als Makerspace kostenfrei zur Verfügung gestelltwerden. DasWikiist in verschiedene so genannte Spaces eingeteilt, je einen für einenWerkstattbereichsowie einige interne Bereiche. Der Zugriff auf manche internen Bereicheistgeschützt.Übersicht:18 +== {{id name="HowToWiki-WikiÜbersicht"/}}Wiki Übersicht == 19 19 20 +Als Software des Wikis kommt eine Community-Version von [[Atlassian Confluence>>url:https://www.atlassian.com/software/confluence||shape="rect"]] zum Einsatz, die uns als Makerspace kostenfrei zur Verfügung gestellt werden. 21 + 22 +== {{id name="HowToWiki-Spaces"/}}Spaces == 23 + 24 +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: 25 + 20 20 (% class="wrapped" %) 21 21 |=((( 22 22 Bereich ... ... @@ -55,6 +55,8 @@ 55 55 Vorstand + Bereichsleiter 56 56 ))) 57 57 64 +== {{id name="HowToWiki-Pages"/}}Pages == 65 + 58 58 Innerhalb der Spaces werden Seiten erstellt, die hierarchisch aufgebaut werden. Folgende Regeln gilt für die Seiten (Pages): 59 59 60 60 * Der Page-Name muss innerhalb eines Spaces eindeutig sein ... ... @@ -62,12 +62,90 @@ 62 62 * Es darf innerhalb eines Spaces maximal 3 Level geben, darunter darf keine weitere Seite angelegt werden 63 63 * Es existieren zwei Templates ein allgemeines und eins für die Beschreibung von Maschinen. Letzteres ist beim Erstellen neuer Maschinen zu verwenden 64 64 65 - ={{id name="HowToWiki-WaskommtWohin?"/}}WaskommtWohin? =73 +Der Aufbau und die Struktur innerhalb eines Bereichs (Holz, Metall, Laser, ...) ist immer gleich und wird hier am Beispiel der Holzwerkstatt gezeigt: 66 66 67 - \\75 +{{documentTree/}} 68 68 69 - = {{idname="HowToWiki-MaschinenundKleinwerkzeuge"/}}Maschinen undKleinwerkzeuge =77 +Die Seiten sind: 70 70 79 +* **Die Holzwerkstatt**: Bereichsübersicht, Fotos, Bereichsleiter, ... alles was den Bereich im allgemeinen Betrifft 80 +* **Maschinen**: Eine Seite pro Maschine, die in diesem Bereich ist 81 +* **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. 82 +* **Kleinwerkzeuge**: Übersicht über alle Kleinwerkzeuge in diesem Bereich, die keine eigene Seite haben wie die Maschinen 83 +* **Anleitungen**: Hier können Anleitungen angelegt werden, die einen Vorgang oder ein Verfahren maschinenunabhängig zu beschreiben 84 + 85 +== {{id name="HowToWiki-WaskommtWohin?"/}}Was kommt Wohin? == 86 + 87 +Grundsätzlich gibt es verschiedene Arten von Inhalt, die an unterschiedlichen Stellen im Wiki ihren Platz haben. Die folgende Tabelle gibt eine Übersicht: 88 + 89 +(% class="wrapped" %) 90 +|=((( 91 +Inhalt 92 +)))|=((( 93 +Wohin 94 +))) 95 +|((( 96 +Organisatorische Informationen (Einweisungen, Verein, ...) 97 +)))|((( 98 +[[doc:MD.WebHome]] 99 +))) 100 +|((( 101 +Sonstige organisatorische oder allgemeine Infos 102 +)))|((( 103 +[[doc:MD.WebHome]] 104 +))) 105 +|((( 106 +Beschreibung eigener Projekte (kann gerne auf Anleitungen innerhalb der Bereiche verweisen) 107 +)))|((( 108 +[[doc:PROJ.WebHome]] > [[doc:PROJ.Mitgliederprojekte.WebHome]] 109 +))) 110 +|((( 111 +Vereinsprojekte (Datron-Fräse, ...) 112 +)))|((( 113 +[[doc:PROJ.WebHome]] > [[doc:PROJ.WebHome]] 114 +))) 115 +|((( 116 +Workshops und Inhalte 117 +)))|((( 118 +[[doc:PROJ.WebHome]] > Workshops 119 +))) 120 +|((( 121 +Beschreibung einer Maschine 122 +)))|((( 123 +//Bereich// > Maschinen 124 +))) 125 +|((( 126 +Anleitung oder Erklärung zu einer Maschine 127 +)))|((( 128 +//Bereich// > Maschinen > //Maschine// 129 +))) 130 +|((( 131 +Allgemeine Anleitungen (Wie erstelle ich Joins bei 3D Druck Teilen?) 132 +)))|((( 133 +//Bereich// > Anleitungen 134 +))) 135 +|((( 136 +Interne Inhalte, die nicht für die Öffentlichkeit bestimmt sind 137 +)))|((( 138 +[[doc:IN.WebHome]] 139 +))) 140 + 141 += {{id name="HowToWiki-BenutzungdesWikis"/}}Benutzung des Wikis = 142 + 143 +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: 144 + 145 +**Wie bearbeite ich eine Seite?** 146 + 147 +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 Tastatur - der Screenshot erklärt, wie. 148 + 149 +[[image:url:https://files.slack.com/files-pri/T5JH1DB7B-F010RBD2H2B/image.png||style="text-decoration: none;"]] 150 + 151 +**Personal Space** 152 + 153 +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! 154 + 155 += {{id name="HowToWiki-Maschinenvs.Kleinwerkzeuge"/}}Maschinen vs. Kleinwerkzeuge = 156 + 71 71 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.// 72 72 73 73 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. ... ... @@ -80,6 +80,12 @@ 80 80 81 81 \\ 82 82 169 +\\ 170 + 171 +\\ 172 + 173 +\\ 174 + 83 83 = {{id name="HowToWiki-Tags"/}}Tags = 84 84 85 85 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: ... ... @@ -106,6 +106,14 @@ 106 106 )))|((( 107 107 Bewirkt, dass eine Seite in den "Getting Started" Links auf der Startseite angezeigt wird 108 108 ))) 201 +|((( 202 +(% class="content-wrapper" %) 203 +((( 204 +{{confluence_badge Style="dark" Text="anleitung-<maschinenkürzel>"/}} 205 +))) 206 +)))|((( 207 +Für alle Seiten unterhalb einer Maschine - bewirkt, dass die Anleitung danach automatisch auf der Hauptseite der Maschine angezeigt wird 208 +))) 109 109 110 110 = {{id name="HowToWiki-Lizenz"/}}Lizenz = 111 111 ... ... @@ -124,3 +124,7 @@ 124 124 * [[Draw.io>>url:https://marketplace.atlassian.com/apps/1210933/draw-io-diagrams-for-confluence?hosting=server&tab=overview||shape="rect"]]: Plugin zum Zeichnen von Graphen und technischen Zeichnungen 125 125 126 126 \\ 227 + 228 +{{info title="Zusätzliche Plugins"}} 229 +Fehlt dir eine bestimmte Funktionalität, die sich [[über ein Plugin>>url:https://marketplace.atlassian.com/addons/app/confluence||shape="rect"]] nachrüsten ließe? Dann hinterlasse einfach ein Kommentar, wir werden das prüfen! 230 +{{/info}}
- Confluence.Code.ConfluencePageClass[0]
-
- Id
-
... ... @@ -1,1 +1,1 @@ 1 -4882 4491 +4882830 - URL
-
... ... @@ -1,1 +1,1 @@ 1 -https://wiki.makerspace-darmstadt.de/spaces/MD/pages/4882 449/How To Wiki1 +https://wiki.makerspace-darmstadt.de/spaces/MD/pages/4882830/How To Wiki
Community
Wir benutzen Slack, um miteinander zu kommunizieren. Melde Dich an und werde Teil unserer Maker-Community!
Frage? FAQ!
Du hast eine Frage, die sich nicht direkt im Wiki findet?
Natürlich kannst Du die Frage jederzeit gerne in der Slack Community stellen. Bevor Du das machst, schau doch bitte einmal auf unserer Homepage bei den Häufig gestellten Fragen vorbei. Wir versuchen diese Fragen stets aktuell zu halten, eventuell hilft Dir das ja schon weiter.
Offene Werkstatt
Ohne Anmeldung einfach vorbei kommen. Am besten bringst Du direkt den ausgefüllten Haftungsauschluss mit.
Jeden Donnerstag ab 19 Uhr
Während der offenen Werkstatt kannst Du einfach vorbei kommen und an Deinem Projekt arbeiten. Bitte beachte aber, dass zur Verwendung der Maschinen eine Einweisung erforderlich ist, die Du gegebenfalls vorher absolvieren musst. Wenn ein Mitglied mit entsprechender Einweisung vor Ort ist und Zeit hat, helfen wir natürlich gerne aus. Dies können wir aber nicht garantieren, da Rundgänge Priorität haben.
Sprich Dich idealerweise schon vor der offenen Werkstatt mit einem Mitglied in unserem Slack ab. So kannst Du sicherstellen, dass Du auf jeden Fall arbeiten kannst.
Übrigens: Du kannst Dich mit einem Mitglied gerne auch außerhalb der offenen Werkstattzeiten zum Arbeiten verabreden!
Führungen und Rundgänge
Im Rahmen der offenen Werkstatt bieten wir euch auch gerne einen Rundgang durch unsere Werkstatt. Hier könnt ihr den Verein und unser Konzept kennenlernen sowie die Maschinen und Möglichkeiten der Werkstatt gezeigt bekommen.
Jeden Donnerstag wird eine Führung angeboten:
- Um 19:15 Uhr (bitte um 19:00 Uhr da sein)
Der Rundgang dauert ca. 45 Minuten und ihr habt natürlich auch die Möglichkeit, eure Fragen loszuwerden.
Bitte beachtet folgendes: Die Werkstatt beinhaltet gefährliche Maschinen. Bringt daher bitte nach Möglichkeit den ausgefüllten und unterschrieben Haftungsauschluss schon mit. Dieser kann aber auch vor Ort ausgefüllt werden, das verzögert allerdings die Abläufe.