Add comment system documentation

content/pages/politica-de-uso.eo.md

@@ -45,6 +45,8 @@ povas viziti la retpaĝaron kun prokurilo kiel
 [Tor](https://eo.wikipedia.org/wiki/Tor_(programaro)) aŭ
 <a href="https://eo.wikipedia.org/wiki/VPN"><abbr title="Virtuala Privata Reto">VPN</abbr></a> por havi pli privatecon.
 
+### Komentoj
+
 Pri la artikoloj oni povas fari anonimajn komentojn, kun falsaj nomoj aŭ
 kun realaj datumoj. Okaze de ajno volu forigi aŭ rektifi komenton, ri devu
 [kontakti nin]({filename}/pages/contacto.md)
@@ -52,3 +54,27 @@ demonstranta, kiu vi skribis la komenton, en tiu kazo ni indikos, ke oni
 eliminis aŭ modifis la komenton kiel ni trovis tion bone, ĉiam penante
 esti plej travidebla eble kun la aliaj partoprenantoj de la konversacio
 kaj evitante perdi la ĉirkaŭtekston de aliaj komentoj.
+
+#### Kiel montri avataron en la komentoj?
+
+CL implementis libavatar por montri la avataron en la komentoj, do se vi
+volas montri avataron vi devas alŝuti ĝin al [libavatar.org][libravatar],
+tiamaniere la avataro povas esti ŝanĝita de la konto de la uzanto en
+[libavatar.org][libravatar].
+
+#### Kiel mencii uzanton?
+
+Pro la foresto de Javaskripto en la komenta sistemo.
+Mencii uzanton povas esti malfacila, tamen ni nur devas meti
+etikedon `<a>` al la komenco de la komento,
+Jen mi montras al vi ekzemplon:
+
+    <a href="#comment-saravia-20191118-20:14:50">@saravia</a>
+    Responda Mesaĝo
+
+kie:
+
+- `#comment-saravia-20191118-20:14:50` estas la `id` de la komento
+  de la uzanto por respondi.
+
+[libravatar]: https://www.libravatar.org/

content/pages/politica-de-uso.md

@@ -52,6 +52,8 @@ usando un proxy como
 <a href="https://es.wikipedia.org/wiki/Red_privada_virtual"><abbr title="Red Privada Virtual">RPV</abbr></a>
 para contar con mayor privacidad.
 
+### Comentarios
+
 Sobre los artículos se pueden realizar comentarios anónimos, con nombres
 falsos o con datos reales. En caso de que alguien desee eliminar o
 rectificar un comentario, deberá
@@ -61,3 +63,28 @@ ha sido eliminado o modificado de la forma que estimemos oportuna,
 siempre intentando ser lo más transparentes posibles con el resto de
 participantes en la conversación y evitando perder el contexto de otros
 comentarios.
+
+#### ¿Cómo lucir un avatar en los comentarios?
+
+CL ha implementado libavatar para mostrar el avatar en los comentarios,
+entonces si desea lucir un avatar deberá subirla a [libavatar.org][libravatar],
+de esta forma los avatar pueden ser cambiados desde la cuenta del
+usuario en [libavatar.org][libravatar].
+
+#### ¿Cómo mencionar a un usuario?
+
+Debido a la ausencia de Javascript en el sistema de comentarios.
+Mencionar a un usuario puede ser algo dificil, sin embargo solo debemos
+colocar una etiqueta `<a>` al inicio del comentario,
+aquí os muestro un ejemplo:
+
+    <a href="#comment-saravia-20191118-20:14:50">@saravia</a>
+    Mensaje de respuesta.
+
+donde:
+
+- `#comment-saravia-20191118-20:14:50` es el `id` del comentario del
+   usuario a responder.
+
+
+[libravatar]: https://www.libravatar.org/

plugins/pelican_comments/README.md

@@ -50,6 +50,21 @@ authors and date/time. For example:
 
 It doesn't matter what the files are named.
 
+# How to mention a user ?
+
+Due to the absence of javascript in the comment system.
+Mentioning a user can be difficult, however we just have
+to put a `<a>` tag at the beginning of the comment,
+Here I show you an example:
+
+    <a href="#comment-saravia-20191118-20:14:50">@saravia</a>
+    Reply message.
+
+where:
+
+- `#comment-saravia-20191118-20:14:50` is the comment `id` of the
+  user to respond.
+
 # Example folder structure
 
 	.