ghost
commented
3 years ago It's not pretty but basically ~intentional:
-
To reduce the amount of configuration necessary for Docserv2, there is always one "main" language (in our case, that has always been en-us), and several dependent languages (i.e. translations). Translations can only ever provide a subset of the documents that are provided for the main language, but they cannot provide additional documents.
-
To get the HTML version of the Install Quick, we build DC-SLES-all. To get single-HTML, PDF, and EPUB versions of the Install Quick, we build DC-SLES-installation.
-
For Hungarian/Arabic/..., we exclude DC-SLES-all from the build: the only document translated to these languages is the Install Quick, and it makes no sense to generate all the other documents contained in DC-SLES-all, as they are untranslated. As the Install Quick is an article-type document, all content is presented on a single HTML page in any case--meaning Single-HTML is (almost) the same as normal HTML for these documents.
-
The links on our navigation pages are generated by combining the config with build metadata. In this case, there is no build metadata for e.g. the Hungarian DC-SLES-all HTML (because, duh, it was never built), hence we don't generate a link.
I guess there may be a way to add in a second link to Single-HTML, and label it HTML..? I have not thought about this too much and am unsure how I would implement it.
One thing I am planning to do, however, is following James's suggestion from #47 of linking the document name instead of making people click on the small format-specific links. This may ease the situation somewhat, but you'd still see one of the links vanish when going to another language.
Ascii art of what I have in mind ([...] indicates a link)
Current situation
en-us view: Document Title [HTML] [Single HTML] [PDF] [EPUB]
hu-hu view: Document Title [Single HTML] [PDF] [EPUB]Proposed new situation
en-us view: [Document Title]->HTML [Single HTML] [PDF] [EPUB]
hu-hu view: [Document Title]->Single [PDF] [EPUB]Tell me what you think.
jfaltenbacher
When checking the translations for SLE 15 SP3, Julia and me stumbled across the following issue:
After selecting
Magyaras language version for theInstallation Quick Start, the button for theHTMLoutput format disappears from the page.This happens for both SLES and SLED (and also for older product versions, SLE 15 SP2 or SLE 12 SP5 for example). We could not spot errors in the docserv-conf files for those products, so it seems to be a bug.
When checking the SLE 12 SP5 docs page, I noticed that the issue is not limited to selecting 'Magyar' but also happens for the following languages: