Hugo Locurcio
bcb9c3bfd8
- Update type names in question about GDScript and other languages. - Move question about plugins to be located just below the question about SDKs. - Mention that using C++ exceptions would increase compile times, as evidenced by Godot's SCons setup recently disabling exception handling by default. - Replace potentially misleading "2K" term with 1440p, assuming the question has mobile devices in mind (current flagships are 1440p). - Remove question about RTTI not being used in Godot, as RTTI is now always used to ensure type safety in projects exported in release mode. - Remove reference to option to shrink images on load, which was removed in Godot 4.0 (devices with such low resolutions are very uncommon nowadays anyway).
Godot Engine documentation
This repository contains the source files of Godot Engine's documentation, in reStructuredText markup language (reST).
They are meant to be parsed with the Sphinx documentation builder to build the HTML documentation on Godot's website.
Download for offline use
To browse the documentation offline, you can use the mirror of the documentation hosted on DevDocs. To enable offline browsing on DevDocs, you need to:
- Click the three dots in the top-left corner, choose Preferences.
- Enable the desired version of the Godot documentation by checking the box next to it in the sidebar.
- Click the three dots in the top-left corner, choose Offline data.
- Click the Install link next to the Godot documentation.
You can also
download an HTML copy
for offline reading (updated every Monday). Extract the ZIP archive then open
the top-level index.html in a web browser.
For mobile devices or e-readers, you can also
download an ePub copy
for offline reading (updated every Monday). Extract the ZIP archive then open
the GodotEngine.epub file in an e-book reader application.
Theming
The Godot documentation uses the default sphinx_rtd_theme with many
customizations applied on top. It will automatically switch between
the light and dark theme depending on your browser/OS' theming preference.
If you use Firefox and wish to use the dark theme regardless of your OS configuration, you can install the Dark Website Forcer add-on.
Contributing
All contributors are welcome to help on the Godot documentation.
To get started, head to the Contributing section of the online manual. There, you will find all the information you need to write and submit changes.
Here are some quick links to the areas you might be interested in:
- Contributing to the online manual
- Contributing to the class reference
- Content guidelines
- Writing guidelines
- Building the manual
- Translating the documentation
License
At the exception of the classes/ folder, all the content of this repository is licensed under the Creative Commons Attribution 3.0 Unported license (CC BY 3.0) and is to be attributed to "Juan Linietsky, Ariel Manzur and the Godot community".
See LICENSE.txt for details.
The files in the classes/ folder are derived from Godot's main source repository and are distributed under the MIT license, with the same authors as above.