#godot #docs #howto

Samuel Nicholas b61cd5d935 Update Working with CMake GDExtension documentation (#11370) 6 hours ago
.github f875de93e5 Update contributing links to contributing.godotengine.org. 1 month ago
_extensions 3a50eec76b read classes from file when lexing 1 month ago
_static 2d9c2365d4 Fix redirects in safari, by moving the redirect js script into the 404 page instead of checking if we're on 404 via the API. 1 week ago
_styleguides 0855668721 Migrate contributing contents to a separate documentation site. 1 month ago
_templates 0855668721 Migrate contributing contents to a separate documentation site. 1 month ago
_tools e69b689540 Add JavaScript-based redirects to supplement Read the Docs redirects 1 week ago
about 91e6e63588 Update release policy with info now that 4.5 is released 5 days ago
classes 9afaf48fc7 classref: Sync with current master branch (cb7cd81) 3 days ago
community a15f86bc03 Merge branch 'master' into patch-1 6 months ago
engine_details f6b40a054e Merge pull request #11352 from Calinou/remove-old-version-references 3 days ago
getting_started cab0c1cb9e Link to GDExtension articles from the Godot introduction. 1 month ago
img a82ed18d3d Add FoldableContainer to the Control node gallery page 3 months ago
tutorials b61cd5d935 Update Working with CMake GDExtension documentation (#11370) 6 hours ago
.editorconfig 24d0a7ec39 Add `.editorconfig` and `.gitattributes` files for automatic settings (#4700) 4 years ago
.gitattributes 24d0a7ec39 Add `.editorconfig` and `.gitattributes` files for automatic settings (#4700) 4 years ago
.gitignore 965685e247 Add more Python-related files to gitignore 8 months ago
.lycheeignore bf27bf2c96 Fix URL check errors 6 months ago
.mailmap 4c3c39cc15 Sync AUTHORS.md to add top contributors from past years 1 year ago
.pre-commit-config.yaml 0855668721 Migrate contributing contents to a separate documentation site. 1 month ago
.readthedocs.yml d9e0d8386e Add tools definition for RTD 2 years ago
404.rst 1ffd71c5e7 Fix RTD language switcher redirecting to nonexistent `/en/4.x/` branch 5 days ago
AUTHORS.md 4c3c39cc15 Sync AUTHORS.md to add top contributors from past years 1 year ago
LICENSE.txt 9bfc111547 Add full text of CC-BY-3.0 license 6 years ago
Makefile 31204023b6 Makefile: use sphinx-build -M 2 years ago
README.md f875de93e5 Update contributing links to contributing.godotengine.org. 1 month ago
conf.py 3cc1b0d979 Bump version 1 month ago
index.rst 0855668721 Migrate contributing contents to a separate documentation site. 1 month ago
make.bat 64a3b465c2 Update SFC to Godot Foundation, old URLs 2 years ago
pyproject.toml f70686cdbe CI: Integrate `pre-commit` for style checks 11 months ago
requirements.txt 01970e58b2 Bump sphinxext-opengraph from 0.12.0 to 0.13.0 1 month ago
robots.txt fd5f6f4909 Appease our great search engine overlords 5 years ago

README.md

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 download an HTML copy (updated every Monday): stable, latest, 3.6. 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 (updated every Monday): stable, latest, 3.6. 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 documentation. 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:

  1. Contributing to the online manual
  2. Contributing to the class reference
  3. Content guidelines
  4. Writing guidelines
  5. Building the manual
  6. Translating the documentation

License

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