Khuôn Mẫu

Hướng dẫn sau đây sẽ cung cấp các kiểu mẫu cho các phần tử giao diện và các thư mục.

Trình Đơn Thao Tác

Mỗi thao tác phải có tiêu đề hoặc trang riêng cho mình, dựa trên chiều dài của nội dung. Phần đầu phải là một tham chiếu nhắc nhở, giải thích bối cảnh của thao tác:

.. admonition:: Reference
   :class: refbox

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

Bảng

Các bảng nên được giải thích dưới tiêu đề riêng của chúng, các bảng lồng nhau, cái nọ trong cái kia, nên sử dụng phân hạng tiêu đề cấp thứ, theo chiều nhỏ dần đi. Mỗi bảng điều khiển có thể có trang riêng của mình, dựa trên độ dài của tài liệu, và/hoặc số lượng bảng. Các Trình Đơn Mở Rộng, dùng để bật/tắt các thuộc tính và cho phép chọn cái nào sẽ trình bày cho người dùng thấy, cái nào không, nên được đối xử như các bảng thứ:

Panel Title
===========

Nested Panel Title
------------------

Tính Chất

Các tính chất nên được giải thích bằng cách sử dụng các danh sách định nghĩa. Các tính chất bị ẩn khuất đi, dưới ảnh hưởng của các tính chất khác, thì nên được sử dụng định nghĩa lồng dưới nhau:

Property
   Property description.

   Hidden Property
      Hidden property description.

Các trình đơn cho phép chọn lựa từng cái một thì nên được ghi lại bằng cú pháp sau:

Menu Label
   General description of the menu.

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

Nút

Các nút phải luôn có ba tiêu đề: đầu vào, tính chất và đầu ra, với một lưu ý nhắc nhở về sự vắng mặt của chúng, nếu nút không có một cái nào đó. Ở cuối trang có thể có một phần về (các) ví dụ, tuy không bắt buộc:

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

Bố Trí của Thư Mục

Các phần nên được kết cấu một cách chung chung như sau:

directory_name/
- index.rst (có chứa các đường kết nối đến những tập tin nội bộ)
- introduction.rst
- section_1.rst
- section_2.rst

Lấy ví dụ:

rendering/
- index.rst
- cycles/
  - index.rst
  - introduction.rst
  - materials/
    - index.rst
    - introduction.rst
    - volumes.rst

Đại ý là chúng ta cần phải gộp tất cả các nội dung của một phần vào nằm nội bên trong một thư mục. Lý tưởng nhất là mỗi phần có một bản index.rst (chứa TOC cho phần đó) và introduction.rst (giới thiệu) cho nội dung của phần đó.

Bảng Mục Lục

Theo mặc định, một bảng nội dung nên có hai tầng bậc:

.. toctree::
   :maxdepth: 2

   introduction.rst
   perspective.rst
   depth_of_field.rst

Join the 2%