menu-api (#10): inicio de páginas /mul/ (hreflang x-index, páginas de…

… interlincagem entre diversos idiomas)

_config.yml

@@ -83,15 +83,17 @@ defaults:
     values:
       sitemap: false
 
+# @see https://github.com/avillafiorita/jekyll-datapage_gen
+page_gen-dirs: true
 page_gen:
   # referens: api-BR-portais-ckan-brasil
   - data: 'api'
     template: 'api'
     name: 'slug'
     # name_expr: "record['slug'] + '_' + record['slug']"
     # dir: 'eng/api-TEMP/BR'
-    dir_expr: "record['linguam'] + '/' + record['gid']"
-    # filter_condition: "record['gid'] == 'api/BR' and record['linguam'] == 'eng'"
+    dir_expr: "record['linguam'] + '/' + record['typum'] + '/' + record['gid']"
+    filter_condition: "record['linguam'] != 'mul'"
     # debug: true
 
   # - data: 'api'

_data/Temporarium.yml

@@ -49,6 +49,7 @@ Temp_hapi_api_aviso_de_isencao_eng: |
 Temp_hapi_api_salvar_como_pdf_lat: "?!(Temp_hapi_api_salvar_como_pdf_lat)!?"
 Temp_hapi_api_salvar_como_pdf_por: "Salvar como PDF"
 Temp_hapi_api_salvar_como_pdf_eng: "Save as PDF"
+Temp_TOC_mul: "Index"
 Temp_TOC_lat: "Índice de Conteúdo"
 Temp_TOC_por: "Índice de Conteúdo"
 Temp_TOC_eng: "Table of contents"

_data/api.yml

@@ -1,74 +1,146 @@
 # https://github.com/avillafiorita/jekyll-datapage_gen
 
+### [linguam]/api/UN ___________________________________________________________
 
-### UN _________________________________________________________________________
-
-- gid: api/UN
+## -----------------------------------------------------------------------------
+- x-default: /mul/api/UN/HDX/
+  uid: /mul/api/UN/HDX/
+  linguam: mul
+  typum: api
+  gid: UN
   lid: HDX
+  title: /mul/api/UN/HDX/
+  noindex: true
+
+- x-default: /mul/api/UN/HDX/
+  uid: /eng/api/UN/humanitarian-data-exchange/
   linguam: eng
+  typum: api
+  gid: UN
+  lid: HDX
   openapi_filum: /api/UN/HDX/eng/openapi.yaml
   slug: humanitarian-data-exchange
-  noindex: true
   title: HDX - The Humanitarian Data Exchange API
-  # namen:
-  # descriptionen:
+  noindex: true
 
-- gid: api/UN
-  lid: ReliefWeb
+## -----------------------------------------------------------------------------
+- x-default: /mul/api/UN/ReliefWeb/
+  uid: /mul/api/UN/ReliefWeb/
+  linguam: mul
+  typum: api
+  gid: UN
+  lid: HDX
+  title: /mul/api/UN/ReliefWeb/
+  noindex: true
+
+- x-default: /mul/api/UN/ReliefWeb/
+  uid: /mul/api/UN/reliefweb/
   linguam: eng
+  typum: api
+  gid: UN
+  lid: ReliefWeb
   openapi_filum: /api/UN/reliefweb/eng/openapi.yaml
   slug: reliefweb
   title: ReliefWeb - Informing humanitarians worldwide
   # title: ReliefWeb - Informing humanitarians worldwide
   noindex: true
 
-- gid: api/UN
-  lid: CODV2API
+## -----------------------------------------------------------------------------
+- x-default: /mul/api/UN/CODV2API/
+  uid: /mul/api/UN/CODV2API/
+  linguam: mul
+  typum: api
+  gid: UN
+  lid: HDX
+  title: /mul/api/UN/CODV2API/
+  noindex: true
+
+- x-default: /mul/api/UN/CODV2API/
   linguam: eng
+  typum: api
+  gid: UN
+  lid: CODV2API
   openapi_filum: /api/UN/CODV2API/eng/openapi.yaml
   slug: common-operational-datasets-api
   title: Common Operational Datasets Services 2 (COD Services)
   noindex: true
 
-### XZ _________________________________________________________________________
+### [linguam]/api/ZX ___________________________________________________________
+
+## -----------------------------------------------------------------------------
+- x-default: /mul/api/XZ/HXL-Proxy/
+  uid: /mul/api/XZ/HXL-Proxy/
+  linguam: mul
+  typum: api
+  gid: XZ
+  # lid: HXL-Proxy
+  title: /mul/api/XZ/HXL-Proxy/
+  noindex: true
 
-- gid: api/XZ
-  lid: HXL-Proxy
+- x-default: /mul/api/XZ/HXL-Proxy/
   linguam: eng
+  typum: api
+  gid: XZ
+  # lid: HXL-Proxy
   openapi_filum: /api/XZ/HXL-Proxy/eng/openapi.yaml
   slug: hxl-proxy
   title: HXL-Proxy - Proxy of the Humanitarian Exchange Language
   noindex: true
 
-### BR _________________________________________________________________________
+### [linguam]/api/BR ___________________________________________________________
 
-- gid: api/BR
-  lid: portais-ckan-brasil
+## -----------------------------------------------------------------------------
+- x-default: /mul/api/BR/portais-ckan-brasil/
+  uid: /mul/api/BR/portais-ckan-brasil/
+  linguam: mul
+  typum: api
+  gid: BR
+  # lid: portais-ckan-brasil
+  title: /mul/api/BR/portais-ckan-brasil/
+  noindex: true
+
+- x-default: /mul/api/BR/portais-ckan-brasil/
+  uid: /eng/api/BR/brazilian-ckan-portals/
   linguam: eng
+  typum: api
+  gid: BR
+  lid: portais-ckan-brasil
   openapi_filum: /api/BR/brazilian-ckan-portals/eng/openapi.yaml
   slug: brazilian-ckan-portals
   title: Portais CKAN de dados abertos do Brasil
   description: |
     Discussão em https://github.com/HXL-CPLP/COD-Services-API-doc/issues/4
   noindex: true
-  # namen:
-  # descriptionen:
 
-- gid: api/BR
-  lid: portais-ckan-brasil
+- x-default: /mul/api/BR/portais-ckan-brasil/
+  uid: /por/api/BR/dados-abertos-ckan-brasil/
   linguam: por
+  typum: api
+  gid: BR
+  lid: dados-abertos-ckan-brasil
   openapi_filum: /api/BR/portais-ckan-brasil/por/openapi.yaml
   slug: dados-abertos-ckan-brasil
   title: Portais ArcGIS de dados abertos do Brasil
   description: |
     Discussão em https://github.com/HXL-CPLP/COD-Services-API-doc/issues/4
   noindex: true
-  # namen:
-  # descriptionen:
 
-- gid: api/BR
-  lid: portais-arcgis-brasil
+## -----------------------------------------------------------------------------
+- x-default: /mul/api/BR/portais-arcgis-brasil/
+  uid: /mul/api/BR/portais-arcgis-brasil/
+  linguam: mul
+  typum: api
+  gid: BR
+  # lid: portais-arcgis-brasil
+  title: /mul/api/BR/portais-arcgis-brasil/
+  noindex: true
+
+- x-default: /mul/api/BR/portais-arcgis-brasil/
+  uid: /por/api/BR/portais-arcgis-brasil/
   linguam: por
+  typum: api
+  gid: BR
+  lid: portais-arcgis-brasil
   openapi_filum: /api/BR/portais-arcgis-brasil/por/openapi.yaml
   slug: ados-abertos-arcgis-brasil
   title: Portais ArcGIS de dados abertos do Brasil
@@ -85,4 +157,4 @@
 #   noindex: true
 #   # namen: Humanitarian Data Exchange
 #   # namen:
-#   # descriptionen:
+#   # descriptionen:

_data/linguam.yml

@@ -19,4 +19,11 @@ canatum:
     - "eng"
     - "lat"
   lat:
+    - "lat"
+  # https://en.wikipedia.org/wiki/ISO_639-3
+  #  - [eng] mul (multiple languages) is intended for cases where the data
+  #    includes more than one language, and (for example) the database
+  #    requires a single ISO code.
+  mul:
+    - "mul"
     - "lat"

documentum/mul/index.md

@@ -0,0 +1,35 @@
+---
+title: "Plures linguae index"
+description: |
+  Documentação argumentada de APIs comuns para ajuda humanitária
+  com [OpenAPI](https://www.openapis.org/), o padrão de mercado aberto de
+  fato para documentar APIs REST.
+locale: mul
+linguam: mul
+permalink: /mul/
+categories: [ index ]
+# layout: defallo
+layout: index
+toc: true
+noindex: true
+---
+
+<div class="alert alert-danger" role="alert">
+  <p lang="eng">[eng]👷🏽 Work in progress</p>
+  <p lang="pt">[por]👷🏽 Trabalho em progresso</p>
+</div>
+
+<h2>TODO</h2>
+<p>https://en.wikipedia.org/wiki/Hreflang</p>
+<p>https://www.semrush.com/blog/the-most-common-hreflang-mistakes-infographic/</p>
+<section>
+  <h2>API</h2>
+  {% for api in site.data.api %}
+    <article>
+      <h3>{{ api.title }}</h3>
+      <pre>
+        {{ api | jsonify }}
+      </pre>
+    </article>
+  {% endfor %}
+</section>

documentum/sitemap.html

@@ -36,6 +36,7 @@ <h1>Sitemap</h1>
   </header>
   <main>
     <div class="container">
+
       <h2>Pages</h2>
       <ul>
         {% for post in site.pages %}