Open mhatzl opened 1 year ago
Maybe translate-to
would be a better name instead of render-langs
.
render
could be misleading, because rendering
is used to describe the process of transforming Unimarkup content into an output format.
Alternative option names:
lang
... The language the document is written in
used-langs
... List of languages used in the document (lang
is optional for this list, and must be added automatically if absent)
output-langs
... List of natural languages the document must be output to
This option is also useful if a .umi
file is used as input, because all output formats can now be created for all languages given in the list. Given languages must be present as columns in the ".umi" file.
If input is a regular ".um" file, this option defines the columns that must be created for a .umi
file.
Otherwise, this option has no effect on other output formats.
As mentioned in issue unimarkup/unimarkup-rs#102, all locales will be supported by default.
This makes used-langs
, locale-file
and download
obsolete.
For clarity, langs
should be renamed to output-langs
with the behaviour described above.
The locale of lang
must always be implicitly added to this list if not present.
At the moment there are two options to specify languages used in a document:
lang
... The default language of the documentmulti-langs
... List of other languages the document should be translated to (e.g. used to create columns in .umi files)While the
lang
option is clear,multi-langs
is not so, because there is a difference between possible other languages used in a document, and other languages the document should be rendered in. Therefore, this option should be divided into two options:used-langs
... List of languages used in the documentrender-langs
... List of languages the document should be rendered inNote:
render-langs
contains natural languages, whileformats
defines output formats the document is rendered to.The
render-langs
option must also not be allowed in the preamble, because this option makes no sense for inserted files. The optionslang
and `used-langs´ should be allowed in the preamble, because they are related to the file content.