Merge branch 'new_howto_theme' into 'howto_headers'

# Conflicts:
#   pages/02.tutorials/04.Chat/01.Webchat/docs.en.md
#   pages/02.tutorials/04.Chat/02.Desktop/01.pidgin/docs.en.md
#   pages/02.tutorials/04.Chat/02.Desktop/02.gajim/docs.en.md
#   pages/02.tutorials/04.Chat/02.Desktop/03.dino/docs.en.md
#   pages/02.tutorials/04.Chat/02.Desktop/docs.en.md
#   pages/02.tutorials/04.Chat/03.Mobile/01.android/01.Conversations/docs.en.md
#   pages/02.tutorials/04.Chat/03.Mobile/01.android/02.Pix-art/docs.en.md
#   pages/02.tutorials/04.Chat/03.Mobile/01.android/docs.en.md
#   pages/02.tutorials/04.Chat/03.Mobile/02.sailfishos/docs.en.md
#   pages/02.tutorials/04.Chat/03.Mobile/03.iOS/docs.en.md
#   pages/02.tutorials/04.Chat/03.Mobile/docs.en.md

pages/02.tutorials/04.Chat/01.Webchat/docs.en.md

@@ -1,66 +1,71 @@
 ---
-title: 'Chat: Web client'
+title: 'Chat: Webchat'
-updated:
-        last_modified: "April 2019"
-        app: Converse.js
-        app_version: 4.2
 published: true
-visible: false
+visible: true
+indexed: true
+updated:
+        last_modified: "11 April 2019"
+        app: Converse.js
+        app_version: 4.2.0
 taxonomy:
     category:
         - docs
     tags:
-        - Chat
+        - chat
-        - XMPP
-        - converse
 page-toc:
     active: true
 ---
 
-**NOTE:**```If the howto reffers to an older software version than the provided by``` **Disroot**,```or the one you're using in your device, there could be missing features or small parts of the information that may have changed.```<br> **Disroot's** ```how-to documentation is a community driven procces. We try to keep it as updated as we can.```
+![](en/converse.png)
-
+Converse is a free and open-source XMPP chat client that runs in a web browser and<br>**[webchat.disroot.org](https:webchat.disroot.org)** provides a way to connect to your XMPP account through it.
----
-|![](en/converse.png)|
-|:--:|
-|Converse is a free and open-source XMPP chat client that runs in a web browser and<br>**[webchat.disroot.org](https:webchat.disroot.org)** provides a way to connect to your XMPP account through it.|
 
 # Connecting
 Open your favorite web browser and go to **[webchat.disroot.org](https://webchat.disroot.org)**
 
-|![](en/01_connexion.png)|
+![](en/01_connexion.png)
-|--|
+1. **XMPP Address**: *Your_Disroot_email*
-|1. **XMPP Address**: *Your_Disroot_email*<br>2. **Password:** *Your_super_secret_Disroot_password*<br>3. **This is a trusted device**: Uncheck this box if you're not on your own computer.|
+2. **Password:** *Your_super_secret_Disroot_password*
+3. **This is a trusted device**: Uncheck this box if you're not on your own computer.
 
 # User Interface
 Once you've logged in, you may see something like this:
 
-|![](en/02_ui.png)|
+![](en/02_ui.png)
-|--|
+1. Your personnal details
-|1. Your personnal details<br>2. The list of chat rooms you're logged in and your bookmarked rooms<br>3. The current room information<br>4. The current room participants<br>5. The current room features/configuration<br>6. The current room on-going discussion<br>7. The message editor|
+2. The list of chat rooms you're logged in and your bookmarked rooms
+3. The current room information
+4. The current room participants
+5. The current room features/configuration
+6. The current room on-going discussion
+7. The message editor
 
 # Rooms
 You can participate in group discussions, also called groupschats or rooms.
 
 ## Entering a room
 
-|![](en/03_enter.png)|
+![](en/03_enter.png)
-|--|
+1. Click on this button to join or create a room.
-|1. Click on this button to join or create a room.<br>2. **Groupchat address**: Enter the address of the room you want to join. It can be a room from any XMPP server that federates. For example, if you want to join a room on **Disroot** server, add ```chat.disroot.org``` after the room name. In this image, the user is trying to join the room called ```mytestroom``` on *chat.disroot.org* XMPP server.<br>3. **Nickname**: you are free to enter whatever username you wish, it doesn't have to be your real **Disroot** username. You can then have a different username on each room you're in if you want.<br>4. **Join** the room by clicking here.|
+2. **Groupchat address**: Enter the address of the room you want to join. It can be a room from any XMPP server that federates. For example, if you want to join a room on **Disroot** server, add ```chat.disroot.org``` after the room name. In this image, the user is trying to join the room called ```mytestroom``` on *chat.disroot.org* XMPP server.
+3. **Nickname**: you are free to enter whatever username you wish, it doesn't have to be your real **Disroot** username. You can then have a different username on each room you're in if you want.
+4. **Join** the room by clicking here.
 
 ## Sending messages
 
-|![](en/05_send.png)|
+![](en/05_send.png)
-|--|
+1. Type your message here.
-|1. Type your message here.<br>2. With two buttons, you can add an emoji or share a file (it can be any type of file, maximum size being 10MB)<br>3. Click on **Send** when you're done writing your message.
+2. With two buttons, you can add an emoji or share a file (it can be any type of file, maximum size being 10MB)
+3. Click on **Send** when you're done writing your message.
 
-**Note:** Shift + Enter will allow you to add a line break.
+!! ![](/home/icons/note.png)
+!! NOTE: Shift + Enter will allow you to add a line break.
 
 You can mention people in your message so they get a notification. Just click on their nickname in the participants list, or add it manually if you know it. You can also start to write its first letters and tap on the tab key of your keyboard to have a suggestion list of nicknames.
 
 ![](en/06_mention.gif)
 
-|Here, we can see the user is actually reading stuff from the Prosody room (blue background) and get a message with its username in the Disroot Howto room.|![](en/06_mention.png)|
+Here, we can see the user is actually reading stuff from the Prosody room (blue background) and get a message with its username in the Disroot Howto room.
-|--|--|
+![](en/06_mention.png)
 
 
 ## Editing messages
@@ -98,17 +103,21 @@ If you want to get more information about the room, just click on the "i" icon o
 ## Finding a public room
 You can search for public rooms (and only for public ones):
 
-|![](en/12_search.png)|
+![](en/12_search.png)
-|--|
+1. Click on this button to open the *Search* window.
-|1. Click on this button to open the *Search* window.<br>2. Enter the address of the server you want to search public rooms on. For example, could be *chat.disroot.org*<br>3. Click on "Show groupchats"<br>4. You'll then get a list of public rooms. Just click on the one you want to join.|
+2. Enter the address of the server you want to search public rooms on. For example, could be *chat.disroot.org*
+3. Click on "Show groupchats"
+4. You'll then get a list of public rooms. Just click on the one you want to join.
 
 
 ## Creating a room
 The process is quite similar to enter an existing room.
 
-|![](en/03_enter.png)|
+![](en/03_enter.png)
-|--|
+1. Click on this button to join or create a room.
-|1. Click on this button to join or create a room.<br>2. **Groupchat address**: Enter the address of the room you want to create. It only can be a room on **Disroot** XMPP server. For example, something like *mytestroom@chat.disroot.org*.<br>3. **Nickname**: you're free to enter whatever username you wish, it doesn't have to be your real **Disroot** username. You can then have differents usernames on each room you're in if you want.<br>4. **Join** the room by clicking here. If the room already exists, then you'll join in if it is public. Otherwise, you'll need to find another room name.|
+2. **Groupchat address**: Enter the address of the room you want to create. It only can be a room on **Disroot** XMPP server. For example, something like *mytestroom@chat.disroot.org*.
+3. **Nickname**: you're free to enter whatever username you wish, it doesn't have to be your real **Disroot** username. You can then have differents usernames on each room you're in if you want.
+4. **Join** the room by clicking here. If the room already exists, then you'll join in if it is public. Otherwise, you'll need to find another room name.
 
 You'll get a message at the top of the room saying that you just succeeded in creating your room:
 ![](en/13_create.png)
@@ -116,7 +125,8 @@ You'll get a message at the top of the room saying that you just succeeded in cr
 Here are the default features of your room when you first create it:
 ![](en/14_features.png)
 
-As you've created the room, you're the owner and it's admin. So you can change those features as you want. Click on the tool icon on the top-right corner of the room page. ![](en/15_tool.png)
+As you've created the room, you're the owner and it's admin. So you can change those features as you want. Click on the tool icon on the top-right corner of the room page.
+![](en/15_tool.png)
 
 You'll then get this page:
 ![](en/15_features_list.png)
@@ -128,9 +138,11 @@ You can also chat with someone in private, in a 1:1 discussion with only the two
 ## Adding a contact
 First you'll need to add a contact before you can talk to the user.
 
-|![](en/16_add_contact.png)|
+![](en/16_add_contact.png)
-|--|
+1. Click on this button to add a contact.
-|1. Click on this button to add a contact.<br>2. **XMPP Address**: *Your_Contact_XMPP_address*. It can be any XMPP server address, as long as it federates.<br>3. **Optional nickname**: it can be anything you want.<br>4. **Add**: click on the button once you're done.|
+2. **XMPP Address**: *Your_Contact_XMPP_address*. It can be any XMPP server address, as long as it federates.
+3. **Optional nickname**: it can be anything you want.
+4. **Add**: click on the button once you're done.
 
 The contact will be informed that you have added him/her to your Contacts list. Until the user approves it, this contact can be found in your pending list:
 
@@ -150,8 +162,8 @@ To have more information about your contact, click on the ID card icon on the to
 ![](en/20_contact_details.png)
 
 ## Encrypting a conversation
-If you want your conversation to be really secure, make sure that **OMEMO** is activated. To do so, check the lock icon. If the lock looks open, then the conversation is not enrypted. ![](en/21_omemo.png)<br>
+If you want your conversation to be really secure, make sure that **OMEMO** is activated. To do so, check the lock icon. If the lock looks open, then the conversation is not enrypted. ![](en/21_omemo.png) {.inline}<br>
-If the chat is encrypted then it should look like this: ![](en/22_omemo.png)
+If the chat is encrypted then it should look like this: ![](en/22_omemo.png) {.inline}
 
 
 # Personnal details
@@ -176,9 +188,3 @@ To log out from [webchat.disroot.org](https://webchat.disroot.org), just click o
 
 # Converse.js
 To know more about the software used, check [converse.js](https://conversejs.org/) website
-
----
-
- <center><a rel="license" href="http://creativecommons.org/licenses/by- sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-sa/4.0/88x31.png" /></a><br />This work is licensed under a <br><a rel="license" href="http://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International License</a>.</center>
-
----

pages/02.tutorials/04.Chat/02.Desktop/01.pidgin/docs.en.md

@@ -4,20 +4,20 @@ updated:
     app: Pidgin
 published: true
 visible: false
+indexed: true
+updated:
 taxonomy:
     category:
         - docs
     tags:
-        - Chat
+        - chat
-        - XMPP
+        - pidgin
-        - Pidgin
 page-toc:
     active: true
 ---
 
-|![](/start/icons/pidgin.png)|
+![](/home/icons/pidgin.png)
-|:--:|
+Pidgin is multi-platform (runs on most operating systems) and multi-protocol messaging application. It supports a lot of different messaging protocols such as: XMPP, Skype, AIM, TOX, Whatsapp, Facebook, etc, so you can have all your messaging done with just one app.
-|Pidgin is multi-platform (runs on most operating systems) and multi-protocol messaging application. It supports a lot of different messaging protocols such as: XMPP, Skype, AIM, TOX, Whatsapp, Facebook, etc, so you can have all your messaging done with just one app.|
 
 
 # Installing Pidgin
@@ -42,9 +42,9 @@ Next, fill in the information needed:
 
 ![](en/pidgin4.png)
 
-|![](en/note.png) Note!|
+
-|:--:|
+!! ![](/home/icons/note.png)
-|If you want to use an avatar (optional) you can select it by checking the "Use this buddy icon for this account" option and browsing your local filesystem (computer) for the picture you want to use.|
+!! NOTE: If you want to use an avatar (optional) you can select it by checking the "Use this buddy icon for this account" option and browsing your local filesystem (computer) for the picture you want to use.
 
 Click the "**Add**" button and you're done!
 

pages/02.tutorials/04.Chat/02.Desktop/02.gajim/docs.en.md

@@ -6,23 +6,23 @@ updated:
         app_version: 1.1
 published: true
 visible: false
+indexed: true
+updated:
+        last_modified: "17 April 2019"
+        app: Gajim
+        app_version: 1.1
 taxonomy:
     category:
         - docs
     tags:
-        - Chat
+        - chat
-        - XMPP
+        - gajim
-        - Gajim
 page-toc:
     active: true
 ---
 
-**NOTE:**```If the howto reffers to an older software version than the provided by``` **Disroot**,```or the one you're using in your device, there could be missing features or small parts of the information that may have changed.```<br> **Disroot's** ```how-to documentation is a community driven procces. We try to keep it as updated as we can.```
+![](/start/icons/gajim.png)
-
+Gajim is multi-platform (runs on most operating systems) messaging application.
----
-|![](/start/icons/gajim.png)|
-|:--:|
-|Gajim is multi-platform (runs on most operating systems) messaging application.|
 
 To setup **Disroot** chat on **Gajim**, follow these easy steps:
 
@@ -231,9 +231,3 @@ Click on **OK** when you're done.
 We have just presented what we think to be the most important features to start using your XMPP account on **Gajim**. But **Gajim** is full of features, so explore them!
 
 If you have any question regarding the use of **Gajim**, join the gajim XMPP room: gajim@conference.gajim.org or check the [gitlab repo](https://dev.gajim.org/gajim/gajim)
-
----
-
- <center><a rel="license" href="http://creativecommons.org/licenses/by- sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-sa/4.0/88x31.png" /></a><br />This work is licensed under a <br><a rel="license" href="http://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International License</a>.</center>
-
----

pages/02.tutorials/04.Chat/02.Desktop/03.dino/docs.en.md

@@ -4,19 +4,20 @@ updated:
     app: Dino
 published: true
 visible: false
+indexed: true
+updated:
 taxonomy:
     category:
         - docs
     tags:
-        - Chat
+        - chat
-        - XMPP
+        - gajim
-        - Dino
 page-toc:
-    active: true
+    active: false
 ---
-|![](en/dino.png)|
+
-|:--:|
+![](en/dino.png)
-|Dino is an open source chat client for the desktop. It has support for [OMEMO](https://en.wikipedia.org/wiki/OMEMO) and [OpenPGP](https://en.wikipedia.org/wiki/Pretty_Good_Privacy#OpenPGP), which means that once you enable encryption, only you and the other person can read your messages and no one else.|
+Dino is an open source chat client for the desktop. It has support for [OMEMO](https://en.wikipedia.org/wiki/OMEMO) and [OpenPGP](https://en.wikipedia.org/wiki/Pretty_Good_Privacy#OpenPGP), which means that once you enable encryption, only you and the other person can read your messages and no one else.
 <br>
 
 1. **Installing Dino**<br>

pages/02.tutorials/04.Chat/02.Desktop/docs.en.md

@@ -2,20 +2,23 @@
 title: Chat: Desktop Clients
 updated:
 published: true
-visible: false
+visible: true
+indexed: true
+updated:
 taxonomy:
     category:
         - docs
     tags:
-        - Chat
+        - chat
-        - XMPP
 page-toc:
-     active: false
+    active: false
 ---
 
+# Chat Clients for Desktop
+
 ### Multiplatform clients
-#### [Pidgin](pidgin)
+- [Pidgin](pidgin)
-#### [Gajim](gajim)
+- [Gajim](gajim)
 
 ### GNU/Linux clients
-#### [Dino](dino)
+- [Dino](dino)

pages/02.tutorials/04.Chat/03.Mobile/01.android/01.Conversations/docs.en.md

@@ -2,19 +2,20 @@
 title: Conversations - Android
 published: true
 visible: false
+indexed: true
 updated:
-        app: Conversations
 taxonomy:
     category:
         - docs
     tags:
-        - Chat
+        - chat
-        - XMPP
+        - conversations
-        - Conversations
-        - Android
 page-toc:
     active: false
 ---
+
+# Conversations - XMPP client for android
+
 Conversations is powerful xmpp client for android that supports OTR and GPG encryption and conferences (multi-user chats). It is available on F-Droid and other commercial app stores.
 
 Here is what you need to do to get things rolling.

pages/02.tutorials/04.Chat/03.Mobile/01.android/02.Pix-art/docs.en.md

@@ -2,30 +2,24 @@
 title: 'Pix-Art messenger - Android'
 published: true
 visible: false
+indexed: true
 updated:
-        last_modified: "April 2019"
+        last_modified: "28 April 2019"
-        app: Pix-Art messenger
+        app: Pix-Art Messenger
         app_version: 2.2
 taxonomy:
     category:
         - docs
     tags:
-        - Chat
+        - chat
-        - XMPP
+        - pix-art
-        - Pix-Art messenger
-        - Android
 page-toc:
     active: true
 ---
 
-**NOTE:**```If the howto reffers to an older software version than the provided by``` **Disroot**,```or the one you're using in your device, there could be missing features or small parts of the information that may have changed.```<br> **Disroot's** ```how-to documentation is a community driven procces. We try to keep it as updated as we can.```
+![](en/pixart.png)
+Pix-Art Messenger is a powerful XMPP client for Android that supports encryption and group chats. It is a fork of Conversations and it's available on F-Droid and other commercial app stores.
 
----
-|![](en/pixart.png)|
-|:--:|
-|Pix-Art Messenger is a powerful XMPP client for Android that supports encryption and group chats. It is a fork of Conversations and it's available on F-Droid and other commercial app stores.|
-
----
 
 # Get Pix-Art messenger
 Download it from [**F-Droid**](https://f-droid.org/) and install it on your device.
@@ -288,10 +282,3 @@ Long press your account and choose **Delete account**.
 We have just presented what we think to be the most important features to start using your XMPP account on **Pix-Art**.
 
 If you have any question regarding the use of **Pix-Art**, join the Pix-Art XMPP room: support@room.pix-art.de or check the [github repo](https://github.com/kriztan/Pix-Art-Messenger)
-
-
-
-
- <center><a rel="license" href="http://creativecommons.org/licenses/by- sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-sa/4.0/88x31.png" /></a><br />This work is licensed under a <br><a rel="license" href="http://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International License</a>.</center>
-
----

pages/02.tutorials/04.Chat/03.Mobile/01.android/docs.en.md

@@ -1,7 +1,6 @@
 ---
 title: 'Chat Clients: Android'
-updated:
+published: false
-published: true
 visible: false
 taxonomy:
     category:

pages/02.tutorials/04.Chat/03.Mobile/02.sailfishos/docs.en.md

@@ -3,17 +3,20 @@ title: SailfishOS
 updated:
 published: true
 visible: false
+indexed: true
+updated:
 taxonomy:
     category:
         - docs
     tags:
-        - Chat
+        - chat
-        - XMPP
+        - sailfishos
-        - SailfishOS
 page-toc:
     active: false
 ---
 
+# XMPP on SailfishOS
+
 1. **Open Settings** app and scroll all the way down to "**Accounts**"
 
 2. Add new **XMPP** account.

pages/02.tutorials/04.Chat/03.Mobile/03.iOS/docs.en.md

@@ -4,17 +4,20 @@ updated:
     app: ChatSecure
 published: true
 visible: false
+indexed: true
+updated:
 taxonomy:
     category:
         - docs
     tags:
-        - Chat
+        - chat
-        - XMPP
+        - chatsecure
-        - iOS
-        - ChatSecure
 page-toc:
     active: false
 ---
+
+# XMPP on iOS with ChatSecure
+
 From the ChatSecure website:
 
 > ChatSecure is a free and open source messaging app that features OMEMO encryption and OTR encryption over XMPP. You can connect to your existing Google accounts or create new accounts on public XMPP servers (including via Tor), or even connect to your own server for extra security.
@@ -46,4 +49,4 @@ Here is what you need to do to get things rolling.
 
 7. You can now add contacts and join rooms!
 
-> Consider joining disroot@chat.disroot.org to interact with the Disroot community and howto@chat.disroot.org to discuss this documentation and start contributing.
+!! Consider joining disroot@chat.disroot.org to interact with the Disroot community and howto@chat.disroot.org to discuss this documentation and start contributing.

pages/02.tutorials/04.Chat/03.Mobile/docs.en.md

@@ -2,24 +2,26 @@
 title: Chat: Mobile clients
 updated:
 published: true
-visible: false
+visible: true
-published: true
+indexed: true
+updated:
 taxonomy:
     category:
         - docs
     tags:
-        - Chat
+        - chat
-        - XMPP
 page-toc:
-     active: false
+    active: false
 ---
 
+# Chat Clients for Mobile
+
 ### Android
-#### [Conversations](android/conversations)
+- [Conversations](android/conversations)
-#### [Pix-Art Messenger](android/pix-art)
+- [Pix-Art Messenger](android/pix-art)
 
 ### SailfishOS
-#### [Chat app](sailfishos)
+- [Chat app](sailfishos)
 
 ### iOS
-#### [Chat Secure](ios)
+- [Chat Secure](ios)

pages/02.tutorials/04.Chat/docsparent.en.md

@@ -15,9 +15,9 @@ page-toc:
 
 ## What is XMPP?
 
-|![](en/xmpp_logo.png)|
+![](en/xmpp_logo.png)
-|:--:|
+
-|XMPP (Extensible Messaging and Presence Protocol) is: "*a set of open technologies for instant messaging, presence, multi-party chat, voice and video calls, collaboration, lightweight middleware, content syndication, and generalized routing of XML data.*"|
+XMPP (Extensible Messaging and Presence Protocol) is: "*a set of open technologies for instant messaging, presence, multi-party chat, voice and video calls, collaboration, lightweight middleware, content syndication, and generalized routing of XML data.*"
 
 XMPP provides an open and decentralized alternative to closed instant messaging services. XMPP protocol offers a lot of advantages:
 
@@ -28,13 +28,3 @@ XMPP provides an open and decentralized alternative to closed instant messaging
 * It's **Extensible** (anyone can build custom functionality on top of the core protocols (common extensions are published in the XEP series)
 
 ... among other features.
-
-----
-## Content
-### [Webchat](webchat)
-
-### [Desktop clients](desktop)
-- Multiplatform and GNU/Linux clients
-
-### [Mobile clients](mobile)
-- Android, SeilfishOS and iOS clients