mirror of
https://github.com/maxkratz/Dokumentation.git
synced 2024-09-21 01:59:21 +00:00
Initial commit
This commit is contained in:
commit
e636409d56
207 changed files with 11774 additions and 0 deletions
3
.gitignore
vendored
Normal file
3
.gitignore
vendored
Normal file
|
@ -0,0 +1,3 @@
|
|||
/public
|
||||
.DS_Store
|
||||
resources
|
3
.gitmodules
vendored
Normal file
3
.gitmodules
vendored
Normal file
|
@ -0,0 +1,3 @@
|
|||
[submodule "themes/learn"]
|
||||
path = themes/learn
|
||||
url = https://github.com/matcornic/hugo-theme-learn.git
|
2
README.md
Normal file
2
README.md
Normal file
|
@ -0,0 +1,2 @@
|
|||
# TU Dresden Matrix Dokumentation
|
||||
**Website:** **https://doc.matrix.tu-dresden.de**
|
6
archetypes/default.md
Normal file
6
archetypes/default.md
Normal file
|
@ -0,0 +1,6 @@
|
|||
---
|
||||
title: "{{ replace .Name "-" " " | title }}"
|
||||
date: {{ .Date }}
|
||||
draft: true
|
||||
---
|
||||
|
31
config.toml
Normal file
31
config.toml
Normal file
|
@ -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"
|
74
content/_index.en.md
Normal file
74
content/_index.en.md
Normal file
|
@ -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 %}}
|
73
content/_index.md
Normal file
73
content/_index.md
Normal file
|
@ -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 %}}
|
48
content/accessibility/_index.en.md
Normal file
48
content/accessibility/_index.en.md
Normal file
|
@ -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
|
||||
|
||||
|
||||
|
48
content/accessibility/_index.md
Normal file
48
content/accessibility/_index.md
Normal file
|
@ -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
|
||||
|
||||
|
||||
|
40
content/clients/_index.en.md
Normal file
40
content/clients/_index.en.md
Normal file
|
@ -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").
|
40
content/clients/_index.md
Normal file
40
content/clients/_index.md
Normal file
|
@ -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.
|
65
content/clients/browser.en.md
Normal file
65
content/clients/browser.en.md
Normal file
|
@ -0,0 +1,65 @@
|
|||
---
|
||||
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)
|
71
content/clients/browser.md
Normal file
71
content/clients/browser.md
Normal file
|
@ -0,0 +1,71 @@
|
|||
---
|
||||
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)
|
31
content/clients/desktop.en.md
Normal file
31
content/clients/desktop.en.md
Normal file
|
@ -0,0 +1,31 @@
|
|||
---
|
||||
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)
|
31
content/clients/desktop.md
Normal file
31
content/clients/desktop.md
Normal file
|
@ -0,0 +1,31 @@
|
|||
---
|
||||
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)
|
36
content/clients/install_linux.en.md
Normal file
36
content/clients/install_linux.en.md
Normal file
|
@ -0,0 +1,36 @@
|
|||
---
|
||||
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
|
||||
```sh
|
||||
sudo pacman -Sy element-desktop
|
||||
```
|
||||
### NixOS
|
||||
```sh
|
||||
nix-env -iA nixos.element-desktop
|
||||
```
|
36
content/clients/install_linux.md
Normal file
36
content/clients/install_linux.md
Normal file
|
@ -0,0 +1,36 @@
|
|||
---
|
||||
title: "Installation unter Linux"
|
||||
date: 2020-12-31T09:29:07+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
weight: 60
|
||||
---
|
||||
# Installation von Element Desktop unter Linux
|
||||
Wir empfehlen das Installieren des Clients über die Paketverwaltung der jeweiligen Distrubution. Die folgenden Befehle installieren den Element Desktop Client über die Kommandozeile.
|
||||
|
||||
### 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
|
||||
```sh
|
||||
sudo pacman -Sy element-desktop
|
||||
```
|
||||
### NixOS
|
||||
```sh
|
||||
nix-env -iA nixos.element-desktop
|
||||
```
|
17
content/clients/mobile.en.md
Normal file
17
content/clients/mobile.en.md
Normal file
|
@ -0,0 +1,17 @@
|
|||
---
|
||||
title: "Element Mobile"
|
||||
date: 2020-10-12T09:29:07+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
weight: 30
|
||||
---
|
||||
|
||||
## Element Mobile
|
||||
|
||||
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 %}}
|
||||
|
||||
The following series of images shows screenshots of the setup of Android or iOS Element:
|
||||
|
||||
![Screenshot of the login procedure under Android/iOS](/images/15_Android1_en.png)
|
||||
|
||||
![Screenshot of the Android client element after successful login](/images/15_Android2_en.png)
|
17
content/clients/mobile.md
Normal file
17
content/clients/mobile.md
Normal file
|
@ -0,0 +1,17 @@
|
|||
---
|
||||
title: "Element Mobil"
|
||||
date: 2020-10-12T09:29:07+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
weight: 30
|
||||
---
|
||||
|
||||
## Element Mobil
|
||||
|
||||
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 %}}
|
||||
|
||||
Die folgende Bilderreihe zeigt Bildschirmfotos der Einrichtung von Android oder iOS Element:
|
||||
|
||||
![Screenshot der Anmeldeprozedur unter Android/iOS](/images/15_Android1_de.png)
|
||||
|
||||
![Screenshot des Element Androidclients nach erfolgreichem Einloggen](/images/15_Android2_de.png)
|
13
content/clients/more_clients.en.md
Normal file
13
content/clients/more_clients.en.md
Normal file
|
@ -0,0 +1,13 @@
|
|||
---
|
||||
title: "More clients"
|
||||
date: 2020-07-02T21:22:27+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
---
|
||||
|
||||
# More clients
|
||||
|
||||
For users who like to experiment, there are numerous other clients in addition to Element, with which the Matrix communication protocol can be used:
|
||||
|
||||
- https://matrix.org/docs/projects/clients-matrix
|
||||
- https://matrix.org/docs/projects/try-matrix-now
|
13
content/clients/more_clients.md
Normal file
13
content/clients/more_clients.md
Normal file
|
@ -0,0 +1,13 @@
|
|||
---
|
||||
title: "Weitere Clients"
|
||||
date: 2020-07-02T21:22:27+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
---
|
||||
|
||||
# Weitere Clients
|
||||
|
||||
Für experimentierfreudige Nutzende gibt es neben Element noch zahlreiche weitere Clients, mit denen das Kommunikationsprotokoll Matrix genutzt werden kann:
|
||||
|
||||
- https://matrix.org/docs/projects/clients-matrix
|
||||
- https://matrix.org/docs/projects/try-matrix-now
|
32
content/communities/_index.en.md
Normal file
32
content/communities/_index.en.md
Normal file
|
@ -0,0 +1,32 @@
|
|||
---
|
||||
title: "Communities"
|
||||
date: 2020-07-02T21:22:34+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
weight: 50
|
||||
---
|
||||
|
||||
# Use communities as room filters
|
||||
|
||||
All matrix users of the client element (and a few other clients) can use communities to filter different rooms, which may be lost or scattered in the room list on the left.
|
||||
|
||||
Communities can only be created for yourself or for others (if you invite them into a community) and create a superordinate structure for rooms. For example, for a semester group/study group or for a chair team etc.
|
||||
|
||||
Existing rooms can be assigned to a community in the community settings (under #).
|
||||
|
||||
![Screenshot of the selection of the current community](/images/20_Communities.webp)
|
||||
|
||||
A community created with the + button can be drag'n'dropped from the community avatar (little picture) onto the sidebar.
|
||||
|
||||
A small HTML page can be used to describe the community.
|
||||
|
||||
Unfortunately it is currently not possible to add more administrators through the matrix client: [https://github.com/vector-im/element-web/issues/5240](https://github.com/vector-im/element-web/issues/5240)
|
||||
|
||||
Removing rooms from communities is done by clicking on the hash # in the upper right corner, then clicking on the room to be removed and then clicking on "Remove from community".
|
||||
|
||||
A community can be deleted when the administrator leaves it.
|
||||
|
||||
### other administrators
|
||||
|
||||
Currently no more administrators can be added to a community via Element. Issue on Github](https://github.com/vector-im/riot-web/issues/5240) If you need more administrators in a community, they can be added by the Matrix Admin Team. Please send a support request to servicedesk@tu-dresden.de.
|
||||
|
32
content/communities/_index.md
Normal file
32
content/communities/_index.md
Normal file
|
@ -0,0 +1,32 @@
|
|||
---
|
||||
title: "Communities"
|
||||
date: 2020-07-02T21:22:34+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
weight: 50
|
||||
---
|
||||
|
||||
# Communities als Raum-Filter einsetzen
|
||||
|
||||
Alle Matrix-Nutzenden des Clients Element (und einiger weniger weiterer Clients) können Communities (zu deutsch Gemeinschaften) nutzen, um verschiedene Räume zu filtern, die in der Raumliste links vllt. untergehen oder zu verstreut platziert sind.
|
||||
|
||||
Communities können nur für sich selbst oder für Andere erstellt werden (wenn man diese in eine Community einlädt) und schaffen eine übergeordnete Struktur für Räume. Bspw. für eine Semestergruppe/Studiengruppe oder für ein Lehrstuhlteam etc.
|
||||
|
||||
Bestehende Räume können einer Community in den Community-Einstellungen zugewiesen werden (unter #).
|
||||
|
||||
![Screenshot der Auswahl der aktuellen Community](/images/20_Communities.webp)
|
||||
|
||||
Eine über den + Knopf erstellte Community kann per Drag'n'Drop des Community-Avatares (Bildchens) auf die Seitenleiste gezogen werden.
|
||||
|
||||
Eine kleine HTML-Seite kann zur Communitybeschreibung benutzt werden.
|
||||
|
||||
Leider ist derzeit das hinzufügen von weiteren Administratoren durch den Matrixclient nicht möglich: [https://github.com/vector-im/element-web/issues/5240](https://github.com/vector-im/element-web/issues/5240)
|
||||
|
||||
Das Entfernen von Räumen aus Communities geht durch Klick auf die Raute # oben rechts, einem anschließenden Klick auf den zu entfernenden Raum und dann dem Klick auf „Aus der Community entfernen“.
|
||||
|
||||
Eine Community kann gelöscht werden, wenn die administrierende Person diese verlässt.
|
||||
|
||||
### weitere Administratoren
|
||||
|
||||
Über Element können aktuell keine weiteren Administratoren zu einer Community hinzugefügt werden. [Issue auf Github](https://github.com/vector-im/riot-web/issues/5240) Wenn Sie weitere Adminstratoren in einer Community benötigen, können diese durch das Matrix Admin Team hinzugefügt werden. Schreiben Sie dazu bitte eine Supportanfrage an servicedesk@tu-dresden.de.
|
||||
|
28
content/development/_index.en.md
Normal file
28
content/development/_index.en.md
Normal file
|
@ -0,0 +1,28 @@
|
|||
---
|
||||
title: "Development"
|
||||
date: 2020-07-03T13:15:20+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
weight: 200
|
||||
---
|
||||
|
||||
# Further development of Matrix
|
||||
|
||||
Currently the TU Dresden does not pay for the use of the source code. The Matrix-Admin-Team is in contact with the developers and occasionally contributes small things to the further development.
|
||||
|
||||
Matrix is an open standard, the details of interoperable communication using the matrix set of HTTP-APIs are freely published. Matrix is also open source, which means that the source code of the reference servers, clients and services has been released to the public under the Apache v2 license to encourage everyone to run their own servers and clients.
|
||||
|
||||
![free software banner](/images/free-software-likes-you-and-your-freedom.webp)
|
||||
|
||||
Since it is free software, improvement requests can be converted into direct programming jobs.
|
||||
|
||||
Currently still in development, and can be promoted/accelerated by orders/donations, are among others
|
||||
|
||||
* chat export
|
||||
* Threading (more clearly arranged discussions)
|
||||
* personal status
|
||||
* various integrations / bots / bridges
|
||||
|
||||
Discussions on the topic can be held in Matrix@TUD.
|
||||
|
||||
|
28
content/development/_index.md
Normal file
28
content/development/_index.md
Normal file
|
@ -0,0 +1,28 @@
|
|||
---
|
||||
title: "Weiterentwicklung"
|
||||
date: 2020-07-03T13:15:20+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
weight: 200
|
||||
---
|
||||
|
||||
# Weiterentwicklung von Matrix
|
||||
|
||||
Zur Zeit bezahlt die TU Dresden nicht für die Nutzung des Quellcodes. Das Matrix-Admin-Team steht in Kontakt mit den Entwickelnden und trägt gelegentlich Kleinigkeiten zur Weiterentwicklung bei.
|
||||
|
||||
Matrix ist ein offener Standard, die Details zur interoperablen Kommunikation unter Verwendung des Matrix-Sets der HTTP-APIs sind frei veröffentlicht. Matrix ist auch quelloffen, was bedeutet, dass der Quellcode der Referenz-Server, -Clients und -Dienste unter der Apache-Lizenz v2 für die Öffentlichkeit freigegeben wurde, um jede und jeden dazu zu ermutigen, ihre eigenen Server und Clients zu betreiben.
|
||||
|
||||
![free software banner](/images/free-software-likes-you-and-your-freedom.webp)
|
||||
|
||||
Da es sich um freie Software handelt, können Verbesserungswünsche in direkte Programmieraufträge umgewandelt werden.
|
||||
|
||||
Aktuell noch in der Entwicklung, und durch Aufträge/Spenden förderbar/beschleunigbar, sind u.a.
|
||||
|
||||
* Chat-Export
|
||||
* Threading (übersichtlicher gestaltete Diskussionen)
|
||||
* persönlichen Status setzen
|
||||
* verschiedenste Integrationen / Bots / Bridges
|
||||
|
||||
Diskussionen zu dem Thema können in Matrix@TUD durchgeführt werden.
|
||||
|
||||
|
68
content/encryption/_index.en.md
Normal file
68
content/encryption/_index.en.md
Normal file
|
@ -0,0 +1,68 @@
|
|||
---
|
||||
title: "Encryption"
|
||||
date: 2020-07-03T13:20:58+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
weight: 60
|
||||
---
|
||||
|
||||
# Use of end-to-end encryption
|
||||
|
||||
1:1 calls are now encrypted end-to-end by default. Therefore, a configured key backup as well as a verification of all self used client devices is recommended ([Important settings]({{{< ref "settings" >}}))
|
||||
|
||||
The decision whether a created room should be encrypted in this way must be well thought out and cannot be undone. If the room is large or public, checking all keys of all interlocutors could take a lot of time. But this manual check can be done later on occasion and end-to-end encrypted conversations can be started directly with blind trust for the time being.
|
||||
|
||||
![Create new room with activated encryption](/images/01_Create-Room-wE2E_en.png)
|
||||
|
||||
If you want end-to-end encryption (E2EE) to interlocutor:inside in an unencrypted room, you can achieve this by clicking on the settings of the desired room. (or in the room via "Room info" > "Room settings" in the upper right corner):
|
||||
|
||||
![Menu to get to the room settings](/images/02_Roomsettings_en.png)
|
||||
|
||||
To do this, move the Encrypted slider on the Security & Privacy tab:
|
||||
|
||||
![Enable encryption in the room settings](/images/03_Roome2e_en.png)
|
||||
|
||||
This can be confirmed with OK. From now on the messages can only be read by those involved in the conversation. If you have not set up a key protection in the settings before, you should do this now (see [Important settings]({{{< ref "settings" >}})) to be able to read earlier and in absence received messages.
|
||||
|
||||
Now the encrypted exchange can begin. If you want to verify the correctness of the keys and to document this trustworthiness digitally, you first have to unfold the sidebar by clicking on the person symbol in the upper right corner:
|
||||
|
||||
![open the list of persons in the room](/images/04_RoomPeople_en.png)
|
||||
|
||||
The contact person can now be clicked on in the opening bar of the participants in the conversation:
|
||||
|
||||
![room with note that not all participants are verified](/images/05_People-Unverified_en.png)
|
||||
|
||||
The bar now shows the conversation person in detail. Here a key verification can be initiated by clicking on "Verify". By clicking on "Start Verification" the other side is notified and after confirmation (see next picture) the "Verification by Emojis" can start.
|
||||
|
||||
![Menu to the person to verify selected with the verify button](/images/06_E2EE_Verify_en.png)
|
||||
|
||||
![Menu to start the verification](/images/07_E2EE_Accept_en.png)
|
||||
|
||||
This verification should be done with the contact person by comparison (e.g. verbally via telephone, in the same room or other medium). Since this is not always easy, the trust can also be expressed first of all (otherwise you will be asked again and again to carry out the verification) and carried out on occasion (e.g. at the next meeting).
|
||||
|
||||
A detailed description of the topic can be found in this [video by Prof. Plikat](https://invidious.ggc-project.de/VOxfa6dqXSk) and [in this Matrix blog article](https://blog.riot.im/e2e-encryption-by-default-cross-signing-is-here).
|
||||
|
||||
The adjustment itself is done via emoji images or QR codes, which can look different depending on the device and icon pack. Also the translation of all interface elements into German is not 100% available.
|
||||
|
||||
![Emoji comparison to verify the key exchange](/images/16_E2EE.png)
|
||||
|
||||
This is done analogously in rooms with several participants, each one individually.
|
||||
|
||||
![verification process was successful](/images/08_Verified_en.png)
|
||||
|
||||
In the respective room rows the following symbols indicate the status of the encryption and the corresponding verification:
|
||||
|
||||
![symbol for at least one non-verified person](/images/gray.png)
|
||||
|
||||
At least one person in the room has not yet been verified.
|
||||
|
||||
![symbol for a verified person who has opened unverified sessions](/images/unverified.png)
|
||||
|
||||
There is at least one person in the room who has already been verified, but who in turn has opened further unverified sessions.
|
||||
|
||||
![symbol for all persons in the room are verified](/images/green.png)
|
||||
|
||||
All persons in the room were verified.
|
||||
|
||||
|
||||
|
68
content/encryption/_index.md
Normal file
68
content/encryption/_index.md
Normal file
|
@ -0,0 +1,68 @@
|
|||
---
|
||||
title: "Verschlüsselung"
|
||||
date: 2020-07-03T13:20:58+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
weight: 60
|
||||
---
|
||||
|
||||
# Ende-zu-Ende-Verschlüsselung nutzen
|
||||
|
||||
1:1 Gespräche sind seit Kurzem standardmäßig Ende-zu-Ende-verschlüsselt. Daher wird eine eingerichtete Schlüsselsicherung sowie eine Verifikation aller selbst eingesetzten Client-Geräte empfohlen ([Wichtige Einstellungen]({{< ref "settings" >}}))
|
||||
|
||||
Die Entscheidung, ob ein erzeugter Raum derartig verschlüsselt werden soll muss gut überlegt sein und kann nicht mehr rückgängig gemacht werden. Wenn es sich um größere oder öffentliche Räume handelt, könnte das Prüfen aller Schlüssel aller Gesprächspartner viel Zeit in Anspruch nehmen. Diese manuelle Prüfung kann man aber auch später bei Gelegenheit durchführen und auch direkt Ende-zu-Ende-verschlüsselte Gespräche mit vorerst blindem Vertrauen starten.
|
||||
|
||||
![Neuen Raum mit aktivierter Verschlüsselung erstellen](/images/01_Create-Room-wE2E_de.png)
|
||||
|
||||
Wer in einem unverschlüsselten Raum eine Ende-zu-Ende-Verschlüsselung (E2EE) zu Gesprächspartner:innen wünscht, erreicht dies durch Klick auf die Einstellungen des gewünschten Raums. (bzw. im Raum über "Raum-Info" > "Raum-Einstellungen" oben rechts):
|
||||
|
||||
![Menü um zu den Raumeinstellungen zu gelangen](/images/02_Roomsettings_de.png)
|
||||
|
||||
Dazu ist im Reiter Sicherheit & Datenschutz der Schieberegler Verschlüsselt zu bewegen:
|
||||
|
||||
![Verschlüsselung in den Raumeinstellungen aktivieren](/images/03_Roome2e_de.png)
|
||||
|
||||
Dies kann mit OK bestätigt werden. Ab sofort können die Nachrichten nur noch von den am Gespräch Beteiligten gelesen werden. Sofern nicht schon vorab in den Einstellungen eine Schlüsselsicherung eingerichtet wurde, so sollte dies nun durchgeführt werden (siehe [Wichtige Einstellungen]({{< ref "settings" >}})), um frühere und in Abwesenheit empfangene Nachrichten lesen zu können.
|
||||
|
||||
Nun kann der verschlüsselte Austausch beginnen. Wenn man sich von der Korrektheit der Schlüssel überzeugen, und diese Vertrauenswürdigkeit digital dokumentieren möchte, ist dazu zuerst auf das Personensymbol oben rechts die Seitenleiste auszuklappen:
|
||||
|
||||
![öffnen der Personenliste in dem Raum](/images/04_RoomPeople_de.png)
|
||||
|
||||
In der sich öffnenden Leiste der am Gespräch Beteiligten kann nun auf die Kontaktperson geklickt werden:
|
||||
|
||||
![Raum mit Hinweis, dass nicht alle eilnehmenden verifiziert sind.](/images/05_People-Unverified_de.png)
|
||||
|
||||
Die Leiste zeigt jetzt die Gesprächsperson im Detail an. Hier ist eine Schlüsselverifikation durch Klick auf „Verifizieren“ einleitbar. Durch einen Klick auf "Start Verifikation" wird die Gegenseiten benachtigt und nach Bestätigung (siehe nächstes Bild) kann die "Verifizierung durch Emojis" beginnen.
|
||||
|
||||
![Menü zu der zu verifizierenden Person mit dem Verifizieren-Knopf ausgewählt](/images/06_E2EE_Verify_de.png)
|
||||
|
||||
![Menü zum starten der Verifikation](/images/07_E2EE_Accept_de.png)
|
||||
|
||||
Diese Verifizierung sollte mit der Kontaktperson durch Abgleich (z.B. mündlichen via Telefon, im selben Zimmer o.a. Medium) geschehen. Da dies nicht immer leicht ist, kann auch ersteinmal das Vertrauen ausgesprochen werden (sonst wird man immer wieder gefragt, die Verifizierung durchzuführen) und bei Gelegenheit (bspw. beim nächsten Meeting) durchzuführen.
|
||||
|
||||
Eine ausführliche Darstellung des Themas findet sich in diesem [Video von Prof. Plikat](https://invidious.ggc-project.de/VOxfa6dqXSk) sowie [im diesem Matrix-Blogartikel](https://blog.riot.im/e2e-encryption-by-default-cross-signing-is-here).
|
||||
|
||||
Der Abgleich selbst geschieht über Emoji-Bildchen oder QR-Codes, die je nach Gerät und Iconpack verschieden aussehen können. Auch ist die Übersetzung aller Oberflächenelemente ins Deutsche nicht 100%-ig vorhanden.
|
||||
|
||||
![Emojivergleich zum verifizieren des Schlüsselaustauschs](/images/16_E2EE.png)
|
||||
|
||||
Analog geschieht dies in Räumen mit mehreren Teilnehmenden, jeweils einzeln.
|
||||
|
||||
![Verifikationsprozess war erfolgreich](/images/08_Verified_de.png)
|
||||
|
||||
In den jeweiligen Raumzeilen deuten folgende Symbole den Status der Verschlüsselung und der dazugehörigen Verifikation an:
|
||||
|
||||
![Symbol für mindestens eine nicht-verifizierte Person](/images/gray.png)
|
||||
|
||||
Mindestens eine Person im Raum wurde noch nicht verifiziert.
|
||||
|
||||
![Symbol für eine verifizierte Person, die unverifizierte Sitzungen geöffnet hat](/images/unverified.png)
|
||||
|
||||
Im Raum ist mindestens eine Person, die bereits verifiziert wurde, aber die ihrerseits weitere unverifizierte Sitzungen geöffnet hat.
|
||||
|
||||
![Symbol für alle Personen im Raum sind verifiziertß](/images/green.png)
|
||||
|
||||
Alle im Raum befindlichen Personen wurden verifiziert.
|
||||
|
||||
|
||||
|
76
content/faq/_index.en.md
Normal file
76
content/faq/_index.en.md
Normal file
|
@ -0,0 +1,76 @@
|
|||
---
|
||||
menutitle: "FAQ"
|
||||
title: "Frequently asked questions"
|
||||
date: 2020-08-02T21:26:25+02:00
|
||||
draft: false
|
||||
weight: 200
|
||||
---
|
||||
This is a collection of frequently asked questions and their answers. Some of the answers are not yet written. In these cases please ask in the matrix room ```#matrix-support:tu-dresden.de```.
|
||||
|
||||
* [What is the difference between passphrase and recovery key?](#securityphrase-vs-securitykey)
|
||||
* [Why is there no status bar at the bottom of the screen when hovering over hyperlinks in the Desktop-Client element? How can you trust them then?](#no-statusline)
|
||||
* [How to tell people a room address with Element Desktop Client?](#desktop-share-room)
|
||||
* [How do you tell people a room address with Element Web-Client?](#web-share-room)
|
||||
* [Can I write LaTeX?](#latex)
|
||||
* [Are there something like Threads (like in Mattermost/Slack) in Matrix?](#threads)
|
||||
* [How do I change the passphrase for my key backup?](##change-securityphrase)
|
||||
* [How do I reset the key backup if I have lost my passphrase AND my (saved and printed) recovery key?](#reset-securityphrase)
|
||||
* [Why is there no room "TU Dresden"? Who is allowed to create it?](#no-tud-room)
|
||||
* [How can I, as the administrator, delete many messages at once?](#delete-multiple-messages)
|
||||
* [Sometimes I see a room marked in bold and click on it, but I don't have the time to edit the content and any consequences for me immediately. How can I mark the room as "unread" again?](#mark-room-as-unread)
|
||||
* [What should I do if video or audio in a video conference does not work on a MacOS?](#apple-no-video)
|
||||
* [How many people can be invited at ones into a room? Can I invite people by their E-Mail address?](#how-many-invites-can-i-do)
|
||||
* [Can I modify access permissions for all rooms in my community, that only members of the community can enter?](#roompermissions-in-communities)
|
||||
|
||||
***
|
||||
#### What is the difference between passphrase and recovery key? {#securityphrase-vs-securitykey}
|
||||
The password that can access the key backup is called the recovery key and is very long, starts with a capital E and should be saved or printed after setup. Since this password is hard to remember in everyday life (e.g. when you are on the road, want to have a look at Matrix, but only have access to other computers) you can think of a (easy to remember) passphrase from which the recovery key can be calculated (in the browser/client) before trying to "open" the key backup.
|
||||
|
||||
***
|
||||
#### Why is there no status bar at the bottom of the screen when hovering over hyperlinks in the Desktop-Client element? How can you trust them then? {#no-statusline}
|
||||
In fact, the status bar is a popular test of the seriousness of hyperlinks you are trying to click on. In the Desktop Client element this is not possible, similar to the mobile clients. Here you can only right-click on the link and check the presented target page for seriousness.
|
||||
|
||||
***
|
||||
#### How to tell people a room address with Element Desktop Client? {#desktop-share-room}
|
||||
With the matrix.to link, which you can see under the i for the room properties and another click on "Share room".
|
||||
|
||||
***
|
||||
#### How do you tell people a room address with Element Web-Client? {#web-share-room}
|
||||
With the matrix.to link, which you can see under the i for the room properties and a further click on "Part room" and an exchange of the front matrix.to with matrix.tu-dresden.de
|
||||
|
||||
***
|
||||
#### Can I write LaTeX? {#latex}
|
||||
No, but there is a workaround: include CodiMD as CustomWidget. Native will work soon, see https://github.com/vector-im/element-web/issues/1945
|
||||
|
||||
***
|
||||
#### Are there something like Threads (like in Mattermost/Slack) in Matrix? {#threads}
|
||||
No, threads like in Mattermost or Slack are currently not existing in Matrix. The developers of Element are aware of this topic and planed it for future release. To get more information, follow their roadmap: https://github.com/vector-im/roadmap/projects/1
|
||||
|
||||
***
|
||||
#### How do I change the passphrase for my key backup? {##change-securityphrase}
|
||||
|
||||
***
|
||||
#### How do I reset the key backup if I have lost my passphrase AND my (saved and printed) recovery key? {#reset-securityphrase}
|
||||
|
||||
***
|
||||
#### Why is there no room "TU Dresden"? Who is allowed to create it? {#no-tud-room}
|
||||
All persons creating a room are administrative persons and are responsible for the room. Matrix is not yet designed for the exchange of thousands of members at the university. Should a central room be needed one day, its establishment and maintenance would certainly be the responsibility of the Rectorate and the Department of "Strategy & Communication".
|
||||
|
||||
***
|
||||
#### How can I, as the administrator, delete many messages at once? {#delete-multiple-messages}
|
||||
|
||||
***
|
||||
#### Sometimes I see a room marked in bold and click on it, but I don't have the time to edit the content and any consequences for me immediately. How can I mark the room as "unread" again? {#mark-room-as-unread}
|
||||
Unfortunately this is not possible in Element. As a workaround, you can mark the room as a favorite and notice yourself that your own favorites should be looked at again.
|
||||
|
||||
***
|
||||
#### What should I do if video or audio in a video conference does not work on a MacOS? {#apple-no-video}
|
||||
Often Element does not have the rights to access the webcam and microphone. These can be assigned in the system settings under Security and Privacy.
|
||||
|
||||
***
|
||||
#### How many people can be invited at ones into a room? Can I invite people by their E-Mail address? {#how-many-invites-can-i-do}
|
||||
Mass invite by E-Mail is currently not supported in Element. If you want to mass invite, please send an request via the servicedesk, so we can assist. You can invite 100 people by their ZIH username yourself.
|
||||
|
||||
***
|
||||
#### Can I modify access permissions for all rooms in my community, that only members of the community can enter? {#roompermissions-in-communities}
|
||||
No, this is not possible. Rooms can be part of multiple communities. Therefore the access permission will be set on room based level.
|
71
content/faq/_index.md
Normal file
71
content/faq/_index.md
Normal file
|
@ -0,0 +1,71 @@
|
|||
---
|
||||
menutitle: "Häufige Fragen (FAQ)"
|
||||
title: "Häufig gestellte Fragen"
|
||||
date: 2020-08-02T21:26:25+02:00
|
||||
draft: false
|
||||
weight: 200
|
||||
---
|
||||
Dies ist eine Zusammenstellung häufiger Fragen und deren Antworten. Teilweise sind die Antworten noch nicht formuliert. In diesen Fällen bitte im Raum ```#matrix-support:tu-dresden.de``` nachfragen.
|
||||
|
||||
* [Was ist der Unterschied zwischen Sicherheitsphrase und Sicherheitsschlüssel?](#securityphrase-vs-securitykey)
|
||||
* [Warum sieht man im Element Desktop-Client keine Statuszeile am unteren Ende des Bildschirms wenn man über Hyperlinks hovert (= Maus drüber bewegt und verweilt)? Wie kann man diesen dann vertrauen?](#no-statusline)
|
||||
* [Wie teilt man Leuten mit Element Desktop-Client eine Raumadresse mit?](#desktop-share-room)
|
||||
* [Wie teilt man Leuten mit Element Web-Client eine Raumadresse mit?](#web-share-room)
|
||||
* [Kann ich LaTeX schreiben?](#latex)
|
||||
* [Gibt es sowas wie Threads (vgl. Mattermost/Slack) in Matrix?](#threads)
|
||||
* [Wie ändere ich die Sicherheitsphrase für meine Schlüsselsicherung?](#change-securityphrase)
|
||||
* [Wie kann ich die Schlüsselsicherung zurücksetzen, wenn ich meine Sicherheitsphrase UND meinen (abgespeicherten und ausgedruckten) Sicherheitsschlüssel verloren habe?](#reset-securityphrase)
|
||||
* [Warum gibt es keinen Raum „TU Dresden“? Wer dürfte ihn erstellen?](#no-tud-room)
|
||||
* [Wie kann ich als administrierende Person viele Nachrichten auf einmal löschen?](#delete-multiple-messages)
|
||||
* [Manchmal sehe ich einen fett markierten Raum und klicke ihn an, habe aber doch nicht die Zeit, den Inhalt und etwaige Konsequenzen für mich sofort zu bearbeiten. Wie kann ich den Raum wieder als „ungelesen“ markieren?](#mark-room-as-unread)
|
||||
* [Was muss ich tun, wenn auf einem MacOS Video oder Audio in einer Videokonferenz nicht funktioniert.](#apple-no-video)
|
||||
* [Wie viele Personen können gleichzeitig in einen Raum eingeladen werden? Kann ich Personen über ihre E-Mail-Adressen einladen?](#how-many-invites-can-i-do)
|
||||
* [Kann ich die Beitrittsrechte aller Räume meiner Community so anpassen, dass nur Mitglieder der Community Zutritt haben?](#roompermissions-in-communities)
|
||||
|
||||
***
|
||||
#### Was ist der Unterschied zwischen Sicherheitsphrase und Sicherheitsschlüssel? {#securityphrase-vs-securitykey}
|
||||
Das Passwort, das auf die Schlüsselsicherung zugreifen kann, wird Sicherheitsschlüssel genannt und ist sehr lang, beginnt mit einem großen E und sollte nach dem Einrichten gespeichert oder ausgedruckt werden. Da dieses Passwort im Alltag schlecht gemerkt werden kann (bspw. unterwegs, wenn man mal eben in Matrix vorbeischauen möchte, aber nur fremde Rechner zur Verfügung hat) kann man sich eine (gut merkbare) Sicherheitsphrase ausdenken, aus der der Sicherheitsschlüssel (im Browser/Client) errechnet werden kann, bevor versucht wird, die Schlüsselsicherung „zu öffnen“.
|
||||
***
|
||||
#### Warum sieht man im Element Desktop-Client keine Statuszeile am unteren Ende des Bildschirms wenn man über Hyperlinks hovert (= Maus drüber bewegt und verweilt)? Wie kann man diesen dann vertrauen? {#no-statusline}
|
||||
Tatsächlich ist die Statusleiste eine beliebte Prüfung der Seriösität von Hyperlinks, die man versucht ist anzuklicken. Im Element Desktop Client geht das ähnlich der mobilen Clients nicht. Hier kann man nur mit der rechten Maustaste auf den Link klicken und so die präsentierte Zielseite auf Seriösität prüfen.
|
||||
***
|
||||
#### Wie teilt man Leuten mit Element Desktop-Client eine Raumadresse mit? {#desktop-share-room}
|
||||
Mit dem matrix.to-Link, den man unter dem i für die Raumeigenschaften und einem weiteren Klick auf „Teile Raum“ erkennt.
|
||||
***
|
||||
#### Wie teilt man Leuten mit Element Web-Client eine Raumadresse mit? {#web-share-room}
|
||||
Mit dem matrix.to-Link, den man unter dem i für die Raumeigenschaften und einem weiteren Klick auf „Teile Raum“ erkennt und einem Austausch vom vorderen matrix.to mit matrix.tu-dresden.de
|
||||
***
|
||||
#### Kann ich LaTeX schreiben? {#latex}
|
||||
Nein, aber es gibt einen Workaround: CodiMD als CustomWidget einbinden. Nativ wird es auch bald gehen, siehe https://github.com/vector-im/element-web/issues/1945
|
||||
|
||||
***
|
||||
#### Gibt es sowas wie Threads (vgl. Mattermost/Slack) in Matrix? {#threads}
|
||||
Threads sind bisher noch nicht in Matrix verfügbar. Das Thema ist aber bei den Entwickler:innen bekannt und wurde in die Entwicklungsperspektive mit aufgenommen und sollte in Zukunft integriert werden. Verfolge dazu: https://github.com/vector-im/roadmap/projects/1
|
||||
|
||||
***
|
||||
#### Wie ändere ich die Sicherheitsphrase für meine Schlüsselsicherung? {#change-securityphrase}
|
||||
|
||||
***
|
||||
#### Wie kann ich die Schlüsselsicherung zurücksetzen, wenn ich meine Sicherheitsphrase UND meinen (abgespeicherten und ausgedruckten) Sicherheitsschlüssel verloren habe? {#reset-securityphrase}
|
||||
|
||||
***
|
||||
#### Warum gibt es keinen Raum „TU Dresden“? Wer dürfte ihn erstellen? {#no-tud-room}
|
||||
Alle raumerstellenden Personen sind administrierende Personen und tragen die Verantwortung für den Raum. Matrix ist bisher nicht für den Austausch von tausenden Mitgliedern an der Universität gedacht. Sollte eines Tages ein zentraler Raum von Bedarf sein, würde die Einrichtung und Pflege sicher beim Rektorat und dem Dezernat „Strategie & Kommunikation“ liegen.
|
||||
***
|
||||
#### Wie kann ich als administrierende Person viele Nachrichten auf einmal löschen? {#delete-multiple-messages}
|
||||
|
||||
***
|
||||
#### Manchmal sehe ich einen fett markierten Raum und klicke ihn an, habe aber doch nicht die Zeit, den Inhalt und etwaige Konsequenzen für mich sofort zu bearbeiten. Wie kann ich den Raum wieder als „ungelesen“ markieren? {#mark-room-as-unread}
|
||||
Das geht in Element leider nicht. Als Workaround kann man den Raum als Favorit markieren und sich selbst merken, dass eigene Favoriten nochmal in den Blick genommen werden sollten.
|
||||
|
||||
***
|
||||
#### Was muss ich tun, wenn auf einem MacOS Video oder Audio in einer Videokonferenz nicht funktioniert. {#apple-no-video}
|
||||
Häufig hat Element nicht die Rechte, auf die Webcam und das Mikrofon zu zugreifen. Diese können in den Systemeinstellungen unter Sicherheit und Privatsphäre vergeben werden.
|
||||
|
||||
***
|
||||
#### Wie viele Personen können gleichzeitig in einen Raum eingeladen werden? Kann ich Personen über ihre E-Mail-Adressen einladen? {#how-many-invites-can-i-do}
|
||||
Die Masseneinladung per E-Mail wird derzeit in Element nicht unterstützt. Wenn Sie eine Masseneinladung durchführen möchten, senden Sie bitte eine Anfrage über den Servicedesk, damit wir Ihnen helfen können. Sie können selbst 100 Personen über ihren ZIH-Benutzernamen einladen.
|
||||
|
||||
***
|
||||
#### Kann ich die Beitrittsrechte aller Räume meiner Community so anpassen, dass nur Mitglieder der Community Zutritt haben? {#roompermissions-in-communities}
|
||||
Nein, dies ist nicht möglich. Räume können in mehreren Communities sein. Der Zutritt zu Räumen wird daher raumweise eingestellt.
|
99
content/first-steps/_index.en.md
Normal file
99
content/first-steps/_index.en.md
Normal file
|
@ -0,0 +1,99 @@
|
|||
---
|
||||
title: "First steps"
|
||||
date: 2020-08-02T21:26:25+02:00
|
||||
chapter: true
|
||||
draft: false
|
||||
weight: 2
|
||||
---
|
||||
|
||||
# First steps - How to use Matrix?
|
||||
|
||||
Members and members of the TU Dresden (of course also students) can use their **ZIH login** to communicate with members of the TU Dresden and other universities and other Matrix users (e.g. academic partners) via chat and audio/video telephony in compliance with the relevant legal and regulatory provisions on data protection and IT security.
|
||||
communicate.
|
||||
|
||||
{{% notice tip %}}
|
||||
We recommend using the Element desktop client, because this avoids most problems users have with Matrix, e.g. end to end encryption.
|
||||
{{% /notice %}}
|
||||
|
||||
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 login with ZIH login and ZIH password must be carried out:
|
||||
|
||||
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
|
||||
|
||||
![Login window with request to enter ZIH login and password](/images/04_Username_en.png)
|
||||
|
||||
## Convenient use of end-to-end encryption (E2EE)
|
||||
|
||||
Matrix not only encrypts transports to and from the home server (in the data center of TU Dresden) but also allows the use of end-to-end encryption (E2EE). For this, cryptographic keys have to be exchanged between all devices that want to write end-to-end encrypted. This technical necessity sounds and is complicated, but in the meantime it has become very convenient for the users. The many cryptographic keys created by the client are stored on the respective device. If this is a tab in a browser, for example, there is a risk that this tab will be closed unintentionally. Then all encrypted contents are no longer readable. To prevent this from happening, a key protection is offered on the home server of the TU Dresden, on which (protected with a security phrase (or security key that can be calculated from it) all cryptographic keys are stored encrypted.
|
||||
|
||||
{{% notice info %}}
|
||||
It is highly recommended to use this key backup (with a secure security phrase which is NOT your ZIH password) and read on at [Other important settings]({{< relref "_index.en.md#other-important-settings" >}})!
|
||||
{{% /notice %}}
|
||||
|
||||
![Screenshot of the prompt to enter a security phrase](/images/01_Restore-Session_en.png)
|
||||
|
||||
If you skip this now, the next screen would look like this:
|
||||
|
||||
![Confirmation of skipping the input of a security phrase](/images/03_Cancel-Restore_en.png)
|
||||
|
||||
Key protection is highly recommended for worry-free end-to-end encryption. For this reason, a smaller tooltip will prompt you to set up the encryption even after you skip further:
|
||||
|
||||
![Chat view showing a tooltip to set up encryption. Marking the confirm field](/images/04_Notification_en.png)
|
||||
|
||||
If you omit this here as well, you will get a last warning if you log off consciously. If no key backup is set up at the latest, encrypted calls that may have already taken place cannot be accessed later. If the tab is closed, this also corresponds to a logout.
|
||||
|
||||
![Query if messages should be encrypted](/images/05_Logout-Notify_en.png)
|
||||
|
||||
## Webclient
|
||||
|
||||
For using the Webclient, see the manuel under [clients -> browser]({{< relref "clients/browser.en.md" >}})
|
||||
|
||||
A registration of accounts (as known from other matrix servers) is not possible here at the TU Dresden, because only persons with ZIH login can use the service. The TU Dresden is not a communication service provider.
|
||||
|
||||
For scientific cooperations with colleagues without a ZIH account there is the possibility to [apply for a ZIH guest account](https://tu-dresden.de/zih/dienste/service-katalog/zugangsvoraussetzung), which also entitles to use Matrix.
|
||||
|
||||
However, the federation with the Matrix servers of other scientific or civil society institutions will soon be possible (analogous to the existing e-mail federation). Example servers with which communication is already possible are:
|
||||
|
||||
* [TU München](https://tum.de)
|
||||
|
||||
* [Uni Hamburg](http://uni-hamburg.de/)
|
||||
|
||||
* [Uni Heidelberg](https://uni-heidelberg.de/)
|
||||
|
||||
* [Uni Bochum](http://ruhr-uni-bochum.de)
|
||||
|
||||
* [TU Freiberg](https://tu-freiberg.de)
|
||||
|
||||
* [TU Chemnitz](http://tu-chemnitz.de)
|
||||
|
||||
* [Hochschule Weimar](http://bau-ha.us)
|
||||
|
||||
* [University for Business and Technology, Kosovo](https://ubt-uni.net/)
|
||||
|
||||
For civil use of the Matrix protocol, here is a list of public home servers that can also be used by Kolleg:innen if their institution does not yet offer a Matrix server:
|
||||
[https://www.hello-matrix.net/public_servers.php](https://www.hello-matrix.net/public_servers.php)
|
104
content/first-steps/_index.md
Normal file
104
content/first-steps/_index.md
Normal file
|
@ -0,0 +1,104 @@
|
|||
---
|
||||
title: "Erste Schritte"
|
||||
date: 2020-08-02T21:26:25+02:00
|
||||
chapter: true
|
||||
draft: false
|
||||
weight: 2
|
||||
---
|
||||
|
||||
# Erste Schritte - Wie kann Matrix genutzt werden?
|
||||
|
||||
Mitgliedern und Angehörigen der TU Dresden (selbstverständlich auch Studierenden) wird unter Einhaltung der einschlägigen gesetzlichen und rechtlichen Bestimmungen zum Datenschutz und zur IT-Sicherheit ermöglicht, mittels ihres **ZIH-Logins** mit Angehörigen dieser und anderer Universitäten sowie weiteren Matrix-Nutzenden (bspw. akademischen Partner:innen) per Chat sowie Audio-/Video-Telefonie zu
|
||||
kommunizieren.
|
||||
|
||||
{{% notice tip %}}
|
||||
Wir empfehlen die Nutzung des Element Desktopclients, weil so viele Probleme, die bei dem Nutzen der Verschlüsselung entstehen können, so vermieden werden.
|
||||
{{% /notice %}}
|
||||
|
||||
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:
|
||||
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
|
||||
|
||||
![Loginfenster mit Aufforderung ZIH Login und Passwort einzugeben](/images/04_Username_de.png)
|
||||
|
||||
## Bequemes Nutzen der Ende-zu-Ende-Verschlüsselung (E2EE)
|
||||
|
||||
Matrix verschlüsselt nicht nur die Transporte von und zu dem Heimserver (im Rechenzentrum der TU Dresden) sondern erlaubt auch die Nutzung von Ende-zu-Ende-Verschlüsselung (E2EE). Hierzu müssen kryptografische Schlüssel zwischen allen Geräten ausgetauscht werden, die sich Ende-zu-Ende-verschlüsselt schreiben möchten. Diese technische Notwendigkeit klingt und ist kompliziert, ist inzwischen für die Anwendenden sehr bequem geworden. Die vielen kryptografischen Schlüssel werden vom Client erstellt auf dem jeweiligen Gerät gespeichert. Sollte dies bspw. ein Tab in einem Browser sein, besteht die Gefahr, dass dieser Tab einmal unbeabsichtigt geschlossen wird. Dann sind alle verschlüsselten Inhalte nicht mehr lesbar. Damit dies nicht geschieht, wird eine Schlüsselsicherung auf dem Heimserver der TU Dresden angeboten, auf der (mit einer Sicherheitsphrase (bzw. daraus errechenbaren Sicherheitsschlüssel) geschützt) alle kryptografischen Schlüssel verschlüsselt abgelegt sind.
|
||||
|
||||
{{% notice info %}}
|
||||
Es wird dringend empfohlen, diese Schlüsselsicherung zu nutzen (mit einer sicheren Sicherheitsphrase, welche NICHT Ihr ZIH-Passwort ist) und am Punkt [Weitere wichtige Einstellungen]({{< relref "_index.md#weitere-wichtige-einstellungen" >}}) weiterlesen!
|
||||
{{% /notice %}}
|
||||
|
||||
![Screenshot der Aufforderung eine Sicherheitsphrase einzugeben](/images/01_Restore-Session_de.png)
|
||||
|
||||
Sollten Sie dies jetzt überspringen, sähe der nächste Bildschirm so aus:
|
||||
|
||||
![Bestätigung des Überspringes der Eingabe einer Sicherheitsphrase](/images/03_Cancel-Restore_de.png)
|
||||
|
||||
Die Schlüsselsicherung wird dringend empfohlen, um sorgenfrei Ende-zu-Ende-Verschlüsselung nutzen zu können. Daher wird auch nach einem weiteren Überspringen in einem kleineren Tooltip zur Einrichtung der Verschlüsselung aufgefordert:
|
||||
|
||||
![Chatansicht mit der Anzeige eines Tooltips, Verschlüsselung einzurichten. Markierung des bestätigen Feldes](/images/04_Notification_de.png)
|
||||
|
||||
Sollten Sie dies auch hier auslassen wird Ihnen eine letzte Warnung bei einem bewussten Abmelden angezeigt. Wenn spätestens hierbei keine Schlüsselsicherung eingerichtet wird, kann später auf ggf. schon stattgefundene verschlüsselte Gespräche nicht mehr zugegriffen werden. Sollte der Tab geschlossen werden, entspricht dies ggf. ebenfalls einem Abmelden.
|
||||
|
||||
![Abfrage, ob Nachrichten verschlüsselt werden sollen](/images/05_Logout-Notify_de.png)
|
||||
|
||||
|
||||
## Nutzung des Webclients
|
||||
|
||||
Eine Anleitung für den Webclient finden Sie unter: [clients -> browser]({{< relref "clients/browser.md" >}})
|
||||
|
||||
Eine Registrierung von Accounts (wie vllt. von anderen Matrix-Servern bekannt) ist hier an der TU Dresden nicht möglich, da den Dienst ausschließlich Personen mit ZIH-Login nutzen können. Die TU Dresden ist kein Kommunikationsdiensteanbieter.
|
||||
|
||||
Für wissenschaftliche Kooperationen mit Kolleg:innen ohne ZIH-Account besteht die Möglichkeit zur [Beantragung eines ZIH-Gast-Accounts](https://tu-dresden.de/zih/dienste/service-katalog/zugangsvoraussetzung), welcher auch zur Nutzung von Matrix berechtigt.
|
||||
|
||||
Die Förderation mit den Matrix-Servern anderer wissenschaftlicher oder zivilgesellschaftlicher Institutionen ist jedoch in Kürze möglich (analog zur bestehenden E-Mail-Föderation). Beispiel-Server, mit denen jetzt schon kommuniziert werden kann sind:
|
||||
|
||||
* [TU München](https://tum.de)
|
||||
|
||||
* [Uni Hamburg](http://uni-hamburg.de/)
|
||||
|
||||
* [Uni Heidelberg](https://uni-heidelberg.de/)
|
||||
|
||||
* [Uni Bochum](http://ruhr-uni-bochum.de)
|
||||
|
||||
* [TU Freiberg](https://tu-freiberg.de)
|
||||
|
||||
* [TU Chemnitz](http://tu-chemnitz.de)
|
||||
|
||||
* [Hochschule Weimar](http://bau-ha.us)
|
||||
|
||||
* [University for Business and Technology, Kosovo](https://ubt-uni.net/)
|
||||
|
||||
Für die zivilgesellschaftliche Nutzung des Protkolls Matrix gibt es hier eine Liste an öffentlichen Heimservern, die auch von Kolleg:innen genutzt werden können, falls ihre Institution noch keinen Matrix-Server anbietet:
|
||||
[https://www.hello-matrix.net/public_servers.php](https://www.hello-matrix.net/public_servers.php)
|
||||
|
||||
Datenschutzerklärung: https://matrix.tu-dresden.de/datenschutz.html
|
||||
|
||||
Impressum: https://matrix.tu-dresden.de/impressum.html
|
||||
|
56
content/imprint/_index.en.md
Normal file
56
content/imprint/_index.en.md
Normal file
|
@ -0,0 +1,56 @@
|
|||
---
|
||||
title: "Imprint"
|
||||
date: 2020-07-02T21:22:54+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
weight: 1000
|
||||
---
|
||||
## Imprint
|
||||
|
||||
The [Imprint of the TU Dresden](https://tu-dresden.de/impressum) is valid with the following changes:
|
||||
|
||||
### Contact person:
|
||||
|
||||
#### Prof. Dr. Oliver Sander
|
||||
|
||||
Professorship for Numerics of Partial Differential Equations
|
||||
|
||||
TU Dresden
|
||||
|
||||
01062 Dresden
|
||||
|
||||
|
||||
#### Christian Bruchatz
|
||||
|
||||
School of Engineering Sciences
|
||||
|
||||
01062 Dresden
|
||||
|
||||
Phone +49 351 463-32328
|
||||
|
||||
matrix@tu-dresden.de
|
||||
|
||||
### Technical implementation:
|
||||
|
||||
#### Christoph Johannes Kleine
|
||||
|
||||
Center for Information Services and High Performance Computing (ZIH)
|
||||
|
||||
matrix@tu-dresden.de
|
||||
|
||||
#### Sebastian Itting
|
||||
|
||||
Centre for Tactile Internet with Human-in-the-Loop
|
||||
|
||||
CeTI - Cluster of Excellence
|
||||
|
||||
01062 Dresden
|
||||
|
||||
Phone +49 351 463-42066
|
||||
|
||||
sebastian.itting@tu-dresden.de
|
||||
|
||||
|
||||
## [privacy policy]({{{< relref "privacy">}})
|
||||
|
||||
|
57
content/imprint/_index.md
Normal file
57
content/imprint/_index.md
Normal file
|
@ -0,0 +1,57 @@
|
|||
---
|
||||
title: "Impressum"
|
||||
date: 2020-07-02T21:22:54+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
weight: 1000
|
||||
---
|
||||
## Impressum
|
||||
|
||||
Es gilt das [Impressum der TU Dresden](https://tu-dresden.de/impressum) mit folgenden Änderungen:
|
||||
|
||||
### Ansprechpartner:
|
||||
|
||||
#### Prof. Dr. Oliver Sander
|
||||
|
||||
Professur für Numerik partieller Differentialgleichungen
|
||||
|
||||
TU Dresden
|
||||
|
||||
01062 Dresden
|
||||
|
||||
### sowie
|
||||
|
||||
#### Christian Bruchatz
|
||||
|
||||
Bereich Ingenieurwissenschaften
|
||||
|
||||
01062 Dresden
|
||||
|
||||
Tel. +49 351 463-32328
|
||||
|
||||
matrix@tu-dresden.de
|
||||
|
||||
### Technische Umsetzung:
|
||||
|
||||
#### Christoph Johannes Kleine
|
||||
|
||||
Zentrum für Informationsdienste und Hochleistungsrechnen (ZIH)
|
||||
|
||||
matrix@tu-dresden.de
|
||||
|
||||
#### Sebastian Itting
|
||||
|
||||
Centre for Tactile Internet with Human-in-the-Loop
|
||||
|
||||
CeTI - Cluster of Excellence
|
||||
|
||||
01062 Dresden
|
||||
|
||||
Tel. +49 351 463-42066
|
||||
|
||||
sebastian.itting@tu-dresden.de
|
||||
|
||||
|
||||
## [Datenschutzerklärung]({{< relref "privacy">}})
|
||||
|
||||
|
56
content/integrations/_index.en.md
Normal file
56
content/integrations/_index.en.md
Normal file
|
@ -0,0 +1,56 @@
|
|||
---
|
||||
title: "Integrations"
|
||||
date: 2020-07-02T21:23:01+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
weight: 80
|
||||
---
|
||||
|
||||
# Use integrations, bridges, bots (e.g. Jitsi)
|
||||
|
||||
Integrations/Widgets can be managed via the room information in the upper right corner.
|
||||
|
||||
![Add integration button](/images/01_Widgets_en.png)
|
||||
|
||||
Here, for example, an etherpad, a jitsi video conference, an RSS bot, etc. can be integrated, i.e. services that are located and run on other servers. Therefore, when using integrations, the JavaScript activity of vector.im (for the integration manager) and other servers (e.g. in the Firefox addon NoScript) must be allowed. Since the widgets are often too small to use the services in their full functionality, widgets can often be opened large in new browser tabs.
|
||||
|
||||
In the following videos Prof. Dr. Alexander Lasch presents some possibilities for integrating widgets into matrix rooms for digital teaching:
|
||||
|
||||
https://invidious.13ad.de/watch?v=AtkA-sE-9uU
|
||||
|
||||
https://invidious.13ad.de/watch?v=D2Pq-NCaVGE
|
||||
|
||||
## Jitsi Videoconference
|
||||
|
||||
A 1:1 phone call or video within Matrix uses the direct WebRTC connection between both parties. From the 3rd person on, [Jitsi](https://de.wikipedia.org/wiki/Jitsi) is used, a free video conferencing tool (Apache license), which was installed locally at the TU Dresden in the course of the Corona crisis and the reduced availability of DFNconf: https://jitsi.tu-dresden.de
|
||||
|
||||
If the video conference call is started via the camera icon in the lower right corner, the Jitsi operated by the TU Dresden is automatically used. In order for Jitsi to be used for the video conference, at least three people must participate in the conference. If only two people participate in the conference, a direct connection will be established.
|
||||
|
||||
{{% notice warning %}}
|
||||
If the jitsi integration is added via the Integration Manager, the jitsi instance of TU Dresden is not used
|
||||
{{% /notice %}}
|
||||
|
||||
Also with Jitsi, opening the widget as a separate tab is useful to use the full functionality (e.g. screen sharing).
|
||||
|
||||
The use of a headset (headphone + microphone) is highly recommended to avoid feedback between sound recording and sound playback. Ideally a headset with a microphone close to the head and not just a headphone and use of the microphone hole on the laptop, which causes noise through it.
|
||||
|
||||
The m key mutes your microphone - with this setting you should always start a conference. The space bar switches the microphone on when muting is active (push-to-talk). Since the microphone input levels are all set differently, all hearing participants can adjust the volume of all conference participants individually. Furthermore, the individual video quality can be adjusted.
|
||||
|
||||
For sharing the screen contents (or specific program windows), it may be necessary to adjust the security settings of the operating system (e.g. in MacOS under System Preferences > Security > Privacy > Screen Capture).
|
||||
|
||||
Many thanks to Dr. Eike Dohmen ([Professorship of Magnetofluiddynamics, Measurement and Automation Technology](https://tu-dresden.de/ing/maschinenwesen/imd/mfd)) and Prof. Dr. Alexander Lasch ([Professorship of German Linguistics and History of Language](http://tu-dresden.de/gsw/slk/germanistik/gls/)) for tests and hints on the interaction of Matrix and Jitsi.
|
||||
|
||||
## Etherpad
|
||||
|
||||
The Etherpad widget can be used for collaborative writing or attaching important information to a room.
|
||||
|
||||
{{% notice warning %}}
|
||||
For this purpose, a name must be assigned which must have less than 16 characters!
|
||||
{{% /notice %}}
|
||||
Etherpads have no user rights management, everyone can write and overwrite other texts (caution!). If user management is needed, better use [Nextcloud Text](https://github.com/nextcloud/text) (contact TUD cloudstore) or [CodiMD](https://md.inf.tu-dresden.de/)
|
||||
|
||||
## Custom widget
|
||||
|
||||
Any Internet pages can be integrated. For example [CodiMD](https://md.inf.tu-dresden.de/) to display LaTeX formulas.
|
||||
|
||||
|
56
content/integrations/_index.md
Normal file
56
content/integrations/_index.md
Normal file
|
@ -0,0 +1,56 @@
|
|||
---
|
||||
title: "Integrationen"
|
||||
date: 2020-07-02T21:23:01+02:00
|
||||
draft: false
|
||||
chapter: true
|
||||
weight: 80
|
||||
---
|
||||
|
||||
# Integrations, Bridges, Bots nutzen (u.a. Jitsi)
|
||||
|
||||
Über die Rauminformationen oben rechts können Integrations / Widgets verwaltet werden.
|
||||
|
||||
![Integration hinzufügen button](/images/01_Widgets_de.png)
|
||||
|
||||
Hier kann bspw. ein Etherpad, eine Jitsi-Videokonferenz, ein RSS-Bot o.a. eingebunden werden, also Dienste, die auf anderen Servern liegen und ausgeführt werden. Daher ist bei Nutzung von Integrations auch die JavaScript-Aktivität von vector.im (für den Integrationsmanager) und weiteren Servern (bspw. im Firefox-Addon NoScript) zu erlauben. Da die Widgets oftmals zu klein sind, um die Dienste in ihrer vollen Funktionalität zu nutzen, lassen sich Widgets auch oft in neuen Browser-Tabs groß öffnen.
|
||||
|
||||
Prof. Dr. Alexander Lasch präsentiert in folgenden Videos einige Möglichkeiten zum Einbinden von Widgets in Matrix-Räume für die digitale Lehre:
|
||||
|
||||
https://invidious.13ad.de/watch?v=AtkA-sE-9uU
|
||||
|
||||
https://invidious.13ad.de/watch?v=D2Pq-NCaVGE
|
||||
|
||||
## Jitsi Videokonferenz
|
||||
|
||||
Ein 1:1 Telefonat oder Video innerhalb von Matrix nutzt die direkte WebRTC-Verbindung zwischen beiden Beteiligten. Ab der 3. Person wird [Jitsi](https://de.wikipedia.org/wiki/Jitsi) hinzugezogen, ein freies Videokonferenz-Tool (Apache-Lizenz), welches im Zuge der Corona-Krise und der verminderten Verfügbarkeit vom DFNconf auch lokal an der TU Dresden installiert wurde: https://jitsi.tu-dresden.de
|
||||
|
||||
Wenn das Videotelefonat über das Kameraicon rechts unten begonnen wird, wird automatisch das von der TU Dresden betriebene Jitsi verwendet. Damit Jitsi für die Videokonferenz verwendet wird, müssen mindestens drei Personen an der Konferenz teilnehmen. Wenn nur zwei Personen an der Konferenz teilnehmen, wird eine Direktverbindung aufgebaut.
|
||||
|
||||
{{% notice warning %}}
|
||||
Wenn die Jitsi-Integration über den Integrationmanager hinzugefügt wird, wird nicht die Jitsiinstanz der TU Dresden verwendet
|
||||
{{% /notice %}}
|
||||
|
||||
Auch bei Jitsi ist das öffnen des Widgets als eigener Tab sinnvoll, um die volle Funktionalität (bspw. Bildschirm teilen / Screensharing) zu nutzen.
|
||||
|
||||
Die Nutzung eines Headsets (Kopfhörer + Mikrofon) ist sehr zu empfehlen, um Rückkopplungen zwischen Tonaufnahme und Tonwiedergabe zu verhindern. Idealerweise ein Headset mit Mikro in Kopfnähe und nicht nur ein Kopfhörer und eine Nutzung des Mikro-Löchleins am Laptop, was zu Geräuschen durch diesen führt.
|
||||
|
||||
Die Taste m schaltet das eigene Mikrofon stumm - mit dieser Einstellung sollte man immer in eine Konferenz starten. Die Leertaste schaltet bei aktiver Stummschaltung das Mikrofon an (Push-to-talk). Da die Mikrofon-Eingangspegel alle unterschiedlich einstellen, können alle hörenden Teilnehmenden die Lautstärke aller Konferenzteilnehmenden individuell anpassen. Weiterhin ist die eigene Videoqualität einstellbar.
|
||||
|
||||
Für das Teilen des Bildschirminhaltes (bzw. spezifischer Programmfenster) ist ggf. eine Anpassung der Sicherheitseinstellungen des Betriebssystems nötig (bspw. in MacOS unter Systemeinstellungen > Sicherheit > Datenschutz > Bildschirmaufnahme).
|
||||
|
||||
Vielen Dank an Dr. Eike Dohmen ([Professur für Magnetofluiddynamik, Mess- und Automatisierungstechnik](https://tu-dresden.de/ing/maschinenwesen/imd/mfd)) und Prof. Dr. Alexander Lasch ([Professur für Germanistische Linguistik und Sprachgeschichte](http://tu-dresden.de/gsw/slk/germanistik/gls/)) für Tests und Hinweise zum Zusammenspiel von Matrix und Jitsi.
|
||||
|
||||
## Etherpad
|
||||
|
||||
Zum kollaborativen Schreiben oder Anheften von wichtigen Informationen an einen Raum kann das Widget Etherpad genutzt werden.
|
||||
|
||||
{{% notice warning %}}
|
||||
Hierzu ist ein Name zu vergeben, der weniger als 16 Zeichen haben muss!
|
||||
{{% /notice %}}
|
||||
Etherpads haben kein Benutzerrechtemanagement, alle können schreiben und andere Texte überschreiben (Vorsicht!). Falls Benutzermanagement benötigt wird besser [Nextcloud Text](https://github.com/nextcloud/text) (Forderung an TUD cloudstore richten) oder [CodiMD](https://md.inf.tu-dresden.de/) nutzen
|
||||
|
||||
## Custom Widget
|
||||