documentation-reorganization (#8): build fixes; paths

EticaAI · Nov 16, 2021 · 405fedd · 405fedd
1 parent 128e6ea
commit 405fedd
Show file tree

Hide file tree

Showing 5 changed files with 48 additions and 35 deletions.
diff --git a/.github/workflows/hxltm-computo_testum.yml b/.github/workflows/hxltm-computo_testum.yml
@@ -25,8 +25,8 @@ jobs:
         # python-version: [3.7, 3.8, 3.9, 3.10]
         python-version: [3.7, 3.8, 3.9]
 
-    # Don't run https://github.com/nektos/act locally. Can be removed later. 
-    if: ${{ !env.ACT }}
+    # # Don't run https://github.com/nektos/act locally. Can be removed later. 
+    # if: ${{ !env.ACT }}
 
     steps:
     - uses: actions/checkout@v1

diff --git a/.github/workflows/hxltm-normae_documentum_hxltm-etica-ai.yml b/.github/workflows/hxltm-normae_documentum_hxltm-etica-ai.yml
@@ -112,10 +112,13 @@ jobs:
           # pre_build: find . type -f
           # pre_build: git add .
 
-      # Not the lastest, but can be used on local ubuntu if no advanced features need
-      # sudo apt install asciidoctor
-      # sudo apt install ruby-asciidoctor-pdf
-      # sudo gem install asciidoctor-pdf
 
-      # (error) asciidoctor --backend pdf docs/eng-Latn/index.adoc
-      # asciidoctor-pdf --attribute allow-uri-read=1 docs/eng-Latn/index.adoc
+      # asciidoctor
+      # @see https://asciidoctor.org/#bundler
+      #    cat Gemfile
+      #    source 'https://rubygems.org'
+      #    gem 'asciidoctor'
+      #    gem 'asciidoctor-pdf'
+      #    gem 'asciidoctor-epub3'
+
+      # bundle exec asciidoctor-pdf --attribute allow-uri-read=1 docs/eng-Latn/index.adoc
diff --git a/.gitignore b/.gitignore
@@ -57,4 +57,11 @@ __pycache__
 
 ### temp
 # tox.ini
-Dockerfile
+Dockerfile
+
+# asciidoctor
+# @see https://asciidoctor.org/#bundler
+vendor
+Gemfile
+Gemfile.lock
+.bundle
diff --git a/docs/eng-Latn/index.adoc b/docs/eng-Latn/index.adoc
@@ -103,7 +103,7 @@ include::../ontologia/cor.hxltm.215.yml[tag=normam_HXLTM]
 
 [source,bash]
 ----
-include::../../testum/disciplinam-manuale-anglicum.sh[tag=HXLTM_CSV]
+include::../testum/disciplinam-manuale-anglicum.sh[tag=HXLTM_CSV]
 ----
 
 ////
@@ -120,7 +120,7 @@ include::../ontologia/cor.hxltm.215.yml[tag=normam_CSV-HXL-XLIFF]
 
 [source,bash]
 ----
-include::../../testum/disciplinam-manuale-anglicum.sh[tag=CSV-HXL-XLIFF]
+include::../testum/disciplinam-manuale-anglicum.sh[tag=CSV-HXL-XLIFF]
 ----
 ////
 
@@ -138,7 +138,7 @@ include::../ontologia/cor.hxltm.215.yml[tag=normam_HXLTM-TMETA]
 
 [source,bash]
 ----
-include::../../testum/disciplinam-manuale-anglicum.sh[tag=HXLTM-ASA]
+include::../testum/disciplinam-manuale-anglicum.sh[tag=HXLTM-ASA]
 ----
 ////
 
@@ -156,7 +156,7 @@ include::../ontologia/cor.hxltm.215.yml[tag=normam_HXLTM-ASA]
 
 [source,bash]
 ----
-include::../../testum/disciplinam-manuale-anglicum.sh[tag=HXLTM-ASA]
+include::../testum/disciplinam-manuale-anglicum.sh[tag=HXLTM-ASA]
 ----
 
 [#HXLTM-archivum-exportandum]
@@ -188,7 +188,7 @@ include::../ontologia/cor.hxltm.215.yml[tag=normam_CSV-3]
 
 [source,bash]
 ----
-include::../../testum/disciplinam-manuale-anglicum.sh[tag=CSV-3]
+include::../testum/disciplinam-manuale-anglicum.sh[tag=CSV-3]
 ----
 
 ===== Result example
@@ -197,7 +197,7 @@ include::../../testum/disciplinam-manuale-anglicum.sh[tag=CSV-3]
 
 [source,csv]
 ----
-include::../../testum/resultatum/hxltm-exemplum-linguam.por-Latn_spa-Latn.csv[]
+include::../testum/resultatum/hxltm-exemplum-linguam.por-Latn_spa-Latn.csv[]
 ----
 
 [#GSheets]
@@ -243,14 +243,14 @@ include::../ontologia/cor.hxltm.215.yml[tag=normam_TBX-Basim]
 
 [source,bash]
 ----
-include::../../testum/disciplinam-manuale-anglicum.sh[tag=TBX-Basim]
+include::../testum/disciplinam-manuale-anglicum.sh[tag=TBX-Basim]
 ----
 
 ===== Result example
 
 [source,xml]
 ----
-include::../../testum/resultatum/hxltm-exemplum-linguam.tbx[]
+include::../testum/resultatum/hxltm-exemplum-linguam.tbx[]
 ----
 
 
@@ -268,7 +268,7 @@ include::../ontologia/cor.hxltm.215.yml[tag=normam_TSV-3]
 
 [source,bash]
 ----
-include::../../testum/disciplinam-manuale-anglicum.sh[tag=TSV-3]
+include::../testum/disciplinam-manuale-anglicum.sh[tag=TSV-3]
 ----
 
 ===== Result example
@@ -277,7 +277,7 @@ include::../../testum/disciplinam-manuale-anglicum.sh[tag=TSV-3]
 
 [source,tsv]
 ----
-include::../../testum/resultatum/hxltm-exemplum-linguam.por-Latn_spa-Latn.tsv[]
+include::../testum/resultatum/hxltm-exemplum-linguam.por-Latn_spa-Latn.tsv[]
 ----
 
 [#TMX]
@@ -293,15 +293,15 @@ include::../ontologia/cor.hxltm.215.yml[tag=normam_TMX]
 
 [source,bash]
 ----
-include::../../testum/disciplinam-manuale-anglicum.sh[tag=TMX]
+include::../testum/disciplinam-manuale-anglicum.sh[tag=TMX]
 ----
 ===== Result example
 
 - https://github.com/EticaAI/hxltm/blob/main/testum/resultatum/hxltm-exemplum-linguam.tmx
 
 [source,xml]
 ----
-include::../../testum/resultatum/hxltm-exemplum-linguam.tmx[]
+include::../testum/resultatum/hxltm-exemplum-linguam.tmx[]
 ----
 
 [#UTX]
@@ -317,15 +317,15 @@ include::../ontologia/cor.hxltm.215.yml[tag=normam_UTX]
 
 [source,bash]
 ----
-include::../../testum/disciplinam-manuale-anglicum.sh[tag=UTX]
+include::../testum/disciplinam-manuale-anglicum.sh[tag=UTX]
 ----
 ===== Result example
 
 - https://github.com/EticaAI/hxltm/blob/main/testum/resultatum/hxltm-exemplum-linguam.utx
 
 [source,xml]
 ----
-include::../../testum/resultatum/hxltm-exemplum-linguam.utx[]
+include::../testum/resultatum/hxltm-exemplum-linguam.utx[]
 ----
 
 [#XML]
@@ -341,15 +341,15 @@ include::../ontologia/cor.hxltm.215.yml[tag=normam_XML]
 
 [source,bash]
 ----
-include::../../testum/disciplinam-manuale-anglicum.sh[tag=XML]
+include::../testum/disciplinam-manuale-anglicum.sh[tag=XML]
 ----
 ===== Result example
 
 - https://github.com/EticaAI/hxltm/blob/main/testum/resultatum/hxltm-exemplum-linguam.tmx
 
 [source,xml]
 ----
-include::../../testum/resultatum/hxltm-exemplum-linguam.hxltm.xml[]
+include::../testum/resultatum/hxltm-exemplum-linguam.hxltm.xml[]
 ----
 
 
@@ -366,14 +366,14 @@ include::../ontologia/cor.hxltm.215.yml[tag=normam_XLIFF]
 
 [source,bash]
 ----
-include::../../testum/disciplinam-manuale-anglicum.sh[tag=XLIFF]
+include::../testum/disciplinam-manuale-anglicum.sh[tag=XLIFF]
 ----
 
 ===== Result example
 
 [source,xml]
 ----
-include::../../testum/resultatum/hxltm-exemplum-linguam.por-Latn--spa-Latn.xlf[]
+include::../testum/resultatum/hxltm-exemplum-linguam.por-Latn--spa-Latn.xlf[]
 ----
 
 [#XLIFF-obsoletum]
@@ -389,14 +389,14 @@ include::../ontologia/cor.hxltm.215.yml[tag=normam_XLIFF-obsoletum]
 
 [source,bash]
 ----
-include::../../testum/disciplinam-manuale-anglicum.sh[tag=XLIFF-obsoletum]
+include::../testum/disciplinam-manuale-anglicum.sh[tag=XLIFF-obsoletum]
 ----
 
 ===== Result example
 
 [source,xml]
 ----
-include::../../testum/resultatum/hxltm-exemplum-linguam.por-Latn--spa-Latn.xlf[]
+include::../testum/resultatum/hxltm-exemplum-linguam.por-Latn--spa-Latn.xlf[]
 ----
 
 [#XLSX]
@@ -470,7 +470,7 @@ hxltmcli --help
 
 [source]
 ----
-include::../../testum/hxltmcli--help_eng-Latn.txt[]
+include::../testum/hxltmcli--help_eng-Latn.txt[]
 ----
 [#hxltmdexml--help]
 == `+hxltmdexml --help+`
@@ -486,7 +486,7 @@ hxltmdexml --help
 
 [source]
 ----
-include::../../testum/hxltmdexml--help_eng-Latn.txt[]
+include::../testum/hxltmdexml--help_eng-Latn.txt[]
 ----
 
 == License

diff --git a/docs/index.adoc b/docs/index.adoc
@@ -22,10 +22,13 @@ link:eng-Latn/index.adoc.adoc[English language (Latin script) - HXLM: Multilingu
 
 ////
 
-* link:eng-Latn[English language (Latin script)] ~link:eng-Latn[documentation],~ ~link:eng-Latn/index[index]~
+* link:eng-Latn[English language (Latin script)] ~link:eng-Latn[documentation],~ ~link:eng-Latn/index/[index]~
 
 
----
-
+.*Excambiō
+[%collapsible]
+====
 link:https://en.wiktionary.org/wiki/Reconstruction:Latin/excambio[*Excambiō est recōnstrūctiō (non officialis)].
-Nomen officialis lingua Anglica est link:https://hxlstandard.org/[The Humanitarian Exchange Language]
+Nomen officialis lingua Anglica est link:https://hxlstandard.org/[The Humanitarian Exchange Language]
+====
+