This document summarizes Shinji Enoki's presentation on the state of CJK issues in LibreOffice in 2021. Shinji discussed typical CJK functions in LibreOffice like vertical writing, phonetic guides, and line breaking rules. He explained how to properly report CJK bugs, including gathering details, searching for existing reports, and attaching samples. Shinji then reviewed the status of reported CJK bugs and some typical ongoing issues, like incorrect traditional Japanese numbers and font setting issues in Impress templates. He concluded by welcoming contributions to help resolve the many existing CJK function and bug issues.

1. This work is licensed under a Creative Commons
Attribution-ShareAlike 4.0 License.
State of CJK issues of LibreOffice 2021
Shinji Enoki
shinji.enoki@libreoffice.org
in COSCUP 2021
2021-08-01

2. 2
Shinji Enoki (榎真治)
● From Nishinomiya City, Japan
● A member of LibreOffice Japanese Team (2011-)
● Membership Committee Deputies of The Document Foundation
(2020-)
● Activity: organizing events, building communities,
sometimes QA
● Other community:
● Vice-chairperson of Japan UNIX Society
● A staff of KANSAI OPEN SOURCE

3. 3
Live in Nishinomiya, Japan

4. 4
I joined COSCUP 2018 and COSCUP 2019

5. 5
Talk summary
● Typical CJK functions of LibreOffice
● How to report CJK issues
● LibreOffice CJK bug status
● Typical CJK issues
Focus this year

6. Do you know the word CJK issues?
I can't see you even if you raise your hand...

7. 7
What are CJK issues /bugs
● CJK is an abbreviation for “Chinese-Japanese-Korean”
● Chinese, Japanese, and Korean are different languages, but
they have some common features
● LibreOffice has many language-specific features and issues,
CJK issue is one of them

8. Typical LibreOffice CJK functions

9. 9
LibreOffice has many CJK features
● It is included in all LibreOffice software
● Word processor (Writer)
● Spreadsheet (Calc)
● Presentation (Impress)
● Drawing (Draw)
● Database (Base)
● Formula (Math)

10. 10
Overview of CJK functions
● Text Layout
● Vertical writing
● Phonetic guides (ruby)
● Page Formats, include Line Composition
● Multibyte character
● Input methods
● Fonts
● ….
● CJK needs similar functionality, but the rules are sometimes different

11. 11
Vertical writing (1)
● Writer: [Page Style] setting can be set to vertical writing

12. 12
Vertical writing (2)
● Vertical text box
● Supported by Writer, Calc, Impress, Draw
● Note: Different from normal text box
● Right click on the toolbar-> [Vertical Text]
縦
書
き
の
テ
キ
ス
ト
ボ
ッ
ク
ス
Vertical
text
box

13. 13
Phonetic guides (ruby)
● In Japanese and Chinese,
mainly indicate how to read
https://www.w3.org/TR/jlreq/#ruby_and_emphasis_dots

14. 14
Phonetic guides (ruby)
● Writer: menu [Format]>
[Asian Phonetic guide]
● Ruby function works,
but the base text is in
the wrong position by
vertical writing.

15. 15
Line breaking rules(Line Composition)
● Paragraph style dialog ->Asian typography

16. 16
3 options on
3 options off
Off Allow hanging punctuation

17. 17
Reference: W3C Requirements documents
● Requirements for Japanese Text Layout
● https:/
/www.w3.org/TR/jlreq/
● “This document describes requirements for general Japanese layout realized with technologies like
CSS, SVG and XSL-FO. ”
●
Requirements for Chinese Text Layout 中文排版需求
● https:/
/www.w3.org/TR/clreq/
● “This document was developed by people working in different areas, using both Simplified and
Traditional Chinese. ”
● Requirements for Hangul Text Layout and Typography
● https:/
/www.w3.org/TR/klreq/
● These three documents were updated in 2020

18. How to report CJK issues

19. 19
TDF : Next Decade Manifesto
“To support the preservation of mother tongue by
encouraging people to translate,document, support, and
promote our office productivity tools in their mother tongue”
● I think these “Our Values” is very important

20. 20
CJK users need to report / reproduce
CJK bugs
● It is hard to notice / understand CJK bug unless it is people
of CJK
● Many LibreOffice developers are not CJK people
● Of course, it's very nice for you to try to fix bugs
● If you can't fix it, it's important to report a bug

21. 21
How to report a bug?
● Register in the bug database
● Same as almost all open source communities
● Steps
1. Gather bug and your environment information
2. Search the bug database to see if it has already been
reported
3. Submitting in the bug database (Bugzilla)
https:/
/bugs.documentfoundation.org/enter_bug.cgi

23. 23
Make it easier to understand
● It is important that non-CJK people can understand it
● Some points:
● Explain the menu in English
● Use screenshots
● Attach a sample file

24. 24
Explain the menu in English
● Not good:
● 1. Start Writer
●
2. Choose Menu [表示]-[ルビ]
● Good
● 1. Start Writer
● 2. Choose Menu [Format]-[Asian Phonetic Guide]

25. 25
Use screenshots
● Easy to understand

26. 26
Attach a sample file
● The sample file where it happens makes it very easy to
reproduce
● Even more important for CJK issues
● Non-CJK people have difficulty creating test files

27. 27
Clarify 'Steps to Reproduce'
● Do not omit operation steps in the middle
● Many people don't know CJK function
● They need complete steps

28. 28
Exact environment information
● In LibreOffice, you can copy your version information
● Menu [Help] -[ About LibreOffice]
● Bugs often occur depending on the environment
● OS, Fonts,
● Caused by ‘user profile’ or ‘extensions’
● You can check in safe mode

29. 29
Demo:Bug report (7min)
● https:/
/bugs.documentfoundation.org/show_bug.cgi?id=14
3409

30. 30
Let's do it
● It is easy
● If you haven't reported a bug to open source project yet,
please try it

31. LibreOffice CJK bug status

32. 32
Meta issue for CJK
● Bug 83066 : [META] CJK (Chinese, Japanese, Korean, and
Vietnamese) language issues
● Meta issue for each CJK language
● Bug 113193 : [META] Traditional Chinese (zh_TW, zh_HK)
● Bug 113194 : [META] Simplified Chinese (zh_CN)
● Bug 113195 : [META] Japanese CJK issues
● Bug 113196 : [META] Korean
Basically only Bug 83066 is used

34. 34
Depends on CJK Meta issue #83066
2017/10 2018/9 2019/9 2020/9 2021/7
Depends on:(All) 135 168 186 207 221
Open 59 73 73 80 78
Close 76 95 113 127 143

35. 35
Many CJK bugs
● Some bugs cannot be tracked by meta bug
● Few people fix CJK bugs

36. 36
Would you like to try bug fix?
● LibreOffice project welcomes contributors
● There is a volunteer developer Mark Hung in Taiwan
● He has fixed a number of CJK bugs
● If you are in Taiwan, it may be easier to get Mark's support

37. Typical CJK issues

38. 38
Japanese Traditional Numeric texts are wrong
such as 1,2,3, 10, 1000, 10000: Bug #130193
● CJK Traditional Number
text units are wrong in Calc
● Naruhiko and DaeHyun
created patch
● himajin100000, Mark, and
Ming commented
● CJK contributors
collaborated
● Fiexd in 7.0

39. 39
Improve CJK and CTL fonts setting in default Impress
templates : Bug 114746
● When selecting a template in Impress,
CJK font is not selected correctly
● It is set to create slides in Gothic from
the template, but it becomes Sans-serif
● Not fixed, but only size issue fixed, and
Nogata's patch is under review
Noto Sans CJK JP is correct

40. 40
"Characters per line" in the Text Grid is calculated
without the header and footer: Bug 141957
● The number of line
characters does not
match the setting
● Occurs when adding
a header or footer
● Not fixed

41. 41
- On Vertical-RTL pages, objects rendered off-page when
setting their anchor to the page : Bug 117938
● In vertical writing mode in Writer,
when you set an anchor ‘To Page’
on an object, the object
disappears
● In 7.1, the menu for setting
anchors 'To Page' has been
removed
● Not fixed, but it does not happen
from the menu

42. 42
Other CJK bugs
● You can check COSCUP 2019 my slide
https:/
/www.slideshare.net/eno_eno/state-of-cjk-issues-of-
libreoffice-2019

43. 43
Conclusion
● Many CJK functions are implemented in LibreOffice
● CJK function is often broken
– Of course, mostly okay
● We welcome your contributions. If you are interested,
please try it

44. 44
Contact
●
Email: shinji.enoki@libreoffice.org
●
Telegram COSCUP channel: user ‘Shinji Enoki’