Templates

The following guide provides patterns for interface elements and directories.

Menu Operator

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`

Panel

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
------------------

Properti

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

Property
   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

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).


Inputs
======

This node has no inputs.


Properties
==========

This node has no properties.


Outputs
=======

This node has no outputs.


Example
=======

Layout Direktori

Bagian-bagian seharusnya pada umumnya terstruktur seperti yang berikut:

• directory_name/

  • index.rst (mengandung link untuk file internal)

  • introduction.rst

  • section_1.rst

  • section_2.rst

Sebagai contoh:

• rendering/

  • index.rst

  • cycles/

    • index.rst

    • introduction.rst

    • materials/

      • index.rst

      • introduction.rst

      • volumes.rst

Idenya adalah untuk menyertakan semua konten bagian di dalam folder. Idealnya setiap bagian harus memiliki index.rst (berisi TOC untuk bagian itu) dan introduction.rst (memperkenalkan) ke konten bagian.

Tabel Konten

Secara default, tabel konten seharusnya menampilkan dua level kedalaman:

.. toctree::
   :maxdepth: 2

   introduction.rst
   perspective.rst
   depth_of_field.rst