The following guide provides patterns for interface elements and directories.

Operator Menus#

Each operator should receive its own heading or page based on the length of the content. At the start should be a reference admonition documenting the context of the operator:

.. admonition:: Reference
   :class: refbox

   :Mode:      Edit Mode
   :Menu:      :menuselection:`Curve --> Snap`
   :Shortcut:  :kbd:`Shift-S`


Panels should be documented by their own heading, nested panels should use decreasing heading levels. Each panel could have its own page based on the length of documentation and/or the amount of panels. Expanded menus that toggle what properties are presented to the user should be treated like subpanels:

Panel Title

Nested Panel Title


Properties should be documented using definition lists. Properties that are hidden based on other properties should used nested definitions:

   Property description.

   Hidden Property
      Hidden property description.

Select menus should be documented using the following syntax:

Menu Label
   General description of the menu.

   :Menu Item: Menu Item Definition.
   :Menu Item: Menu Item Definition.
   :Menu Item: Menu Item Definition.


Nodes should always have three headings inputs, properties and outputs with a note of absence if the node has none. At the end of the page can be an optional example(s) section:

World Node

.. figure:: /images/render_shader-nodes_output_world_node.png
   :align: right

   The World node.

Introduction and general use case(s).


This node has no inputs.


This node has no properties.


This node has no outputs.


폴더 구조#

섹션(secion)은 이렇게 정리되어야 해요.

  • directory_name/

    • index.rst (contains links to internal files)

    • 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 소개 파일을 가져요.


목차는 두 단계의 깊이(depth)를 가져야 해요.

.. toctree::
   :maxdepth: 2