mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2026-01-05 14:10:19 +03:00
233 lines
13 KiB
Plaintext
233 lines
13 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
||
# Copyright (C) 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0)
|
||
# This file is distributed under the same license as the Godot Engine package.
|
||
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
||
#
|
||
#, fuzzy
|
||
msgid ""
|
||
msgstr ""
|
||
"Project-Id-Version: Godot Engine 4.4\n"
|
||
"Report-Msgid-Bugs-To: \n"
|
||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||
"MIME-Version: 1.0\n"
|
||
"Content-Type: text/plain; charset=UTF-8\n"
|
||
"Content-Transfer-Encoding: 8bit\n"
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:4
|
||
msgid "Contributing to the documentation"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:6
|
||
msgid "This guide explains how to contribute to Godot's documentation, be it by writing or reviewing pages."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:11
|
||
msgid "If you want to translate pages or the class reference from English to other languages, read :ref:`doc_editor_and_docs_localization`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:15
|
||
msgid "Getting started"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:17
|
||
msgid "To modify or create pages in the reference manual, you need to edit ``.rst`` files in the `godot-docs GitHub repository <https://github.com/godotengine/godot-docs>`_. Modifying those pages in a pull request triggers a rebuild of the online documentation upon merging."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:22
|
||
msgid "For details on Git usage and the pull request workflow, please refer to the :ref:`doc_pr_workflow` page. Most of what it describes regarding the main godotengine/godot repository is also valid for the docs repository."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:27
|
||
msgid "The class reference's source files are in the `Godot engine repository <https://github.com/godotengine/godot>`_. We generate the :ref:`Class Reference <doc_class_reference>` section of this documentation from them. If you want to update the description of a class, its methods, or properties, read :ref:`doc_updating_the_class_reference`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:35
|
||
msgid "What is the Godot documentation"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:37
|
||
msgid "The Godot documentation is intended as a comprehensive reference manual for the Godot game engine. It is not meant to contain step-by-step tutorials, except for two game creation tutorials in the Getting Started section."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:41
|
||
msgid "We strive to write factual content in an accessible and well-written language. To contribute, you should also read:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:44
|
||
msgid ":ref:`doc_docs_writing_guidelines`. There, you will find rules and recommendations to write in a way that everyone understands."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:46
|
||
msgid ":ref:`doc_content_guidelines`. They explain the principles we follow to write the documentation and the kind of content we accept."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:50
|
||
msgid "Contributing changes"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:52
|
||
msgid "**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."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:58
|
||
msgid "Though less convenient to edit than a wiki, this Git repository is where we write the documentation. Having direct access to the source files in a revision control system is a plus to ensure our documentation quality."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:63
|
||
msgid "Editing existing pages"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:65
|
||
msgid "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 <https://github.com/godotengine/godot/tree/master/doc/classes>`__. See :ref:`doc_updating_the_class_reference` for details."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:72
|
||
msgid "To build the manual and test changes on your computer, see :ref:`doc_building_the_manual`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:76
|
||
msgid "Editing pages online"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:78
|
||
msgid "You can edit the documentation online by clicking the **Edit on GitHub** link in the top-right of every page."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:81
|
||
msgid "Doing so takes you to the GitHub text editor. You need to have a GitHub account and to log in to use it. Once logged in, you can propose change like so:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:84
|
||
msgid "Click the **Edit on GitHub** button."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:86
|
||
msgid "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\"."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:91
|
||
msgid "Edit the text in the text editor."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:93
|
||
msgid "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**."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:98
|
||
msgid "On the following screens, click the **Create pull request** button until you see a message like *Username wants to merge 1 commit into godotengine:master from Username:patch-1*."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:104
|
||
msgid "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."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:109
|
||
msgid "Another contributor will review your changes and merge them into the docs if they're good. They may also make changes or ask you to do so before merging."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:113
|
||
msgid "Adding new pages"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:115
|
||
msgid "Before adding a new page, please ensure that it fits in the documentation:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:117
|
||
msgid "Look for `existing issues <https://github.com/godotengine/godot-docs/issues>`_ or open a new one to see if the page is necessary."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:120
|
||
msgid "Ensure there isn't a page that already covers the topic."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:121
|
||
msgid "Read our :ref:`doc_content_guidelines`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:123
|
||
msgid "To add a new page, create a ``.rst`` file with a meaningful name in the section you want to add a file to, e.g. ``tutorials/3d/light_baking.rst``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:126
|
||
msgid "You should then add your page to the relevant \"toctree\" (table of contents, e.g. ``tutorials/3d/index.rst``). Add your new filename to the list on a new line, using a relative path and no extension, e.g. here ``light_baking``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:131
|
||
msgid "Titles"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:133
|
||
msgid "Always begin pages with their title and a Sphinx reference name:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:142
|
||
msgid "The reference ``_doc_insert_your_title_here`` and the title should match."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:144
|
||
msgid "The reference allows linking to this page using the ``:ref:`` format, e.g. ``:ref:`doc_insert_your_title_here``` would link to the above example page (note the lack of leading underscore in the reference)."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:148
|
||
msgid "Write your titles like plain sentences, without capitalizing each word:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:150
|
||
msgid "**Good:** Understanding signals in Godot"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:151
|
||
msgid "**Bad:** Understanding Signals In Godot"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:153
|
||
msgid "Only proper nouns, projects, people, and node class names should have their first letter capitalized."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:157
|
||
msgid "Sphinx and reStructuredText syntax"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:159
|
||
msgid "Check Sphinx's `reST Primer <https://www.sphinx-doc.org/en/stable/rest.html>`__ and the `official reference <https://docutils.sourceforge.net/rst.html>`__ for details on the syntax."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:163
|
||
msgid "Sphinx uses specific reST comments to do specific operations, like defining the table of contents (``.. toctree::``) or cross-referencing pages. Check the `official Sphinx documentation <https://www.sphinx-doc.org/en/stable/index.html>`__ for more details. To learn how to use Sphinx directives like ``.. note::`` or ``.. seealso::``, check out the `Sphinx directives documentation <https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html>`__."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:172
|
||
msgid "Adding images and attachments"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:174
|
||
msgid "To add images, please put them in an ``img/`` folder next to the ``.rst`` file with a meaningful name and include them in your page with:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:181
|
||
msgid "Alternatively, you can use the `figure` directive, which gives the image a contrasting border and allows centering it on the page."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:189
|
||
msgid "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:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:196
|
||
msgid "Consider using the `godot-docs-project-starters <https://github.com/godotengine/godot-docs-project-starters>` repository for hosting support materials, such as project templates and asset packs. You can use a direct link to the generated archive from that repository with the regular link markup:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:207
|
||
msgid "License"
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:209
|
||
msgid "This documentation and every page it contains is published under the terms of the `Creative Commons Attribution 3.0 license (CC BY 3.0) <https://creativecommons.org/licenses/by/3.0/>`_, with attribution to \"Juan Linietsky, Ariel Manzur and the Godot community\"."
|
||
msgstr ""
|
||
|
||
#: ../../docs/contributing/documentation/contributing_to_the_documentation.rst:214
|
||
msgid "By contributing to the documentation on the GitHub repository, you agree that your changes are distributed under this license."
|
||
msgstr ""
|