mvp-tema-i18n (#9): _systema/programma/download-hxl-datum.sh

.github/workflows/05-deploy-github-pages.yml

@@ -17,8 +17,8 @@ jobs:
     steps:
       - uses: actions/checkout@v2
 
-      - name: Build
-        run: bash _systema/infrastructuram/travis-ci.sh
+      - name: Download community-contributed translations via Google Sheets from HXL-CPLP
+        run: bash _systema/programma/download-hxl-datum.sh
 
       # @see https://github.com/actions/setup-java#supported-distributions
       - name: "Java installation (required by openapi-generator-cli)"

_data/L10n.hxl.csv

@@ -1,5 +1,8 @@
-#item+code,#item+l10n+i_lat,#item+l10n+i_eng,#item+l10n+i_por
-l10n_API,API,API,API
-l10n_API_UN,API UN 🇺🇳,API UN 🇺🇳,API UN 🇺🇳
-l10n_openapi_filum,OpenAPI Fīlum,OpenAPI file,Arquivo OpenAPI
-l10n_vicipaediam,Vicipaediam,Wikipedia,Wikipédia
+#item+code,#item+l10n+i_lat,#item+l10n+i_eng,#item+l10n+i_por
+L10n_API,API,API,API
+L10n_API_UN,API UN 🇺🇳,API UN 🇺🇳,API UN 🇺🇳
+L10n_API_XZ,API XZ 🌐,API XZ 🌐,API XZ 🌐
+L10n_API_BR,API BR 🇧🇷,API BR 🇧🇷,API BR 🇧🇷
+L10n_schema,Schēmam,Schema,Schema
+L10n_openapi_filum,OpenAPI Fīlum,OpenAPI file,Arquivo OpenAPI
+L10n_vicipaediam,Vicipaediam,Wikipedia,Wikipédia

_data/README.md

@@ -0,0 +1,27 @@
+# _data
+
+> - [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
+
+- <https://translate.google.com/translate?sl=pt&tl=en&u=https://github.com/HXL-CPLP/Auxilium-Humanitarium-API/blob/main/_data/README.md>
+
+## Notas aos mantenedores em português
+
+### `_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.

_systema/programma/download-hxl-datum.sh

@@ -0,0 +1,50 @@
+#!/bin/sh
+#===============================================================================
+#
+#          FILE:  download-hxl-datum.sh
+#
+#         USAGE:  ./_systema/programma/download-hxl-datum.sh
+#
+#   DESCRIPTION:  Download data from Google Spreadsheets via HXL-Proxy
+#
+#       OPTIONS:  ---
+#
+#  REQUIREMENTS:  ---
+#          BUGS:  ---
+#         NOTES:  ---
+#        AUTHOR:  Emerson Rocha <rocha[at]ieee.org>
+#       COMPANY:  EticaAI
+#       LICENSE:  Public Domain dedication
+#                 SPDX-License-Identifier: Unlicense
+#       VERSION:  v1.0
+#       CREATED:  2021-05-13 20:16 UTC started, based on EticaAI/
+#                         HXL-Data-Science-file-formats/prepare-hxlm-relsease.sh
+#      REVISION: ---
+#===============================================================================
+
+# Trivia:
+# - "download"
+#   - Note: no idea what word use for 'download' not even in New Latin
+#   - https://en.wiktionary.org/wiki/download
+# - "hxl"
+#   - https://hxlstandard.org/
+# - "datum"
+#   - https://en.wiktionary.org/wiki/datum#Latin
+
+#### Customizations, ___________________________________________________________
+
+### Data pull configurations ---------------------------------------------------
+
+# @see https://docs.google.com/spreadsheets/d/1ih3ouvx_n8W5ntNcYBqoyZ2NRMdaA0LRg5F9mGriZm4/edit#gid=1181688279
+HAPI_L10N="https://proxy.hxlstandard.org/data/download/L10n_hxl_csv.csv?dest=data_edit&strip-headers=on&force=on&url=https%3A%2F%2Fdocs.google.com%2Fspreadsheets%2Fd%2F1ih3ouvx_n8W5ntNcYBqoyZ2NRMdaA0LRg5F9mGriZm4%2Fedit%23gid%3D1181688279"
+
+ROOTDIR="$(pwd)"
+
+#### DATA PULL _________________________________________________________________
+
+# TODO: check first if remote resources are online (or if do exist network)
+#       instead of save to disk. These " if true;" are placeholders
+
+if true ; then
+    wget -qO- "$HAPI_L10N" > "${ROOTDIR}/_data/L10n.hxl.csv"
+fi

documentum/README.md

@@ -2,7 +2,23 @@
 published: false
 ---
 
-# Ajuda para mantenedores
+# 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
+
+- <https://translate.google.com/translate?sl=pt&tl=en&u=https://github.com/HXL-CPLP/Auxilium-Humanitarium-API/blob/main/documentum/README.md>
+
+## Notas aos mantenedores em português
+
+## Planilha online
+### HXL-CPLP-Vocab_Auxilium-Humanitarium-API
+- <https://docs.google.com/spreadsheets/d/1ih3ouvx_n8W5ntNcYBqoyZ2NRMdaA0LRg5F9mGriZm4/edit#gid=1181688279>
+
+## (rascunho) por ser feito
 
 > TODOs:
 > - https://forestry.io/blog/creating-a-multilingual-blog-with-jekyll/
@@ -16,10 +32,10 @@ published: false
 >     - https://docs.weblate.org/pt/latest/formats.html#csv-files
 >     - https://docs.weblate.org/pt/latest/formats.html#xliff
 
+<!--
 ## Extensões e plugins
 ### VSCode
 
-<!--
 - `ext install neilding.language-liquid`
   - https://github.com/GingerBear/vscode-liquid
   - https://marketplace.visualstudio.com/items?itemName=neilding.language-liquid