微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

Sphinx 和 RinohType 的代码文档仅在页面的右三分之一

如何解决Sphinx 和 RinohType 的代码文档仅在页面的右三分之一

我正在为我的代码文档的 RinohType 生成的 PDF 文档的格式而苦苦挣扎。如何更改以下示例的 PDF 文档格式。

类描述的所有内容都在构造函数定义的右侧。

image of PDF

解决方法

这是由于最近对带有标签的对象的渲染方式进行了更改造成的。调整了 Sphinx 样式表以在 rinohtype 0.5.2 中修复此问题(感谢您指出此问题!)。

如果您无法升级到 0.5.2,您可以通过 extending the style sheet 并覆盖 label_max_width 样式的 object description 样式属性来解决此问题。 none 值对标签宽度没有限制,并且总是将描述呈现在右侧。将 label_max_width 设置为一个维度,如果超过指定的宽度,将强制将描述呈现在标签下方。

mystyle.rts

[STYLESHEET]
name=MyStyle
base=sphinx

[object description]
label_max_width=10pt

要指示 rinohtype 使用此样式表,您首先需要创建一个引用它的 template configuration file

mytemplate.rtt

[TEMPLATE_CONFIGURATION]
name = my template configuration
template = book
stylesheet = mystyle.rts

最后,从您项目的 conf.py 中的 rinoh_documents 引用此模板配置文件:

rinoh_documents = [
    dict(doc='index',target='manual',template='mytemplate.rtt'),]

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。