index.rst 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158
  1. :allow_comments: False
  2. Godot Docs – *4.3* branch
  3. ============================
  4. .. only:: not i18n
  5. .. note:: Godot's documentation is available in various languages and versions.
  6. Expand the "Read the Docs" panel at the bottom of the sidebar to see
  7. the list.
  8. .. only:: i18n
  9. .. note:: This documentation is translated from the `original English one
  10. <https://docs.godotengine.org/en/stable>`_ by community members
  11. on `Weblate <https://hosted.weblate.org/projects/godot-engine/godot-docs>`_.
  12. Depending on the translation effort's completion level, you may
  13. find paragraphs or whole pages which are still in English. You can
  14. help the community by providing new translations or reviewing existing
  15. ones on Weblate.
  16. For the time being, localized translations are only available for
  17. the "stable" branch. You can still view the English documentation for
  18. other engine versions using the "Read the Docs" panel at the bottom
  19. of the sidebar.
  20. Welcome to the official documentation of `Godot Engine <https://godotengine.org>`__,
  21. the free and open source community-driven 2D and 3D game engine! If you are new
  22. to this documentation, we recommend that you read the
  23. :ref:`introduction page <doc_about_intro>` to get an overview of what this
  24. documentation has to offer.
  25. The table of contents in the sidebar should let you easily access the documentation
  26. for your topic of interest. You can also use the search function in the top-left corner.
  27. Get involved
  28. ------------
  29. Godot Engine is an open source project developed by a community of volunteers.
  30. The documentation team can always use your feedback and help to improve the
  31. tutorials and class reference. If you don't understand something, or cannot find
  32. what you are looking for in the docs, help us make the documentation better
  33. by letting us know!
  34. Submit an issue or pull request on the `GitHub repository <https://github.com/godotengine/godot-docs/issues>`_,
  35. help us `translate the documentation <https://hosted.weblate.org/engage/godot-engine/>`_
  36. into your language, or talk to us on the ``#documentation`` channel on the
  37. `Godot Contributors Chat <https://chat.godotengine.org/>`_!
  38. .. centered:: |weblate_widget|
  39. Offline documentation
  40. ---------------------
  41. To browse the documentation offline, you can download an HTML copy (updated every Monday): `stable <https://nightly.link/godotengine/godot-docs/workflows/build_offline_docs/master/godot-docs-html-stable.zip>`__, `latest <https://nightly.link/godotengine/godot-docs/workflows/build_offline_docs/master/godot-docs-html-master.zip>`__, `3.6 <https://nightly.link/godotengine/godot-docs/workflows/build_offline_docs/master/godot-docs-html-3.6.zip>`__. Extract the ZIP archive then open
  42. the top-level ``index.html`` in a web browser.
  43. For mobile devices or e-readers, you can also download an ePub copy (updated every Monday): `stable <https://nightly.link/godotengine/godot-docs/workflows/build_offline_docs/master/godot-docs-epub-stable.zip>`__, `latest <https://nightly.link/godotengine/godot-docs/workflows/build_offline_docs/master/godot-docs-epub-master.zip>`__, `3.6 <https://nightly.link/godotengine/godot-docs/workflows/build_offline_docs/master/godot-docs-epub-3.6.zip>`__. Extract the ZIP archive then open
  44. the ``GodotEngine.epub`` file in an e-book reader application.
  45. .. Below is the main table-of-content tree of the documentation website.
  46. It is hidden on the page itself, but it makes up the sidebar for navigation.
  47. .. toctree::
  48. :hidden:
  49. :maxdepth: 1
  50. :caption: About
  51. :name: sec-general
  52. about/introduction
  53. about/list_of_features
  54. about/system_requirements
  55. about/faq
  56. about/complying_with_licenses
  57. about/release_policy
  58. about/docs_changelog
  59. .. toctree::
  60. :hidden:
  61. :maxdepth: 1
  62. :caption: Getting started
  63. :name: sec-learn
  64. getting_started/introduction/index
  65. getting_started/step_by_step/index
  66. getting_started/first_2d_game/index
  67. getting_started/first_3d_game/index
  68. .. Sections below are split into two groups. First come meta sections, covering
  69. general matters. Below that different areas of the engine are listed.
  70. These sections are sorted alphabetically. Please keep them that way.
  71. .. toctree::
  72. :hidden:
  73. :maxdepth: 1
  74. :caption: Manual
  75. :name: sec-tutorials
  76. tutorials/best_practices/index
  77. tutorials/troubleshooting
  78. tutorials/editor/index
  79. tutorials/migrating/index
  80. tutorials/2d/index
  81. tutorials/3d/index
  82. tutorials/animation/index
  83. tutorials/assets_pipeline/index
  84. tutorials/audio/index
  85. tutorials/export/index
  86. tutorials/io/index
  87. tutorials/i18n/index
  88. tutorials/inputs/index
  89. tutorials/math/index
  90. tutorials/navigation/index
  91. tutorials/networking/index
  92. tutorials/performance/index
  93. tutorials/physics/index
  94. tutorials/platform/index
  95. tutorials/plugins/index
  96. tutorials/rendering/index
  97. tutorials/scripting/index
  98. tutorials/shaders/index
  99. tutorials/ui/index
  100. tutorials/xr/index
  101. .. toctree::
  102. :hidden:
  103. :maxdepth: 1
  104. :caption: Contributing
  105. :name: sec-contributing
  106. contributing/how_to_contribute
  107. contributing/workflow/index
  108. contributing/development/index
  109. contributing/documentation/index
  110. .. toctree::
  111. :hidden:
  112. :maxdepth: 1
  113. :caption: Community
  114. :name: sec-community
  115. community/asset_library/index
  116. community/channels
  117. community/tutorials
  118. .. toctree::
  119. :hidden:
  120. :maxdepth: 1
  121. :caption: Class reference
  122. :name: sec-class-ref
  123. classes/index