Zum Inhalt springen

Wiki-Quellcode von How To Wiki

Version 19.1 von ff8080816ec34dff016f93ca9ec9000b am 2020/01/14 16:49
Zeige letzte Bearbeiter
1 Herzlich willkommen auf dem Makerspace Darmstadt Wiki!
2
3 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.
4
5 **Fällt dir irgendwas auf, was falsch ist?** Korrigiere es gerne!
6 **Fehlt dir irgendwas?** Füge es gerne hinzu!
7
8 {{info icon="false" title="Fehlt etwas?"}}
9 Fehlen dir auf dieser Seite irgendwelche Informationen, die Du brauchst, um am Wiki mitzuarbeiten? Hinterlasse einfach ein Kommentar unten, dann werden wir uns darum kümmern, deine Fragen möglichst zeitnah zu beantworten!
10 {{/info}}
11
12 = {{id name="HowToWiki-Inhaltsverzeichnis"/}}Inhaltsverzeichnis =
13
14 {{toc/}}
15
16 = {{id name="HowToWiki-AufbaudesWikis"/}}Aufbau des Wikis =
17
18 == {{id name="HowToWiki-WikiÜbersicht"/}}Wiki Übersicht ==
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
26 (% class="wrapped" %)
27 |=(((
28 Bereich
29 )))|=(((
30 Spaces
31 )))|=(((
32 Wer darf Lesen
33 )))|=(((
34 Wer darf Schreiben
35 )))
36 |(((
37 Öffentlich
38 )))|(((
39 Alle Werkstätten, Projekte, Der Verein
40 )))|(((
41 Jeder (auch ohne Anmeldung)
42 )))|(((
43 Jedes Mitglied
44 )))
45 |(((
46 Intern
47 )))|(((
48 Intern
49 )))|(((
50 Jedes Mitglied
51 )))|(((
52 Jedes Mitglied
53 )))
54 |(((
55 Geschützt
56 )))|(((
57 Inner Circle
58 )))|(((
59 Vorstand + Bereichsleiter
60 )))|(((
61 Vorstand + Bereichsleiter
62 )))
63
64 == {{id name="HowToWiki-Pages"/}}Pages ==
65
66 Innerhalb der Spaces werden Seiten erstellt, die hierarchisch aufgebaut werden. Folgende Regeln gilt für die Seiten (Pages):
67
68 * Der Page-Name muss innerhalb eines Spaces eindeutig sein
69 * Der Page-Name darf keine Sonderzeichen enthalten
70 * Es darf innerhalb eines Spaces maximal 3 Level geben, darunter darf keine weitere Seite angelegt werden
71 * Es existieren zwei Templates ein allgemeines und eins für die Beschreibung von Maschinen. Letzteres ist beim Erstellen neuer Maschinen zu verwenden
72
73 Der Aufbau und die Struktur innerhalb eines Bereichs (Holz, Metall, Laser, ...) ist immer gleich und wird hier am Beispiel der Holzwerkstatt gezeigt:
74
75 {{documentTree/}}
76
77 Die Seiten sind:
78
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-Maschinenvs.Kleinwerkzeuge"/}}Maschinen vs. Kleinwerkzeuge =
142
143 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.//
144
145 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.
146
147 = {{id name="HowToWiki-Linkserstellen"/}}Links erstellen =
148
149 [[image:attach:Link erstellen.png||thumbnail="true" data-xwiki-image-style-alignment="start" height="150"]]
150
151 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.
152
153 \\
154
155 \\
156
157 \\
158
159 \\
160
161 = {{id name="HowToWiki-Tags"/}}Tags =
162
163 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:
164
165 (% class="wrapped" %)
166 |=(((
167 Tag
168 )))|=(((
169 Beschreibung
170 )))
171 |(((
172 (% class="content-wrapper" %)
173 (((
174 {{confluence_badge Style="dark" Text="maschine"/}}
175 )))
176 )))|(((
177 Darf nur an Pages von Maschinen innerhalb eines Bereichs angefügt werden und bewirkt, dass die Maschine automatisch in der Geräteübersicht angezeigt wird.
178 )))
179 |(((
180 (% class="content-wrapper" %)
181 (((
182 {{confluence_badge Style="dark" Text="lbl-quick-link"/}}
183 )))
184 )))|(((
185 Bewirkt, dass eine Seite in den "Getting Started" Links auf der Startseite angezeigt wird
186 )))
187 |(((
188 (% class="content-wrapper" %)
189 (((
190 {{confluence_badge Style="dark" Text="anleitung-<maschinenkürzel>"/}}
191 )))
192 )))|(((
193 Für alle Seiten unterhalb einer Maschine - bewirkt, dass die Anleitung danach automatisch auf der Hauptseite der Maschine angezeigt wird
194 )))
195
196 = {{id name="HowToWiki-Lizenz"/}}Lizenz =
197
198 Um die kommerzielle Verwendung der hier erstellten Inhalte zu verhindern, wird der Inhalt unter die [[Creative Commons Attribution-NonCommercial-ShareAlike Lizenz>>url:https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode||shape="rect"]] gestellt. Durch deine Mitarbeit erkennst Du an, dass diese Lizenz auch für von dir veröffentliche Inhalte im Wiki gilt.
199
200 = {{id name="HowToWiki-Plugins"/}}Plugins =
201
202 Es sind einige Plugins in Verwendung, um die Features oder des Aussehen des Wikis anzupassen:
203
204 * [[Refined>>url:https://marketplace.atlassian.com/apps/15231/refined-structure-and-theme-confluence?hosting=server&tab=overview||shape="rect"]] und [[Refined Mobile>>url:https://marketplace.atlassian.com/apps/22008/refined-mobile-for-confluence?hosting=server&tab=overview||shape="rect"]]: Theme sowie Einführung des Space-Kategorien. Bessere Unterstützung für mobile Endgeräte
205 * [[No Email Storm>>url:https://marketplace.atlassian.com/apps/42684/no-email-storm?hosting=server&tab=overview||shape="rect"]]: Anpassung der Notification und Watcher Einstellungen in Confluence
206 * [[SAML Single Sign On>>url:https://marketplace.atlassian.com/apps/1212129/saml-single-sign-on-sso-confluence?hosting=server&tab=overview||shape="rect"]]: Anbindung an unser Anmeldesystem Keycloak
207 * [[Sketch for Confluence>>url:https://marketplace.atlassian.com/apps/1211075/sketch-for-confluence-image-editing?hosting=server&tab=overview||shape="rect"]]: Add-on zur Bearbeitung von Bildern und Fotos direkt während des Uploads
208 * [[Scroll Exporter for Confluence>>url:https://marketplace.atlassian.com/apps/24982/scroll-word-exporter-for-confluence?hosting=server&tab=overview||shape="rect"]]: Gut aussehender Export von Confluence Seiten in Word Dokumente
209 * [[Google Drive / Docs for Confluence>>url:https://marketplace.atlassian.com/apps/1216484/google-drive-docs-for-confluence?hosting=server&tab=overview||shape="rect"]]: Plugin zum Einbinden von Google Docs direkt in Confluence
210 * [[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
211
212 \\
213
214 {{info title="Zusätzliche Plugins"}}
215 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!
216 {{/info}}

Community

https://xwiki.makerspace-darmstadt.de/bin/download/Panels/MKSP%20Slack/Slack_MKSP.png

Wir benutzen Slack, um miteinander zu kommunizieren. Melde Dich an und werde Teil unserer Maker-Community!

Zum Slack Workspace

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.