Metadados e macros

13 files changed, 165 insertions, 64 deletions

diff --git a/ChangeLog.md b/ChangeLog.md
new file mode 100644
index 0000000..86eb6aa
--- /dev/null
+++ b/ChangeLog.md
@@ -0,0 +1,8 @@
+# ChangeLog
+
+## 2024-09-14 - Reorganização
+
+* [x] Create document macros:
+  * Version.
+  * Original document (if translation, summary etc).
+  * Original document version.
diff --git a/docs/index.en.md b/docs/index.en.md
index 774fcb6..dcd80c8 100644
--- a/docs/index.en.md
+++ b/docs/index.en.md
@@ -1,3 +1,25 @@
 # Sociotechnic Protocols
 
-**Blueprints, boilerplates, models, lists, templates! Ready to use and to organize yourself and your team!**
+## About
+
+**Blueprints, boilerplates, models, lists, templates! Ready to use and to
+organize yourself and your team!**
+
+This is a repository with protocols for personal and collective management.
+
+It has procedures, behaviors and simple rules that can be freely adopted.
+When combined, they may contribute to the sprouting of complex collective
+modes of organization.
+
+They are small machines that increase the flow and organization of social
+groups.
+
+These protocols are mainly maintained in [Portuguese](/), but versions
+in other languages may be available.
+
+## Metadata
+
+* {{ metadata.version.pt }}: `ver:2024-09-14`.
+* {{ metadata.identifier.pt }}: `pid:index_en`.
+* {{ metadata.original_identifier.pt }}: `pid:index`.
+* {{ metadata.original_version.en }} `ver:2024-09-14`.
diff --git a/docs/index.md b/docs/index.md
index b47567a..eb35711 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,5 +1,7 @@
 # Protocolos e Procederes Sociotécnicos
 
+## Sobre
+
 **Modelos, listas, templates! Prontos para usar e se organizar!**
 
 Este é um repositório de protocolos de gestão pessoal e coletiva.
@@ -10,4 +12,12 @@ complexos de organização coletiva.
 
 São pequenas máquinas que aumentam a fluidez e a organização de grupos sociais.
 
+Estes protocolos são mantidos prioritariamente no idioma Português, porém
+versões noutros idiomas podem estar disponíveis, como por exemplo em [Inglês](en).
+
 [^emergencia]: Ou _emergência_, no sentido de emergir.
+
+## Metadados
+
+* {{ metadata.version.pt }}: `ver:2024-09-14`.
+* {{ metadata.identifier.pt }}: `pid:index`.
diff --git a/docs/pessoal/conduta/README.md b/docs/pessoal/conduta/README.md
index aab9dd4..93842a2 100644
--- a/docs/pessoal/conduta/README.md
+++ b/docs/pessoal/conduta/README.md
@@ -1,5 +1,14 @@
 # Códigos de Conduta Pessoal
 
+!!! warning "Alerta de gatilhos"
+
+    Esta seção trata de temas sensíveis e que podem causar desconforto.
+
+    Por outro lado, ela contém modelos de proceder cujo objetivo é
+    acabar com violências e desconfortos sociais.
+
+## Introdução
+
 Esta seção trata de códigos de conduta pessoal:
 
 * Tanto de Códigos de Conduta pré-estabelecidos em eventos, grupos etc.
@@ -8,7 +17,7 @@ Esta seção trata de códigos de conduta pessoal:
   usado em eventos e outras situações onde não haja um Código de Conduta
   explícito/definido/conhecido.
 
-!!! warning "Alerta"
+!!! warning "Alerta de comportamento"
 
     Não é porque um local/evento não possua um código de conduta explícito
     que significa que não haja código de conduta.
@@ -26,6 +35,9 @@ Esta seção trata de códigos de conduta pessoal:
 
 ## Códigos de Conduta Pré-estabelecidos
 
+Esta é uma lista incompleta de códigos de conduta pré-estabelecidos para
+participação em organizações e eventos:
+
 * [Código de Conduta da CryptoRave](https://we.riseup.net/cryptorave/politica-anti-assedio).
 * [Código de Conduta para eventos na MariaLab](https://www.marialab.org/codigo-de-conduta/).
 * [Código de Conduta Antiassédio Sexual Intervozes](https://app.rios.org.br/index.php/s/PyLXN85zywLkYBt).
@@ -37,14 +49,3 @@ Esta seção trata de códigos de conduta pessoal:
 * [Note Well - IETF](https://www.ietf.org/about/note-well/).
 * [Universal Declaration of Human Rights | United Nations](http://www.un.org/en/universal-declaration-human-rights/index.html).
 * [Chatham House Rule](https://en.wikipedia.org/wiki/Chatham_House_Rule).
-
-## Prevenção e combate
-
-Cartilhas e manuais anti-assédio e anti-discriminação:
-
-* [Prevenção aos assédios moral e sexual - Capes](https://www.gov.br/capes/pt-br/centrais-de-conteudo/documentos/16102023_Cartilha_de_Preveno_aos_assdios_moral_e_sexual.pdf).
-* [Assédio moral no trabalho: perguntas e respostas - MPT](https://mpt.mp.br/pgt/publicacoes/cartilhas/assedio-moral-no-trabalho-perguntas-e-respostas/@@display-file/arquivo_pdf).
-* [Assédio moral e sexual - Previna-se - CNMP](https://www.mpf.mp.br/sc/arquivos/cartilha-assedio)
-  ([cópia](https://www.cnmp.mp.br/portal/publicacoes/245-cartilhas-e-manuais/9982-assedio-moral-e-sexual-previna-se)).
-* [Manual sobre a prevenção e o enfrentamento ao assédio moral e sexual e à discriminação](https://mpt.mp.br/pgt/publicacoes/manuais/manual-sobre-a-prevencao-e-o-enfrentamento-ao-assedio-moral-e-sexual-e-a-discriminacao/@@display-file/arquivo_pdf).
-* [Assédio Moral, Sexual e Discriminação Saiba mais sobre essas distorções de conduta no ambiente de trabalho](https://biblioteca.mpf.mp.br/server/api/core/bitstreams/a7da884c-fefb-4641-a301-a22abeb93824/content).
diff --git a/docs/pessoal/conduta/anti-assedio.md b/docs/pessoal/conduta/anti-assedio.md
new file mode 100644
index 0000000..bdc9ff0
--- /dev/null
+++ b/docs/pessoal/conduta/anti-assedio.md
@@ -0,0 +1,12 @@
+# Anti-assédio e anti-discriminação
+
+## Prevenção e combate
+
+Cartilhas e manuais anti-assédio e anti-discriminação:
+
+* [Prevenção aos assédios moral e sexual - Capes](https://www.gov.br/capes/pt-br/centrais-de-conteudo/documentos/16102023_Cartilha_de_Preveno_aos_assdios_moral_e_sexual.pdf).
+* [Assédio moral no trabalho: perguntas e respostas - MPT](https://mpt.mp.br/pgt/publicacoes/cartilhas/assedio-moral-no-trabalho-perguntas-e-respostas/@@display-file/arquivo_pdf).
+* [Assédio moral e sexual - Previna-se - CNMP](https://www.mpf.mp.br/sc/arquivos/cartilha-assedio)
+  ([cópia](https://www.cnmp.mp.br/portal/publicacoes/245-cartilhas-e-manuais/9982-assedio-moral-e-sexual-previna-se)).
+* [Manual sobre a prevenção e o enfrentamento ao assédio moral e sexual e à discriminação](https://mpt.mp.br/pgt/publicacoes/manuais/manual-sobre-a-prevencao-e-o-enfrentamento-ao-assedio-moral-e-sexual-e-a-discriminacao/@@display-file/arquivo_pdf).
+* [Assédio Moral, Sexual e Discriminação Saiba mais sobre essas distorções de conduta no ambiente de trabalho](https://biblioteca.mpf.mp.br/server/api/core/bitstreams/a7da884c-fefb-4641-a301-a22abeb93824/content).
diff --git a/docs/pessoal/conduta/debates/README.md b/docs/pessoal/conduta/debates/README.md
deleted file mode 100644
index 982f21d..0000000
--- a/docs/pessoal/conduta/debates/README.md
+++ /dev/null
@@ -1,4 +0,0 @@
-# Conduta em Debates
-
-Existem vários modos de conduta em debates.
-Esta seção documenta alguns deles, disponibilizados para quem quiser usar.
diff --git a/docs/pessoal/conduta/modelos/README.md b/docs/pessoal/conduta/modelos/README.md
deleted file mode 100644
index a0763ad..0000000
--- a/docs/pessoal/conduta/modelos/README.md
+++ /dev/null
@@ -1,4 +0,0 @@
-# Modelos de Código de Conduta Pessoal
-
-Esta seção trata de códigos que podem ser adotados por padrão, em situações
-onde haja ausência de códigos explíticos.
diff --git a/docs/pessoal/conduta/debates/modelos/estrito.md b/docs/pessoal/conduta/modelos/debates/estrito.md
index 15e3a65..1837828 100644
--- a/docs/pessoal/conduta/debates/modelos/estrito.md
+++ b/docs/pessoal/conduta/modelos/debates/estrito.md
@@ -1,6 +1,6 @@
 # Conduta Estrita em Debates
 
-Versão: 0.0.1 (2024-08-15).
+## Introdução
 
 No modo de conduta estrita, o comportamento é otimizado para evitar
 desconfortos.
@@ -18,7 +18,7 @@ desconfortos.
 ## Preparando sua fala
 
 * Para não desperdiçar o tempo alheio, prepare de antemão a sua intervenção.
-* Prepare, se possível, materiais auxiliares (audivisuais, slides, panfletos etc).
+* Prepare, se possível, materiais auxiliares (audiovisuais, slides, panfletos etc).
 
 ## Fala inicial padrão
 
@@ -30,8 +30,9 @@ Este pode ser um exemplo de pontos para uma fala inicial padrão:
     * Agradecimento pela atenção e oportunidade.
     * Alerta sobre possíveis gatilhos, e do quanto (não-)prioritário é
       o assunto.
-    * Ainda estou aprendendo tudo isso, e gostaria de compartilhar o que
-      aprendi e sobre o que ainda quero aprender.
+    * Afirmar que ainda está aprendendo tudo isso, e que gostaria de
+      compartilhar o que aprendeu até o momento e sobre o que ainda quer
+      aprender.
     * Reconhecimento/enunciação dos meus privilégios, de quanto sou parte dos
       problemas, e quanto acredito (ou posso ser) parte das soluções.
 * Disclaimers opcionais:
@@ -65,3 +66,8 @@ Após contribuições/colocações/retornos de terceiros:
 
 * Refletir sobre como foi sua participação, especialmente relativamente
   às ponderações, sugestões etc recebidas.
+
+## Metadados
+
+* {{ metadata.version.pt }}: `0.0.2 (2024-08-15)`.
+* {{ metadata.identifier.pt }}: `pid:conduta:debate_estrito`.
diff --git a/docs/pessoal/conduta/modelos/quadrado.md b/docs/pessoal/conduta/modelos/quadrado.md
index 85e4528..ed2eea3 100644
--- a/docs/pessoal/conduta/modelos/quadrado.md
+++ b/docs/pessoal/conduta/modelos/quadrado.md
@@ -1,9 +1,9 @@
 # Pisando no Quadrado: um Código de Conduta Padrão
 
-Versão: 0.0.2 (2024-08-15).
+Este é um checklist de procedimentos e código de conduta.
+Você tem uma ideia de como se portar em cada um desses items?
 
-Este é um checklist de procedimentos e código de conduta. Você tem uma ideia de
-como se portar em cada um desses items?
+## Checklist
 
 * Comunicação implícita e explícita:
     * O que pode ser assumido de antemão.
@@ -67,3 +67,8 @@ como se portar em cada um desses items?
     * Uma maneira de abordar a ambiguidade dos alertas de gatilho talvez seja formulá-los
       de modo que a pessoa possa ter a escolha de como e quando lidar com suas
       questões, ao invés de ser pega de surpresa.
+
+## Metadados
+
+* {{ metadata.version.pt }}: `0.0.3 (2024-08-15)`.
+* {{ metadata.identifier.pt }}: `pid:conduta:quadrada`.
diff --git a/docs/todo.md b/docs/todo.md
index b5c10c8..de46d5d 100644
--- a/docs/todo.md
+++ b/docs/todo.md
@@ -14,13 +14,13 @@ Lista de tarefas deste projeto.
       * @nahema2017 sobre "protocolos atrofiados".
       * @nahema2024 pág. 107 sobre sistemas sócio-técnicos (Grupo de Tavistock).
 * [ ] Re-estruturação inspirada em projetos como o Copy Far "AI":
-    * Usar plugins de metainformação (`macros`).
-    * Re-estruturar pastas.
-    * Cada tema/tópico numa pasta, com um texto introdutório independente de
-      protocolo específico.
-    * Cada tema/tópico pode ter inúmeros protocolos.
-    * Nome, ID e versão para cada protocolo.
-    * Versão de cada documento original.
+    * [x] Usar plugins de metainformação (`macros`).
+    * [x] Nome, ID e versão para cada protocolo.
+    * [x] Versão de cada documento original.
+    * [ ] Re-estruturar pastas.
+    * [ ] Cada tema/tópico numa pasta, com um texto introdutório independente de
+          protocolo específico.
+    * [ ] Cada tema/tópico pode ter inúmeros protocolos.
 
 ## Template
 
@@ -47,35 +47,36 @@ Um esboço deste tipo foi feito no [RSP](https://rsp.fluxo.info).
         e transferências), que funcione para todos os projetos. Campos: data,
         credor, valor, ID da transação etc.
 
-## Ética
+## Conduta
 
-* [ ] Incluir nos códigos de conduta:
+* [ ] Introdução:
   * Erich Fromm: amor socialista, 2R 2C: base para qualquer relação.
-  * Política Anti-Assédio:
-    * Sobre assediadores saberem como e quem assediar. O assédio não
-      ocorre somente contra uma pessoa, como é parte de toda uma rede
-      de relações sociais onde assediadores estabelecem níveis de
-      relação, compartimentalização, divisionismo etc de modo que
-      seja estabelecida um modus operandi de perpetuação e
-      acobertamento.
-  * Conduta estrita:
-    * Se te consideram, ou se você se considera, uma pessoa de privilégios.
-    * Avisar as pessoas quando você não estiver em condições de convívio,
-      para que não pensem que o problema é com elas.
-    * Não encostar nas pessoas.
-    * Não encarar ninguém.
-    * Relações poluídas, pré-carregadas de traumas e más experiências
-      anteriores. Cada pessoa pode trazer bagagens boas e ruins numa
-      relação. E as relações tendem a já começar dentro de uma sociedade
-      poluída com violências.
-    * Primeiro encontro, tensão, assumir as piores possibilidades, precaução.
-      Voto de boas intenções, compreensão das tensões pré-existentes e
-      voto de confiança para que eventuais encontros posteriores sejam
-      melhores; encontros subsequentes confiança.
-    * Reconhecer o quanto sua mera existência ou presença já pode ser uma
-      violência para outros seres. Tentar ao máximo reduzir essa violência.
-    * Estimar se a sua presença e atitudes serão mais benéficas do que os
-      prejuízos que ela pode trazer a outros seres e ao ambiente.
+* [ ] Linguagens inclusivas, de gênero neutro, não-binárias etc.
+* [ ] Política Anti-Assédio:
+  * Sobre assediadores saberem como e quem assediar. O assédio não
+    ocorre somente contra uma pessoa, como é parte de toda uma rede
+    de relações sociais onde assediadores estabelecem níveis de
+    relação, compartimentalização, divisionismo etc de modo que
+    seja estabelecida um modus operandi de perpetuação e
+    acobertamento.
+* [ ] Conduta estrita:
+  * Se te consideram, ou se você se considera, uma pessoa de privilégios.
+  * Avisar as pessoas quando você não estiver em condições de convívio,
+    para que não pensem que o problema é com elas.
+  * Não encostar nas pessoas.
+  * Não encarar ninguém.
+  * Relações poluídas, pré-carregadas de traumas e más experiências
+    anteriores. Cada pessoa pode trazer bagagens boas e ruins numa
+    relação. E as relações tendem a já começar dentro de uma sociedade
+    poluída com violências.
+  * Primeiro encontro, tensão, assumir as piores possibilidades, precaução.
+    Voto de boas intenções, compreensão das tensões pré-existentes e
+    voto de confiança para que eventuais encontros posteriores sejam
+    melhores; encontros subsequentes confiança.
+  * Reconhecer o quanto sua mera existência ou presença já pode ser uma
+    violência para outros seres. Tentar ao máximo reduzir essa violência.
+  * Estimar se a sua presença e atitudes serão mais benéficas do que os
+    prejuízos que ela pode trazer a outros seres e ao ambiente.
 
 ## Expedições
 
diff --git a/docs/usando.md b/docs/usando.md
index 2a5d110..26bfe51 100644
--- a/docs/usando.md
+++ b/docs/usando.md
@@ -1,5 +1,7 @@
 # Como usar este projeto
 
+## Introdução
+
 A modularidade de tais protocolos permite que eles sejam adotados tanto como um
 todo quanto em pequenos conjuntos (ou mesmo unitariamente) sem perda de
 consistência desde que seja observada a dependência entre protocolos/processos.
@@ -12,4 +14,12 @@ de texto `$coletivo` podem ser substituídas pelo nome do seu grupo.
 
 ## Clonando o código
 
-    git clone https://git.fluxo.info/templates
+O código pode ser obtido diretamente de um dos seus espelhos:
+
+* Espelho #1: [https://git.fluxo.info/templates](https://git.fluxo.info/templates).
+* Espelho #2: [https://0xacab.org/rhatto/protocolos.git](https://0xacab.org/rhatto/protocolos.git).
+
+## Metadados
+
+* {{ metadata.version.pt }}: `ver:2024-09-14`.
+* {{ metadata.identifier.pt }}: `pid:usando`.
diff --git a/mkdocs.yml b/mkdocs.yml
index 0f00786..2df8a87 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -75,6 +75,7 @@ plugins:
       - locale: en
         name: English
         build: true
+
       - locale: pt
         name: Português
         build: true
@@ -82,6 +83,10 @@ plugins:
         nav_translations:
           Provedor: Provider
 
+  # MkDocs-Macros Plugin
+  # https://mkdocs-macros-plugin.readthedocs.io
+  macros: {}
+
   # Redirects
   # https://github.com/mkdocs/mkdocs-redirects
   # In case site re-structure is needed, this plugin will ensure permalink functionality
@@ -117,3 +122,32 @@ copyright: Copyleft © 2024
 # https://www.mkdocs.org/user-guide/configuration/#extra
 extra:
   generator: false
+
+  metadata:
+    version:
+      pt: >
+        Versão deste documento
+
+      en: >
+        Document version
+
+    identifier:
+      pt: >
+        Identificador
+
+      en: >
+        Identifier
+
+    original_identifier:
+      pt: >
+        Documento original
+
+      en: >
+        Original document
+
+    original_version:
+      pt: >
+        Traduzido e adaptado da versão original em Português
+
+      en: >
+        Translated and adapted from the original Portuguese version
diff --git a/scripts/provision b/scripts/provision
index a22e424..a47f524 100755
--- a/scripts/provision
+++ b/scripts/provision
@@ -13,7 +13,7 @@ DEPENDENCIES="mkdocs apache2 python3-pip pandoc"
 DEPENDENCIES="$DEPENDENCIES tor python3-requests python3-bs4 python3-socks python3-pybtex"
 
 # PyPI dependencies
-DEPENDENCIES_PIP="mkdocs-bibtex mkdocs-material mkdocs-awesome-pages-plugin mkdocs-static-i18n mkdocs-redirects"
+DEPENDENCIES_PIP="mkdocs-bibtex mkdocs-material mkdocs-awesome-pages-plugin mkdocs-static-i18n mkdocs-redirects mkdocs-macros-plugin"
 
 # Ensure an up-to-date system
 sudo apt-get update && sudo apt-get dist-upgrade -y && sudo apt-get autoremove -y && sudo apt-get clean