Merge pull request 'GNOME_Integration_H2' (#60) from GNOME_Integration_H2 into master

Reviewed-on: Disroot/Howto#60

pages/02.tutorials/02.Cloud/05.Clients/01.Desktop/02.GNU-Linux/01.gnome-desktop-integration/docs.en.md

@@ -1,10 +1,10 @@
 ---
-title: GNU/Linux: GNOME Desktop Integration
+title: 'Cloud: GNOME Integration'
 visible: false
 updated:
-        last_modified: "8 April 2019"
-        app: Gnome
-        app_version: 3.30.2 For Manjaro Linux
+        last_modified: "January 2021"
+        app: GNOME
+        app_version: 3.38.2 on Manjaro Linux
 page-toc:
   active: true
 published: true
@@ -17,45 +17,185 @@ taxonomy:
         - integration
 ---
 
-# Gnome Integration
+# GNOME Desktop Integration
 
-Gnome is a very popular, slick, modern and easy to use graphical desktop environment for Linux. It's my desktop of choice and it is mainly due to it's awesome integration with Disroot's cloud services.
+**GNOME** is a free and open source graphical desktop environment for **GNU/Linux** based operating systems. It has an excellent integration with **Disroot**'s cloud services.
 
-Integration with desktop environment means, you no longer need to login to Disroots cloud via the browser, every time you need to add or lookup information. It means everything you need is available to you directly from your desktop. Furthermore it makes it look and feel unified with all other apps you use while you work. It's definitely **THE** way to get things done.
+In the context of desktop environments, integration is the ability to use a number of web services and applications directly on the desktop as if they were just computer programs. In the case of **GNOME**, moreover, this level of integration makes it look and feel unified with the rest of the applications.
 
-In this tutorial I would like to show you how easy and handy it is to integrate your cloud calendar on your computer. Setup procedure should take no longer then few minutes of your time.
+Once you have set up your **Disroot** account with **GNOME** you will not need to configure anything else. On top of that, the process is incredibly simple.
 
+<a name="top"></a>
 
-# Set Online accounts
+----
 
-In order to get up and running, all you need to do is:
+# Setting up an Online Account
 
- - Go to Gnome **Settings** (eg. type settings in the dashboard search)
- - Open **"Online Accounts"**
- - Select **"Nextcloud"** (or owncloud if using older version)
- - Follow instructions to fill in all your credentials:
-    - **Address:** https://cloud.disroot.org
-    - **Username:** *yourusername*
+ - Open the **GNOME Settings**
+ - Go to **Online Accounts**
+ - Select **Nextcloud**
+ - Fill in the required data:
+    - **Server:** https://cloud.disroot.org
+    - **Username:** *your_username*
     - **Password:** *your_super_secret_password*
+ - Click on **Connect**
 
-If you did that correctly now you can choose which aspects of the cloud you want to integrate. You can switch them on and off at any time depending on your use case. I choose to integrate it all.
+If you entered the data correctly, a box will appear with the aspects that you can integrate. By default, they are all active, but you can activate/deactivate them as you wish.
 
-![](en/gnome_online_accounts1.gif)
+![](en/goa.mp4?resize=1024,576&autoplay=1&loop)
+
+Now services such as the **Calendar**, **Tasks** and **Contacts** can be found and used directly on your desktop.
+
+Next we will see how to work with the **Cloud** services integrated in the **GNOME** desktop.
 
 
 # Calendar
 
-One of the useful features is calendar. You will notice that your calendars are already integrated if you press on the  **current time** in your top bar on the desktop. A popup window with a calendar will automatically display all the events from your disroot's cloud account. You will of course receive all notifications on upcoming events as well.
+The Calendar app is quite easy to use. From it you can manage your calendars and perform basic operations such as adding, editing and removing events. To do this you need to have installed the **GNOME Calendar** app.
 
-![](en/gnome_calendar1.gif)
+!! _It should be already installed and accessible from the **Software menu**. If not, you will have to search for it and download it from the system's software centre._
 
-In order to add/edit/remove events or have better overview on all your calendars, I suggest installing Gnome Calendar app.
-Depending on your operating system you should search for it in your "Software" application (linux app store).
+![](en/installing_calendar_app.mp4?resize=1024,576&autoplay=1&loop)
 
-![](en/gnome_install_calendar.png)
+Well, once you have your account connected you will notice that your calendars are already integrated if you press on the **current time** in your top bar on the desktop. The calendar window will automatically display all the events (if any) from your **Disroot**'s cloud account. You will, of course, receive all notifications on upcoming events as well.
 
-Once you get it installed, you'll notice your calendars are already integrated thanks to the global "Online Accounts" you set up earlier. The application is very simple, and still missing some features to be complete (eg. recurrence) but it enables you to do basic things such as create/delete/edit calendar entries. You can select which calendars you would like to see and which ones to disable (in case you have numerous calendars). You can create/modify/delete events, and they'll be all synchronized with disroot cloud, which means also with all the devices connected to it.
+![](en/connected_calendar.mp4?resize=752,700&autoplay=1&loop)
 
-![](en/gnome_calendar2.gif)
+## Manage your calendars
 
-![](en/gnome_calendar3.gif)
+If you have already created one or more calendars in the **Cloud**, when you open the **GNOME Calendar** app, you will see them in it along with their respective events (if any).
+
+![](en/calendar_app.png)
+
+You can check and manage your calendars by clicking on the calendar icon.
+
+![](en/calendar_manage.png)
+
+Through this menu you can:
+
+- Mark/unmark the calendars to make them visible in the applicatión and work on them.
+- Synchronize them
+- Add, import, remove or disconnect a calendar
+
+![](en/calendar_manage_02.png)
+
+To add or import a calendar that does not belong to your online account, click on **Add Calendar...**
+
+![](en/calendar_manage_03.png)
+
+From this menu you can add a calendar by entering its URL address or upload one that you have previously exported in .ics format, assign it a name and colour.
+
+!! **TIP**
+!! To learn how to get the URL address of a calendar in the **Cloud** or export it, you can check this [**Calendar tutorial**](/tutorials/cloud/apps/calendar/web).
+
+## Adding and editing an event
+
+There are several ways to manage an event depending on the time view you are positioned in.
+
+For example, whether you are in the monthly, weekly or annual calendar view, you can always add an event by clicking on the **+** (plus) icon in the upper left of the top bar.
+
+![](en/calendar_add_event.png)
+
+You can also add an event from the weekly view by clicking on the time of a day or from the yearly view by clicking on the **Add event...** button at the bottom right. In any case, a box will open with the basic options (name and calendar to which it belongs) for adding an event.
+
+![](en/calendar_adding.png)
+
+To add more detailed information about the event, click on **Edit Details...**.
+
+![](en/event_details_01.png)
+
+Now you can:
+
+- Select which calendar the event will belong to
+
+  ![](en/event_calendar_select.png)
+
+- Add a name or title for the event and set a location if you want to
+
+  ![](en/event_calendar_title.png)
+
+- Schedule the event. You can set if it is an all-day event or if it is at a particular time on a particular date and if it is recurrent, which means that it happens every day, week, month, etc.
+
+ ![](en/event_schedule_01.png)
+
+ ![](en/event_schedule_02.png)
+
+- Set reminders
+
+  ![](en/event_reminders.png)
+
+- And add notes to help you get organized
+
+  ![](en/event_notes.png)
+
+Once you feel that the event information is complete, just click **Done**. It will automatically synchronize with the calendar in the **Cloud** and you will be able to view it on any device where you have it configured.
+
+If you need to edit an event, simply click on it, make the necessary changes and then click **Done** again.
+
+[Back to the top](#top)
+
+# Tasks
+The tasks are linked to the calendars so once your online account is synced up, the tasks will be too.
+
+**GNOME** includes a **ToDo** app. Open it to manage the tasks you have linked to your **Disroot** account.
+
+![](en/tasks_01.png)
+
+It use is quite intuitive and works basically like the web app.
+
+## Adding lists and tasks
+
+To add a list of tasks:
+1. Click on **New List** and write the name of your new list
+2. Click on the computer icon and select where the list will be saved
+3. Click on **Create List**
+
+![](en/tasks_02.png)
+
+You can also select a colour for the list by clicking the colour button at the right of the list title.
+
+![](en/list_colour.png)
+
+
+To add a task to a list:
+1. Select a list
+2. Click on the **New task...** field, write the name of the task and press enter
+
+![](en/tasks_add.png)
+
+3. Clicking the arrow icon to the right of the task title will display a menu to add notes, set a due date and priority, as well as the option to delete the task.
+
+![](en/tasks_options.png)
+
+Like calendars, tasks will be synchronised with the cloud and you can access them from any device or application you have configured.
+
+
+[Back to the top](#top)
+
+# Contacts
+Your contacts in the **Cloud** are also synchronised when you connect your account and are easily accessible from **GNOME** via the **Contacts** application and you can edit them by clicking on a contact name.
+
+![](en/contacts_01.png)
+
+## Adding a contact
+Before adding a new contact, you can select which address book it should go to by clicking the **three dots** menu in the top bar.
+
+![](en/contacts_select_addressbook.png)
+
+Now to add a new contact just click on the **+** (plus) icon in the upper left of the top bar.
+
+![](en/contacts_add.png)
+
+Add all the information you need and when you are done click on **Add**.
+
+![](en/contacts_add_02.png)
+
+
+[Back to the top](#top)
+
+# Documents
+Once your account is connected you can access and work with your documents and files in the cloud from your file manager.
+
+![](en/documents.mp4?resize=1096,630&autoplay=1&loop)
+
+[Back to the top](#top)

pages/02.tutorials/02.Cloud/05.Clients/01.Desktop/docs.en.md

@@ -14,13 +14,14 @@ page-toc:
     active: false
 ---
 
-<br>
+## Multiplatform Desktop Clients
+- [**Nextcloud** client](multiplatform/desktop-sync-client)
+- [**Thunderbird**](multiplatform/thunderbird-calendar-contacts)
+- [**calcurse** command line client](multiplatform/calcurse-caldav)
 
-### [Multiplatform Desktop Clients](multiplatform)
-- **Nextcloud** multiplatform clients
+## GNU/Linux
+- [**GNOME** desktop integration](gnu-linux/gnome-desktop-integration)
+- [**KDE** desktop integration](gnu-linux/kde-desktop-integration)
 
-### [GNU/Linux](gnu-linux)
-- Desktop Integration
-
-### [MacOS](mac-os)
-- MacOS device integration
+## MacOS
+- [**MacOS** device integration](mac-os)

pages/02.tutorials/02.Cloud/05.Clients/docs.en.md

@@ -1,22 +1,27 @@
 ---
-title: Cloud: Clients
+title: 'Cloud: Clients'
 published: true
+visible: true
+indexed: true
 updated:
+        last_modified: "December 2020"
+        app: Nextcloud
+        app_version: 20
 taxonomy:
     category:
         - docs
     tags:
         - cloud
+        - nextcloud
         - clients
-visible: true
 page-toc:
-    active: false
+  active: false
 ---
 
-<br>
+## [Desktop clients and Integration](desktop)
+- How to setup **Nextcloud** and others sync clients
+- Desktop environments integration on GNU/Linux
 
-### [Desktop clients and Integration](desktop)
-- Nextcloud and others sync clients, settings
-
-### [Mobile clients](mobile)
-- Nextcloud Apps, clients, DAVx⁵, device settings
+## [Mobile clients](mobile)
+- **Nextcloud** mobile client
+- **DAVx⁵**, device settings