模板#
以下指南提供了接口元素和目录的模式。
面板#
面板应按自己的标题记录,嵌套面板应使用降低的标题级别。每个小组可根据文件的长度和/或小组的数量有自己的网页。切换显示给用户的属性的展开菜单应被视为子面板:
Panel Title
===========
Nested Panel Title
------------------
属性#
应使用定义列表记录属性。基于其他属性隐藏的属性应使用嵌套定义:
Property
Property description.
Hidden Property
Hidden property description.
选择菜单应使用以下语法记录:
Menu Label
General description of the menu.
:Menu Item: Menu Item Definition.
:Menu Item: Menu Item Definition.
:Menu Item: Menu Item Definition.
节点#
节点应始终有三个标题输入、属性和输出,如果节点没有,则注明缺勤。在页面的末尾可以是一个可选的示例部分:
**********
World Node
**********
.. figure:: /images/render_shader-nodes_output_world_node.png
:align: right
The World node.
Introduction and general use case(s).
Inputs
======
This node has no inputs.
Properties
==========
This node has no properties.
Outputs
=======
This node has no outputs.
Example
=======
目录布局#
通用章节结构如下:
目录名称/
index.rst
(包含内部文件链接)introduction.rst
section_1.rst
section_2.rst
例如:
rendering/
index.rst
cycles/
index.rst
introduction.rst
materials/
index.rst
introduction.rst
volumes.rst
这样做是为了将同一章节的内容包含在一个文件夹内。理想的情况下每个章节都应该有一个 index.rst
(包含该章节目录)和一个 introduction.rst
介绍该章节内容。
目录#
默认情况下,目录需显示两级深度:
.. toctree::
:maxdepth: 2
introduction.rst
perspective.rst
depth_of_field.rst