Initial commit

.gitignore

+/public
+.DS_Store
+resources

.gitmodules

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

README.md

+# TU Dresden Matrix Dokumentation
+**Website:** **https://doc.matrix.tu-dresden.de**

archetypes/default.md

+---
+title: "{{ replace .Name "-" " " | title }}"
+date: {{ .Date }}
+draft: true
+---
+

config.toml

+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"
\ No newline at end of file

content/_index.en.md

+---
+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

+---
+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

+---
+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

+---
+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

+---
+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

+---
+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.

content/clients/browser.en.md

+---
+title: "Element Web (Browser)"
+date: 2020-07-15T16:46:07+02:00
+draft: false
+chapter: true
+weight: 10
+---
+
+# Using the Element webclient
+Start here: [https://matrix.tu-dresden.de](https://matrix.tu-dresden.de) 
+
+![Start page of Element Webclient with login button](/images/01_Welcome_en.png)
+
+No registration is necessary, the service can be used immediately by clicking on "Register" on the homepage [https://matrix.tu-dresden.de](https://matrix.tu-dresden.de).
+
+![Login window with request to enter ZIH login and password](/images/02_Login1_en.png)
+
+The drop-down menu "Log in with:" should be left at "User name". Then the following entries must be made:
+
+**Username: ZIH-Login** (only the ZIH-Login, no e-mail address!)
+
+**Password: ZIH password**
+
+An alternative login, e.g. using the e-mail address, is **NOT** possible during the first, initial login, only after the second login.
+
+After the first login there is also no e-mail / confirmation mail.
+
+Analogous to e-mail addresses, this results in matrix addresses with the following structure:
+
+@ZIH-Login:tu-dresden.de
+
+{{% notice warning %}}
+If you want to start immediately with a [Matrix Client]({{{< relref "../clients" >}}) instead of the above mentioned website (Element Web-App installed at TU Dresden), it is important to change the home server from the usually default matrix.org to https://matrix.tu-dresden.de (shown in the following three screenshots)
+{{% /notice %}}
+
+![Change login page with focus on the homeserver Button](/images/02_Login2_en.png)
+
+1. click on change
+
+![input field to change the homeser with the input mstrix.tu-dresden.de](/images/02_Login3_en.png)
+
+2. mark the preset home server address and remove it
+
+![](/images/02_Login4_en.png)
+
+3. entry of the matrix home server address of the TU Dresden
+
+## Browser settings
+
+### Browser selection
+
+Recommended are the browsers [Firefox](https://www.mozilla.org/de/firefox/new/), [Chromium](https://www.chromium.org/getting-involved/download-chromium), newer versions of MS Edge (based on Chromium). Older or unsuitable browsers may only show a white page.
+
+### NoScript
+
+Many people use script blockers to protect themselves from [Tracking](https://tu-dresden.de/tu-dresden/newsportal/news/datenschutz-beim-website-tracking) and malware in the browser, for example with the addon [NoScript](https://addons.mozilla.org/de/firefox/addon/noscript/). Here you have to make the following settings (for the integration manager, e.g. Jitsi/Etherpad)
+
+![Browser plugin settings NoScript with tu-dresden.de and vector.im selected as trusted script sources](/images/10_Sicherheit2_en.png)
+
+### Cookies
+
+Do you also allow cookies from
+
+- tu-dresden.de
+- vector.im (for the integration manager)

content/clients/browser.md

+---
+title: "Element Web (Browser)"
+date: 2020-07-15T16:46:07+02:00
+draft: false
+chapter: true
+weight: 10
+---
+
+## Nutzung des Webclients
+
+Starten Sie auf [matrix.tu-dresden.de](https://matrix.tu-dresden.de).
+
+![Startseite von Element Webclient mit Anmeldebutton](/images/01_Welcome_de.png)
+
+Hierzu ist keine Registrierung nötig, der Dienst kann sofort durch Klick auf „Anmelden“ auf der Startseite [https://matrix.tu-dresden.de](https://matrix.tu-dresden.de) genutzt werden.
+
+![Loginfenster mit Aufforderung ZIH Login und Passwort einzugeben](/images/02_Login1_de.png)
+
+Das Dropdown-Menü „Anmelden mit:“ sollte auf „Benutzername“ belassen werden. Dann sind folgende Eingaben zu tätigen:
+
+**Benutzername: ZIH-Login**  (nur der ZIH-Login, keine E-Mail-Adresse!)
+
+**Passwort: ZIH-Passwort**
+
+Ein alternativer Login, bspw. über die E-Mail-Adresse ist **NICHT** beim ersten, initialen, Anmelden möglich, erst ab dem zweiten Einloggen.
+
+Es folgt nach dem Erstlogin auch keine E-Mail / Bestätigungsmail.
+
+Analog zu E-Mail-Adressen ergeben sich damit Matrix-Adressen folgender Struktur:
+
+@ZIH-Login:tu-dresden.de
+
+{{% notice warning %}}
+Sollten Sie statt mit der oben genannten Website (Element Web-App an der TU Dresden installiert) sofort mit einem [Matrix Client]({{< relref "../clients" >}}) starten wollen, ist es wichtig den Heimserver vom zumeist standardmäßig eingestellten matrix.org auf https://matrix.tu-dresden.de zu ändern (dargestellt in den folgenden drei Bildschirmfotos):
+{{% /notice %}}
+
+![Anmeldeseite mit Fokus auf dem Homeserver ändern Button](/images/02_Login2_de.png)
+
+1. Klick auf Ändern
+
+![Eingabefeld zum Ändern des Homeserers mit der Eingabe mstrix.tu-dresden.de](/images/02_Login3_de.png)
+
+2. Markieren der voreingestellten Heimserver-Adresse und entfernen dieser.
+
+![](/images/02_Login4_de.png)
+
+3. Eintragung der Matrix-Heimserver-Adresse der TU Dresden
+
+
+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/)) unter der Adresse: [https://matrix.tu-dresden.de](https://matrix.tu-dresden.de).
+
+![Willkommensbildschirm des TU Dresden Element Web Clients](/images/01_Welcome_de.png)
+
+## Browsereinstellungen
+
+### Browserwahl
+
+Empfehlenswert sind die Browser [Firefox](https://www.mozilla.org/de/firefox/new/), [Chromium](https://www.chromium.org/getting-involved/download-chromium), neuere Versionen von MS Edge (basierend auf Chromium). Ältere oder ungeeignete Browser zeigen ggf. nur eine weiße Seite an.
+
+### NoScript
+
+Viele Menschen nutzen u.a. Skript-Blocker, um sich vor [Tracking](https://tu-dresden.de/tu-dresden/newsportal/news/datenschutz-beim-website-tracking) und Schadsoftware im Browser zu schützen, bspw. mit dem Addon [NoScript](https://addons.mozilla.org/de/firefox/addon/noscript/). Hier sind folgende Einstellungen durchzuführen (für den Integrationsmanager, z.B. Jitsi/Etherpad)
+
+![Einstellungen des Browserplugins NoScript mit tu-dresden.de und vector.im als vertrauenswürdige Skriptquellen ausgewählt](/images/10_Sicherheit2_de.png)
+
+### Cookies
+
+Erlauben Sie auch Cookies von
+
+- tu-dresden.de
+- vector.im (für den Integrationsmanager)

content/clients/desktop.en.md

+---
+title: "Element Desktop"
+date: 2020-10-12T09:27:07+02:00
+draft: false
+chapter: true
+weight: 20
+---
+
+## Element Desktop
+
+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 %}}
+
+After a desktop installation, make sure to use the existing account with the ZIH login and not to create a new account on another server. Here the example of Element:
+
+![Selected login button in the element matrix client](/images/01_Login_en.png)
+
+This is done by clicking on **Change**. Then you will not accidentally end up on the wrong server...
+
+![Change login page with focus on the homeserver button](/images/02_Change-Homeserver_en.png)
+
+Now you can manually specify the home server: https://matrix.tu-dresden.de
+
+![Input field to change the home server with the input matrix.tu-dresden.de](/images/03_Set-Homeserver_en.png)
+
+Afterwards the one-time login with ZIH login and ZIH password must be carried out:
+
+![Login window with request to enter ZIH login and password](/images/04_Username_en.png)
+
+By activating the slider under Settings > Settings > "**Automatic start after system login**", the element client starts after every reboot and you no longer miss any notifications due to accidentally closing the browser tab in the usage variant with the Web App.
+
+![settings marked with the dot start automatically after system startup](/images/05_Settings_en.png)

content/clients/desktop.md

+---
+title: "Element Desktop"
+date: 2020-10-12T09:27:07+02:00
+draft: false
+chapter: true
+weight: 5
+---
+
+## Element Desktop
+
+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 %}}
+
+Nach einer Desktop-Installation ist darauf zu achten, den bestehenden Account mit dem ZIH-Login zu nutzen, und keinen neuen Account auf einem anderen Server zu erstellen. Hier am Beispiel von Element:
+
+![Markierter Anmeldebutton im Element Matrixclient](/images/01_Login_de.png)
+
+Dies wird durch Klick auf **Ändern** realisiert. Dann landet man nicht versehentlich auf einem falschen Server...
+
+![Anmeldeseite mit Fokus auf dem Homeserver ändern Button](/images/02_Change-Homeserver_de.png)
+
+Nun kann man manuell die Angabe des Heimservers durchführen: https://matrix.tu-dresden.de
+
+![Eingabefeld zum Ändern des Homeservers mit der Eingabe matrix.tu-dresden.de](/images/03_Set-Homeserver_de.png)
+
+Anschließend ist der einmalige Login mit ZIH-Login und ZIH-Passwort durchzuführen:
+
+![Loginfenster mit Aufforderung ZIH Login und Passwort einzugeben](/images/04_Username_de.png)
+
+Mit der Aktivierung des Schiebereglers unter Einstellungen > Einstellungen > „**Nach System-Login automatisch starten**“ startet der Element-Client nach jedem Neustart und man verpasst keine Benachrichtigungen mehr durch ein versehentliches Schließen des Browser-Tabs in der Nutzungsvariante mit der Web-App.
+
+![Einstellungen mit dem Punkt nach Systemstart automatisch starten makiert](/images/05_Settings_de.png)

content/clients/install_linux.en.md

+---
+title: "Install on Linux"
+date: 2020-12-31T09:29:07+02:00
+draft: false
+chapter: true
+weight: 60
+---
+# Install Element Desktop on Linux
+We recommend using the package manager of your System to install Element Desktop. The following commands will install element desktop. You can enter them on the commandline.
+
+### Debian/Ubuntu
+```sh
+sudo apt install -y wget apt-transport-https
+
+sudo wget -O /usr/share/keyrings/riot-im-archive-keyring.gpg https://packages.riot.im/debian/riot-im-archive-keyring.gpg
+
+echo "deb [signed-by=/usr/share/keyrings/riot-im-archive-keyring.gpg] https://packages.riot.im/debian/ default main" | sudo tee /etc/apt/sources.list.d/riot-im.list
+
+sudo apt update
+
+sudo apt install element-desktop
+```
+### Fedora
+```sh
+sudo dnf install -y dnf-plugins-core distribution-gpg-keys
+sudo dnf copr enable taw/element
+sudo dnf install -y element --refresh
+```
+### Arch Linux