Fix line break behavior of inline code/literals in PDF

[ghost]

ptinley made us aware of the things they undertake to fix display of tables in the AY Guide (for 15 SP2), we should try to see what we can do to make this work less necessary, e.g. add zero-width spaces within literals in PDF.

(This is probably a dupe but I guess it bears repeating.)

[janajaeger]

@jfaltenbacher Can you try to find out what Stefan meant by this? If we can't verify what's behind this report we'd have to close it.

[janajaeger]

Also, as we want to handle PDF generating differently in the future, we might not want to touch legacy PDF stylesheets at all.

[jfaltenbacher]

I will ask Patrick directly, if he can explain.

Will ask Padraig first, if he has some conversation on this

[ptinley-vt]

Hi all,

1. There are more complete details on this issue in Issue #325

Stefan was suggesting running a S&R routine on the XML to replace occurrences of "</literal>、<literal>" (notice Chinese comma and no space separation) with "</literal>、&#x200b;<literal>" (adding a zero-width-space character which will fix PDF rendering and at the same time not make presentation of the Chinese HTML worse by using a normal space, which would look wrong in Chinese). This will allow the lines to break automatically where they need to.

So, the following: <para> 通过以下命令访问控制文件：<literal>autoyast=nfs://..</literal>、<literal>autoyast=ftp://..</literal>、<literal>autoyast=http://..</literal>、<literal>autoyast=https://..</literal>、<literal>autoyast=tftp://..</literal> 或 <literal>autoyast=cifs://..</literal>。需使用 linuxrc 中的引导选项定义网络访问。可以通过 DHCP 执行此操作：<command>netsetup=dhcp autoyast=http://<replaceable>163.122.3.5/autoyast.xml</replaceable></command> </para> would become: <para> 通过以下命令访问控制文件：<literal>autoyast=nfs://..</literal>、&#x200b;<literal>autoyast=ftp://..</literal>、&#x200b;<literal>autoyast=http://..</literal>、&#x200b;<literal>autoyast=https://..</literal>、&#x200b;<literal>autoyast=tftp://..</literal> 或 <literal>autoyast=cifs://..</literal>。需使用 linuxrc 中的引导选项定义网络访问。可以通过 DHCP 执行此操作：<command>netsetup=dhcp autoyast=http://<replaceable>163.122.3.5/autoyast.xml</replaceable></command> </para> See current file, which was manually edited to make this work (line 431): https://github.com/SUSE/doc-sle/blob/maintenance/SLE15SP4/l10n/sles/zh-cn/xml/ay_auto_installation.xml

2. Chinese, and Japanese, which do not use spaces to break words, also produce long lines like:

   值：auto.master、ethers、group、hosts、netgrp、networks、passwd、protocols、rpc、services、shadow

I think we will have to rely on DTP QA to catch such occurrences, since these terms are not in <literal> elements.

3. While #325 gives examples of tables, the title of this bug also mentions Code blocks.

An example of text overflow can also be seen in the AutoYaST book, English, page 160: https://documentation.suse.com/sles/15-SP4/pdf/book-autoyast_color_en.pdf This is a different issue. zero-width-spaces are not a solution here. This particular example was an issue in the source English which then appears in the localised book. Sometimes, I think with ZH_TW, which uses a percentage resize on the fonts, text in code blocks can get enlarged and the line-breaks need to be redone to make it work in the rendered PDF.

[tomschr]

It seems, for SLE15SP4 tables are replaced by lists. Lists don't have these problems that Patrick described above.

Need to investigate further.

[jfaltenbacher]

@ptinley-vt please check with current SLE 15 SP5 loc drop if the issue still occurs

[ptinley-vt]

@jfaltenbacher, in SLE 15 SP5 I have used the zero-width-space character (​) to improve layout of a number of issues in the SLES AutoYaST Guide and the SLES and SLED Security Guides by breaking lines. These issues were found by QAing the PDFs. ay_auto_installation.xml ay_erb_templates.xml ay_nis_server.xml ay_partitioning.xml ay_rules_classes.xml systemd.xml x11_fonts.xml apparmor_profiles.xml audit_setup.xml rmt_rmt-cli.xml user_management.xml