Up to date

This page is up to date for Godot 4.3. If you still find outdated information, please open an issue.

Contribuyendo a la documentación

Esta guía explica cómo contribuir a la documentación de Godot, ya sea escribiendo o revisando páginas.

Ver también

Si deseas traducir páginas o la referencia de clases de inglés a otros idiomas, lee Editor and documentation localization.

Empezar

Para modificar o crear páginas en el manual de referencia, debes editar archivos .rst en el repositorio de GitHub de godot-docs. Al modificar esas páginas en una solicitud de extracción (pull request), se activa una reconstrucción de la documentación en línea al fusionarse.

Ver también

Para obtener detalles sobre el uso de Git y el flujo de trabajo de solicitudes de extracción (pull requests), consulta la página Flujo de trabajo para los Pull request. La mayoría de lo que describe sobre el repositorio principal godotengine/godot también es válido para el repositorio de documentación.

Advertencia

The class reference's source files are in the Godot engine repository. We generate the Class Reference section of this documentation from them. If you want to update the description of a class, its methods, or properties, read Contribuyendo a la referencia de la clase.

Qué es la documentación de Godot

La documentación de Godot tiene como objetivo ser un manual de referencia completo para el motor de juegos Godot. No está destinada a contener tutoriales paso a paso, excepto por dos tutoriales de creación de juegos en la sección de Introducción.

Nos esforzamos por escribir contenido factual en un lenguaje accesible y bien escrito. Para contribuir, también debes leer:

  1. Writing guidelines. There, you will find rules and recommendations to write in a way that everyone understands.

  2. Directrices de contenido. They explain the principles we follow to write the documentation and the kind of content we accept.

Contribuyendo con los cambios

Pull requests should use the master branch by default. Only make pull requests against other branches (e.g. 3.6 or 4.2) if your changes only apply to that specific version of Godot. After a pull request is merged into master, it will usually be cherry-picked into the current stable branch by documentation maintainers.

Aunque sea menos conveniente de editar que una wiki, este repositorio Git es donde escribimos la documentación. Tener acceso directo a los archivos fuente en un sistema de control de versiones es una ventaja para asegurar la calidad de nuestra documentación.

Editando páginas existentes

To edit an existing page, locate its .rst source file and open it in your favorite text editor. You can then commit the changes, push them to your fork, and make a pull request. Note that the pages in classes/ should not be edited here. They are automatically generated from Godot's XML class reference. See Contribuyendo a la referencia de la clase for details.

Ver también

Para compilar el manual y probar los cambios en tu computadora, consulta Contruyendo el manual con Sphinx.

Editando páginas online

Puedes editar la documentación en línea haciendo clic en el enlace Editar en GitHub que se encuentra en la parte superior derecha de cada página.

Una vez allí, se abrirá el editor de texto de GitHub. Necesitas tener una cuenta en GitHub y haber iniciado sesión para poder utilizarlo. Una vez iniciada sesión, puedes proponer cambios de la siguiente manera:

  1. Haz clic en el botón "Editar en GitHub".

  2. On the GitHub page you're taken to, make sure the current branch is "master". Click the pencil icon in the top-right corner near the Raw, Blame, and Delete buttons. It has the tooltip "Fork this project and edit the file".

  3. Edita el texto en el editor de texto.

  4. Click "Commit changes...", summarize the changes you made and make sure to replace the placeholder "Update file.rst" by a short but clear one-line description, as this is the commit title. Click the button Propose changes.

  5. En las siguientes pantallas, haz clic en el botón Create pull request hasta que veas un mensaje como Username quiere fusionar 1 commit en godotengine:master desde Username:patch-1.

Nota

If there are more commits than your own in the pull request it is likely that your branch was created using the wrong origin, due to "master" not being the current branch in step 2. You will need to rebase your branch to "master" or create a new branch.

Otro colaborador revisará tus cambios y los fusionará en la documentación si son buenos. También pueden realizar cambios o pedirte que los hagas antes de fusionarlos.

Agregando nuevas páginas

Antes de agregar una nueva página, asegúrate de que se ajuste a la documentación existente:

  1. Busca en los problemas existentes o abre uno nuevo para ver si la página es necesaria.

  2. Asegúrate de que no haya una página que ya cubra el tema.

  3. Lea nuestro Directrices de contenido.

Para agregar una nueva página, crea un archivo .rst con un nombre significativo en la sección donde desees agregarlo, por ejemplo, tutorials/3d/light_baking.rst.

Luego, debes agregar tu página al "toctree" relevante (tabla de contenidos), por ejemplo, tutorials/3d/index.rst. Agrega el nombre de tu archivo nuevo en la lista en una nueva línea, usando una ruta relativa y sin extensión, por ejemplo, aquí light_baking.

Títulos

Siempre comienza las páginas con su título y un nombre de referencia de Sphinx:

.. _doc_insert_your_title_here:

Insert your title here
======================

La referencia _doc_insert_your_title_here y el título deben coincidir.

La referencia permite vincular a esta página utilizando el formato :ref:, por ejemplo, :ref:`doc_insert_your_title_here` enlazaría a la página de ejemplo anterior (nota la falta de guión bajo al principio de la referencia).

Escribe tus títulos como frases simples, sin capitalizar cada palabra:

  • Bueno: Entendiendo las señales en Godot

  • Malo: Entendiendo Señales En Godot

Only proper nouns, projects, people, and node class names should have their first letter capitalized.

Sintaxis de Sphinx y reStructuredText

Check Sphinx's reST Primer and the official reference for details on the syntax.

Sphinx utiliza comentarios específicos de reST para realizar operaciones específicas, como definir la tabla de contenido (.. toctree::) o crear referencias cruzadas entre páginas. Para obtener más detalles, consulta la documentación oficial de Sphinx. Si deseas aprender cómo usar directivas de Sphinx como .. note:: o .. seealso::, puedes revisar la documentación de directivas de Sphinx.

Añadiendo imágenes y archivos adjuntos

Para agregar imágenes, colócalas en una carpeta img/ junto al archivo .rst con un nombre significativo e inclúyelas en tu página con:

.. image:: img/image_name.webp

Alternativamente, puedes usar la directiva figure, la cual te da la imagen de un borde contrastante y permite centrarlo en la página.

.. figure:: img/image_name.webp
    :align: center

You can also include attachments as support material for a tutorial, by placing them into a files/ folder next to the .rst file, and using this inline markup:

:download:`file_name.zip <files/file_name.zip>`

Considere la posibilidad de utilizar el repositorio godot-docs-project-starters <https://github.com/godotengine/godot-docs-project-starters> para alojar material de apoyo, como plantillas de proyectos y paquetes de recursos. Puede utilizar un enlace directo al archivo generado desde ese repositorio con el marcado de enlace habitual:

`file_name.zip <https://github.com/godotengine/godot-docs-project-starters/releases/download/latest-4.x/file_name.zip>`_

Licencia

This documentation and every page it contains is published under the terms of the Creative Commons Attribution 3.0 license (CC BY 3.0), with attribution to "Juan Linietsky, Ariel Manzur and the Godot community".

Al contribuir a la documentación en el repositorio de GitHub, aceptas que tus cambios se distribuyen bajo esta licencia.