Merge branch 'master' into meazdev

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>