Initial commit

.gitignore

@@ -0,0 +1,3 @@
+/public
+.DS_Store
+resources

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "themes/learn"]
+	path = themes/learn
+	url = https://github.com/matcornic/hugo-theme-learn.git

README.md

@@ -0,0 +1,2 @@
+# TU Dresden Matrix Dokumentation
+**Website:** **https://doc.matrix.tu-dresden.de**

archetypes/default.md

@@ -0,0 +1,6 @@
+---
+title: "{{ replace .Name "-" " " | title }}"
+date: {{ .Date }}
+draft: true
+---
+

config.toml

@@ -0,0 +1,31 @@
+baseURL = "https://doc.matrix.tu-dresden.de/"
+languageCode = "de-DE"
+DefaultContentLanguage = "de"
+title = "Matrix Dokumentation"
+theme = "learn"
+
+[params]
+  themeVariant = "tud"
+  disableNextPrev = true
+  disableShortcutsTitle = false
+  showVisitedLinks = true
+  disableBreadcrumb = false
+  disableMermaid = false
+[outputs]
+home = [ "HTML", "RSS", "JSON"]
+
+# No newline (<br/>) unless unsafe is enabled
+# https://gohugo.io/news/0.60.0-relnotes/
+[markup]
+  [markup.goldmark]
+    [markup.goldmark.renderer]
+      unsafe = true
+[languages]
+	[languages.en]
+    		title = "Matrix Documentation"
+    		weight = 2
+		languageName = "English"
+	[languages.de]
+		title = "Matrix Dokumentation"
+		weight = 1
+		languageName = "Deutsch"

content/_index.en.md

@@ -0,0 +1,74 @@
+---
+title: "Matrix at TU Dresden"
+date: 2020-08-02T21:26:25+02:00
+chapter: false
+draft: false
+---
+## Matrix at TU Dresden
+Matrix is a free and open, secure, decentralized protocol for real-time communication, also known by the name of one of its clients, Element.
+
+<object data="/images/matrix_interactive_en.svg" type="image/svg+xml" style="width: 1280px; max-width: 100%"></object>
+
+In recent years, the need for supporting digital tools for team collaboration has increased. A central tool is a team chat. According to Wikipedia, a chat refers to "electronic communication by means of written text in real time, usually via the Internet". ([Source](https://en.wikipedia.org/wiki/Chat)). With a messenger team members can make each other aware of current information and especially share links (*hyperlinks* / *links*) for further collaboration (e.g. for finding appointments, collaborative writing, planning events, editing data, code, mind maps,). Due to the lack of a centralized offer so far, many teams at TU Dresden have been looking for their own solutions, some of which are privacy-critical or cannot be linked to other systems.
+
+In order to meet the demand for real-time communication, the open communication protocol Matrix was introduced in a pilot operation at the TU Dresden at the end of 2018, after a comparative analysis of several potential solution options, and presented to the CIO in April 2019. In autumn 2019, the pilot operation was transferred to regular operation. e.g. [digital](https://invidious.13ad.de/AtkA-sE-9uU) [teaching](https://invidious.13ad.de/jEvKdFTKSxU) (Videos by Prof. Lasch) with Matrix in addition to the [OPAL](https://bildungsportal.sachsen.de/opal) application.
+
+## Topics
+
+* [Why Matrix and no other chat system?]({{< relref "why/_index.en.md" >}})
+
+* [How can Matrix be used? (registration and first steps)]({{< relref "first-steps/_index.en.md" >}})
+
+* [Recommendations for further important settings after first login]({{< relref "settings/_index.en.md" >}})
+
+* [Installation of a client / program]({{< relref "clients/_index.en.md" >}})
+
+    * [Browsersettings]({{< relref "clients/browser.en.md" >}})
+
+* [Find people and send direct messages]({{< relref "messaging/_index.en.md" >}})
+
+* [Use end-to-end encryption]({{< relref "encryption/_index.en.md" >}})
+
+* [Create rooms and take responsibility]({{< relref "rooms/_index.en.md" >}})
+
+    * [Sharing rooms and making them public]({{< relref "rooms/sharing.en.md" >}})
+
+    * [Find rooms]({{< relref "rooms/find/_index.en.md" >}})
+
+    * [Delete and leave rooms]({{< relref "rooms/delete/_index.en.md" >}})
+
+* [Fine-tune notifications]({{< relref "notifications/_index.en.md" >}})
+
+* [Use integrations, bridges, bots (e.g. Jitsi)]({{< relref "integrations/_index.en.md" >}})
+
+* [More Clients]({{< relref "clients/more_clients.en.md" >}})
+
+* [Using communities as room filters]({{< relref "communities/_index.en.md" >}})
+
+* [Further development of Matrix]({{< relref "development/_index.en.md" >}})
+
+* [Privacy policy]({{< relref "privacy/_index.en.md" >}})
+
+* [Imprint]({{< relref "imprint/_index.en.md" >}})
+
+* [Declaration of Accessibility]({{< relref "accessibility/_index.en.md" >}})
+
+### Questions and Contact
+
+Please address general questions to the service desk of TU Dresden:
+
+https://tu-dresden.de/zih/dienste/service-desk
+
+If the service desk is unable to help, questions are forwarded to the decentralized administration team that accompanies Matrix at the TU Dresden.
+
+The ideal is to deal with problems in a transparent way, from which all others can learn. This can be done by describing the situation in the Matrix Support Room - here problems and solutions can be discussed together:
+
+[https://matrix.tu-dresden.de/#/room/#matrix-support:tu-dresden.de](https://matrix.tu-dresden.de/#/room/#matrix-support:tu-dresden.de)
+
+{{% notice warning %}}
+For some anomalies you can try to empty the cache and reload everything: Settings > Help & About > Clear Cache and reload
+{{% /notice %}}
+
+{{% notice warning %}}
+Current maintenance is announced in the matrix room [#Matrix-Betriebsstatus:tu-dresden.de](https://matrix.tu-dresden.de/#/room/#Matrix-Betriebsstatus:tu-dresden.de).
+{{% /notice %}}

content/_index.md

@@ -0,0 +1,73 @@
+---
+title: "Matrix an der TU Dresden"
+date: 2020-08-02T21:26:25+02:00
+chapter: false
+draft: false
+---
+## Matrix an der TU Dresden
+Matrix ist ein freies und offenes, sicheres, dezentralisiertes Protokoll für Echtzeit-Kommunikation, das auch unter dem Namen eines seiner nutzenden Programme, Element, bekannt ist.
+
+<object data="/images/matrix_interactive.svg" type="image/svg+xml" style="width: 1280px; max-width: 100%"></object>
+
+Zur Zusammenarbeit in Teams stieg in den letzten Jahren der Bedarf an unterstützenden digitalen Werkzeugen (engl. *tool*). Ein zentrales Werkzeug ist dabei ein Team-Chat. Ein Chat bezeichnet, laut Wikipedia, „die elektronische Kommunikation mittels geschriebenem Text in Echtzeit, meist über das Internet“ ([Quelle](https://de.wikipedia.org/wiki/Chat)). Die dazugehörige Handlung nennt man „*chatten*“. Mit einem Chattool (manchmal auch Messenger genannt) können sich Teammitglieder gegenseitig auf aktuelle Informationen aufmerksam machen und insb. Verknüpfungen (*Hyperlinks* / *Links*) zur weitergehenden Zusammenarbeit teilen (bspw. zur Terminfindung, zum kollaborativen Schreiben, zum Planen von Events, zum Bearbeiten von Daten, Code, Mindmaps oder Prozessen). Viele Teams an der TU Dresden haben sich aufgrund des bisher fehlenden zentralen Angebots eigene Lösungen gesucht, die zum Teil datenschutzbedenklich sind oder nicht mit anderen Systemen verknüpfbar sind.
+
+Zur Deckung des Bedarfes an Echtzeitkommunikation wurde daher Ende 2018, nach vergleichender Analyse mehrerer potentieller Lösungsoptionen, innerhalb der TU Dresden das offene Kommunikationsprotokoll Matrix in einem Pilotbetrieb eingeführt und im April 2019 im CIO präsentiert. Im Herbst 2019 wurde der Pilotbetrieb in den Regelbetrieb überführt. U.a. in der [digitalen](https://invidious.13ad.de/AtkA-sE-9uU) [Lehre](https://invidious.13ad.de/jEvKdFTKSxU) (Videos von Prof. Lasch) findet Matrix als Ergänzung zu [OPAL](https://bildungsportal.sachsen.de/opal) Anwendung.
+
+## Themen der Dokumentation
+
+* [Warum Matrix und kein anderes Chat-System?]({{< relref "why/_index.md" >}})
+* [Wie kann Matrix genutzt werden? (Anmeldung und erste Schritte)]({{< relref "first-steps/_index.md" >}})
+
+* [Empfehlungen zu weiteren wichtigen Einstellungen nach dem Erstlogin]({{< relref "settings/_index.md" >}})
+
+* [Installation eines Clients / Programms]({{< relref "clients/_index.md" >}})
+
+    * [Browsereinstellungen]({{< relref "clients/browser/_index.md" >}})
+
+* [Personen finden und direkte Nachrichten versenden]({{< relref "messaging/_index.md" >}})
+
+* [Ende-zu-Ende-Verschlüsselung nutzen]({{< relref "encryption/_index.md" >}})
+
+* [Räume erstellen und Verantwortung übernehmen]({{< relref "rooms/_index.md" >}})
+
+    * [Räume teilen und publik machen]({{< relref "rooms/sharing/_index.md" >}})
+
+    * [Räume finden]({{< relref "rooms/find/_index.md" >}})
+
+    * [Räume löschen und aus Räumen austreten]({{< relref "rooms/delete/_index.md" >}})
+
+* [Benachrichtigungen feiner einstellen]({{< relref "notifications/_index.md" >}})
+
+* [Integrations, Bridges, Bots nutzen (u.a. Jitsi)]({{< relref "integrations/_index.md" >}})
+
+* [Weitere Clients]({{< relref "clients/more_clients/_index.md" >}})
+
+* [Communities als Raum-Filter einsetzen]({{< relref "communities/_index.md" >}})
+
+* [Weiterentwicklung von Matrix]({{< relref "development/_index.md" >}})
+
+* [Datenschutzerklärung]({{< relref "privacy/_index.md" >}})
+
+* [Impressum]({{< relref "imprint/_index.md" >}})
+
+* [Barrierefreiheitserklärung]({{< relref "accessibility/_index.md" >}})
+
+### Fragen / Kontakt
+
+Allgemeine Fragen richten Sie bitte an den Servicedesk der TU Dresden:
+
+https://tu-dresden.de/zih/dienste/service-desk
+
+Sollte der Servicedesk nicht weiterhelfen können, werden von diesem Fragen an das dezentrale Administrationsteam, welches Matrix an der TU Dresden begleitet, weitergeleitet.
+
+Ideal ist der transparente Umgang mit Problemen, aus denen alle Anderen lernen können. Dies kann durch Schildern des Sachverhaltes im Matrix-Support-Raum geschehen - hier können Probleme und Lösungen gemeinsam diskutiert werden:
+
+[https://matrix.tu-dresden.de/#/room/#matrix-support:tu-dresden.de](https://matrix.tu-dresden.de/#/room/#matrix-support:tu-dresden.de)
+
+{{% notice tip %}}
+Man kann bei manchen Anomalien probieren den Cache (Zwischenspeicher) zu leeren und alles neu zu laden: Einstellungen > Hilfe & Über > Cache löschen und neu laden
+{{% /notice %}}
+
+{{% notice note %}}
+Aktuelle Wartungen werden in dem Matrixraum [#Matrix-Betriebsstatus:tu-dresden.de](https://matrix.tu-dresden.de/#/room/#Matrix-Betriebsstatus:tu-dresden.de) angekündigt.
+{{% /notice %}}

content/accessibility/_index.en.md

@@ -0,0 +1,48 @@
+---
+title: "Declatation of accessibility"
+date: 2020-09-05T10:53:07+02:00
+draft: false
+chapter: true
+---
+
+# Accessibility declaration 
+This declaration on accessibility applies to the chat application Matrix/Element of the Technische Universität Dresden published at https://matrix.tu-dresden.de.
+
+As a public body within the meaning of the Barrier-free Web Sites Act (BfWebG), the Dresden University of Technology makes every effort to make its Web sites and mobile applications accessible without barriers in accordance with the provisions of the Barrier-free Web Sites Act (BfWebG) in conjunction with the Barrier-free Information Technology Ordinance (BITV 2.0).
+
+## Creation of this declaration of accessibility
+This declaration was prepared on 05.09.2020 and last updated on 05.09.2020. 
+
+<!-- The basis of this declaration on accessibility is [a [BITV-]self-assessment [on the date | in the period from date to date] carried out by the TU Dresden | an evaluation (e.g. certification according to BITV 2.0) [on the date | in the period from date to date]] carried out by an independent body (name name!). -->
+
+## State of accessibility
+No BITV test for the web application Element has been performed yet.
+
+## Non-accessible content 
+* The login page has too low contrast.
+* The chat application has too low contrast, can only be operated in its basic features using a screen reader.
+* The chat application is not always operable with the keyboard.
+## Alternatives
+Accessible alternatives are for example the command line clients [matrix-commands](https://matrix.org/docs/projects/client/matrix-commander), [weechat-matrix](https://matrix.org/docs/projects/client/weechat-matrix) or [gomuks](https://matrix.org/docs/projects/client/gomuks).
+## Contact 
+Should you notice any shortcomings in terms of barrier-free design, please contact matrix@tu-dresden.de.
+## Enforcement procedures
+If we do not process your feedback satisfactorily from your point of view, you can contact the Saxon Enforcement Panel:
+Commissioner of the Saxon State Government for the interests of persons with disabilitiesAlbertstraße 10, 01097 Dresden
+
+**postal address**
+
+Archivstraße 1
+
+01097 Dresden
+
+E-Mail: info.behindertenbeauftragter@sk.sachsen.de
+
+Telefon: 0351 564-12161
+
+Fax: 0351 564-12169
+
+Webseite: https://www.inklusion.sachsen.de
+
+
+

content/accessibility/_index.md

@@ -0,0 +1,48 @@
+---
+title: "Barrierefreiheitserklärung"
+date: 2020-09-05T10:53:07+02:00
+draft: false
+chapter: true
+---
+
+# Erklärung zur Barrierefreiheit 
+Diese Erklärung zur Barrierefreiheit gilt für die unter https://matrix.tu-dresden.de veröffentlichte Chatanwendung Matrix/Element der Technischen Universität Dresden.
+
+Als öffentliche Stelle im Sinne des Barrierefreie-Websites-Gesetz (BfWebG) ist die Technische Universität Dresden bemüht, ihre Websites und mobilen Anwendungen im Einklang mit den Bestimmungen des Barrierefreie-Websites-Gesetz (BfWebG) in Verbindung mit der Barrierefreie-Informationstechnik-Verordnung (BITV 2.0) barrierefrei zugänglich zu machen.
+
+## Erstellung dieser Erklärung zur Barrierefreiheit
+Diese Erklärung wurde am 05.09.2020 erstellt und zuletzt am 05.09.2020 aktualisiert. 
+
+<!-- Grundlage der Erstellung dieser Erklärung zur Barrierefreiheit ist [eine [am Datum | im Zeitraum von Datum bis Datum] von der TU Dresden durchgeführte [BITV-]Selbstbewertung | eine durch eine unabhängige Stelle (Name nennen!) durchgeführte Bewertung (z.B. Zertifizierung nach BITV 2.0) [am Datum | im Zeitraum von Datum bis Datum]]. -->
+
+## Stand der Barrierefreiheit
+Es wurde bisher noch kein BITV-Test für die Webapplikation Element durchgeführt.
+
+## Nicht barrierefreie Inhalte 
+* Die Anmeldeseite weist zu niedrige Kontraste auf.
+* Die Chatanwendung weist zu niedrige Kontrast auf, ist nur in ihren Grundzügen mittels Screenreader bedienbar.
+* Die Chatanwendung ist nicht immer mit der Tastatur bedienbar.
+## Alternativen
+Barrierefreie Alternativen sind z.B. die Kommandozeilenclients [matrix-commands](https://matrix.org/docs/projects/client/matrix-commander), [weechat-matrix](https://matrix.org/docs/projects/client/weechat-matrix) oder [gomuks](https://matrix.org/docs/projects/client/gomuks).
+## Kontakt 
+Sollten Ihnen Mängel in Bezug auf die barrierefreie Gestaltung auffallen, wenden Sie sich bitte an matrix@tu-dresden.de.
+## Durchsetzungsverfahren
+Wenn wir Ihre Rückmeldungen aus Ihrer Sicht nicht befriedigend bearbeiten, können Sie sich an die Sächsische Durchsetzungsstelle wenden:
+Beauftragter der Sächsischen Staatsregierung für die Belange von Menschen mit BehinderungenAlbertstraße 10, 01097 Dresden
+
+**Postanschrift**
+
+Archivstraße 1
+
+01097 Dresden
+
+E-Mail: info.behindertenbeauftragter@sk.sachsen.de
+
+Telefon: 0351 564-12161
+
+Fax: 0351 564-12169
+
+Webseite: https://www.inklusion.sachsen.de
+
+
+

content/clients/_index.en.md

@@ -0,0 +1,40 @@
+---
+title: "Clients / Installation"
+date: 2020-07-02T21:22:27+02:00
+draft: false
+chapter: true
+weight: 15
+---
+
+# Installation of a client / program
+
+The recommended client for using Matrix is called Element and can be used on different systems and devices:
+1. **Element Web:** [The TU Dresden browser web application](#web-app)
+1. **Element Desktop:** [Downloads for Linux/Windows/Mac](#desktop-app)
+1. **Element mobile:** [Android/iOS](#mobile-app)
+
+![Element page for client download](/images/12_Element-Download.png)
+
+## Element Web {#web-app}
+
+Web-App: {{% button href="https://matrix.tu-dresden.de" icon="fas fa-globe" %}}matrix.tu-dresden.de{{% /button %}}
+
+The easiest way is to open the Element Web application directly in a modern browser (e.g. [Mozilla Firefox](https://www.mozilla.org/de/firefox/)).
+
+Further information can be found in the submenu ["Element Web (Browser)"]({{< ref "clients/browser" >}} "Element Web (Browser)").
+
+## Element Desktop {#desktop-app}
+
+Downloads for: {{% button href="https://packages.riot.im/desktop/install/win32/x64/Element%20Setup.exe" icon="fas fa-download" %}}Windows{{% /button %}} {{% button href="https://packages.riot.im/desktop/install/macos/Element.dmg" icon="fas fa-download" %}}macOS{{% /button %}} {{% button href="/clients/install_linux" icon="fas fa-download" %}}Linux{{% /button %}}
+
+More recommendable than using a browser tab is the installation of the program Element on your own computer. Here you can keep the overview independently of the browser (however, you should also take care of the updates of the program).
+
+More information can be found in the submenu ["Element Desktop"]({{< ref "desktop.md" >}} "Element Desktop").
+
+## Element Mobile {#mobile-app}
+
+Downloads for: {{% button href="https://play.google.com/store/apps/details?id=im.vector.app" icon="fas fa-download" %}}Android (Google Play){{% /button %}} {{% button href="https://apps.apple.com/app/vector/id1083446067" icon="fas fa-download" %}}iOS (iPhone/iPad){{% /button %}} {{% button href="https://f-droid.org/packages/im.vector.app/" icon="fas fa-download" %}}Android (F-Driod){{% /button %}}
+
+To have access to Matrix on the road, there is the possibility to install a mobile element client on the smartphone.
+
+Further information can be found in the submenu ["Element Mobile"]({{< ref "mobile.md" >}} "Element Mobile").

content/clients/_index.md

@@ -0,0 +1,40 @@
+---
+title: "Clients / Installation"
+date: 2020-07-02T21:22:27+02:00
+draft: false
+chapter: true
+weight: 15
+---
+
+# Installation eines Clients / Programms
+
+Der empfohlene Client zur Nutzung von Matrix heißt Element und kann auf verschiedenen Systemen und Geräten genutzt werden:
+1. **Element Web:** [Die Browser-Web-App der TU Dresden](#web-app)
+2. **Element Desktop:** [Downloads für Linux/Windows/Mac](#desktop-app)
+3. **Element Mobil:** [Android/iOS](#mobile-app)
+
+[![Element Seite zum Download des Clients](/images/12_Element-Download.png)](https://element.io/get-started)
+
+## Element Web {#web-app}
+
+Zur Web-App: {{% button href="https://matrix.tu-dresden.de" icon="fas fa-globe" %}}matrix.tu-dresden.de{{% /button %}}
+
+Der einfachste Weg ist das direkte Öffnen der Element Web Anwendung in einem modernen Browser (z.B. [Mozilla Firefox](https://www.mozilla.org/de/firefox/)).
+
+Weitere Informationen sind im Untermenü ["Element Web (Browser)"]({{< ref "browser.md" >}} "Element Web (Browser)") zu finden.
+
+## Element Desktop {#desktop-app}
+
+Downloads für: {{% button href="https://packages.riot.im/desktop/install/win32/x64/Element%20Setup.exe" icon="fas fa-download" %}}Windows{{% /button %}} {{% button href="https://packages.riot.im/desktop/install/macos/Element.dmg" icon="fas fa-download" %}}macOS{{% /button %}} {{% button href="/clients/install_linux" icon="fas fa-download" %}}Linux{{% /button %}}
+
+Empfehlenswerter als die Nutzung eines Browsertabs ist jedoch die Installation des Programms Element auf dem eigenen Rechner. Hier kann unabhängig vom Browser der Überblick behalten werden (allerdings sollte man sich auch um die Aktualisierungen des Programms kümmern).
+
+Weitere Informationen sind im Untermenü ["Element Desktop"]({{< ref "desktop.md" >}} "Element Desktop") zu finden.
+
+## Element Mobil {#mobile-app}
+
+Downloads für: {{% button href="https://play.google.com/store/apps/details?id=im.vector.app" icon="fas fa-download" %}}Android (Google Play){{% /button %}} {{% button href="https://apps.apple.com/app/vector/id1083446067" icon="fas fa-download" %}}iOS (iPhone/iPad){{% /button %}} {{% button href="https://f-droid.org/packages/im.vector.app/" icon="fas fa-download" %}}Android (F-Driod){{% /button %}}
+
+Um unterwegs Zugriff auf Matrix zu haben, gibt es die Möglichkeit einen mobilen Element Client auf dem Smartphone zu installieren.
+
+Weitere Informationen sind im Untermenü ["Element Mobil"]({{< ref "mobile.md" >}} "Element Mobil") zu finden.