From 82cc75b997d3a1243728559c6151cf5e9bc7de20 Mon Sep 17 00:00:00 2001 From: creme Date: Thu, 5 Aug 2021 16:38:39 +0200 Subject: [PATCH] update client pages --- docs/clients.md | 32 ++++++++++++++--------------- docs/clients/browser.md | 38 ++++++++++++++++------------------- docs/clients/desktop.md | 21 ++++++++----------- docs/clients/install_linux.md | 2 +- docs/clients/mobile.md | 7 ++----- docs/clients/more_clients.md | 4 ++-- 6 files changed, 45 insertions(+), 59 deletions(-) diff --git a/docs/clients.md b/docs/clients.md index 96bc25a..418e21a 100644 --- a/docs/clients.md +++ b/docs/clients.md @@ -1,40 +1,38 @@ --- title: "Clients / Installation" -date: 2020-07-02T21:22:27+02:00 -draft: false -chapter: true -weight: 15 +date: 2021-08-03T20:30:00+02:00 --- # Installation of a client / program The recommended client for using Matrix is called Element and can be used on different systems and devices: -1. **Element Web:** [The TU Dresden browser web application](#web-app) -1. **Element Desktop:** [Downloads for Linux/Windows/Mac](#desktop-app) -1. **Element mobile:** [Android/iOS](#mobile-app) -![Element page for client download](images/12_Element-Download.png) +- **Element Web:** [The envs.net webclient](#element_web) +- **Element Desktop:** [Downloads for Linux/Windows/Mac](#element_desktop) +- **Element mobile:** [Android/iOS](#element_mobile) -## Element Web {#web-app} +![Element page for client download](/images/12_Element-Download.png) -Web-App: {{% button href="https://matrix.tu-dresden.de" icon="fas fa-globe" %}}matrix.tu-dresden.de{{% /button %}} +## Element Web + +Web-App: [:fontawesome-solid-globe: element.envs.net](https://element.envs.net){ .md-button } The easiest way is to open the Element Web application directly in a modern browser (e.g. [Mozilla Firefox](https://www.mozilla.org/de/firefox/)). -Further information can be found in the submenu ["Element Web (Browser)"]({{< ref "clients/browser" >}} "Element Web (Browser)"). +Further information can be found in the submenu ["Element Web (Browser)"](/clients/browser/). -## Element Desktop {#desktop-app} +## Element Desktop -Downloads for: {{% button href="https://packages.riot.im/desktop/install/win32/x64/Element%20Setup.exe" icon="fas fa-download" %}}Windows{{% /button %}} {{% button href="https://packages.riot.im/desktop/install/macos/Element.dmg" icon="fas fa-download" %}}macOS{{% /button %}} {{% button href="/clients/install_linux" icon="fas fa-download" %}}Linux{{% /button %}} +Downloads for: [:fontawesome-solid-download: Windows](https://packages.riot.im/desktop/install/win32/x64/Element%20Setup.exe){ .md-button } [:fontawesome-solid-download: macOS](https://packages.riot.im/desktop/install/macos/Element.dmg){ .md-button } [:fontawesome-solid-download: Linux](/clients/install_linux){ .md-button } More recommendable than using a browser tab is the installation of the program Element on your own computer. Here you can keep the overview independently of the browser (however, you should also take care of the updates of the program). -More information can be found in the submenu ["Element Desktop"]({{< ref "desktop.md" >}} "Element Desktop"). +More information can be found in the submenu ["Element Desktop"](/clients/desktop/). -## Element Mobile {#mobile-app} +## Element Mobile -Downloads for: {{% button href="https://play.google.com/store/apps/details?id=im.vector.app" icon="fas fa-download" %}}Android (Google Play){{% /button %}} {{% button href="https://apps.apple.com/app/vector/id1083446067" icon="fas fa-download" %}}iOS (iPhone/iPad){{% /button %}} {{% button href="https://f-droid.org/packages/im.vector.app/" icon="fas fa-download" %}}Android (F-Driod){{% /button %}} +Downloads for: [:fontawesome-solid-download: Android (Google Play)](https://play.google.com/store/apps/details?id=im.vector.app){ .md-button } [:fontawesome-solid-download: Android (F-Driod)](https://f-droid.org/packages/im.vector.app/){ .md-button } [:fontawesome-solid-download: iOS (iPhone/iPad)](https://apps.apple.com/app/vector/id1083446067){ .md-button } To have access to Matrix on the road, there is the possibility to install a mobile element client on the smartphone. -Further information can be found in the submenu ["Element Mobile"]({{< ref "mobile.md" >}} "Element Mobile"). +Further information can be found in the submenu ["Element Mobile"](/clients/mobile/). diff --git a/docs/clients/browser.md b/docs/clients/browser.md index 9da5474..b2faf76 100644 --- a/docs/clients/browser.md +++ b/docs/clients/browser.md @@ -1,49 +1,46 @@ --- title: "Element Web (Browser)" -date: 2020-07-15T16:46:07+02:00 -draft: false -chapter: true -weight: 10 +date: 2021-08-03T20:30:00+02:00 --- # Using the Element webclient -Start here: [https://matrix.tu-dresden.de](https://matrix.tu-dresden.de) + +Start here: [https://element.envs.net](https://element.envs.net) ![Start page of Element Webclient with login button](/images/01_Welcome_en.png) -No registration is necessary, the service can be used immediately by clicking on "Register" on the homepage [https://matrix.tu-dresden.de](https://matrix.tu-dresden.de). +Registration is necessary, the service can be used by clicking on "Create Account" on the homepage [https://element.envs.net](https://element.envs.net). -![Login window with request to enter ZIH login and password](/images/02_Login1_en.png) +After the Registration you need to confirm your account. Check your mail Inbox. -The drop-down menu "Log in with:" should be left at "User name". Then the following entries must be made: +Now you can Login to your webclient. -**Username: ZIH-Login** (only the ZIH-Login, no e-mail address!) +![Login window with request to enter Username and Password](/images/02_Login1_en.png) -**Password: ZIH password** +The drop-down menu "Log in with:" should be left at "Username". Then the following entries must be made: -An alternative login, e.g. using the e-mail address, is **NOT** possible during the first, initial login, only after the second login. +**Username** -After the first login there is also no e-mail / confirmation mail. +**Password** Analogous to e-mail addresses, this results in matrix addresses with the following structure: -@ZIH-Login:tu-dresden.de +`@username:envs.net` -{{% notice warning %}} -If you want to start immediately with a [Matrix Client]({{< relref "../clients" >}}) instead of the above mentioned website (Element Web-App installed at TU Dresden), it is important to change the home server from the usually default matrix.org to https://matrix.tu-dresden.de (shown in the following three screenshots) -{{% /notice %}} +!!! note + If you want to start immediately with a [Matrix Client](/clients/) instead of the above mentioned website (Element Web-App hosted on envs.net), it is important to change the home server from the usually default `matrix.org to` [`https://matrix.envs.net`](https://matrix.envs.net) (shown in the following three screenshots) ![Change login page with focus on the homeserver Button](/images/02_Login2_en.png) 1. click on change -![input field to change the home server with the input matrix.tu-dresden.de](/images/02_Login3_en.png) +![input field to change the home server with the input matrix.envs.net](/images/02_Login3_en.png) 2. mark the preset home server address and remove it ![](/images/02_Login4_en.png) -3. entry of the matrix home server address of the TU Dresden +3. entry of the matrix home server address of envs.net ## Browser settings @@ -55,11 +52,10 @@ Recommended are the browsers [Firefox](https://www.mozilla.org/de/firefox/new/), Many people use script blockers to protect themselves from [Tracking](https://tu-dresden.de/tu-dresden/newsportal/news/datenschutz-beim-website-tracking) and malware in the browser, for example with the addon [NoScript](https://addons.mozilla.org/de/firefox/addon/noscript/). Here you have to make the following settings (for the integration manager, e.g. Jitsi/Etherpad) -![Browser plugin settings NoScript with tu-dresden.de and vector.im selected as trusted script sources](/images/10_Sicherheit2_en.png) +![Browser plugin settings NoScript with envs.net selected as trusted script sources](/images/10_Sicherheit2_en.png) ### Cookies Do you also allow cookies from -- tu-dresden.de -- vector.im (for the integration manager) +- envs.net diff --git a/docs/clients/desktop.md b/docs/clients/desktop.md index 526eee9..6113476 100644 --- a/docs/clients/desktop.md +++ b/docs/clients/desktop.md @@ -1,18 +1,13 @@ --- title: "Element Desktop" -date: 2020-10-12T09:27:07+02:00 -draft: false -chapter: true -weight: 20 +date: 2021-08-03T20:30:00+02:00 --- ## Element Desktop -Downloads for: {{% button href="https://packages.riot.im/desktop/install/win32/x64/Element%20Setup.exe" icon="fas fa-download" %}}Windows{{% /button %}} -{{% button href="https://packages.riot.im/desktop/install/macos/Element.dmg" icon="fas fa-download" %}}macOS{{% /button %}} -{{% button href="/clients/install_linux/" icon="fas fa-download" %}}Linux{{% /button %}} +Downloads for: [:fontawesome-solid-download: Windows](https://packages.riot.im/desktop/install/win32/x64/Element%20Setup.exe){ .md-button } [:fontawesome-solid-download: macOS](https://packages.riot.im/desktop/install/macos/Element.dmg){ .md-button } [:fontawesome-solid-download: Linux](/clients/install_linux){ .md-button } -After a desktop installation, make sure to use the existing account with the ZIH login and not to create a new account on another server. Here the example of Element: +After a desktop installation, make sure to use the existing account or create a new account on the envs.net homeserver. Here the example of Element: ![Selected login button in the element matrix client](/images/01_Login_en.png) @@ -20,14 +15,14 @@ This is done by clicking on **Change**. Then you will not accidentally end up on ![Change login page with focus on the homeserver button](/images/02_Change-Homeserver_en.png) -Now you can manually specify the home server: tu-dresden.de +Now you can manually specify the home server: `matrix.envs.net` -![Input field to change the home server with the input matrix.tu-dresden.de](/images/03_Set-Homeserver_en.png) +![Input field to change the home server with the input matrix.envs.net](/images/03_Set-Homeserver_en.png) -Afterwards the one-time login with ZIH login and ZIH password must be carried out: +Afterwards the one-time login with Username and Password must be carried out: -![Login window with request to enter ZIH login and password](/images/04_Username_en.png) +![Login window with request to enter Username and Password](/images/04_Username_en.png) -By activating the slider under Settings > Settings > "**Automatic start after system login**", the element client starts after every reboot and you no longer miss any notifications due to accidentally closing the browser tab in the usage variant with the Web App. +By activating the slider under `All Settings` > `Preferences` > **`Automatic start after system login`**, the element client starts after every reboot and you no longer miss any notifications due to accidentally closing the browser tab in the usage variant with the Web App. ![settings marked with the dot start automatically after system startup](/images/05_Settings_en.png) diff --git a/docs/clients/install_linux.md b/docs/clients/install_linux.md index 4539cc6..eda69ef 100644 --- a/docs/clients/install_linux.md +++ b/docs/clients/install_linux.md @@ -1,8 +1,8 @@ --- title: "Install on Linux" date: 2021-08-03T20:30:00+02:00 -weight: 2 --- + # Install Element Desktop on Linux We recommend using the package manager of your System to install Element Desktop. The following commands will install element desktop. You can enter them on the command line. diff --git a/docs/clients/mobile.md b/docs/clients/mobile.md index 04434ce..d72d994 100644 --- a/docs/clients/mobile.md +++ b/docs/clients/mobile.md @@ -1,14 +1,11 @@ --- title: "Element Mobile" -date: 2020-10-12T09:29:07+02:00 -draft: false -chapter: true -weight: 30 +date: 2021-08-03T20:30:00+02:00 --- ## Element Mobile -Downloads for: {{% button href="https://play.google.com/store/apps/details?id=im.vector.app" icon="fas fa-download" %}}Android (Google Play){{% /button %}} {{% button href="https://apps.apple.com/app/vector/id1083446067" icon="fas fa-download" %}}iOS (iPhone/iPad){{% /button %}} {{% button href="https://f-droid.org/packages/im.vector.app/" icon="fas fa-download" %}}Android (F-Driod){{% /button %}} +Downloads for: [:fontawesome-solid-download: Android (Google Play)](https://play.google.com/store/apps/details?id=im.vector.app){ .md-button } [:fontawesome-solid-download: Android (F-Driod)](https://f-droid.org/packages/im.vector.app/){ .md-button } [:fontawesome-solid-download: iOS (iPhone/iPad)](https://apps.apple.com/app/vector/id1083446067){ .md-button } The following series of images shows screenshots of the setup of Android or iOS Element: diff --git a/docs/clients/more_clients.md b/docs/clients/more_clients.md index c32d6ee..cfb007b 100644 --- a/docs/clients/more_clients.md +++ b/docs/clients/more_clients.md @@ -7,5 +7,5 @@ date: 2021-08-03T20:30:00+02:00 For users who like to experiment, there are numerous other clients in addition to Element, with which the Matrix communication protocol can be used: -- https://matrix.org/docs/projects/clients-matrix -- https://matrix.org/docs/projects/try-matrix-now +- [https://matrix.org/clients/](https://matrix.org/clients/) +- [https://matrix.org/docs/projects/try-matrix-now](https://matrix.org/docs/projects/try-matrix-now)