Merge branch 'meazdev' of https://git.disroot.org/Disroot/Howto into meazdev

pages/02.tutorials/03.Email/02.Filters/01.forward/docs.en.md

@@ -21,7 +21,7 @@ We understand that not everyone wants to use **Disroot** mail as their daily dri
 
 However, there are important information you should not miss out on.
 
- - Get notifications for **Forum** and **Nextcloud**. Those services are tight to **Disroot** email and you can't change it.
+ - Get notifications for **Forum** and **Nextcloud**. These services are tied to **Disroot** email and you can not change it.
  - To be up to date with what's going on in **Disroot**. Every three / six weeks we're sending email to all users informing them about recent developments, new features and services. We're also sending information about scheduled downtime of services if they are longer than 20 min. We have no intention to spam you with too much information so don't worry about that.
 
 This short how-to will show you how to forward your **Disroot** emails to your preferred email address (it should take you no more than three minutes to get this setup).

pages/02.tutorials/04.Chat/04.Transports/01.IRC/docs.en.md

@@ -0,0 +1,77 @@
+---
+title: 'Chat Transports: IRC'
+published: true
+visible: true
+indexed: true
+updated:
+        app: Biboumi
+        app_version: 9.0
+taxonomy:
+    category:
+        - docs
+    tags:
+        - chat
+        - xmpp
+page-toc:
+    active: true
+---
+
+# XMPP <-> IRC
+
+Disroot Chat provides [Biboumi](https://biboumi.louiz.org/), an IRC transport for XMPP, at irc.disroot.org.
+
+## SYNTAX
+
+The syntax for connecting to IRC channel is:
+
+`#channel%irc.network.tld@irc.disroot.org`
+
+The syntax for connecting to IRC user is:
+
+`nick%irc.network.tld@irc.disroot.org`
+
+## SETTINGS
+
+Settings can be configured at three different levels, by executing ad-hoc commands on respective items:
+
+1. IRC-Transport Level: `irc.disroot.org`
+2. IRC-Network Level: `irc.network.tld@irc.disroot.org`
+3. IRC-Channel Level: `#channel%irc.network.tld@irc.disroot.org`
+
+If there are common options across all the levels, priority or over-ride of those settings happens in the order of [3] > [2] > [1].
+
+## STEPS
+
+### For short-term/one-shot
+
+1. Join chat `#channel%irc.network.tld@irc.disroot.org`, with a chosen nick.
+2. You'll get messages from `irc.network.tld@irc.disroot.org`. If your nick is registered, send message `NickServ IDENTIFY password`.
+3. Start chatting in `#channel`.
+
+Repeat 1 and 3, for different channel on same network.
+
+Repeat 1 to 3, for different channel on different network.
+
+### For long-term/recurring
+
+1. Add `irc.disroot.org` to your roaster.
+2. Execute ad-hoc command on it, then enable history and persistence.
+3. Add `irc.network.tld@irc.disroot.org` to your roaster.
+4. Execute ad-hoc command on it, then add your username (nick) and password (nick password).
+5. Add `#channel%irc.network.tld@irc.disroot.org` to bookmarks and then join.
+6. Execute ad-hoc command on it, then enable history and persistence.
+7. Start chatting in `#channel`.
+
+Repeat 5 to 7, if joining different channel on same network.
+
+Repeat 3 to 7, if joining different channel on different network.
+
+## CLIENTS
+
+Any client can be used, although only following clients are known to support ad-hoc commands.
+
+### Gajim
+
+1. Right-click on the roaster element.
+2. Click 'Execute Command'.
+3. Follow the options.

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

@@ -0,0 +1,23 @@
+---
+title: 'Chat: Transports'
+published: true
+visible: true
+indexed: true
+updated:
+taxonomy:
+    category:
+        - docs
+    tags:
+        - chat
+        - xmpp
+page-toc:
+    active: true
+---
+
+# XMPP Transports
+
+In XMPP realm, transports are the means to connect to different protocols.
+
+Currently, Disroot Chat provides following transports:
+
+1. [IRC](https://howto.disroot.org/en/tutorials/chat/transports/irc)

themes/grav-theme-howto/templates/default.html.twig

@@ -1,5 +1,5 @@
 {% extends 'partials/base.html.twig' %}
 
 {% block content %}
-    {{ page.content }}
+    {{ page.content|raw }}
 {% endblock %}

themes/grav-theme-howto/templates/docsparent.html.twig

@@ -35,14 +35,14 @@
       {% include 'partials/docmeta.html.twig' %}
 
       <section class="index content narrow">
-            {{ page.content }}
+            {{ page.content|raw }}
              <div class="row">
                  {% for p in page.children %}
                      <div class="three columns">
                      {%if p.header.indexed %}
                          <a href="{{ p.link }}">
                          {%if p.media %}
-                            {{ p.media.images|first.html }}
+                            {{ p.media.images|first.html|raw }}
                          {% endif %}
                          <h6>{{ p.title }}</h6>
                          </a>

themes/grav-theme-howto/templates/error.html.twig

@@ -3,6 +3,6 @@
 {% block content %}
     <div class="lead text-center">
         <h1>Error!</h1>
-        {{ page.content }}
+        {{ page.content|raw }}
     </div>
 {% endblock %}

themes/grav-theme-howto/templates/home.html.twig

@@ -10,7 +10,7 @@
 {% set colsize = ['seven', 'five'] %}
 <section id="{{ page.header.section_id }}" class="row columns">
   <div class="{{ colsize[0] }} columns">
-    {{ page.content }}
+    {{ page.content|raw }}
   </div>
   <div class="{{ colsize[1] }} columns topic-list">
     {% for p in page.collection %}

themes/grav-theme-howto/templates/modular.html.twig

@@ -4,10 +4,10 @@
 {% macro pageLinkName(text) %}{{ text|lower|replace({' ':'_'}) }}{% endmacro %}
 
 {% block content %}
-    {{ page.content }}
+    {{ page.content|raw }}
     <div id="content">
         {% for module in page.collection() %}
-                {{ module.content }}
+                {{ module.content|raw }}
         {% endfor %}
     </div>
 {% endblock %}

themes/grav-theme-howto/templates/partials/base.html.twig

@@ -17,13 +17,13 @@
         {% do assets.addCss('theme://css/style.css') %}
         {% do assets.addCss('theme://css/media-queries.css') %}
     {% endblock %}
-    {{ assets.css() }}
+    {{ assets.css()|raw }}
 
-        {% block javascripts %}
+    {% block javascripts %}
         {% do assets.addJs('jquery', 100) %}
         {% do assets.addJs('theme://js/howto.js', { group:'bottom' }) %}
     {% endblock %}
-    {{ assets.js() }}
+    {{ assets.js()|raw }}
 
 {% endblock head%}
 </head>