mirror of
https://github.com/godotengine/godot-docs.git
synced 2026-01-05 22:09:56 +03:00
Add support for split class reference
This commit is contained in:
@@ -5,7 +5,7 @@ Documentation changelog
|
|||||||
|
|
||||||
The documentation is continually being improved. New releases
|
The documentation is continually being improved. New releases
|
||||||
include new pages, fixes and updates to existing pages, and many updates
|
include new pages, fixes and updates to existing pages, and many updates
|
||||||
to the :ref:`class reference <toc-class-ref>`. Below is a list of new pages
|
to the :ref:`class reference <doc_class_reference>`. Below is a list of new pages
|
||||||
added since version 3.0.
|
added since version 3.0.
|
||||||
|
|
||||||
.. note:: This document only contains new pages so not all changes are reflected,
|
.. note:: This document only contains new pages so not all changes are reflected,
|
||||||
|
|||||||
@@ -1,11 +1,13 @@
|
|||||||
:github_url: hide
|
:github_url: hide
|
||||||
|
|
||||||
|
.. _doc_class_reference:
|
||||||
|
|
||||||
Godot API
|
Godot API
|
||||||
=========
|
=========
|
||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 1
|
:maxdepth: 1
|
||||||
:name: toc-class-ref
|
:name: toc-class-ref-classes
|
||||||
:glob:
|
:glob:
|
||||||
|
|
||||||
class_*
|
class_*
|
||||||
|
|||||||
@@ -26,7 +26,7 @@ request triggers a rebuild of the online documentation upon merging.
|
|||||||
|
|
||||||
.. warning:: The class reference's source files are in the `Godot engine
|
.. warning:: The class reference's source files are in the `Godot engine
|
||||||
repository <https://github.com/godotengine/godot>`_. We generate
|
repository <https://github.com/godotengine/godot>`_. We generate
|
||||||
the :ref:`Godot API <toc-class-ref>` section of this documentation
|
the :ref:`Class Reference <doc_class_reference>` section of this documentation
|
||||||
from them. If you want to update the description of a class, its
|
from them. If you want to update the description of a class, its
|
||||||
methods, or properties, read
|
methods, or properties, read
|
||||||
:ref:`doc_updating_the_class_reference`.
|
:ref:`doc_updating_the_class_reference`.
|
||||||
|
|||||||
@@ -5,7 +5,7 @@ Contributing to the class reference
|
|||||||
|
|
||||||
.. highlight:: shell
|
.. highlight:: shell
|
||||||
|
|
||||||
The class reference is available online in the :ref:`classes <toc-class-ref>`
|
The class reference is available online in the :ref:`classes <doc_class_reference>`
|
||||||
section of the documentation and in the Godot editor, from the help menu.
|
section of the documentation and in the Godot editor, from the help menu.
|
||||||
|
|
||||||
In the class reference, some methods, variables, and signals lack descriptions.
|
In the class reference, some methods, variables, and signals lack descriptions.
|
||||||
@@ -45,7 +45,7 @@ repository: `doc/classes/
|
|||||||
|
|
||||||
.. warning:: Always edit the API reference through these source XML files. Do
|
.. warning:: Always edit the API reference through these source XML files. Do
|
||||||
not edit the generated ``.rst`` files :ref:`in the online documentation
|
not edit the generated ``.rst`` files :ref:`in the online documentation
|
||||||
<toc-class-ref>`, hosted in the `godot-docs
|
<doc_class_reference>`, hosted in the `godot-docs
|
||||||
<https://github.com/godotengine/godot-docs>`_ repository.
|
<https://github.com/godotengine/godot-docs>`_ repository.
|
||||||
|
|
||||||
.. warning::
|
.. warning::
|
||||||
|
|||||||
@@ -196,8 +196,8 @@ There are two separate resources referred to as "documentation" in Godot:
|
|||||||
|
|
||||||
- **The class reference.** This is the documentation for the complete Godot API
|
- **The class reference.** This is the documentation for the complete Godot API
|
||||||
as exposed to GDScript and the other scripting languages. It can be consulted
|
as exposed to GDScript and the other scripting languages. It can be consulted
|
||||||
offline, directly in Godot's code editor, or online at :ref:`Godot API
|
offline, directly in Godot's code editor, or online at Godot :ref:`Class Reference
|
||||||
<toc-class-ref>`. To contribute to the class reference, you have to edit the
|
<doc_class_reference>`. To contribute to the class reference, you have to edit the
|
||||||
XML file corresponding to the class and make a pull request.
|
XML file corresponding to the class and make a pull request.
|
||||||
See :ref:`doc_updating_the_class_reference` and
|
See :ref:`doc_updating_the_class_reference` and
|
||||||
:ref:`doc_class_reference_writing_guidelines` for more details.
|
:ref:`doc_class_reference_writing_guidelines` for more details.
|
||||||
|
|||||||
@@ -33,7 +33,7 @@ from within the Godot editor. To do so, go to Help -> Search or press
|
|||||||
|
|
||||||
.. image:: img/manual_class_reference_search.png
|
.. image:: img/manual_class_reference_search.png
|
||||||
|
|
||||||
To browse it online, head to the manual's :ref:`Class Reference <toc-class-ref>`
|
To browse it online, head to the manual's :ref:`Class Reference <doc_class_reference>`
|
||||||
section.
|
section.
|
||||||
|
|
||||||
A class reference's page tells you:
|
A class reference's page tells you:
|
||||||
|
|||||||
Reference in New Issue
Block a user