[xep-support] Re: multi-language support using XEP

Fri Nov 12 08:36:56 PST 2021

Hi Kevin,

I made the changes you suggested for the options.  Yes, the xep.xml and fonts folder are siblings. I changed the hardcoded path to just “fonts/”

Now I’m not getting the boxes anymore, but no messages via the OT. No messages regarding fonts from the command line either. I get the following:

C:\Program Files\Oxygen XML Editor 24\frameworks\dita\DITA-OT3.x\plugins\org.dita.pdf2.xep\lib\xep>xep -fo D:\projects\client\2021\Dita2Pdf.client.aroslanovo.243209.1631212044375\test\temp\pdf\topic.fo -pdf D:\projects\client\2021\Dita2Pdf.client.aroslanovo.243209.1631212044375\test\out\pdf\test.pdf
(document [system-id file:/D:/projects/client/2021/Dita2Pdf.client.aroslanovo.243209.1631212044375/test/temp/pdf/topic.fo]
  (validate [validation OK])
  (compile
    (meta-info )
    (masters
      (sequence-master [master-name front-matter-first])
      (sequence-master [master-name front-matter-last])
      (sequence-master [master-name front-matter-odd])
      (sequence-master [master-name toc-odd])
      (sequence-master [master-name toc-last])
      (sequence-master [master-name toc-first])
      (sequence-master [master-name body-first])
      (sequence-master [master-name body-odd])
      (sequence-master [master-name body-last])
      (sequence-master [master-name index-first])
      (sequence-master [master-name index-odd])
      (sequence-master [master-name glossary-first])
      (sequence-master [master-name glossary-odd])
      (sequence-master [master-name toc-sequence])
      (sequence-master [master-name body-sequence])
      (sequence-master [master-name ditamap-body-sequence])
      (sequence-master [master-name index-sequence])
      (sequence-master [master-name front-matter])
      (sequence-master [master-name glossary-sequence]))
    (outline )
    (sequence [master-reference front-matter]
      (static-content [flow-name xsl-footnote-separator])
      (static-content [flow-name odd-frontmatter-footer])
      (static-content [flow-name odd-frontmatter-header])
      (flow [flow-name xsl-region-body]))
    (sequence [master-reference toc-sequence]
      (static-content [flow-name odd-toc-footer])
      (static-content [flow-name odd-toc-header])
      (flow [flow-name xsl-region-body]))
    (sequence [master-reference ditamap-body-sequence]
      (static-content [flow-name xsl-footnote-separator])
      (static-content [flow-name odd-body-footer])
      (static-content [flow-name odd-body-header])
      (static-content [flow-name first-body-header])
      (static-content [flow-name first-body-footer])
      (static-content [flow-name last-body-header])
      (static-content [flow-name last-body-footer])
      (flow [flow-name xsl-region-body])))
  (format
    (sequence [master-reference front-matter]
      (flow [1])
      (static-content [1]))
    (sequence [master-reference toc-sequence]
      (flow [ii][ii])
      (static-content [ii]))
    (sequence [master-reference ditamap-body-sequence]
      (flow [3])
      (static-content [3]|odd-body-footer||odd-body-header|)))
  (generate [output-format pdf][1][ii][3]))

Éric Sirois
DITA Toolsmith

IXIASOFT
45 Chemin Bates, Suite 220 • Montreal, QC H2V 1A6
tel  + 1 514 279-4942  /  toll free + 1 877 279-4942
mobile + 1 647 462-3620
eric.sirois at ixiasoft.com<mailto:eric.sirois at ixiasoft.com> / www.ixiasoft.com<http://www.ixiasoft.com/>

[http://captmondo.com/IXIASOFT/ixiasoft-logo-small.png]

From: Kevin Brown <kevin at renderx.com>
Sent: November 11, 2021 3:21 PM
To: 'RenderX Community Support List' <xep-support at renderx.com>; Eric Sirois <eric.sirois at ixiasoft.com>
Subject: RE: [xep-support] Re: multi-language support using XEP

And just a note in modern Windows OSes like 10, 11 … do not simply right click and select install font.
This will not copy the font file to C:\windows\fonts.
It will actually put it in your user roaming directory.
The font will still be listed when you browse to the windows font directory but the actual path is not c:\Windows\Fonts.

Kevin

From: Xep-support <xep-support-bounces at renderx.com<mailto:xep-support-bounces at renderx.com>> On Behalf Of Kevin Brown
Sent: Thursday, November 11, 2021 12:12 PM
To: 'Eric Sirois' <eric.sirois at ixiasoft.com<mailto:eric.sirois at ixiasoft.com>>; 'RenderX Community Support List' <xep-support at renderx.com<mailto:xep-support at renderx.com>>
Subject: [xep-support] Re: multi-language support using XEP

There are some things wrong.

  1.  I assume this is the directory in the picture:

C:\Program Files\Oxygen XML Editor 24\frameworks\dita\DITA-OT3.x\plugins\org.dita.pdf2.xep\lib\xep\fonts

If not, that is your first problem. That font group says it is for all relatively referenced fonts in this absolute path.

  1.  Based on the fact that your first font group is this (relative) path:

fonts/

It means all the fonts in that group are found in a subdirectory /fonts from the location of the parent file (xep.xml).

Because your rendering is not failing completely and the fact that Helvetica is in the picture you sent, you sent a picture of the /fonts directory.

Now if C:\Program Files\Oxygen XML Editor 24\frameworks\dita\DITA-OT3.x\plugins\org.dita.pdf2.xep\lib\xep\fonts is the same as /fonts then you are still missing many of the referenced fonts. Like Artial.ttf, Times.ttf and such.

  1.  There are other issues like option VALIDATE is not a valid entry in the <generator-options format="PDF"> section. Whomever made these edits was incorrect.

The key here is that you should look at the log output from RenderX. If you are trying to reference a font and it is not found, then the log will tell you where it looked (per your xep.xml). Normally (since you are on Windows), one would copy the fonts to the c:\Windows\Fonts directory to install those TTF fonts in the Windows OS. Then that whole section where you are referencing fonts in some deep path under Oxygen should point to “c:/Windows/Fonts/”. In this case, fonts that are already install in Windows like Arial, Courier New, Tahoma and Verdana would just work. It may be that you actually did install the fonts like Noto and Arial Unicode and they are in Windows/Fonts but then you are telling XEP they are in C:\Program Files\Oxygen XML Editor 24\frameworks\dita\DITA-OT3.x\plugins\org.dita.pdf2.xep\lib\xep\fonts
As a side note, I would normally never use VALIDATE = false until I was sure I had a completely functional system. It is better to set:

VALIDATE=”true”
DISCARD_IF_NOT_VALID=”false”

This way you get all the warnings, errors and yet the formatter will still try and format the document.

Kevin Brown
RenderX

From: Eric Sirois <eric.sirois at ixiasoft.com<mailto:eric.sirois at ixiasoft.com>>
Sent: Thursday, November 11, 2021 11:30 AM
To: 'kevin at renderx.com' <kevin at renderx.com<mailto:kevin at renderx.com>>; 'RenderX Community Support List' <xep-support at renderx.com<mailto:xep-support at renderx.com>>
Subject: RE: [xep-support] Re: multi-language support using XEP

Apologies for the long delay.

Here is the info.  I tried swapping out the reference to Arial MS Unicode in the xep.xml file from the actual licensed version to Noto Sans.  The content has Hindi, Japanese, and Traditional Chinese. None are showing up.  So I fully expect something missing or misconfigured in our xep.xml file.  For the Hindi content though.  The latest version of FOP in DITA OT 3.6.1 was able to render the content in the PDF.

Please let me know if you have any questions.

[cid:image003.png at 01D7D7B7.B0058DE0]

Éric Sirois
DITA Toolsmith

IXIASOFT
45 Chemin Bates, Suite 220 • Montreal, QC H2V 1A6
tel  + 1 514 279-4942  /  toll free + 1 877 279-4942
mobile + 1 647 462-3620
eric.sirois at ixiasoft.com<mailto:eric.sirois at ixiasoft.com> / www.ixiasoft.com<http://www.ixiasoft.com/>

[http://captmondo.com/IXIASOFT/ixiasoft-logo-small.png]

From: Xep-support <xep-support-bounces at renderx.com<mailto:xep-support-bounces at renderx.com>> On Behalf Of Kevin Brown
Sent: September 29, 2021 1:35 PM
To: 'RenderX Community Support List' <xep-support at renderx.com<mailto:xep-support at renderx.com>>
Subject: [xep-support] Re: multi-language support using XEP

  *   We do have xep.xml configured to load the Arial MS Unicode font in which the glyph does exist in that font.

How do you know this is correct? Please send your xep.xml lines where you have included the font including all pathing. Also include a screen shot of your directory that the font is located in. And finally include the relative xsl fo showing you are specifying that font. Note: Arial Unicode MS is a font which requires a license to use. You should own this license if you intend to use it and even then it is not recommended. The copyright notice for the font is very large and legally required to be inserted into the output. RenderX respects this and will insert the copyright information *even if you are only using one character of that font*. We have had customers complain that using one smiley face increases the output PDF size by 100kb. This is because the copyright notice must be inserted into the PDF output (something other formatters may not do).

  *   I did find the following thread from 2015 where it was mentioned Hindi/Devanagari is not supported.  Is that still the case or was support added in newer versions of Xep?

It takes more than just a font to support Indic languages. The formatter engine must support advanced ligatures and glyph reshaping to properly format those languages.
RenderX does not include support for Indic languages.

Kevin Brown
RenderX

From: Xep-support <xep-support-bounces at renderx.com<mailto:xep-support-bounces at renderx.com>> On Behalf Of Eric Sirois
Sent: Monday, September 20, 2021 7:43 AM
To: 'xep-support at renderx.com' <xep-support at renderx.com<mailto:xep-support at renderx.com>>
Subject: [xep-support] multi-language support using XEP

Hi,

A client of ours would like to have multi-language content show up in their PDFs, but they are getting blank boxes instead.  We do have xep.xml configured to load the Arial MS Unicode font in which the glyph does exist in that font.  I did find the following thread from 2015 where it was mentioned Hindi/Devanagari is not supported.  Is that still the case or was support added in newer versions of Xep?

http://services.renderx.com/lists/xep-support/7405.html

Éric Sirois
DITA Toolsmith

IXIASOFT
45 Chemin Bates, Suite 220 • Montreal, QC H2V 1A6
tel  + 1 514 279-4942  /  toll free + 1 877 279-4942
mobile + 1 647 462-3620
eric.sirois at ixiasoft.com<mailto:eric.sirois at ixiasoft.com> / www.ixiasoft.com<http://www.ixiasoft.com/>

[http://captmondo.com/IXIASOFT/ixiasoft-logo-small.png]

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.renderx.com/pipermail/xep-support/attachments/20211112/19302fa9/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image002.png
Type: image/png
Size: 1980 bytes
Desc: image002.png
URL: <http://lists.renderx.com/pipermail/xep-support/attachments/20211112/19302fa9/attachment-0002.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image003.png
Type: image/png
Size: 35093 bytes
Desc: image003.png
URL: <http://lists.renderx.com/pipermail/xep-support/attachments/20211112/19302fa9/attachment-0003.png>