mvp-tema-i18n (#9): mais documentação no README.md, Voluntarius Auxil…

…io Tuo

README.md

@@ -5,7 +5,7 @@
 [![GitHub Repo stars](https://img.shields.io/github/stars/HXL-CPLP/Auxilium-Humanitarium-API?style=social)](https://github.com/HXL-CPLP/Auxilium-Humanitarium-API) 
 [![Download .zip](https://img.shields.io/badge/Download-.zip-brightgreen)](https://github.com/HXL-CPLP/Auxilium-Humanitarium-API/archive/refs/heads/main.zip)
 
-## Links
+## Praefātiōnem
 
 1. **❓🌐 https://hapi.etica.ai/ 🌐❓**
     1. ❗ https://github.com/HXL-CPLP/hapi.etica.ai ❗
@@ -25,6 +25,54 @@
 
 > @TODO: [por] adicionar mais links
 
+## Voluntarius Auxilio Tuo
+
+<!--
+Trivia:
+- fundātōrem
+  - https://en.wiktionary.org/wiki/fundator#Latin
+- "pictūram"
+  - https://en.wiktionary.org/wiki/pictura#Latin
+- "opus"
+  - https://en.wiktionary.org/wiki/opus#Latin
+- "trānslātiōnem"
+  - https://en.wiktionary.org/wiki/translatio#Latin
+- "commūnitātem"
+  - https://en.wiktionary.org/wiki/communitas
+- "auxilium"
+  - https://en.wiktionary.org/wiki/auxilium
+-->
+
+```yaml
+
+- namen: Thalles Augusto
+  opus:
+    - fundatarem
+  picturam: https://avatars.githubusercontent.com/u/61105850?v=4
+  iri: https://github.com/ThesllaDev
+  github: https://github.com/ThesllaDev
+  linkedin: https://www.linkedin.com/in/thalles-augusto/
+
+- namen: Emerson Rocha
+  opus:
+    - fundatarem
+  picturam: https://avatars.githubusercontent.com/u/812299?v=4
+  iri: https://github.com/fititnt
+  github: https://github.com/fititnt
+  linkedin: https://www.linkedin.com/in/fititnt/
+
+- namen: Sine nomine (multis clanculum civibus)
+  opus:
+    - translationem
+    - commanitatem-auxilium
+  picturam: https://avatars.githubusercontent.com/u/50434491?v=4
+  iri: https://github.com/eticaaibot
+  github:
+  gitee:
+  linkedin:
+
+```
+
 ## English
 
 ### Note to maintainers in English
@@ -39,5 +87,79 @@
 
 ## Português
 
-> TODO: [por] Começar a mover documentação de como manter o projeto para este
-  arquivo.
+Seja uma pessoa bem vinda ao projeto **Documentação interativa para APIs humanitárias**!
+
+Neste momento, 2021-05-16, este projeto está em fase de desenvolvimento alfa e,
+ainda que o site hapi.etica.ai possa ser usado pelo publico final, não há
+documentação em como aceitar colaboração externa. Se você já não foi convidado
+por algum de nossos membros e tem nosso contato direto, por favor entre em
+contato por e-mail, Facebook, WhatsApp, LinkedIn ou o que for com membros do
+HXL-CPLP.
+
+### Introdução rápida
+
+- **Site público**: <https://hapi.etica.ai/>
+- **GitHub, código fonte**: <https://github.com/HXL-CPLP/Auxilium-Humanitarium-API>
+- **GitHub, código fonte de hapi.etica.ai**: <https://github.com/HXL-CPLP/hapi.etica.ai>
+- **Fontes de dados externas**:
+  - [docs.google.com: HXL-CPLP-Vocab_Auxilium-Humanitarium-API](https://docs.google.com/spreadsheets/d/1ih3ouvx_n8W5ntNcYBqoyZ2NRMdaA0LRg5F9mGriZm4/edit#gid=1181688279)
+
+
+### Executar o Jekyll localmente
+
+```bash
+bundle exec jekyll serve
+# Server address: http://127.0.0.1:4000/
+
+## Debug
+bundle exec jekyll build --trace --watch
+```
+
+### `_data/L10n.hxl.csv`
+- Automação
+  - Script: [_systema/programma/download-hxl-datum.sh](_systema/programma/download-hxl-datum.sh)
+  - GitHub action: [.github/workflows/05-deploy-github-pages.yml](.github/workflows/05-deploy-github-pages.yml)
+- Arquivo: [_data/L10n.hxl.csv](_data/L10n.hxl.csv)
+- GSheets: HXL-CPLP-Vocab_Auxilium-Humanitarium-API_L10n
+  - https://docs.google.com/spreadsheets/d/1ih3ouvx_n8W5ntNcYBqoyZ2NRMdaA0LRg5F9mGriZm4/edit#gid=1181688279
+
+O arquivo `_data/L10n.hxl.csv` é obtido automaticamente antes da publicação no
+GitHub pages com ajuda do script `_systema/programma/download-hxl-datum.sh`.
+
+É possivel usar uma versão antiga desse arquivo ao testar com Jekyll localmente,
+porém qualquer customização, mesmo que commitada neste repositório, caso
+não esteja também em _GSheets: HXL-CPLP-Vocab_Auxilium-Humanitarium-API_L10n_
+sera completamente ignorada.
+
+### Informar o Google sobre versões localizadas da sua página
+
+- https://developers.google.com/search/docs/advanced/crawling/localized-versions?hl=pt-br
+- https://resultadosdigitais.com.br/blog/tag-hreflang/
+- https://searchengineland.com/how-to-implement-the-hreflang-element-using-xml-sitemaps-123030
+- https://en.wikipedia.org/wiki/Hreflang
+
+### (rascunho) por ser feito
+
+> TODOs:
+> - https://forestry.io/blog/creating-a-multilingual-blog-with-jekyll/
+> - https://jekyllcodex.org/without-plugins/
+> - http://hamishwillee.github.io/2014/11/13/jekyll-includes-are-functions/
+> - https://en.m.wikipedia.org/wiki/Translation_memory
+>   - https://en.m.wikipedia.org/wiki/Translation_Memory_eXchange
+>   - https://en.m.wikipedia.org/wiki/OAXAL
+>   - https://github.com/WeblateOrg/weblate
+>   - https://weblate.org/pt/
+>     - https://docs.weblate.org/pt/latest/formats.html#csv-files
+>     - https://docs.weblate.org/pt/latest/formats.html#xliff
+> - Update boostrap
+>   - https://github.com/twbs/bootstrap/releases/tag/v5.0.1
+>     - https://github.com/twbs/bootstrap/pull/33709
+
+### Licença
+<!--TODO: o texto em português da licença é um rascunho. Ainda precisa ser revisado -->
+
+[![Public Domain Dedication](https://i.creativecommons.org/p/zero/1.0/88x31.png)](https://unlicense.org/)
+
+Na medida do possível sob a lei, as pessoas autoras de
+[HXL-CPLP](https://github.com/HXL-CPLP) renunciam todos os direitos autorais e
+direitos conexos ou vizinhos a este trabalho para o [domínio público](https://unlicense.org/).