From 897f78c3ed4bda9f32645ac542ed85c1e5524e98 Mon Sep 17 00:00:00 2001 From: Emerson Rocha Date: Sun, 16 May 2021 17:36:22 -0300 Subject: [PATCH] =?UTF-8?q?mvp-tema-i18n=20(#9):=20mais=20documenta=C3=A7?= =?UTF-8?q?=C3=A3o=20no=20README.md,=20Voluntarius=20Auxilio=20Tuo?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 128 ++++++++++++++++++++++++++++++++++++++++++- documentum/README.md | 73 ------------------------ 2 files changed, 125 insertions(+), 76 deletions(-) delete mode 100644 documentum/README.md diff --git a/README.md b/README.md index 67bd037..590e5f2 100644 --- a/README.md +++ b/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 + + + +```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. \ No newline at end of file +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**: +- **GitHub, código fonte**: +- **GitHub, código fonte de 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 + + +[![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/). \ No newline at end of file diff --git a/documentum/README.md b/documentum/README.md deleted file mode 100644 index f3be491..0000000 --- a/documentum/README.md +++ /dev/null @@ -1,73 +0,0 @@ ---- -published: false ---- - -# documentum/README.md - -> - [documentum/README.md](documentum/README.md) -> - [_data/README.md](_data/README.md) -> - [GSheets: HXL-CPLP-Vocab_Auxilium-Humanitarium-API_L10n](https://docs.google.com/spreadsheets/d/1ih3ouvx_n8W5ntNcYBqoyZ2NRMdaA0LRg5F9mGriZm4/edit#gid=1181688279) - -## Note to maintainers in English - -- - -## Notas aos mantenedores em português - -## Executar o Jekyll localmente - -```bash -bundle exec jekyll serve -# Server address: http://127.0.0.1:4000/ - -## Debug -bundle exec jekyll build --trace --watch -``` - -## Planilha online -### HXL-CPLP-Vocab_Auxilium-Humanitarium-API -- - -## Internacionalização/Localização - -### Links de referência -- **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 - - - - \ No newline at end of file