Skip to content

docs: fix multiple documentation warnings#240

Open
Artlesbol wants to merge 1 commit intosophgo:masterfrom
Artlesbol:fix-docs-warnings
Open

docs: fix multiple documentation warnings#240
Artlesbol wants to merge 1 commit intosophgo:masterfrom
Artlesbol:fix-docs-warnings

Conversation

@Artlesbol
Copy link
Contributor

  • Clean up documentation to eliminate various warnings and improve consistency.

- Clean up documentation to eliminate various warnings and improve consistency.
@xujm1998
Copy link

前部分红字warning部分已清理,但编译RST文档为PDF格式时,还有一系列warning,再麻烦修改一下这个问题吧
image

@Artlesbol
Copy link
Contributor Author

Artlesbol commented Aug 30, 2025

经过定位,这些Warning主要分为两种,解决方案需要征求maintainer的确认:

  1. Fandol字体导致的Warning,报错描述为Fandol缺少CJK和斜体的支持。这里是否考虑更换字体以解决此类问题,需要您的确认
image
  1. xelatex对于交叉引用需要两次编译,第一次编译时他不知道后续的引用位置在哪,所以会给出Warning,第二次编译则不再产生,这个无法避免,我这边考虑添加 > /dev/null 屏蔽第一次编译的输出
image

@charlesxzb
Copy link
Collaborator

您好,感谢您的关注,关于文档的warning问题:

  1. 需要使用docker环境中已存在的字体,并且保障新字体相对原本的用户体验更好
  2. 可以重定向忽略掉第一次编译的warning信息

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants