Crash_Override
/
Matrix_Pfalz-Mail_Documentation
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

First commit

This commit is contained in:
Carsten Schmiemann 2022-05-06 01:35:34 +02:00
commit 0bf859b168
356 changed files with 18202 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
.gitignore vendored Normal file
View File

@ -0,0 +1,4 @@
/public
.DS_Store
resources
.lock

3
.gitmodules vendored Normal file
View File

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

0
.hugo_build.lock Normal file
View File

173
LICENSE.md Normal file
View File

@ -0,0 +1,173 @@
## creative commons
# Attribution-ShareAlike 4.0 International
Creative Commons Corporation (“Creative Commons”) is not a law firm and does not provide legal services or legal advice. Distribution of Creative Commons public licenses does not create a lawyer-client or other relationship. Creative Commons makes its licenses and related information available on an “as-is” basis. Creative Commons gives no warranties regarding its licenses, any material licensed under their terms and conditions, or any related information. Creative Commons disclaims all liability for damages resulting from their use to the fullest extent possible.
### Using Creative Commons Public Licenses
Creative Commons public licenses provide a standard set of terms and conditions that creators and other rights holders may use to share original works of authorship and other material subject to copyright and certain other rights specified in the public license below. The following considerations are for informational purposes only, are not exhaustive, and do not form part of our licenses.
* __Considerations for licensors:__ Our public licenses are intended for use by those authorized to give the public permission to use material in ways otherwise restricted by copyright and certain other rights. Our licenses are irrevocable. Licensors should read and understand the terms and conditions of the license they choose before applying it. Licensors should also secure all rights necessary before applying our licenses so that the public can reuse the material as expected. Licensors should clearly mark any material not subject to the license. This includes other CC-licensed material, or material used under an exception or limitation to copyright. [More considerations for licensors](http://wiki.creativecommons.org/Considerations_for_licensors_and_licensees#Considerations_for_licensors).
* __Considerations for the public:__ By using one of our public licenses, a licensor grants the public permission to use the licensed material under specified terms and conditions. If the licensor’s permission is not necessary for any reason–for example, because of any applicable exception or limitation to copyright–then that use is not regulated by the license. Our licenses grant only permissions under copyright and certain other rights that a licensor has authority to grant. Use of the licensed material may still be restricted for other reasons, including because others have copyright or other rights in the material. A licensor may make special requests, such as asking that all changes be marked or described. Although not required by our licenses, you are encouraged to respect those requests where reasonable. [More considerations for the public](http://wiki.creativecommons.org/Considerations_for_licensors_and_licensees#Considerations_for_licensees).
## Creative Commons Attribution-ShareAlike 4.0 International Public License
By exercising the Licensed Rights (defined below), You accept and agree to be bound by the terms and conditions of this Creative Commons Attribution-ShareAlike 4.0 International Public License ("Public License"). To the extent this Public License may be interpreted as a contract, You are granted the Licensed Rights in consideration of Your acceptance of these terms and conditions, and the Licensor grants You such rights in consideration of benefits the Licensor receives from making the Licensed Material available under these terms and conditions.
### Section 1 – Definitions.
a. __Adapted Material__ means material subject to Copyright and Similar Rights that is derived from or based upon the Licensed Material and in which the Licensed Material is translated, altered, arranged, transformed, or otherwise modified in a manner requiring permission under the Copyright and Similar Rights held by the Licensor. For purposes of this Public License, where the Licensed Material is a musical work, performance, or sound recording, Adapted Material is always produced where the Licensed Material is synched in timed relation with a moving image.
b. __Adapter's License__ means the license You apply to Your Copyright and Similar Rights in Your contributions to Adapted Material in accordance with the terms and conditions of this Public License.
c. __BY-SA Compatible License__ means a license listed at [creativecommons.org/compatiblelicenses](http://creativecommons.org/compatiblelicenses), approved by Creative Commons as essentially the equivalent of this Public License.
d. __Copyright and Similar Rights__ means copyright and/or similar rights closely related to copyright including, without limitation, performance, broadcast, sound recording, and Sui Generis Database Rights, without regard to how the rights are labeled or categorized. For purposes of this Public License, the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights.
e. __Effective Technological Measures__ means those measures that, in the absence of proper authority, may not be circumvented under laws fulfilling obligations under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, and/or similar international agreements.
f. __Exceptions and Limitations__ means fair use, fair dealing, and/or any other exception or limitation to Copyright and Similar Rights that applies to Your use of the Licensed Material.
g. __License Elements__ means the license attributes listed in the name of a Creative Commons Public License. The License Elements of this Public License are Attribution and ShareAlike.
h. __Licensed Material__ means the artistic or literary work, database, or other material to which the Licensor applied this Public License.
i. __Licensed Rights__ means the rights granted to You subject to the terms and conditions of this Public License, which are limited to all Copyright and Similar Rights that apply to Your use of the Licensed Material and that the Licensor has authority to license.
j. __Licensor__ means the individual(s) or entity(ies) granting rights under this Public License.
k. __Share__ means to provide material to the public by any means or process that requires permission under the Licensed Rights, such as reproduction, public display, public performance, distribution, dissemination, communication, or importation, and to make material available to the public including in ways that members of the public may access the material from a place and at a time individually chosen by them.
l. __Sui Generis Database Rights__ means rights other than copyright resulting from Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, as amended and/or succeeded, as well as other essentially equivalent rights anywhere in the world.
m. __You__ means the individual or entity exercising the Licensed Rights under this Public License. Your has a corresponding meaning.
### Section 2 – Scope.
a. ___License grant.___
1. Subject to the terms and conditions of this Public License, the Licensor hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license to exercise the Licensed Rights in the Licensed Material to:
A. reproduce and Share the Licensed Material, in whole or in part; and
B. produce, reproduce, and Share Adapted Material.
2. __Exceptions and Limitations.__ For the avoidance of doubt, where Exceptions and Limitations apply to Your use, this Public License does not apply, and You do not need to comply with its terms and conditions.
3. __Term.__ The term of this Public License is specified in Section 6(a).
4. __Media and formats; technical modifications allowed.__ The Licensor authorizes You to exercise the Licensed Rights in all media and formats whether now known or hereafter created, and to make technical modifications necessary to do so. The Licensor waives and/or agrees not to assert any right or authority to forbid You from making technical modifications necessary to exercise the Licensed Rights, including technical modifications necessary to circumvent Effective Technological Measures. For purposes of this Public License, simply making modifications authorized by this Section 2(a)(4) never produces Adapted Material.
5. __Downstream recipients.__
A. __Offer from the Licensor – Licensed Material.__ Every recipient of the Licensed Material automatically receives an offer from the Licensor to exercise the Licensed Rights under the terms and conditions of this Public License.
B. __Additional offer from the Licensor – Adapted Material.__ Every recipient of Adapted Material from You automatically receives an offer from the Licensor to exercise the Licensed Rights in the Adapted Material under the conditions of the Adapter’s License You apply.
C. __No downstream restrictions.__ You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, the Licensed Material if doing so restricts exercise of the Licensed Rights by any recipient of the Licensed Material.
6. __No endorsement.__ Nothing in this Public License constitutes or may be construed as permission to assert or imply that You are, or that Your use of the Licensed Material is, connected with, or sponsored, endorsed, or granted official status by, the Licensor or others designated to receive attribution as provided in Section 3(a)(1)(A)(i).
b. ___Other rights.___
1. Moral rights, such as the right of integrity, are not licensed under this Public License, nor are publicity, privacy, and/or other similar personality rights; however, to the extent possible, the Licensor waives and/or agrees not to assert any such rights held by the Licensor to the limited extent necessary to allow You to exercise the Licensed Rights, but not otherwise.
2. Patent and trademark rights are not licensed under this Public License.
3. To the extent possible, the Licensor waives any right to collect royalties from You for the exercise of the Licensed Rights, whether directly or through a collecting society under any voluntary or waivable statutory or compulsory licensing scheme. In all other cases the Licensor expressly reserves any right to collect such royalties.
### Section 3 – License Conditions.
Your exercise of the Licensed Rights is expressly made subject to the following conditions.
a. ___Attribution.___
1. If You Share the Licensed Material (including in modified form), You must:
A. retain the following if it is supplied by the Licensor with the Licensed Material:
i. identification of the creator(s) of the Licensed Material and any others designated to receive attribution, in any reasonable manner requested by the Licensor (including by pseudonym if designated);
ii. a copyright notice;
iii. a notice that refers to this Public License;
iv. a notice that refers to the disclaimer of warranties;
v. a URI or hyperlink to the Licensed Material to the extent reasonably practicable;
B. indicate if You modified the Licensed Material and retain an indication of any previous modifications; and
C. indicate the Licensed Material is licensed under this Public License, and include the text of, or the URI or hyperlink to, this Public License.
2. You may satisfy the conditions in Section 3(a)(1) in any reasonable manner based on the medium, means, and context in which You Share the Licensed Material. For example, it may be reasonable to satisfy the conditions by providing a URI or hyperlink to a resource that includes the required information.
3. If requested by the Licensor, You must remove any of the information required by Section 3(a)(1)(A) to the extent reasonably practicable.
b. ___ShareAlike.___
In addition to the conditions in Section 3(a), if You Share Adapted Material You produce, the following conditions also apply.
1. The Adapter’s License You apply must be a Creative Commons license with the same License Elements, this version or later, or a BY-SA Compatible License.
2. You must include the text of, or the URI or hyperlink to, the Adapter's License You apply. You may satisfy this condition in any reasonable manner based on the medium, means, and context in which You Share Adapted Material.
3. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, Adapted Material that restrict exercise of the rights granted under the Adapter's License You apply.
### Section 4 – Sui Generis Database Rights.
Where the Licensed Rights include Sui Generis Database Rights that apply to Your use of the Licensed Material:
a. for the avoidance of doubt, Section 2(a)(1) grants You the right to extract, reuse, reproduce, and Share all or a substantial portion of the contents of the database;
b. if You include all or a substantial portion of the database contents in a database in which You have Sui Generis Database Rights, then the database in which You have Sui Generis Database Rights (but not its individual contents) is Adapted Material, including for purposes of Section 3(b); and
c. You must comply with the conditions in Section 3(a) if You Share all or a substantial portion of the contents of the database.
For the avoidance of doubt, this Section 4 supplements and does not replace Your obligations under this Public License where the Licensed Rights include other Copyright and Similar Rights.
### Section 5 – Disclaimer of Warranties and Limitation of Liability.
a. __Unless otherwise separately undertaken by the Licensor, to the extent possible, the Licensor offers the Licensed Material as-is and as-available, and makes no representations or warranties of any kind concerning the Licensed Material, whether express, implied, statutory, or other. This includes, without limitation, warranties of title, merchantability, fitness for a particular purpose, non-infringement, absence of latent or other defects, accuracy, or the presence or absence of errors, whether or not known or discoverable. Where disclaimers of warranties are not allowed in full or in part, this disclaimer may not apply to You.__
b. __To the extent possible, in no event will the Licensor be liable to You on any legal theory (including, without limitation, negligence) or otherwise for any direct, special, indirect, incidental, consequential, punitive, exemplary, or other losses, costs, expenses, or damages arising out of this Public License or use of the Licensed Material, even if the Licensor has been advised of the possibility of such losses, costs, expenses, or damages. Where a limitation of liability is not allowed in full or in part, this limitation may not apply to You.__
c. The disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability.
### Section 6 – Term and Termination.
a. This Public License applies for the term of the Copyright and Similar Rights licensed here. However, if You fail to comply with this Public License, then Your rights under this Public License terminate automatically.
b. Where Your right to use the Licensed Material has terminated under Section 6(a), it reinstates:
1. automatically as of the date the violation is cured, provided it is cured within 30 days of Your discovery of the violation; or
2. upon express reinstatement by the Licensor.
For the avoidance of doubt, this Section 6(b) does not affect any right the Licensor may have to seek remedies for Your violations of this Public License.
c. For the avoidance of doubt, the Licensor may also offer the Licensed Material under separate terms or conditions or stop distributing the Licensed Material at any time; however, doing so will not terminate this Public License.
d. Sections 1, 5, 6, 7, and 8 survive termination of this Public License.
### Section 7 – Other Terms and Conditions.
a. The Licensor shall not be bound by any additional or different terms or conditions communicated by You unless expressly agreed.
b. Any arrangements, understandings, or agreements regarding the Licensed Material not stated herein are separate from and independent of the terms and conditions of this Public License.
### Section 8 – Interpretation.
a. For the avoidance of doubt, this Public License does not, and shall not be interpreted to, reduce, limit, restrict, or impose conditions on any use of the Licensed Material that could lawfully be made without permission under this Public License.
b. To the extent possible, if any provision of this Public License is deemed unenforceable, it shall be automatically reformed to the minimum extent necessary to make it enforceable. If the provision cannot be reformed, it shall be severed from this Public License without affecting the enforceability of the remaining terms and conditions.
c. No term or condition of this Public License will be waived and no failure to comply consented to unless expressly agreed to by the Licensor.
d. Nothing in this Public License constitutes or may be interpreted as a limitation upon, or waiver of, any privileges and immunities that apply to the Licensor or You, including from the legal processes of any jurisdiction or authority.
> Creative Commons is not a party to its public licenses. Notwithstanding, Creative Commons may elect to apply one of its public licenses to material it publishes and in those instances will be considered the “Licensor.” The text of the Creative Commons public licenses is dedicated to the public domain under the [CC0 Public Domain Dedication](https://creativecommons.org/publicdomain/zero/1.0/legalcode). Except for the limited purpose of indicating that material is shared under a Creative Commons public license or as otherwise permitted by the Creative Commons policies published at [creativecommons.org/policies](http://creativecommons.org/policies), Creative Commons does not authorize the use of the trademark “Creative Commons” or any other trademark or logo of Creative Commons without its prior written consent including, without limitation, in connection with any unauthorized modifications to any of its public licenses or any other arrangements, understandings, or agreements concerning use of licensed material. For the avoidance of doubt, this paragraph does not form part of the public licenses.
>
> Creative Commons may be contacted at creativecommons.org.

9
README.md Normal file
View File

@ -0,0 +1,9 @@
# Pfalz-Mail Matrix Dokumentation
**Website:** **https://matrix.pfalz-mail.de/hilfe**
### To build:
1. Clone the repository `git clone https://git.bit-cloud.de/carsten.schmiemann/Matrix_Pfalz-Mail_Documentation.git`
1. `cd Matrix_Pfalz-Mail_Documentation`
1. Install [Hugo](https://gohugo.io/getting-started/installing)
1. Run `hugo server -D`
1. Open http://localhost:1313/

6
archetypes/default.md Normal file
View File

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

22
config.toml Normal file
View File

@ -0,0 +1,22 @@
baseURL = "https://matrix.pfalz-mail.de/hilfe"
languageCode = "de-DE"
DefaultContentLanguage = "de"
title = "Matrix Dokumentation"
theme = "learn"
[params]
themeVariant = "pfalzmail"
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

65
content/_index.md Normal file
View File

@ -0,0 +1,65 @@
---
title: "Pfalz-Mail Community Matrix Server"
date: 2022-05-05T22:43:00+02:00
chapter: false
draft: false
---
## Pfalz-Mail Community Matrix Server
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="/hilfe/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 kostenlos erhältliche Chat-Applikationen haben eine zentrale Kontrollinstanz, sind proprietär und oft datenschutzbedenklich. In den letzten Jahren hat die Datensammelwut um sich geschlagen und jeder Klick und jede Nachricht wird analysiert und an werbetreibende Firmen verkauft. Eduard Snowdens Enthüllungen über die unnötige und sinnlose Spionage von allen Bürgern hat mich schlussendlich dazu veranlasst ein offenes und freies sowie federiertes System zu suchen, um wieder privater und dennoch angenehm konfortabel kommunizieren zu können.
Zur Deckung des Bedarfes an Echtzeitkommunikation wurde daher Ende 2021, nach vergleichender Analyse mehrerer potentieller Lösungsoptionen, das offene Kommunikationsprotokoll Matrix in einem Pilotbetrieb eingeführt und im April 2022 als Produktivsystem - und auch als Ablösung von RocketChat - eingeführt.
## 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" >}})
* [Spaces zur Raumverwaltung einsetzen]({{< relref "spaces/_index.md" >}})
* [Weiterentwicklung von Matrix]({{< relref "development/_index.md" >}})
* [Datenschutzerklärung]({{< relref "privacy/_index.md" >}})
* [Impressum]({{< relref "imprint/_index.md" >}})
### Fragen / Kontakt
Probleme und Lösungen können durch Schildern des Sachverhalts gemeinsam im [Matrix-Support-Raum](https://matrix.to/#/#hilfe:matrix.pfalz-mail.de) diskutiert werden, sodass alle anderen durch den transparenten Austausch lernen können.
{{% 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 %}}

40
content/clients/_index.md Normal file
View File

@ -0,0 +1,40 @@
---
title: "Clients / Installation"
date: 2022-05-05T22:43:00+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](#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](/hilfe/images/12_Element-Download.png)](https://element.io/get-started)
## Element Web {#web-app}
Zur Web-App: {{% button href="https://matrix.pfalz-mail.de" icon="fas fa-globe" %}}matrix.pfalz-mail.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-Droid){{% /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.

71
content/clients/browser.md Normal file
View File

@ -0,0 +1,71 @@
---
title: "Element Web (Browser)"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
weight: 10
---
## Nutzung des Webclients
Starten Sie auf [matrix.pfalz-mail.de](https://matrix.pfalz-mail.de).
![Startseite von Element Webclient mit Anmeldebutton](/hilfe/images/01_Welcome_de.png)
Hierzu ist keine Registrierung nötig, der Dienst kann sofort durch Klick auf „Anmelden“ auf der Startseite [https://matrix.pfalz-mail.de](https://matrix.pfalz-mail.de) genutzt werden.
![Loginfenster mit Aufforderung Login und Passwort einzugeben](/hilfe/images/02_Login1_de.png)
Das Dropdown-Menü „Anmelden mit:“ sollte auf „Benutzername“ belassen werden. Dann sind folgende Eingaben zu tätigen:
**Benutzername: Festgelegt bei Registrierung**
**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:
@benutzername:pfalz-mail.de
{{% notice warning %}}
Solltest du statt mit der oben genannten Website (Element Web-App auf dem Pfalz-Mail Server 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.pfalz-mail.de zu ändern (dargestellt in den folgenden drei Bildschirmfotos):
{{% /notice %}}
![Anmeldeseite mit Fokus auf dem Homeserver ändern Button](/hilfe/images/02_Login2_de.png)
1. Klick auf Ändern
![Eingabefeld zum Ändern des Homeserers mit der Eingabe matrix.pfalz-mail.de](/hilfe/images/02_Login3_de.png)
2. Markieren der voreingestellten Heimserver-Adresse und entfernen dieser.
![](/hilfe/images/02_Login4_de.png)
3. Eintragung unseres Matrix-Heimserver-Adresse
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.pfalz-mail.de](https://matrix.pfalz-mail.de).
![Willkommensbildschirm des Pfalz-Mail Element Web Clients](/hilfe/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 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 pfalz-mail.de und vector.im als vertrauenswürdige Skriptquellen ausgewählt](/hilfe/images/10_Sicherheit2_de.png)
### Cookies
Erlauben Sie auch Cookies von
- pfalz-mail.de
- vector.im (für den Integrationsmanager)

34
content/clients/desktop.md Normal file
View File

@ -0,0 +1,34 @@
---
title: "Element Desktop"
date: 2022-05-05T22:43:00+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 auf dem Pfalz-Mail Server zu nutzen, und keinen neuen Account auf einem anderen Server zu erstellen. Hier am Beispiel von Element:
![Markierter Anmeldebutton im Element Matrixclient](/hilfe/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](/hilfe/images/02_Change-Homeserver_de.png)
Nun kann man manuell die Angabe des Heimservers durchführen: pfalz-mail.de
![Eingabefeld zum Ändern des Homeservers mit der Eingabe matrix.pfalz-mail.de](/hilfe/images/03_Set-Homeserver_de.png)
Anschließend ist der einmalige Login durchzuführen:
![Loginfenster mit Aufforderung Login und Passwort einzugeben](/hilfe/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 markiert](/hilfe/images/05_Settings_de.png)

36
content/clients/install_linux.md Normal file
View File

@ -0,0 +1,36 @@
---
title: "Installation unter Linux"
date: 2022-05-05T22:43:00+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 Distribution. 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
```

21
content/clients/mobile.md Normal file
View File

@ -0,0 +1,21 @@
---
title: "Element Mobil"
date: 2022-05-05T22:43:00+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:
{{% notice info %}}
Abweichend von den hier gezeigten Screenshots ist bei iOS Element die Adresse des Homeservers mit matrix.pfalz-mail.de anzugeben.
{{% /notice %}}
![Screenshot der Anmeldeprozedur unter Android/iOS](/hilfe/images/15_Android1_de.png)
![Screenshot des Element Androidclients nach erfolgreichem Einloggen](/hilfe/images/15_Android2_de.png)

13
content/clients/more_clients.md Normal file
View File

@ -0,0 +1,13 @@
---
title: "Weitere Clients"
date: 2022-05-05T22:43:00+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

64
content/communities/_index.md Normal file
View File

@ -0,0 +1,64 @@
---
title: "Communities"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
weight: 50
---
# Communities (veraltet)
{{% notice note %}}
[Spaces]({{< relref "spaces/_index.md" >}}) lösen die Communities zur Raumverwaltung ab. Die Funktion ist in aktuellen Element-Versionen automatisch aktiviert. (Desktop/Web 1.9, Android 1.3, iPadOS/iOS 1.6 oder neuer)
{{% /notice %}}
## Inhalt
* [Communities temporär anzeigen](#communities-temporär-anzeigen)
* [Communities konvertieren](#communities-konvertieren)
* [Communities als Raum-Filter einsetzen](#communities-als-raum-filter-einsetzen)
## Communities temporär anzeigen
![Auswahl des Punkts "Alle Einstellungen" im personlichen Menü](/hilfe/images/06_Settings_de.png)
Klicke auf den nach unten zeigenden Pfeil oben rechts in der Personenspalte und rufe `Alle Einstellungen` auf.
![Element-Einstellungen mit Optionen zu Communities](/hilfe/images/20_Communities_Settings1_de.png)
Wähle im Dialog links den Punkt `Optionen` (1) aus. Auf der Rechten Seite findest du unter der Überschrift `Communities` die Option `Communities statt Spaces anzeigen` (2). Aktiviere den Regler rechts daneben, wird dein Element-Client neu geladen und die Communities werden angezeigt. Klicke erneut auf den Regler, wenn du zur regulären Ansicht zurückkehren möchtest.
## Communities konvertieren
![Auswahl des Punkts "Alle Einstellungen" im personlichen Menü](/hilfe/images/06_Settings_de.png)
Klicke auf den nach unten zeigenden Pfeil oben rechts in der Personenspalte und rufe `Alle Einstellungen` auf.
![Element-Einstellungen mit Optionen zu Communities](/hilfe/images/20_Communities_Settings2_de.png)
Wähle im Dialog links den Punkt `Optionen` (1) aus. Auf der Rechten Seite findest du unter der Überschrift `Communities` den Eintrag `Meine Communities anzeigen` (2). Klappe den Eintrag aus, werden deine Communities angezeigt. Mit einem Klick auf den Button `Space erstellen` (3) jeweils rechts neben einem Eintrag wird der Konvertierungsdialog aufgerufen.
![Dialog für die Konvertierung einer Community zu einem Space](/hilfe/images/20_Communities_Conversion1_de.png)
Hier kannst du das Foto, den Namen, die Beschreibung und die Sichtbarkeit (privat oder öffentlich) des Spaces konfigurieren. Anschließend kann die Konvertierung mit einem Klick auf `Space erstellen` gestartet werden.
![Dialog mit Erfolsmeldung nach der Konvertierung](/hilfe/images/20_Communities_Conversion2_de.png)
Ist der Prozess abgeschlossen, erhälst du eine Erfolgsmeldung. Über den Button `Optionen` gelangst du wieder in die Einstellungen für Communities.
## 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 vielleicht 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.
Bestehende Räume können einer Community in den Community-Einstellungen zugewiesen werden (unter #).
![Screenshot der Auswahl der aktuellen Community](/hilfe/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.
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.

71
content/encryption/_index.md Normal file
View File

@ -0,0 +1,71 @@
---
title: "Verschlüsselung"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
weight: 60
---
# Ende-zu-Ende-Verschlüsselung nutzen
1:1 Gespräche sind 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](/hilfe/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](/hilfe/images/02_Roomsettings_de.png)
Dazu ist im Reiter Sicherheit & Datenschutz der Schieberegler Verschlüsselt zu bewegen:
![Verschlüsselung in den Raumeinstellungen aktivieren](/hilfe/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](/hilfe/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 Teilnehmenden verifiziert sind.](/hilfe/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 benachrichtigt 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](/hilfe/images/06_E2EE_Verify_de.png)
![Menü zum starten der Verifikation](/hilfe/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 Treffen) 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](/hilfe/images/16_E2EE.png)
Analog geschieht dies in Räumen mit mehreren Teilnehmenden, jeweils einzeln.
![Verifikationsprozess war erfolgreich](/hilfe/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](/hilfe/images/gray.png)
Mindestens eine Person im Raum wurde noch nicht verifiziert.
![Symbol für eine verifizierte Person, die unverifizierte Sitzungen geöffnet hat](/hilfe/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](/hilfe/images/green.png)
Alle im Raum befindlichen Personen wurden verifiziert.
Hier ein weiteres Beispiel, wie man den Verschlüsselungszustand eines Raumes in den Rauminformationen oben rechts neben dem Raum-Icon erkennen kann:
![Darstellung der Verschlüsselungssituation in Matrix-Räumen](/hilfe/images/room_security_status.png)

112
content/faq/_index.md Normal file
View File

@ -0,0 +1,112 @@
---
menutitle: "Häufige Fragen (FAQ)"
title: "Häufig gestellte Fragen"
date: 2022-05-05T22:43:00+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:pfalz-mail.de``` nachfragen.
* [Nachrichten nicht lesbar](#unable-to-decrypt)
* [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)
* [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)
* [Kann ich mit Element mehrere Matrix-Accounts verwalten (Multi-Account-Client)?](#multiple-accounts-element)
* [Überall steht nur „missing translation: en“|](#missing-translations)
* [Ist unser Server auf eurer Föderations-Blacklist?](#blacklist)
* [Ich sehe in einem Raum von einer bestimmten Person keine Nachrichten](#blocked-user)
***
#### Nachrichten nicht lesbar{#unable-to-decrypt}
* Es muss zur zeit mindestens immer eine verifizierte Sitzung offen sein, am einfachsten geht dies, wenn der Desktop Client oder Element auf dem tragbarem Handrechner eingerichtet ist. Diese Programme können beendet und neu gestartet werden, ohne sich erneut anmelden zu müssen. Anderweitig kann eine verifizierte Matrixsitzung in einem privaten Browserfenster erstellt werden, indem man sich dort bei Matrix anmeldet und diese Sitzung aus einer bestehenden verifziert. Dieses Fenster kann nach ca. fünf Minuten geschlossen werden. Die Schlüssel werden durch die Verifikation in die anderen Matrixclients übernommen. Das erzeugt eine Geistersitzung welche dann immer offen ist. Dann können alle anderen Clients abgemeldet werden. Ansonsten können Nachrichten welche in dem Zeitraum ohne offene Matrixsitzung empfangen werden später nicht mehr gelesen werden. Dies soll in Zukunft mittels der Funktion dehydrated devices gelöst werden.
* Wurde die Schlüsselsicherung ordnungsgemäß eingerichtet?
* Nachrichten bleiben nicht lesbar, wenn Matrixsitzungen erstellt werden und dann das Fenster des Browsers einfach geschlossen wird, ohne sich abzumelden. Lösung: nur für neue Nachrichten möglich: diese Dokumentation durchlesen.
***
#### Was ist der Unterschied zwischen Sicherheitsphrase und Sicherheitsschlüssel? {#securityphrase-vs-securitykey}
Das Kennwort, welches für die Schlüsselsicherung benötigt wird heißt Sicherheitsprase. Damit verschlüsselt der Matrixclient den Sicherheitsschlüssel/Wiederherstellungsschlüssel. Der Sicherheitsschlüssel wird beim erstellen als security-key.txt angeboten und sollte bei Windows nicht unter Downloads gespeichert werden, da dieser von Windows gegebenenfalls automatisch bereinigt wird. Der Sicherheitsschlüssel besteht aus 12 Blöcken zu je vier Zeichen und startet mit einem großen E. Es empfiehlt sich nach dem Einrichten des Sicherheitsschlüssels diesen in einem Passwortmanager, als Datei und evlt. ausgedruckt zu speichern. Da der Sicherheitsschlüssel 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 (z.B. ein [Passsatz](https://inv.13ad.de/watch?v=jtFc6B5lmIM)), damit kann dann die Sitzung verifiziert werden und wird damit mit der Schlüsselsicherung verbunden.
***
#### 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.pfalz-mail.de/#/room/
***
#### Kann ich LaTeX schreiben? {#latex}
Ja! Zur Zeit ist es nur ein experimentelles Feature und muss in der Config-Datei des Element Clienten aktiviert werden.
***
#### Gibt es sowas wie Threads (vgl. Mattermost/Slack) in Matrix? {#threads}
Threads sind in Kürze in Matrix verfügbar und aktuell, zumindest am Element Desktop, als Laborfunktion ausprobierbar: https://github.com/vector-im/roadmap/projects/1
***
#### Ich habe keinen Wiederherstellungsschlüssel
Dafür bitte prüfen, ob diese überhaupt eingerichtet wurde. Siehe [Schlüsselsicherung](/settings/#schlüsselsicherung)
***
#### Wie ändere ich die Sicherheitsphrase für meine Schlüsselsicherung? {#change-securityphrase}
* bei allen Matrix-Sitzungen bis auf eine, auf die noch Zugriff besteht, die Raumschlüssel exportieren `Einstellungen`-> `Sicherheit & Datenschutz` -> `Verschlüsselung` hier am besten mit dem Matrix-Anmeldekennwort versehen. Abschließend abmelden, dafür links oben auf den Benutzernamen und abmelden, bei der Frage möglicherweise auftretenden Fage ob die verschüsselten Nachrichten gewünscht werden den Knopf `Ich möchte meine verschlüsselten Nachrichten nicht` betätigen, da diese Schlüssel eben schon exportiert wurden.
* Unter `Einstellungen`-> `Sicherheit & Datenschutz` -> `Sicheres Backup` erst den Knopf `Sicherung löschen`, dann den Knopf `Zurücksetzen`, möglicherweise ist ein löschen des Zwischenspeichers unter `Einstellungen`-> `Hilfe & Über` nötig, möglicherweise auch ein abmelden und erneutes anmelden mit anschließendem erneuten Versuch. Wenn das alles nicht geht, im nächsten Punkt fortfahren. Die Aktion war erfolgreich, wenn nur noch der grüne Einrichten Knopf angezeigt wird.
* Für alle vorher exportieren Schlüsselsicherungen den manuellen importweg ausführen.
* Neue Schlüsselsicherung einrichten. Siehe [Schlüsselsicherung](/settings/#schlüsselsicherung)
***
#### Wie kann ich die Schlüsselsicherung zurücksetzen, wenn ich meine Sicherheitsphrase UND meinen (abgespeicherten und ausgedruckten) Sicherheitsschlüssel verloren habe? {#reset-securityphrase}
Bitte folgendes ausführen:
1. In einer Matrix-Sitzung (=Client/Geräte/Browser), wo man die früheren verschlüsselten Gespräche noch lesen kann, die Raumschlüssel exportieren. Dazu zu unter `Einstellungen`-> `Sicherheit` -> `Verschlüsselung` auf E2E-Raumschlüssel exportieren klicken. Sollte es keinen Zugang zu irgendeiner Matrix-Sitzung mehr geben, in der frühere verschlüsselte Nachrichten lesbar sind, diesen Schritt überspringen.
2. In der einen Matrix-Sitzung, bei der man soeben in Schritt 1 die Raumschlüssel manuell exportiert hat, unter `Einstellungen`-> `Sicherheit` -> `Verschlüsselung` alle weiteren Sitzungen über die Checkbox am Zeilenende markieren und unterhalb der Liste auf den rot umrandeten Knopf „x ausgewählte Geräte abmelden“ klicken. Die oberste in Fettschrift ist die aktuelle Sitzung, diese nicht mit anhaken, also nicht löschen.
3. Ggf. ausloggen und wieder einloggen, dabei Nachfragen ignorieren.
4. Unter `Einstellungen`-> `Sicherheit` -> `Sicheres Backup` schauen ob dort ein grüner Knopf `Einrichten` und keine roten Knöpfe da sind. Oder wenn noch rote Knöpfe da sind, erst den Knopf `Sicherung löschen`, dann den Knopf `Zurücksetzen` klicken. Möglicherweise ist ein löschen des Zwischenspeichers (roter Knopf unter `Einstellungen`-> `Hilfe & Über`) nötig, möglicherweise auch ein Abmelden und erneutes aAnmelden.
5. Anschließend unter `Einstellungen`-> `Sicherheit` -> `Quersignierung` auf den roten Knopf `Zurücksetzen` drücken. Die Aktion war erfolgreich, wenn für `Sicheres Backup` und `Quersignierung` nur noch der grüne Einrichten Knopf angezeigt wird.
6. Jetzt die zuvor exportieren Schlüsselsicherungen manuell importieren. Dazu unter `Einstellungen`-> `Sicherheit` -> `Verschlüsselung` auf E2E-Raumschlüssel importieren klicken.
7. Neue Schlüsselsicherung und Quersignierung einrichten mit den zwei grünen Knöpfen. Siehe [Schlüsselsicherung]({{< relref "settings/#schlüsselsicherung" >}}). Den Sicherheitsschlüssel mehrfach ausdrucken und an verschiedenen Orten sicher aufbewahren (Verlustgefahr bspw. durch Brand, wenn nur an einem Ort).
***
#### 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}
Es können Personen via EMail eingeladen werden. Dazu einfach auf das i in der Raumansicht klicken, Personen einladen und E-Mail Adresse eingeben, dies kann beliebig oft wiederholt werden. Getestet wurden 10 Mail-Adressen gleichzeitig.
Da dazu unser Identiätsserver verwendet werden muss der die Third Party IDs (E-Mail Adresse und Handynummer wenn angegeben) verwaltet, muss diesem zuerst vertraut werden.
***
#### Kann ich mit Element mehrere Matrix-Accounts verwalten (Multi-Account-Client)? {#multiple-accounts-element}
Ein Element-Fenster kann zur Zeit nur einen Matrix-Account verwalten. Es ist aber möglich, mehrere Element-Fenster mit unterschiedlichen Matrix-Konten zu starten, auch im Autostart des Rechners. Dazu ist der Programmaufruf so abzuändern, dass ein spezifisches Profil geöffnet wird:
```
element-desktop --profile PROFILNAME
```
So lassen sich mehrere Starter im Autostart platzieren, die dann verschiedene Profilnamen haben, z.B. --profile pfalz-mail und --profile Privat. Beide geöffneten Fenster haben leider gleichaussehende Icons im Indicator-Applet. Hierfür gibt es aber sicher auch bald eine Lösung...
Darüber hinaus gibt es andere Matrix-Clients, die mehrere Matrix-Konten verwalten können, u.a. [weechat](https://matrix.org/docs/projects/client/weechat-matrix), [Spectral](https://matrix.org/docs/projects/client/spectral), [Quaternion](https://matrix.org/docs/projects/client/quaternion) oder [Mirage](https://matrix.org/docs/projects/client/mirage).
***
#### Überall steht nur „missing translation: en“ {#missing-translations}
Dieses Phänomen steht häufig im Zusammenhang mit noch nicht fertiggestellten Aktualisierungen des Matrix-Clients. Lade den Zwischenspeicher neu: Gehe in den Element-Einstellungen in die Kategorie „Hilfe und Über“ und scrolle ganz nach unten: „Zwischenspeicher löschen und neu laden“ sollte das Anzeigeproblem beheben.
#### Ist unser Server auf eurer Föderations-Blacklist? {#blacklist}
Aktuell befindet sich kein Server auf unserer Föderations-Blacklist. Dies kann nicht der Grund für etwaige Förderations-Probleme sein.
#### Ich sehe in einem Raum von einer bestimmten Person keine Nachrichten {#blocked-user}
Ein häufig vorkommender Grund hierfür ist, dass du dich verklickt hast und die Person, von der du keine Nachrichten mehr sehen kannst, obwohl dir berichtet wird, dass dort etwas stehen müsste, von dir blockiert wurde. Öffne hierzu deine Sicherheitseinstellungen und scrolle weit nach unten. Prüfe, ob in der Kategorie „Blockierte Benutzer“ Einträge stehen, die dort nicht hingehören. Entfernen diese ggf.

94
content/first-steps/_index.md Normal file
View File

@ -0,0 +1,94 @@
---
title: "Erste Schritte"
date: 2022-05-05T22:43:00+02:00
chapter: true
draft: false
weight: 2
---
# Erste Schritte - Wie kann Matrix genutzt werden?
{{% notice tip %}}
Wir empfehlen die Nutzung des Element Desktop-Clients, weil so zahlreiche Probleme, die bei dem Nutzen der Verschlüsselung entstehen können, vermieden werden können.
{{% /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 zu nutzen, und keinen neuen Account auf einem anderen Server zu erstellen. Hier am Beispiel von Element:
![Markierter Anmeldebutton im Element Matrixclient](/hilfe/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](/hilfe/images/02_Change-Homeserver_de.png)
Nun kann man manuell die Angabe des Heimservers durchführen: matrix.pfalz-mail.de
![Eingabefeld zum Ändern des Homeservers mit der Eingabe matrix.pfalz-mail.de](/hilfe/images/03_Set-Homeserver_de.png)
Anschließend ist der Login durchzuführen:
Dropdown-Menü „Anmelden mit:“ sollte auf „Benutzername“ belassen werden. Dann sind folgende Eingaben zu tätigen:
**Benutzername: Festgelegt bei Registrierung**
**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:
@benutzername:pfalz-mail.de
![Loginfenster mit Aufforderung Login und Passwort einzugeben](/hilfe/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 Mutterstadt) 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. Obwohl diese technische Notwendigkeit kompliziert klingt und im Hintergrund auch ist, ist sie 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 Pfalz-Mail Heimserver 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, die Schlüsselsicherung zu nutzen (mit einer sicheren Sicherheitsphrase, welche NICHT dein Account-Passwort ist)!
{{% /notice %}}
![Aufforderung den Sicherheitsschlüssel zu generieren oder eine Sicherheitsphrase einzugeben](/hilfe/images/11_Setup-Key_de.png)
![Aufforderung eine Passwort für die Schlüsselsicherung einzugeben](/hilfe/images/12_Enter-Key_de.png)
Alternativ kannst du dir statt der Sicherheitsphrase auch einen Sicherheitsschlüssel generieren lassen, welcher den selben Zweck wie die Sicherheitsphrase erfüllt. Weiterhin wird der Sicherheitsschlüssel immer zusätzlich zur Sicherheitsphrase erstellt und sollte als Notfallschlüssel sicher und wiederauffindbar verwahrt werden (z.B. Abspeichern als .txt-Datei UND Ausdrucken)
![Anzeige des Sicherheitsschlüssel zum abschreiben oder wegspeichern](/hilfe/images/13_Present-Key_de.png)
[Weitere wichtige Einstellungen]({{< relref "settings/_index.md" >}}) können dein Matrix-Erlebnis verbessern!
## Aufforderungen zum Einrichten der Schlüsselsicherung
![Screenshot der Aufforderung eine Sicherheitsphrase einzugeben](/hilfe/images/01_Restore-Session_de.png)
Sollte die Aufforderung zum Einrichten der Schlüsselsicherung übersprungen werden, sähe der nächste Bildschirm so aus:
![Bestätigung des Überspringens der Eingabe einer Sicherheitsphrase](/hilfe/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](/hilfe/images/04_Notification_de.png)
Solltest du auch das hier auslassen wird dir 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](/hilfe/images/05_Logout-Notify_de.png)
Vermeide diese Situation durch eine eingerichtete Schlüsselsicherung!
## Matrix-Login ohne Account
Eine Registrierung von Accounts kann bei uns ohne Probleme durchgeführt werden. Allerdings ist aktuell die Angabe einer E-Mail-Adresse Pflicht, an die auch eine Bestätigungsmail gesendet wird.
Allerdings behalte ich mir vor die Registrierungsfunktion aufgrund Missbrauch oder Spammens zu deaktivieren und nur nach schriftlicher oder persönlicher Anfrage zu gestatten.
Die Förderation mit den Matrix-Servern anderer Communities oder Organisationen ist uneingeschränkt möglich. Wenn dort ebenfalls Schindluder getrieben wird, wird dies ebenfalls zu Einschränkungen führen. Falls Matrix-Server geblacklistet werden, wird dies hier kundgetan.
## Datenschutzerklärung
Datenschutzerklärung: [Link]({{< relref "privacy/_index.md" >}})
## Impressum
Impressum: [Link]({{< relref "imprint/_index.md" >}})

19
content/imprint/_index.md Normal file
View File

@ -0,0 +1,19 @@
---
title: "Impressum"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
weight: 1000
---
# Impressum
Es gilt das [Impressum unserer Pfalz-Mail Community](https://pfalz-mail.de/impressum.html)
**Ansprechpartner und technische Umsetzung des Matrix-Dienstes**
Carsten Schmiemann <br>
Julius-Leber-Str.6 <br>
67346 Speyer <br>
Tel.: +49 151-56028081 <br>
E-Mail: carsten.schmiemann@pfalz-mail.de <br>

53
content/integrations/_index.md Normal file
View File

@ -0,0 +1,53 @@
---
title: "Integrationen"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
weight: 80
---
# Integrations, Bridges, Bots nutzen (u.a. Jitsi)
Über die Rauminformationen oben rechts können [Integrations]/(https://matrix.org/docs/guides/types-of-bridging) / Widgets verwaltet werden.
![Integration hinzufügen button](/hilfe/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.
## 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 installiert wurde: https://meet.pfalz-mail.de
Wenn das Videotelefonat über das Kameraicon rechts unten begonnen wird, wird automatisch das von uns 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 unsere Jitsi-Instanz 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).
## 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://bit-cloud.de) nutzen
## Element Matrix Services (EMS) bieten Bridge für Microsoft Teams an
Um Benutzende von Element und MS Teams zusammenzubringen bietet EMS eine MS Teams Bridge an, die allerdings kostenpflichtig ist:
[https://element.io/blog/ems-launches-bridging-for-microsoft-teams/](https://element.io/blog/ems-launches-bridging-for-microsoft-teams/) und [https://element.io/blog/microsoft-teams-and-slack-integration-using-matrix/](https://element.io/blog/ems-launches-bridging-for-microsoft-teams/).
## Custom Widget
Hierbei können beliebige Internetseiten eingebunden werden.

14
content/integrations/email.md Normal file
View File

@ -0,0 +1,14 @@
---
title: "EMail Integration"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
---
# EMail Integration
Auf unserem Heimatserver betreiben wir ein EMail Bot, welcher EMails von einem POP3 oder IMAP4 Postfach abrufen kann. Dieser kann dann über eine neue EMail benachrichtigen oder diese Mail per Text im Chat darstellen.
# Anleitung folgt
Wie man diese Integration nutzen kann, wird später noch folgen....

14
content/integrations/telegram.md Normal file
View File

@ -0,0 +1,14 @@
---
title: "Telegram Integration"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
---
# Telegram Integration
Auf unserem Heimatserver betreiben wir ein eigene Telegram Integration, um über Matrix auf Telegram-Chats und -Gruppen zuzgreifen.
# Anleitung folgt
Wie man diese Integration nutzen kann, wird später noch folgen....

40
content/messaging/_index.md Normal file
View File

@ -0,0 +1,40 @@
---
title: "Nachrichten"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
weight: 30
---
## Personen finden und direkte Nachrichten versenden
Um einzelne Personen anzuschreiben und somit einen 1:1 Chat zu erzeugen ist als Erstes auf das + in der Kategorie „Direkte Nachrichten“ zu klicken:
![Klick au den Chat starten Button](/hilfe/images/01_Start-Chat_de.png)
Nun ist in das Suchfeld zu tippen und bspw. die E-Mail-Adresse der empfangenen Person anzufangen zu tippen:
Personen, die schon einen Account in Matrix haben sind auch durch ihren Anzeigenamen (meist „Vorname Nachname“) auffindbar. Bitte nach jedem letzten eingegebenen Zeichen 5 Sekunden warten, bis die Suchergebnisse angezeigt werden. Personen, die noch nicht eingeloggt waren, sind ausschließlich über ihre E-Mail-Adresse oder ihren Login auffindbar. Der Link-Button „Show More“ lässt weitere Sucherergebnisse erscheinen. Beachte auch, auf welchem Server deine gesuchte Person angezeigt wird.
{{% notice note %}}
Ein Einfügen von E-Mail-Adressen (bspw. via Strg+V) reicht nicht aus, um Personen zu finden! Bitte gebe die Zeichen der E-Mail-Adresse per Hand ein, Zeichen für Zeichen und abschließend 5 Sekunden warten, bis zur Sichtung der Treffer.
{{% /notice %}}
![Ergebnis zugefügt zu den Personen, die in den Chat eingeladen werden](/hilfe/images/99_Find-Neo_de.gif)
Für das massenhafte Einladen von Personen (bis zu 100 auf einmal, dann wiederholbar) sind die Matrix-Namen notwendig, die in der Form @benutzername:matrix.pfalz-mail.de vorliegen sollten. Diese bspw. in einem Texteditor Zeile für Zeile sammeln und dann mittels Zwischenablage (Kopieren & Einfügen) in das Suchfeld in Matrix/Element einfügen.
Wenn du niemanden finden kannst, frage nach deren Benutzernamen oder teile deinen Benutzernamen (@benutzername:matrix.pfalz-mail.de) oder https://matrix.to/#/@benutzername:matrix.pfalz-mail.de, damit die angesprochene Person dich innerhalb von Matrix kontaktieren kann.
Eine Einladungs-E-Mail wird nicht durch Matrix versendet.
Im Suchergebnis ist auf die Zielperson zu klicken und dann auf Los:
![Ein Suchergebnis auf eingegebenen Suchanfrage](/hilfe/images/04_Found-and-Go_de.png)
Es öffnet sich das Gespräch, welches nach Annahme der Einladung durch die verbundene Person [Ende-zu-Ende-verschlüsselt]({{< relref "encryption" >}}) (inzwischen Standard) beginnen kann. Die Verbindung zum Pfalz-Mail-Server in Mutterstadt ist natürlich auch transport-verschlüsselt. Solltest du aus einem speziellen Grund explizit keine Ende-zu-Ende-Verschlüsselung wünschen, wäre ein unverschlüsselter [Raum zu erzeugen]({{< relref "rooms/create.md" >}}) und die Gesprächspartner:in in diesen einzuladen.
Weiteres: [Nachrichten formatieren]({{< relref "formatting.md" >}})
Ein Raum mit sich selbst ist auch möglich und kann als Zwischenablage / Notizbuch und für Tests benutzt werden, bspw. ob Formatierungen und Hyperlinks korrekt aussehen.

48
content/messaging/formatting.md Normal file
View File

@ -0,0 +1,48 @@
---
title: "Nachrichten formatieren"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
weight: 30
---
## Nachrichten schreiben und lesen
Nachrichten können mit der **Enter-Taste** versendet werden. Für einen Zeilenumbruch drückt man Umschalt + Enter.
![Erläuterung der Symbole in der Texteingabezeile](/hilfe/images/01_Textformatting_de.webp)
**Dateien** (auch Bilder) lassen sich bis zu einer Größe von 50MB versenden. Dazu ist die Büroklammer auszuwählen. Die Seitenleiste mit dem Dokumentensymbol zeigt die Dateien innerhalb eines Raumes an. Größere Dateien können über unsere [Bit-Cloud](https://bit-cloud.de) und einen Freigabelink geteilt werden.
Mittels Text, der in der Auszeichnungssprache [**MarkDown**](https://de.wikipedia.org/wiki/Markdown) formatiert ist, lassen sich auch in Matrix Element Nachrichten formatieren. Hier einige Beispiele:
| Ergebnis | einzutippen |
|:------------------------------------------------------------------------------- |:----------------------------------------------------------------------------------------------:|
| **Fett** | ```**Fett**``` |
| *Kursiv* | ```_Kursiv_``` |
| \| Zitat | ```> Zitat``` |
| **Überschrift 1** | ```# Überschrift 1``` |
| Überschrift 2 | ```## Überschrift 2``` |
| [Matrix Hilfe](https://matrix.pfalz-mail.de/hilfe/) | ```[Matrix Hilfe](https://matrix.pfalz-mail.de/hilfe/)``` |
| ![Pfalz-Mail](https://pfalz-mail.de/images/logo.png) | ```![Pfalz-Mail](https://pfalz-mail.de/images/logo.png)``` |
| Listeneinträge | ```* Listeneintrag```<br/>```* Listeneintrag```<br/>```* Listeneintrag```<br/> |
| Nummerierte Listen | ```1. Nummerierte Liste``` <br/>```2. Nummerierte Liste```<br/>```3. Nummerierte Liste```<br/> |
Die aktuelle [MarkDown-Spezifikation ist hier](https://spec.commonmark.org/current/) zu finden.
Das Eingeben von LaTeX-Formeln wird als Labor-Funktion unterstützt, und kann vom Gegenüber *gerendert* betrachtet werden, wenn dort auch unter Labor-Funktionen die Darstellung von LaTeX-Formeln aktiviert ist.
**Hashtags** können benutzt werden um Begriffe leichter in der Suche auffindbar zu machen.
**Emojis** erreicht man mit einem beginnenden Doppelpunkt „:“ und dem Tippen von min. zwei weiteren Buchstaben. Wer gewünschte Emoji-Namen nicht auswendig kennt, kann mit Mausklick auf das Smiley-Zeichen rechts in der Eingabezeile durch viele Emojis scrollen.
![Aufeklapptes Emoji Menü](/hilfe/images/14_Direktnachricht14.webp)
Wenn es mehr ungelesene Nachrichten in einem Raum gibt, als der Bildschirm anzeigen kann, lässt einen ein Klick auf das Symbol rechts vom zentralen Inhalt mit Dreieck nach oben und einem Punkt nach oben zur ältesten ungelesenen Nachricht springen.
![Makierung des Sprung zur letzten ungeleseen Nachrichtbuttons](/hilfe/images/18_Sprung_hoch.webp)
Analog springt man zum neuesten Zeitstempel einer Unterhaltung durch Klick auf das Dreieck nach unten in einem Kreis am rechten Rand der zentralen Inhaltsseite.
![Makierung des zur neusten Nachricht-springen buttons](/hilfe/images/18_Sprung_nach_unten.webp)
Eine Themenbasierte Darstellung, die Gedankensträngen weiter folgt (auch „Threading“ genannt), gibt es seit Ende 2021 auch in Element.

27
content/messaging/search.md Normal file
View File

@ -0,0 +1,27 @@
---
title: "Nachrichten suchen"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
weight: 40
---
## Nachrichten suchen
Nicht selten kommt es vor, dass nach älteren Gesprächsinhalten gesucht werden möchte.
Um den Nachrichtenverlauf in einem Raum (oder in allen Räumen) nach einen bestimmten Text
zu durchsuchen, befindet sich in der oberen rechte Ecke der Element-App der
"Suchen"-Button.
![Darstellung der Position des Funktionsbutton für die Suche](/hilfe/images/message-search_de.png)
Das Suchen nach Nachrichten ist in unverschlüsselten Räumen ohne Problem möglich, da
Element auf alle Nachrichten Zugriff hat. Anders sieht es in verschlüsselten Räumen aus.
Diese Funktion ist nur unter Verwendung des Desktop-Clients möglich (siehe [Clients /
Installation]({{< relref "clients" >}})), da die Nachrichten für die Suche
zwischengespeichert werden müssen. Die Nachrichtensuche muss explizit unter
`Einstellungen` -> `Sicherheit & Datenschutz` -> `Nachrichtensuche` aktiviert werden.
Anschließend ist das Suchen auch in verschlüsselten Räumen möglich.
![Einstellungsebereich für das Aktivieren der Nachrichtensuche](/hilfe/images/message-search-active_de.png)

36
content/notifications/_index.md Normal file
View File

@ -0,0 +1,36 @@
---
title: "Benachrichtigungen"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
weight: 38
---
## Benachrichtigungen feiner einstellen
Man muss seine Arbeit erledigen können und darf nicht durch Matrix gestört werden. Wir alle müssen in Zeiten der digitalen Ablenkung lernen, wie Benachrichtigungen schrittweise sinnvoll angepasst werden sollten.
*Szenario 1:*
Wenn du am Arbeiten bist, möchtest du vielleicht benachrichtigt werden, wenn deine Kolleg:innen eine Diskussion mit dir beginnen wollen. Benachrichtigungen in diesem Raum sollen aufmerksam machen und werden dementsprechend eingestellt...
*Szenario 2:*
Wenn du dich in einem Raum befindest, dessen Hauptzweck es ist, sich gelegentlich über neue Arbeiten und andere interessante Dinge zu informieren, kannst du die Benachrichtigungen abschalten und dich selbst daran erinnern, den Raum von Zeit zu Zeit zu betreten, oder sich nur laut benachrichtigen lassen, wenn dein Name in der Diskussion fällt.
### Globale Einstellungen
**Einstellungen > Benachrichtigungen**
Hier müssen ggf. Erfahrungen gemacht werden, die bei der Einschätzung helfen, welche Benachrichtigungen man wirklich zeitnah braucht und wann ein hin-und-wieder-vorbeischauen ausreicht.
Siehe [Empfehlungen zu ersten Schritten nach Erstlogin]({{< ref "settings" >}})
![Screenshot des Menüs zur Auswahl, wann Benachrichtigungen verschickt werden sollen](/hilfe/images/notifications2.webp)
### Raumweise Einstellungen
Wenn die Maus über einzelne Räume in der Raumliste bewegt wird, zeigen sich je Raum 3 graue Punkte am rechten Rand. Nach einem Klick darauf lassen sich raumindividuell die Benachrichtigungen einrichten.
![Screenshot der Benachrichtigungsoptionen in den Raumeinstellungen](/hilfe/images/notification-rooms.webp)

89
content/privacy/_index.md Normal file
View File

@ -0,0 +1,89 @@
---
title: "Datenschutz"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
weight: 900
---
## Datenschutzerklärung für den Matrix-Dienst
**Welcher Zweck wird mit der Datenverarbeitung verfolgt?**
"Matrix" ist ein offener, dezentraler Kommunikationsdienst für die Echtzeitkommunikation. Es wird allen unter Einhaltung der einschlägigen gesetzlichen und rechtlichen Bestimmungen zum Datenschutz und zur IT-Sicherheit ermöglicht, per Chat sowie Audio-/Video-Telefonie zu kommunizieren. Ziel des Einsatzes von unseren Anwendungen sind insbesondere die Abkapselung von zentralen und datenfressenden Diensten. Die Verarbeitung personenbezogener Daten ist bei uns auf ein absolutes Minimum beschränkt und wird nur zur Fehlersuche, Missbrauchserkennung oder für den eigentlichen Betrieb der Dienste verwendet.
Jeder der unsere Anwendungen nutzen möchte, kann selbst entscheiden welche Daten eingegeben werden. Es wird kein Tracking durch externe Dienstleister o.ä. durchgeführt. Zudem wird darauf geachtet möglichst keine externen Quellen für Skripte oder Schriftarten zu verwenden.
**Wer ist für die Datenverarbeitung verantwortlich und an wen können sich
betroffene wenden?**
Carsten Schmiemann <br>
Julius-Leber-Str.6 <br>
67346 Speyer <br>
Tel.: +49 151-56028081 <br>
E-Mail: [carsten.schmiemann@pfalz-mail.de ](mailto:carsten.schmiemann@pfalz-mail.de )
**Welche personenbezogenen Daten werden verarbeitet?**
Die Verarbeitung umfasst folgende personenbezogene Daten:
1. Zugangsverwaltung: Benutzername, Mailadresse, Matrix-ID, Anzeigename
2. Authentifizierung: Nutzername und Passwort
3. Benutzerinhalte: alle Daten, welche der Nutzer in das System eingibt (Ende-zu-Ende-verschlüsselt möglich)
4. Geräteidentifikation: IP-Adressen mit Zeitstempel und Gerätename; verwendete Art des Endgerätes (Mobil / Desktop), Betriebssystem
5. Serverprotokoll: IP-Adressen mit Zeitstempel
6. Audio-/Video-Telefonie: IP-Adressen, AV-Daten
7. Benachrichtigungen (Mail)
**Wie lange werden die personenbezogenen Daten gespeichert?**
Die personenbezogenen Daten in den Log-Files der Dienste werden rund 1 Monat gespeichert.
**Wozu die selbst gehosteten Dienste, wenn trotzdem geloggt wird?**
Die Log-Files sind reine Metadaten zu den Verbindungen die zu unseren Server aufgebaut werden und beinhalten keine Nutzdaten. Das Logging ist notwendig, um
Fehlersuche zu ermöglichen und eventuellen Missbrauch zu erkennen (Spambots, Angriffsversuche).
**Wie sehen die in den Log-Files erfassten Daten aus?**
<u>Matrix Server</u>
2022-05-05 22:43:43,267 - synapse.access.http.8008 - 427 - INFO - GET-290401 - 192.168.0.45 - 8008 - {@demouser:matrix.pfalz-mail.de} Processed request: 30.002sec/0.000sec (0.001sec, 0.000sec) (0.000sec/0.000sec/2) 250B 200 "GET /_matrix/client/r0/sync?filter=0&timeout=30000& since=s56354_1476335_2779_31481_53649_3_20216_7136_1 HTTP/1.0" "Mozilla/5.0 (X11; Linux x86_64; rv:100.0) Gecko/20100101 Firefox/100.0" [0 dbevts] <br>
2022-05-05 22:43:43,312 - synapse.access.http.8008 - 427 - INFO - GET-290430 - 192.168.0.45 - 8008 - {@demouser:matrix.pfalz-mail.de} Processed request: 0.004sec/0.000sec (0.001sec, 0.000sec) (0.000sec/0.000sec/2) 566B 200 "GET /_matrix/client/r0/sync?filter=0&timeout=30000&since=s56354_1476336_2779_31481_53649_3_20216_7136_1 HTTP/1.0" "Mozilla/5.0 (X11; Linux x86_64; rv:100.0) Gecko/20100101 Firefox/100.0" [0 dbevts] <br>
2022-05-05 22:43:43,507 - synapse.access.http.8008 - 427 - INFO - GET-290402 - 192.168.0.45 - 8008 - {@demouser:matrix.pfalz-mail.de} Processed request: 30.002sec/0.000sec (0.000sec, 0.000sec) (0.000sec/0.000sec/2) 250B 200 "GET /_matrix/client/r0/sync?filter=0&timeout=30000&since=s56354_1476335_2779_31481_53649_3_20216_7136_1 HTTP/1.0" "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.147 Safari/537.36" [0 dbevts] <br>
2022-05-05 22:43:43,565 - synapse.access.http.8008 - 427 - INFO - GET-290432 - 192.168.0.45 - 8008 - {@demouser:matrix.pfalz-mail.de} Processed request: 0.004sec/0.000sec (0.001sec, 0.000sec) (0.000sec/0.000sec/2) 566B 200 "GET /_matrix/client/r0/sync?filter=0&timeout=30000&since=s56354_1476336_2779_31481_53649_3_20216_7136_1 HTTP/1.0" "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.147 Safari/537.36" [0 dbevts] <br>
<u>NginX Reverse Proxy Server</u>
192.168.0.45 - - [05/May/2022:22:43:41 +0200] "GET /_matrix/client/r0/sync?filter=0&timeout=30000&since=s56354_1476335_2779_31481_53649_3_20216_7136_1 HTTP/2.0" 200 250 "-" "Mozilla/5.0 (X11; Linux x86_64; rv:100.0) Gecko/20100101 Firefox/100.0" <br>
192.168.0.45 - - [05/May/2022:22:43:41 +0200] "GET /_matrix/client/r0/sync?filter=0&timeout=30000&since=s56354_1476336_2779_31481_53649_3_20216_7136_1 HTTP/2.0" 200 566 "-" "Mozilla/5.0 (X11; Linux x86_64; rv:100.0) Gecko/20100101 Firefox/100.0" <br>
192.168.0.45 - - [05/May/2022:22:43:41 +0200] "GET /_matrix/client/r0/sync?filter=0&timeout=30000&since=s56354_1476335_2779_31481_53649_3_20216_7136_1 HTTP/2.0" 200 250 "-" "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.147 Safari/537.36" <br>
192.168.0.45 - - [05/May/2022:22:43:41 +0200] "GET /_matrix/client/r0/sync?filter=0&timeout=30000&since=s56354_1476336_2779_31481_53649_3_20216_7136_1 HTTP/2.0" 200 566 "-" "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.147 Safari/537.36" <br>
**Welche Rechte stehen den betroffenen Personen grundsätzlich zu?**
<u>Auskunftsrecht (Art. 15 DSGVO)</u>
Die Betroffenen haben das Recht, jederzeit Auskunft über die zu ihrer
Person verarbeiteten Daten sowie die möglichen Empfänger dieser
Daten verlangen zu können.
<u>Recht auf Berichtigung, Löschung und Einschränkung (Art. 16 - 18 DSGVO)</u>
Die Betroffenen können jederzeit die
Berichtigung, Löschung ihrer personenbezogenen Daten bzw. die
Einschränkung der Verarbeitung zu verlangen.
<u>Recht auf Datenübertragbarkeit (Art. 20 DSGVO)</u>
Die Betroffenen können verlangen, dass der Verantwortliche ihnen ihre
personenbezogenen Daten maschinenlesbaren in Format übermittelt.
<u>Beschwerderecht (Art. 77 DSGVO)</u>
Betroffene Personen können sich jederzeit an die zuständige Aufsichtsbehörde
für den Datenschutz wenden.

16
content/rooms/_index.md Normal file
View File

@ -0,0 +1,16 @@
---
title: "Räume"
date: 2022-05-05T22:43:00+02:00
chapter: true
draft: false
weight: 35
---
# Räume
Konversationen sind in Matrix in Räumen organisiert. 1:1-Gespräche sind auch Räume, aber eben erstmal mit nur zwei Personen. In dieser
Rubrik geht es um
1. [Räume erstellen]({{< relref "rooms/create.md" >}})
1. [Räume finden]({{< relref "rooms/find.md" >}})
1. [Räume löschen]({{< relref "rooms/delete.md" >}})
1. [Räume teilen]({{< relref "rooms/sharing.md" >}})

53
content/rooms/create.md Normal file
View File

@ -0,0 +1,53 @@
---
title: "Räume erstellen"
date: 2022-05-05T22:43:00+02:00
chapter: true
draft: false
weight: 10
---
## Räume erstellen und Verantwortung übernehmen
Neue Räume werden über das + in der linken Leiste in der Kategorie Räume erstellt.
![Makierung des Raumhinzufügenbuttons](/hilfe/images/01_Rooms_de.png)
Anschließend ist der Raumname zu vergeben. Auch kann optional ein Thema (das später öfter angepasst werden kann) vergeben werden. Optional kann der Raum auch öffentlich zugänglich gemacht werden (dies ist nicht die Standardeinstellung). Mit einem zusätzlichen Klick auf „Weitere Einstellungen anzeigen“ kann anschließend noch verhindert werden, dass Matrix-Nutzende von außerhalb unseres Pfalz-Mail Homeservers den Raum betreten können. Standard ist inzwischen, dass alle neuen Räume (genau wie alle neuen 1:1-Gespräche) eine [Ende-zu-Ende-Verschlüsselung]({{< relref "encryption" >}}) eingerichtet haben. Sollte man dies nicht wünschen (bspw. weil in sehr großen Räumen die Verifikation der Teilnehmenden sehr unpraktisch wird) kann hier vor der Raum-Erstellung der Schieberegler benutzt werden um die Ende-zu-Ende-Verschlüsselung nicht zu aktivieren.
![Eingabemenü für den Raumnamen](/hilfe/images/02_Rooms_de.png)
Der Raum ist nun erstellt und erhält eine beliebige bunte Icon-Farbe. Durch Klick auf das i oben rechts und anschließend das Zahnrad „Raum-Einstellungen“ gelangt man zu genau jenen Raum-Einstellungen:
![Makierung des Raumenstellungsbuttons für den neu erstellten Raum](/hilfe/images/03_Rooms_de.png)
Hier kann im Reiter **Allgemein** ein raumspezifisches Bild/Icon hochgeladen werden. Eine wichtige Eigenschaft ist die Vergabe einer lokalen Raumadresse. Diese kann von Menschen leichter gelesen werden als die parallel auch immer vorhandene kryptische Raumadresse (die man unter dem Reiter Erweitert einsehen kann). Die vergebene lokale Raumadresse kann dann leicht in der Öffentlichkeit bzw. an die Zielgruppe verteilt werden und hat folgende Struktur:
#Raumadressname:matrix.pfalz-mail.de
Eine weitere wichtige Einstellmöglichkeit ist hier, ob der Raum im Raum-Verzeichnis auftauchen soll. Auch die URL-Vorschau für den Raum zu aktivieren kann hier eingestellt werden.
![Raumeinstellungen](/hilfe/images/04_Rooms_de.png)
Im Reiter **Sicherheit & Datenschutz** sind für Raumadministrator:innen wichtige Entscheidungen zu treffen: Soll der Raum verschlüsselt werden? Wer darf Zugang erhalten? Und wer darf den bisherigen Chatverlauf lesen?
![Sicherheitseinstellungen für den neu erstellten Raum](/hilfe/images/05_Rooms_de.png)
**Zur Erklärung der Raumzugangsoptionen:**
1. „Nur Personen, die eingeladen wurden“: Das sind geschlossene Räume. Zugang zur Zeit nur durch explizite Einladung durch Moderator:innen oder Administrator:innen
2. „Alle, denen der Raum-Link bekannt ist (ausgenommen Gäste)“: Das ist ein öffentlicher Raum, aber lesen kann man nur, wenn man ihn betritt (und damit ersichtlich wird für alle Raummitglieder). Hier kann man genau nachvollziehen, wer wann im Raum ist, und ggf. mit Kicken und Verbannen handeln, wenn Personen dabei sind, die hier nicht hingehören sollten...
3. „Alle, denen der Raum-Link bekannt ist (auch Gäste)“: Das ist ein öffentlicher Raum, und lesen können ihn alle. Weltweit. Und Raummitglieder werden nie erfahren, wer es wann gelesen hat. Dies ist also so wie eine Internetseite, auf der alle mitschreiben können. Zu dieser Einstellung oft passend wäre auch die später zu tätigende Option, dass „Jeder“ den Chatverlauf lesen darf.
Ein "Anklopfen" an geschlossene Räume ist bisher nicht möglich. Der nahestehendste Workaround ist, an die raumadministrierende Person eine Direkte Nachricht zu senden, die einen dann einlädt.
{{% notice note %}}
Die Ende-zu-Ende-Verschlüsselung größerer oder öffentlicher Räume ist kritisch hinsichtlich der schwierigen Verifikation für viele Personen. Siehe [Ende-zu-Ende-Verschlüsselung nutzen]({{< relref "encryption" >}}).
{{% /notice %}}
{{% notice warning %}}
Als raumadministrierende Person hast du die **Verantwortung** für die im Raum geteilten Inhalte (bspw. Falschnachrichten, Hetze etc.). Binde weitere Personen in diese Verantwortung mit ein, in dem du Personen in der rechten Leiste (nach Klick auf das Personensymbol) über das Drop-Down-Menü „Berechtigungslevel“ Rollen vergeben, bspw. zu Administrator:innen oder Moderator:innen machen kannst.
{{% /notice %}}
![Dropdownmenü für die Rechtevergabe für Raumteilnehmende (Bildreihe 1)](/hilfe/images/06_Users-Permissions-1_de.png)
![Dropdownmenü für die Rechtevergabe für Raumteilnehmende (Bildreihe 2)](/hilfe/images/06_Users-Permissions-2_de.png)
Über die Admin-Werkzeuge können Sie auch auf etwaiges Fehlverhalten reagieren (Stummschalten, Kicken, Verbannen, Kürzliche Nachrichten löschen).

17
content/rooms/delete.md Normal file
View File

@ -0,0 +1,17 @@
---
title: "Räume löschen"
date: 2022-05-05T22:43:00+02:00
chapter: true
draft: false
weight: 30
---
## Räume löschen und aus Räumen austreten
Durch das Verlassen von Räumen erscheinen diese nicht mehr in der Raumliste (linke Spalte). Wenn die letzte im Raum befindliche Person den Raum verlässt, wird dieser endgültig gelöscht.
![Raumeinstellungen mit der Auswahl Verlassen](/hilfe/images/01_Leave_de.png)
Als Administrator:in sollten erst alle Raummitglieder „gekickt“ werden (aus dem Raum entfernt werden), anschließend verlässt du als letzte den Raum und initiierst so die Löschung durch den Server.
Ein Export der Raumhistorie bspw. in eine .txt- oder .html-Datei ist möglich, in der Raumansicht (i) auf Chat exportieren klicken.

16
content/rooms/find.md Normal file
View File

@ -0,0 +1,16 @@
---
title: "Räume finden"
date: 2022-05-05T22:43:00+02:00
chapter: true
draft: false
weight: 20
---
## Räume finden
Das Raumverzeichnis, in dem die öffentlich zugänglichen Räume präsentiert werden, erreicht man über den Button „Entdecke / Explore“ links oben unter dem eigenen Anzeigenamen. Hier kann sofort nach einem Raum auf unserem Pfalz-Mail Server gesucht werden.
![Menü zum finden von öffentlichen Räumen](/hilfe/images/01_Find_de.png)
{{% notice note %}}
Die globale Föderation ist aktuell uneingeschränkt möglich. Es kann sein, dass die Föderation zu späterem Zeitpunkt eingeschränkt wird (Missbrauch, Spam).
{{% /notice %}}

63
content/rooms/sharing.md Normal file
View File

@ -0,0 +1,63 @@
---
title: "Räume teilen"
date: 2022-05-05T22:43:00+02:00
chapter: true
draft: false
weight: 40
---
# Räume teilen und publik machen
Jeder Raum hat eine Adresse, die man in den Raumeinstellungen unter dem Reiter "Erweitert" finden kann, bspw.
!bEasFOtVoDJGUifrAG:matrix.pfalz-mail.de
Da diese kryptische Adresse aber von Menschen nicht leicht gelesen werden kann, können Raumadressen vergeben werden, die von Menschen gelesen werden können. Dies ist nur in Räumen nötig, die man an anderen Stellen publik machen möchte.
Entweder durch global veröffentlichte Adressen (auffindbar von Benutzenden in anderen Servern) oder durch eine lokale Adresse, die nur innerhalb unseres Matrix-Heimatservers gilt.
{{% notice note %}}
Um eine globale Adresse zu veröffentlichen, muss diese zu allererst als lokale Adresse erstellt worden sein. **Das heißt in beiden Fällen ist es notwendig eine lokale Adresse zu erstellen.**
{{% /notice %}}
Für den häufigeren Fall der gewünschten lokalen Adresse in die Raumeinstellungen unter dem Reiter Allgemein auf „Show more“ unter Local Addresses klicken:
![Raumeinstellungen mit dem mehr anzeigen ausgewählt](/hilfe/images/01_Sharing_de.png)
Anschließend kann in der „Room alias“ Zeile ein wiedererkennbarer Name dieser Raumverknüpfung vergeben werden (keine Leerzeichen!):
![Raumeinstellungen mit dem lokale Adressen ausgewählt](/hilfe/images/02_Sharing_de.png)
Es können auch verschiedene Adressen vergeben werden. Sollte die Raumadresse im Raum-Verzeichnis unseres Matrix-Heimatservers veröffentlicht werden sollen, kann dies durch den folgend gezeigten Schalter und die Auswahl der Primären Adresse im Drop-Down-Menü erfolgen:
![Raumeinstellungen mit dem öffentliche Raumadresse ausgewählt](/hilfe/images/03_Sharing_de.png)
Die Raumadresse hat dann folgende Struktur
#Raumadressname:matrix.pfalz-mail.de
Wenn innerhalb von Matrix auf einen anderen Raum verlinkt werden soll, kann dies einfach durch (beginnendes) Eintippen in das Nachrichtenfeld von
```
#Raumadressname:matrix.pfalz-mail.de
```
geschehen. Ist man selber Mitglied in dem Raum, so erscheinen automatisch Vorschläge. Dies ist dann ein spezieller Hyperlink innerhalb von Matrix, der auch direkt im Client der empfangenden Person (mit einem Mausklick) genutzt werden kann.
Erhält man solche Adressen auf anderem Wege (z.B. via E-Mail) hilft es, diese in einen persönlichen Notizraum (selbst angelegter Raum ohne weitere Personen) zu senden. Anschließend kann man dann bequem auf diesen sich ergebenden Raumlink klicken.
Das Teilen-Symbol oben rechts in jedem Raum, bietet einen matrix.to-Link an, sowie einen QR-Code und verschiedene soziale Netzwerke. Der matrix.to- Link führt auf eine Seite, auf der ausgewählt werden kann, wie der Link geöffnet werden soll. So kann z.B. der installierte Client Element Desktop verwendet werden, oder ausgewählt werden, über welchen Heimserver der Raum betreten werden soll.
![Teilensymbol in der Chatansicht des Raums makiert](/hilfe/images/04_Sharing-Button_de.png)
```
https://matrix.to/#/#Raumadressname:matrix.pfalz-mail.de?via=matrix.pfalz-mail.de
```
Weiterhin könnte man aus der vergebenen Raumadresse eine Internetadresse (URL) nach folgender Struktur konstruieren:
https://matrix.pfalz-mail.de/#/room/#Raumadressname:matrix.pfalz-mail.de
Diese könnte, ähnlich des matrix.to-Links, auch leicht in der Öffentlichkeit bzw. an die Zielgruppe verteilt werden, **öffnet sich allerdings nur in Element Web**, nicht in einem ggf. installiertem Element Desktop. Universeller (insb. für die große Gruppe an Personen mit Element Desktop) und inzwischen empfehlenswerter ist daher der zuvor beschriebene Weg mit dem matrix.to-Link.

82
content/settings/_index.md Normal file
View File

@ -0,0 +1,82 @@
---
title: "Wichtige Einstellungen"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
weight: 10
---
# Empfehlungen zu Schritten nach dem Erstlogin
## Bequemes Nutzen der Ende-zu-Ende-Verschlüsselung (E2EE)
Matrix verschlüsselt nicht nur die Transporte von und zu dem Heimserver (im Rechenzentrum Mutterstadt) 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 unserem Heimserver angeboten, auf der (mit einer Sicherheitsphrase (bzw. daraus errechenbaren Sicherheitsschlüssel) geschützt) alle kryptografischen Schlüssel verschlüsselt abgelegt sind.
{{% notice warning %}}
Es wird dringend empfohlen, diese Schlüsselsicherung zu nutzen (mit einer sicheren Sicherheitsphrase, welche NICHT dein Passwort ist) und am Punkt [Weitere wichtige Einstellungen]({{< relref "_index.md#weitere-wichtige-einstellungen" >}}) weiterlesen!
{{% /notice %}}
![Screenshot der Aufforderung eine Sicherheitsphrase einzugeben](/hilfe/images/01_Restore-Session_de.png)
Solltest du dies jetzt überspringen, sähe der nächste Bildschirm so aus:
![Bestätigung des Überspringes der Eingabe einer Sicherheitsphrase](/hilfe/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](/hilfe/images/04_Notification_de.png)
Solltest du dies auch hier auslassen wird dir 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](/hilfe/images/05_Logout-Notify_de.png)
## Weitere wichtige Einstellungen
Nach erfolgreicher Einrichtung der Schlüsselsicherung aktiviere nun die Desktop-Benachrichtigungen:
![Screenshot der Abfrage, Pushbenarchitigungen zu aktivieren](/hilfe/images/06_Enable-Notifications_de.png)
Dies kann später auch rückgängig gemacht werden und insb. können einzelne „Gespräche“ in ihrer Benachrichtigungsbefugnis eingestellt werden
Einstellungen im Einstellungsmenü vornehmen: dazu ist auf die Zeile der E-Mail-Adresse und des nach unten zeigenden Dreiecks zu klicken und anschließend auf die Zeile "Alle Einstellungen":
![Auswahl des Menüpunkts Einstellungen in dem Nutzer:innenmenü](/hilfe/images/06_Settings_de.png)
In den Einstellungen kannst du im Reiter **Allgemein** bei Bedarf deinen Anzeigenamen ändern („Vorname Nachname“) und ein Profilbild hochladen:
![Makierung des Feldes Anzeigenamen und des Profilbilds in den Einstellungen](/hilfe/images/06_Settings-Names_de.png)
Theoretisch können hier weitere Adressen hinzugefügt werden, bspw. um Benachrichtigungen über verpasste Nachrichten an eine weitere E-Mail-Adresse senden zu lassen.
Auf der selben Seite kann auch das Design Thema von hell zu dunkel verändert werden.
Im Reiter **Benachrichtigungen** kannst du E-Mail-Benachrichtigungen (um über verpasste Nachrichten informiert zu werden) sowie akustische Benachrichtigungen aktivieren und diese granular für einzelne Aktivitäten Anderer einstellen. Mehr dazu auf der Seite [Benachrichtigungen]({{< relref "notifications" >}}).
![Screenshot der Benarchrichtigungeneinstellungen mit einer Makierung der ausgeschalteten E-Mail benachrichtigungen](/hilfe/images/06_Settings-EMailNotify_de.png)
Im Reiter **Sprache & Video** kannst du den Matrix-Client Element berechtigen Ihre Medien (Kamera + Mikrofon) zu nutzen, direkten Sprach-/Videoanrufe mittels Peer-to-Peer-Verbindungen erlauben, sowie bei Videotelefonaten sich selbst in einem kleinen Bild zu sehen:
![Screenshot des Einstellungsmenüs Sprache und Video](/hilfe/images/06_Settings-Media_de.png)
Erfreulicherweise starten 1:1 Gespräche standardmäßig Ende-zu-Ende-verschlüsselt. Um dieser Verschlüsselung wirklich mit gutem Gefühl zu vertrauen, können Nutzer:innen den Schlüsselvergleich mit Gesprächspartner:innen durchführen. Damit dies dann auch für alle Geräte dieser Gesprächspartner:innen gilt, müssen Matrix-Nutzenden ihrerseits wiederum die Schlüssel all ihrer Geräte untereinander verifizieren (Fachbegriff: Cross-Signing). Unter Beachtung der nachfolgenden Hinweise kann dies alles sehr bequem geschehen.
## Sicherheit & Datenschutz
Im Reiter **Sicherheit & Datenschutz** findest du alle deine Geräte, die bisher vom Matrix-Account genutzt wurden.
* Entferne ggf. nicht mehr benutzte Sitzungen durch Markierung der quadratischen Box am Zeilenende und dem Klick auf den sich dann zeigenden roten Button.
![Screenshot des Menüs zum löschen von aktiven Sessions](/hilfe/images/09_Delete-Sessions_de.png)
* Die Geräte-Namen geben dir auch Übersicht beim gegenseitigen Schlüsselvergleich zwischen deinen Geräten.
* Die hier vergebbaren öffentlichen Namen (durch Mausklick auf diese) deiner Geräte können auch von Gesprächspartner:innen eingesehen werden. Dies hilft, wenn diese einen Vergleich der kryptografischen Schlüssel Ihrer Geräte (bspw. Laptop + Handy) durchzuführen möchten und so leicht die Gerätenamen identifizieren können.
* Die vielen kryptografischen Schlüssel werden 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 unserem Homserver angeboten, auf der (mit einer Passphrase geschützt) alle kryptografischen Schlüssel verschlüsselt abgelegt sind. Es wird dringend empfohlen, diese Schlüsselsicherung zu nutzen!
![Screenshot des Menüpunkts zur Schlüsselsicherung](/hilfe/images/10_Setup-Keystore_de.png)
## Schlüsselsicherung
Sofern nicht nach Erstanmeldung eingerichtet: Die **Schlüsselsicherung** ist eine wertvolle Errungenschaft, da sie ermöglicht, die Schlüssel aller Gespräche, die Ende-zu-Ende-verschlüsselt sind, mit einem Passwort versehen zentral auf dem Pfalz-Mail Matrix Server zu sichern. Dies ermöglicht bequem die Nutzung mehrerer Geräte bzw. Matrix-Clients. Hierzu ist auf „Beginne Schlüsselsicherung zu nutzen“ zu klicken und eine starke Sicherheitsphrase (aber nicht das Login-Passwort) zu wählen. Diese Sicherheitsphrase wird immer einzugeben sein, wenn Schlüssel mit der Schlüsselsicherung synchronisiert werden sollen.
![Aufforderung den Sicherheitsschlüssel zu generieren oder eine Sicherheitsphrase einzugeben](/hilfe/images/11_Setup-Key_de.png)
![Aufforderung eine Passwort für die Schlüsselsicherung einzugeben](/hilfe/images/12_Enter-Key_de.png)
Alternativ kannst du dich statt der Sicherheitsphrase auch einen Sicherheitsschlüssel generieren lassen, welcher den selben Zweck wie die Sicherheitsphrase erfüllt. Weiterhin wird der Sicherheitsschlüssel zusätzlich zur Sicherheitsphrase erstellt und sollte als Notfallschlüssel sicher und wiederauffindbar verwahrt werden (z.B. Abspeichern als .txt-Datei oder Ausdrucken)
![Anzeige des Sicherheitsschlüssel zum abschreiben oder wegspeichern](/hilfe/images/13_Present-Key_de.png)

17
content/spaces/_index.md Normal file
View File

@ -0,0 +1,17 @@
---
title: "Spaces"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
weight: 51
---
# Spaces zur Raumverwaltung einsetzen
## Überlick
Spaces bieten die Möglichkeit, Kontakte und Räume für eine bessere Organisation zu gruppieren. Kontakte und Räume können dabei mehreren Spaces zugeordnet werden. Spaces können wiederum andere Spaces enthalten. Es gibt drei Arten von Spaces:
* Öffentliche Spaces
* Private Spaces
* Persönliche Spaces

33
content/why/_index.md Normal file
View File

@ -0,0 +1,33 @@
---
title: "Warum Matrix?"
date: 2022-05-05T22:43:00+02:00
draft: false
chapter: true
weight: 1
---
# Warum Matrix und kein anderes Chat-System?
Es gibt sehr viele Dienste und Programme zum instantanen elektronischen Kommunizieren. Matrix wurde ausgewählt, da es sich durch folgende Eigenschaften auszeichnet:
- Offener Standard (keine technische Sackgasse)
- Kommunikationsprotokoll für föderierte Echtzeitkommunikation (keine isolierte Lösung sondern wie E-Mail mit weltweiter Konnektivität)
- Differenzierte Kommunikation möglich (1:1, multiple Teams, themenspezifisch)
- Dezentralisierte, persistente und interoperable Kommunikation (keine zentralen Kontrollinstanzen, verbindbar mit anderen Protokollen und Tools)
- Datenschutz: Ende-zu-Ende-Verschlüsselung ist Standard in 1:1-Gesprächen und (Gruppen-)Räumen, in letzteren bei Bedarf ausschaltbar
- Web-Anwendung + Desktop-Client + Mobile Apps vorhanden
- Die Kontakte auf dem eigenen Handy werden nicht automatisch an Dritte weitergegeben (kein Adressbuch-Upload)
- Anbindung an bestehende Authentifizierungssysteme (bspw. LDAP des Pfalz-Mail Exchanges)
- Bestehende erfolgreiche Sicherheitsauditierung
- Autonomie und Kontrolle: lokal installierbar (Serverstandort Mutterstadt)
- Erkennen des Anwesenheitsstatus
- Aktive Weiterentwicklung
- Aufstrebende Nutzung durch weitere Organisationen und Wissenschaftseinrichtungen
Ausführliche Informationen: https://matrix.org/faq/#intro
Ausführliches Fachbegriffs-Glossar: https://matrix.org/faq/#definitions
Hochschulen und Universitäten mit einem Matrix-Dienst:
<object data="/hilfe/images/federation_map.svg" type="image/svg+xml" style="width: 600px; max-width: 100%"></object>

3
layouts/partials/custom-footer.html Normal file
View File

@ -0,0 +1,3 @@
<center>
Text and images are licensed under <a href="https://creativecommons.org/licenses/by-sa/4.0/legalcode">CC BY-SA 4.0</a>. Sourcecode hosted on my Gitea instance <a href="https://git.bit-cloud.de/carsten.schmiemann/Matrix_Pfalz-Mail_Documentation">here</a>.
</center>

1
layouts/partials/favicon.html Normal file
View File

@ -0,0 +1 @@
<link rel="icon" type="image/png" sizes="32x32" href="{{ .Site.BaseURL }}/favicon.png">

3
layouts/partials/logo.html Normal file
View File

@ -0,0 +1,3 @@
<a id="logo" href="/">
<img src="{{ .Site.BaseURL }}/images/logo.png">
</a>

0
layouts/partials/menu-footer.html Normal file
View File

155
layouts/partials/menu.html Normal file
View File

@ -0,0 +1,155 @@
<nav id="sidebar" class="{{if $.Site.Params.showVisitedLinks }}showVisitedLinks{{end}}">
{{ $currentNode := . }}
{{ $showvisitedlinks := .Site.Params.showVisitedLinks }}
<div id="header-wrapper">
<div id="header">
{{ partial "logo.html" . }}
</div>
{{if not .Site.Params.disableSearch}}
{{ partial "search.html" . }}
{{end}}
</div>
{{ if or .Site.IsMultiLingual}}
<br/>
<section id="prefooter">
<ul>
{{ if and .Site.IsMultiLingual (not .Site.Params.DisableLanguageSwitchingButton)}}
<li>
<a class="padding">
<i class="fas fa-language fa-fw"></i>
<div class="select-style">
<select id="select-language" onchange="location = this.value;">
{{ $siteLanguages := .Site.Languages}}
{{ $pageLang := .Page.Lang}}
{{ range .Page.AllTranslations }}
{{ $translation := .}}
{{ range $siteLanguages }}
{{ if eq $translation.Lang .Lang }}
{{ $selected := false }}
{{ if eq $pageLang .Lang}}
<option id="{{ $translation.Language }}" value="{{ $translation.Permalink }}" selected>{{ .LanguageName }}</option>
{{ else }}
<option id="{{ $translation.Language }}" value="{{ $translation.Permalink }}">{{ .LanguageName }}</option>
{{ end }}
{{ end }}
{{ end }}
{{ end }}
</select>
<svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
<g>
<g id="arrow-drop-down">
<polygon points="0,63.75 127.5,191.25 255,63.75 " />
</g>
</g>
</svg>
</div>
</a>
</li>
{{end}}
</ul>
</section>
{{ end }}
<div class="highlightable">
<ul class="topics">
<li class="dd-item" data-nav-id="/" titel="Zurück zum Login">
<a href="https://matrix.pfalz-mail.de">Zurück zum Login</a>
</li>
{{if eq .Site.Params.ordersectionsby "title"}}
{{range .Site.Home.Sections.ByTitle}}
{{ template "section-tree-nav" dict "sect" . "currentnode" $currentNode "showvisitedlinks" $showvisitedlinks}}
{{end}}
{{else}}
{{range .Site.Home.Sections.ByWeight}}
{{ template "section-tree-nav" dict "sect" . "currentnode" $currentNode "showvisitedlinks" $showvisitedlinks}}
{{end}}
{{end}}
</ul>
{{ $disableShortcutsTitle := .Site.Params.DisableShortcutsTitle}}
{{with .Site.Menus.shortcuts}}
<section id="shortcuts">
<h3>{{ if not $disableShortcutsTitle}}{{ T "Shortcuts-Title"}}{{ end }}</h3>
<ul>
{{ range sort . "Weight"}}
<li>
{{.Pre}}<a class="padding" href="{{.URL | absLangURL }}">{{safeHTML .Name}}</a>{{.Post}}
</li>
{{end}}
</ul>
</section>
{{end}}
{{ if .Site.IsMultiLingual }}
<section id="prefooter">
<hr/>
<ul>
{{ if $showvisitedlinks}}
<li><a class="padding" href="#" data-clear-history-toggle=""><i class="fas fa-history fa-fw"></i> {{T "Clear-History"}}</a></li>
{{ end }}
</ul>
</section>
{{ end }}
</div>
</nav>
<!-- templates -->
{{ define "section-tree-nav" }}
{{ $showvisitedlinks := .showvisitedlinks }}
{{ $currentNode := .currentnode }}
{{ $currentFileUniqueID := "" }}
{{ with $currentNode.File }}{{ $currentFileUniqueID = .UniqueID }}{{ end }}
{{with .sect}}
{{if and .IsSection (or (not .Params.hidden) $.showhidden)}}
{{safeHTML .Params.head}}
<li data-nav-id="{{.RelPermalink}}" title="{{.Title}}" class="dd-item
{{if .IsAncestor $currentNode }}parent{{end}}
{{if eq .File.UniqueID $currentFileUniqueID}}active{{end}}
{{if .Params.alwaysopen}}parent{{end}}
">
<a href="{{.RelPermalink}}">
{{safeHTML .Params.Pre}}{{or .Params.menuTitle .LinkTitle .Title}}{{safeHTML .Params.Post}}
{{ if $showvisitedlinks}}
<i class="fas fa-check read-icon"></i>
{{ end }}
</a>
{{ $numberOfPages := (add (len .Pages) (len .Sections)) }}
{{ if ne $numberOfPages 0 }}
<ul>
{{ $currentNode.Scratch.Set "pages" .Pages }}
{{ if .Sections}}
{{ $currentNode.Scratch.Set "pages" (.Pages | union .Sections) }}
{{end}}
{{ $pages := ($currentNode.Scratch.Get "pages") }}
{{if eq .Site.Params.ordersectionsby "title"}}
{{ range $pages.ByTitle }}
{{ if and .Params.hidden (not $.showhidden) }}
{{else}}
{{ template "section-tree-nav" dict "sect" . "currentnode" $currentNode "showvisitedlinks" $showvisitedlinks }}
{{end}}
{{ end }}
{{else}}
{{ range $pages.ByWeight }}
{{ if and .Params.hidden (not $.showhidden) }}
{{else}}
{{ template "section-tree-nav" dict "sect" . "currentnode" $currentNode "showvisitedlinks" $showvisitedlinks }}
{{end}}
{{ end }}
{{end}}
</ul>
{{ end }}
</li>
{{else}}
{{ if not .Params.Hidden }}
<li data-nav-id="{{.RelPermalink}}" title="{{.Title}}" class="dd-item {{if eq .File.UniqueID $currentFileUniqueID}}active{{end}}">
<a href="{{ .RelPermalink}}">
{{safeHTML .Params.Pre}}{{or .Params.menuTitle .LinkTitle .Title}}{{safeHTML .Params.Post}}
{{ if $showvisitedlinks}}<i class="fas fa-check read-icon"></i>{{end}}
</a>
</li>
{{ end }}
{{end}}
{{ end }}
{{ end }}

124
static/css/theme-pfalzmail.css Normal file
View File

@ -0,0 +1,124 @@
:root{
--MAIN-TEXT-color:#323232; /* Color of text by default */
--MAIN-TITLES-TEXT-color: #5e5e5e; /* Color of titles h2-h3-h4-h5 */
--MAIN-LINK-color:#006ab3; /* Color of links */
--MAIN-LINK-HOVER-color:#006ab3; /* Color of hovered links */
--MAIN-ANCHOR-color: #0077b3; /* color of anchors on titles */
--MENU-HEADER-BG-color:#ffffff; /* Background color of menu header */
--MENU-HEADER-BORDER-color:#8fc0e0; /*Color of menu header border */
--MENU-SEARCH-BG-color:#20272b; /* Search field background color (by default borders + icons) */
--MENU-SEARCH-BOX-color: #ca3d3d; /* Override search field border color */
--MENU-SEARCH-BOX-ICONS-color: #8f8f8f; /* Override search field icons color */
--MENU-SECTIONS-ACTIVE-BG-color:#20272b; /* Background color of the active section and its childs */
--MENU-SECTIONS-BG-color:#252c31; /* Background color of other sections */
--MENU-SECTIONS-LINK-color: #ccc; /* Color of links in menu */
--MENU-SECTIONS-LINK-HOVER-color: #e6e6e6; /* Color of links in menu, when hovered */
--MENU-SECTION-ACTIVE-CATEGORY-color: #777; /* Color of active category text */
--MENU-SECTION-ACTIVE-CATEGORY-BG-color: #fff; /* Color of background for the active category (only) */
--MENU-VISITED-color: #006ab3; /* Color of 'page visited' icons in menu */
--MENU-SECTION-HR-color: #20272b; /* Color of <hr> separator in menu */
}
body {
color: var(--MAIN-TEXT-color) !important;
}
textarea:focus, input[type="email"]:focus, input[type="number"]:focus, input[type="password"]:focus, input[type="search"]:focus, input[type="tel"]:focus, input[type="text"]:focus, input[type="url"]:focus, input[type="color"]:focus, input[type="date"]:focus, input[type="datetime"]:focus, input[type="datetime-local"]:focus, input[type="month"]:focus, input[type="time"]:focus, input[type="week"]:focus, select[multiple=multiple]:focus {
border-color: none;
box-shadow: none;
}
h2, h3, h4, h5 {
color: var(--MAIN-TITLES-TEXT-color) !important;
}
a {
color: var(--MAIN-LINK-color);
}
.anchor {
color: var(--MAIN-ANCHOR-color);
}
a:hover {
color: var(--MAIN-LINK-HOVER-color);
}
#sidebar ul li.visited > a .read-icon {
color: var(--MENU-VISITED-color);
}
#chapter p{
text-align: start;
}
#chapter h4 {
text-align: left;
}
#body a.highlight:after {
display: left;
content: "";
height: 1px;
width: 0%;
-webkit-transition: width 0.5s ease;
-moz-transition: width 0.5s ease;
-ms-transition: width 0.5s ease;
transition: width 0.5s ease;
background-color: var(--MAIN-LINK-HOVER-color);
}
#sidebar {
background-color: var(--MENU-SECTIONS-BG-color);
}
#sidebar #header-wrapper {
background: var(--MENU-HEADER-BG-color);
color: var(--MENU-SEARCH-BOX-color);
border-color: var(--MENU-HEADER-BORDER-color);
}
#sidebar .searchbox {
border-color: var(--MENU-SEARCH-BOX-color);
background: var(--MENU-SEARCH-BG-color);
}
#sidebar ul.topics > li.parent, #sidebar ul.topics > li.active {
background: var(--MENU-SECTIONS-ACTIVE-BG-color);
}
#sidebar .searchbox * {
color: var(--MENU-SEARCH-BOX-ICONS-color);
}
#sidebar a {
color: var(--MENU-SECTIONS-LINK-color);
}
#sidebar a:hover {
color: var(--MENU-SECTIONS-LINK-HOVER-color);
}
#sidebar ul li.active > a {
background: var(--MENU-SECTION-ACTIVE-CATEGORY-BG-color);
color: var(--MENU-SECTION-ACTIVE-CATEGORY-color) !important;
}
#sidebar hr {
border-color: var(--MENU-SECTION-HR-color);
}
div.notices.warning:lang(de) p:first-child:after {
content: 'Warnung';
}
div.notices.note:lang(de) p:first-child:after {
content: 'Hinweis';
}
div.notices.info:lang(de) p:first-child:after {
content: 'Info';
}
div.notices.tip:lang(de) p:first-child:after {
content: 'Tipp';
}

BIN
static/favicon.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 991 B

BIN
static/images/00_matrix-riot.webp Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 72 KiB

BIN
static/images/01_Create-Room-wE2E_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 79 KiB

BIN
static/images/01_Find_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 69 KiB

BIN
static/images/01_Leave_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 90 KiB

BIN
static/images/01_Login_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 621 KiB

BIN
static/images/01_Restore-Session_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 690 KiB

BIN
static/images/01_Rooms_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 58 KiB

BIN
static/images/01_Sharing_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 89 KiB

BIN
static/images/01_Start-Chat_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 57 KiB

BIN
static/images/01_Textformatting_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 42 KiB

BIN
static/images/01_Textformatting_de.webp Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 104 KiB

BIN
static/images/01_Welcome_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 649 KiB

BIN
static/images/01_Widgets_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 31 KiB

BIN
static/images/02_Enter-Key_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 500 KiB

BIN
static/images/02_Login1_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 504 KiB

BIN
static/images/02_Login2_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.1 MiB

BIN
static/images/02_Login3_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.2 MiB

BIN
static/images/02_Login4_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.2 MiB

BIN
static/images/02_Messaging-Dialog_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 67 KiB

BIN
static/images/02_Rooms_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 75 KiB

BIN
static/images/02_Roomsettings_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 67 KiB

BIN
static/images/02_Sharing_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 66 KiB

BIN
static/images/03_Cancel-Restore_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 67 KiB

BIN
static/images/03_Find-Person_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 95 KiB

BIN
static/images/03_Roome2e_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 80 KiB

BIN
static/images/03_Rooms_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 97 KiB

BIN
static/images/03_Set-Homeserver_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 698 KiB

BIN
static/images/03_Sharing_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 97 KiB

BIN
static/images/04_Found-and-Go_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 79 KiB

BIN
static/images/04_Notification_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 64 KiB

BIN
static/images/04_RoomPeople_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 93 KiB

BIN
static/images/04_Rooms_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 78 KiB

BIN
static/images/04_Sharing-Button_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 93 KiB

BIN
static/images/04_Username_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 884 KiB

BIN
static/images/05_Logout-Notify_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 55 KiB

BIN
static/images/05_People-Unverified_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 93 KiB

BIN
static/images/05_Rooms_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 89 KiB

BIN
static/images/05_Settings_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 100 KiB

BIN
static/images/06_Enable-Notifications_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 72 KiB

BIN
static/images/06_Settings-EMailNotify_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 105 KiB

BIN
static/images/06_Settings-Media_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 83 KiB

BIN
static/images/06_Settings-Names_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 75 KiB

BIN
static/images/06_Settings_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 97 KiB

BIN
static/images/06_Users-Permissions-1_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 34 KiB

BIN
static/images/06_Users-Permissions-2_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 159 KiB

BIN
static/images/07_E2EE_Accept_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 111 KiB

BIN
static/images/08_Verified_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 32 KiB

BIN
static/images/09_Delete-Sessions_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 114 KiB

BIN
static/images/10_Setup-Keystore_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 96 KiB

BIN
static/images/10_Sicherheit2_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 274 KiB

BIN
static/images/11_Setup-Key_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 96 KiB

BIN
static/images/12_Element-Download.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 68 KiB

BIN
static/images/12_Element-Download.xcf Normal file
View File

Binary file not shown.

BIN
static/images/12_Enter-Key_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 86 KiB

BIN
static/images/13_Present-Key_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 84 KiB

BIN
static/images/14_Direktnachricht14.webp Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 16 KiB

BIN
static/images/15_Android1_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 119 KiB

BIN
static/images/15_Android2_de.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 77 KiB

Some files were not shown because too many files have changed in this diff Show More