= `+HXLTM+` HXL Trānslātiōnem Memoriam: archīvum fōrmātum normam
:toc: preamble
:toclevels: 3
:icons: font
:source-highlighter: highlight.js
:highlightjs-languages: yaml

////
asciidoctor --backend=html5 -o hxltm/archivum/index.htm -a toc2 hxltm/archivum/README.adoc
////

https://hdp.etica.ai/hxltm[image:https://img.shields.io/badge/Site-hdp.etica.ai%2Fhxltm-blue[Site]]
https://github.com/EticaAI/HXL-Data-Science-file-formats[image:https://img.shields.io/badge/GitHub-EticaAI%2FHXL--Data--Science--file--formats-lightgrey?logo=github&style=social[EticaAI/HXL-Data-Science-file-formats]]
https://pypi.org/project/hdp-toolchain/[image:https://img.shields.io/badge/python%20package-hdp--toolchain-brightgreen[Python
Package: hdp-toolchain]]
https://hxlstandard.org/[image:https://img.shields.io/badge/Standard-HXL-%23F26459[Standard
HXL]]
image:https://img.shields.io/github/license/EticaAI/HXL-Data-Science-file-formats[License]
https://docs.google.com/spreadsheets/d/1ih3ouvx_n8W5ntNcYBqoyZ2NRMdaA0LRg5F9mGriZm4/edit#gid=470146486[image:https://img.shields.io/badge/Google%20Drive-HXL--CPLP--Vocab_Auxilium--Humanitarium--API-yellowgreen[Google
Drive]]

NOTE: `+hxltmcli+` uses Python 3 and the reference version can be installed
     with https://pypi.org/project/hdp-toolchain/[hdp-toolchain].
     TL;DR: `pip install hdp-toolchain`. *The result of the lastest
     link:++#hxltmcli--help++[hxltmcli --help. is on the bottom of this page].*

NOTE: The https://github.com/EticaAI/HXL-Data-Science-file-formats/blob/main/ontologia/cor.hxltm.yml[HXLTM core ontology cor.hxltm.yml]
    that comes with hxltmcli can be customized with
    `hxltmcli --archivum-configurationem path/to/mycopy.hxltm.yml`.

TIP: For advanced hackers or (people helping others in middle of urgency and
     with basic knowledge of python),
     *is possible copy only the single file
     https://github.com/EticaAI/HXL-Data-Science-file-formats/blob/main/bin/hxltmcli[hxltmcli.py]*,
     put on your executable path, and use immediately instead of
     hdp-toolchain version. The hard requirements are
     `pip install libhxl langcodes pyyaml python-liquid`


[#HXLTM-TLDR]
== TL;DR: Too Long; Didn't read

[source,yaml]
----
include::../../bin/hxltmcli[tag=epilogum]
----

[#HXLTM-archivum-dialecton]
== HXLM core file dialects

[#HXLTM]
=== `+HXLTM+`
==== HXL Trānslātiōnem Memoriam

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=normam_HXLTM]
----

===== Command line examples

[source,bash]
----
include::../../testum/hxltm/disciplinam-manuale-anglicum.sh[tag=HXLTM_CSV]
----

////
[#CSV-HXL-XLIFF]
=== `+CSV-HXL-XLIFF+`:
==== HXLated bilingual CSV (+ up to 5 source alt) for XLIFF

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=normam_CSV-HXL-XLIFF]
----

===== Command line examples

[source,bash]
----
include::../../testum/hxltm/disciplinam-manuale-anglicum.sh[tag=CSV-HXL-XLIFF]
----
////

[#HXLTM-ASA]
=== `+HXLTM-ASA+`:
==== HXLTM Abstractum Syntaxim Arborem

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=normam_HXLTM-ASA]
----


===== Command line examples

[source,bash]
----
include::../../testum/hxltm/disciplinam-manuale-anglicum.sh[tag=HXLTM-ASA]
----

[#HXLTM-archivum-exportandum]
== HXLTM exported formats

[#CSV-3]
=== `+CSV-3+`:
==== CSV Source + Target + Comment (draft)

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=normam_CSV-3]
----

===== Command line examples

[source,bash]
----
include::../../testum/hxltm/disciplinam-manuale-anglicum.sh[tag=CSV-3]
----

[#GSheets]
=== `+GSheets+`:
==== Google Sheets (via CSV import)

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=normam_GSheets]
----

[#JSON-kv]
=== `+JSON-kv+`:
==== JSON key: val; id/source -> target (draft)

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=normam_JSON-kv]
----

[#TBX-Basim]
=== `+TBX-Basim+`:
==== TermBase eXchange (TBX) Basic 2.1

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=normam_TBX-Basim]
----

===== Command line examples

[source,bash]
----
include::../../testum/hxltm/disciplinam-manuale-anglicum.sh[tag=TBX-Basim]
----

===== Result example

[source,xml]
----
include::../../testum/hxltm/resultatum/hxltm-exemplum-linguam.tbx[]
----

[#TMX]
=== `+TMX+`:
==== Translation Memory eXchange format (TMX)

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=normam_TMX]
----

===== Command line examples

[source,bash]
----
include::../../testum/hxltm/disciplinam-manuale-anglicum.sh[tag=TMX]
----

[#UTX]
=== `+UTX+`:
==== Universal Terminology eXchange (UTX) (planned, but no draft)

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=normam_UTX]
----

[#XLIFF]
=== `+XLIFF+`:
==== XML Localization Interchange File Format (XLIFF) v2.1

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=normam_XLIFF]
----

===== Command line examples

[source,bash]
----
include::../../testum/hxltm/disciplinam-manuale-anglicum.sh[tag=XLIFF]
----

===== Result example

[source,xml]
----
include::../../testum/hxltm/resultatum/hxltm-exemplum-linguam.por-Latn--spa-Latn.xlf[]
----

[#XLIFF-obsoletum]
=== `+XLIFF-obsoletum+`:
==== XML Localization Interchange File Format (XLIFF) v1.2 (too old, no draft)

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=normam_XLIFF-obsoletum]
----

===== Command line examples

[source,bash]
----
include::../../testum/hxltm/disciplinam-manuale-anglicum.sh[tag=XLIFF-obsoletum]
----

===== Result example

[source,xml]
----
include::../../testum/hxltm/resultatum/hxltm-exemplum-linguam.por-Latn--spa-Latn.xlf[]
----

[#XLSX]
=== `+XLSX+`:
==== Microsoft Excel (no plugins to read data directly from .XSLX)

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=normam_XLSX]
----

[#YAML]
=== `+YAML+`:
==== YAML (planned, but no draft)

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=normam_YAML]
----


== HXLTM ontologies

[#ontologia]
=== Ontologia

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=ontologia]
----

[#ontologia-aliud]
=== Aliases

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=ontologia_aliud]
----

[#ontologia-datum-typum]
=== Data types

[source,yaml]
----
include::../../ontologia/cor.hxltm.yml[tag=ontologia_datum_typum]
----

[#hxltmcli--help]
== `+hxltmcli --help+`

[source,bash]
----
# hxltmcli can be installed with hdp-toolchain
# @see https://pypi.org/project/hdp-toolchain/
pip install hdp-toolchain

hxltmcli --help
----

[source]
----
include::../../testum/hxltm/hxltmcli--help_eng-Latn.txt[]
----

== License

link:UNLICENSE[image:../../img/public-domain.png[Public Domain Dedication]]

The https://github.com/EticaAI[EticaAI] has dedicated the work to the
link:../../UNLICENSE[public domain] by waiving all of their rights to the
work worldwide under copyright law, including all related and
neighboring rights, to the extent allowed by law. You can copy, modify,
distribute and perform the work, even for commercial purposes, all
without asking permission.
