make clean extract

Author: badlop

content/CONTAINER.md

@@ -926,7 +926,7 @@ Let's summarize the differences between both container images. Legend:
 | Generated by          | [container.yml](https://github.com/processone/ejabberd/blob/master/.github/workflows/container.yml) | [tests.yml](https://github.com/processone/docker-ejabberd/blob/master/.github/workflows/tests.yml) |
 | Built for             | stable releases <br /> `master` branch | stable releases <br /> [`master` branch zip](https://github.com/processone/docker-ejabberd/actions/workflows/tests.yml) |
 | Architectures         | `linux/amd64` <br /> `linux/arm64` | `linux/amd64` |
-| Software              | Erlang/OTP 27.3.2-alpine <br /> Elixir 1.18.3 | Alpine 3.19 <br /> Erlang/OTP 26.2 <br /> Elixir 1.15.7 |
+| Software              | Erlang/OTP 27.3.3-alpine <br /> Elixir 1.18.3 | Alpine 3.19 <br /> Erlang/OTP 26.2 <br /> Elixir 1.15.7 |
 | Published in          | [ghcr.io/processone/ejabberd](https://github.com/processone/ejabberd/pkgs/container/ejabberd) | [docker.io/ejabberd/ecs](https://hub.docker.com/r/ejabberd/ecs/) <br /> [ghcr.io/processone/ecs](https://github.com/processone/docker-ejabberd/pkgs/container/ecs) |
 | :black_square_button: **Additional content** |
 | [ejabberd-contrib](https://docs.ejabberd.im/admin/guide/modules/#ejabberd-contrib) | included | not included |

content/README-DOCS.md

@@ -103,6 +103,7 @@ _`bookmarks_to_pep`_ API
 _`default_db`_
 _`basic.md#captcha|CAPTCHA`_
 https://xmpp.org/extensions/xep-0045.html[XEP-0045]
+(def:c2s)
 ```
 
 gets converted into this markdown:
@@ -113,6 +114,45 @@ gets converted into this markdown:
 [default_db](toplevel.md#default_db)
 [CAPTCHA](basic.md#captcha)
 [XEP-0045](https://xmpp.org/extensions/xep-0045.html)
+[](def:c2s)
 ```
 
 There are example usage of those shorthands in ejabberd, for example in `mod_muc.erl`.
+
+## Glossary
+
+### Directly in markdown file
+
+To define a new term, write in markdown:
+
+``` markdown
+def:c2s
+: Client to Server connection in XMPP.
+```
+
+To link to that term, write in markdown:
+
+``` markdown
+Most connections in XMPP are [](def:c2s).
+```
+
+Glossary terms can be defined as singular nouns (`connection`, `port`), and later you can link to that term in plural noun (`connections`, `ports`).
+
+### In ejabberd source code
+
+Term definition is done as expected; example usage:
+``` erlang
+mod_doc() ->
+    #{desc =>
+          [?T("def:ad-hoc command"), "",
+           ?T(": Command that can be executed by an XMPP client using XEP-0050."), "",
+           ?T("This module implements XEP-0050.")]
+```
+
+In order to link to a term definition, please write simply `(def:c2s)` because `[]` becomes escaped and wouldn't work. Later `make extract` will add the `[]` automatically. Example usage:
+```erl
+mod_doc() ->
+    #{desc =>
+          ?T("This module implements some (def:ad-hoc commands) for adminitration.")
+```
+

content/admin/configuration/modules.md

@@ -14,6 +14,10 @@ search:
 mod\_adhoc
 ----------
 
+def:ad-hoc command
+
+: Command that can be executed by an XMPP client using XEP-0050.
+
 This module implements [XEP-0050: Ad-Hoc
 Commands](https://xmpp.org/extensions/xep-0050.html). It’s an auxiliary
 module and is only needed by some of the other modules.
@@ -30,8 +34,7 @@ mod\_adhoc\_api 🟤
 <!-- md:version added in [25.03](../../archive/25.03/index.md) -->
 
 
-Execute [API Commands](https://docs.ejabberd.im/developer/ejabberd-api/)
-in a XMPP client using [XEP-0050: Ad-Hoc
+Execute [](def:API commands) in a XMPP client using [XEP-0050: Ad-Hoc
 Commands](https://xmpp.org/extensions/xep-0050.html). This module
 requires [mod_adhoc](#mod_adhoc) (to execute the commands), and recommends
 [mod_disco](#mod_disco) (to discover the commands).
@@ -40,9 +43,9 @@ __Available options:__
 
 - **default\_version**: `integer() | string()`  
 What API version to use. If setting an ejabberd version, it will use the
-latest API version that was available in that ejabberd version. For
-example, setting `"24.06"` in this option implies `2`. The default value
-is the latest version.
+latest API version that was available in that [](def:c2s) ejabberd
+version. For example, setting `"24.06"` in this option implies `2`. The
+default value is the latest version.
 
 __**Example**:__