mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
226 lines
12 KiB
Plaintext
226 lines
12 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
||
# Copyright (C) 2014-2022, 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 3.5\n"
|
||
"Report-Msgid-Bugs-To: \n"
|
||
"POT-Creation-Date: 2022-09-09 16:03+0200\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/community/contributing/contributing_to_the_documentation.rst:4
|
||
msgid "Contributing to the documentation"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/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/community/contributing/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/community/contributing/contributing_to_the_documentation.rst:15
|
||
msgid "Getting started"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/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/community/contributing/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/community/contributing/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:`Godot API <toc-class-ref>` 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/community/contributing/contributing_to_the_documentation.rst:35
|
||
msgid "What is the Godot documentation"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/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/community/contributing/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/community/contributing/contributing_to_the_documentation.rst:44
|
||
msgid "The :ref:`doc_docs_writing_guidelines`. There, you will find rules and recommendations to write in a way that everyone understands."
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:46
|
||
msgid "The content guidelines. They explain the principles we follow to write the documentation and the kind of content we accept."
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:50
|
||
msgid "Contributing changes"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/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. ``2.1`` or ``3.0``) if your changes only apply to that specific version of Godot."
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:56
|
||
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/community/contributing/contributing_to_the_documentation.rst:61
|
||
msgid "Editing existing pages"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:63
|
||
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/community/contributing/contributing_to_the_documentation.rst:70
|
||
msgid "To build the manual and test changes on your computer, see :ref:`doc_building_the_manual`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:74
|
||
msgid "Editing pages online"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:76
|
||
msgid "You can edit the documentation online by clicking the **Edit on GitHub** link in the top-right of every page."
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:79
|
||
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/community/contributing/contributing_to_the_documentation.rst:82
|
||
msgid "Click the **Edit on GitHub** button."
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:84
|
||
msgid "On the GitHub page you're taken to, 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/community/contributing/contributing_to_the_documentation.rst:88
|
||
msgid "Edit the text in the text editor."
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:90
|
||
msgid "At the bottom of the web page, summarize the changes you made and click the button **Propose file change**. Make sure to replace the placeholder \"Update file.rst\" by a short but clear one-line description, as this is the commit title."
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:94
|
||
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/community/contributing/contributing_to_the_documentation.rst:98
|
||
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/community/contributing/contributing_to_the_documentation.rst:102
|
||
msgid "Adding new pages"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:104
|
||
msgid "Before adding a new page, please ensure that it fits in the documentation:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:106
|
||
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/community/contributing/contributing_to_the_documentation.rst:109
|
||
msgid "Ensure there isn't a page that already covers the topic."
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:110
|
||
msgid "Read our :ref:`doc_content_guidelines`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:112
|
||
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/community/contributing/contributing_to_the_documentation.rst:115
|
||
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/community/contributing/contributing_to_the_documentation.rst:120
|
||
msgid "Titles"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:122
|
||
msgid "Always begin pages with their title and a Sphinx reference name:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:131
|
||
msgid "The reference ``_doc_insert_your_title_here`` and the title should match."
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:133
|
||
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/community/contributing/contributing_to_the_documentation.rst:137
|
||
msgid "Write your titles like plain sentences, without capitalizing each word:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:139
|
||
msgid "**Good:** Understanding signals in Godot"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:140
|
||
msgid "**Bad:** Understanding Signals In Godot"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:142
|
||
msgid "Only propers nouns, projects, people, and node class names should have their first letter capitalized."
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:146
|
||
msgid "Sphinx and reStructuredText syntax"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:148
|
||
msgid "Check Sphinx’s `reST Primer <https://www.sphinx-doc.org/en/stable/rest.html>`__ and the `official reference <http://docutils.sourceforge.net/rst.html>`__ for details on the syntax."
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:152
|
||
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/community/contributing/contributing_to_the_documentation.rst:161
|
||
msgid "Adding images and attachments"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:163
|
||
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/community/contributing/contributing_to_the_documentation.rst:170
|
||
msgid "Similarly, you can include attachments, like assets 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/community/contributing/contributing_to_the_documentation.rst:180
|
||
msgid "License"
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:182
|
||
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://tldrlegal.com/license/creative-commons-attribution-(cc)>`_, with attribution to \"Juan Linietsky, Ariel Manzur and the Godot community\"."
|
||
msgstr ""
|
||
|
||
#: ../../docs/community/contributing/contributing_to_the_documentation.rst:187
|
||
msgid "By contributing to the documentation on the GitHub repository, you agree that your changes are distributed under this license."
|
||
msgstr ""
|
||
|
||
#: ../../docs/<rst_epilog>:0
|
||
msgid "Translation status"
|
||
msgstr ""
|