Files
godot-docs-l10n/sphinx/templates/getting_started/introduction/learning_new_features.pot
2025-12-19 15:00:42 +01:00

149 lines
9.7 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 latest\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/getting_started/introduction/learning_new_features.rst:8
msgid "Learning new features"
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:10
msgid "Godot is a feature-rich game engine. There is a lot to learn about it. This page explains how you can use the online manual, built-in code reference, and join online communities to learn new features and techniques."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:15
msgid "Making the most of this manual"
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:17
msgid "What you are reading now is the user manual. It documents each of the engine's concepts and available features. When learning a new topic, you can start by browsing the corresponding section of this website. The left menu allows you to explore broad topics while the search bar will help you find more specific pages. If a page exists for a given theme, it will often link to more related content."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:26
msgid "The manual has a companion class reference that explains each Godot class's available functions and properties when programming. While the manual covers general features, concepts, and how to use the editor, the reference is all about using Godot's scripting API (Application Programming Interface). You can access it both online and offline. We recommend browsing the reference offline, from within the Godot editor. To do so, go to Help -> Search Help or press :kbd:`F1`."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:36
msgid "To browse it online, head to the manual's :ref:`Class Reference <doc_class_reference>` section."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:39
msgid "A class reference's page tells you:"
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:41
msgid "Where the class exists in the inheritance hierarchy. You can click the top links to jump to parent classes and see the properties and methods a type inherits."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:47
msgid "A summary of the class's role and use cases."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:49
msgid "An explanation of the class's properties, methods, signals, enums, and constants."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:52
msgid "Links to manual pages further detailing the class."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:54
msgid "If the manual or class reference is missing or has insufficient information, please open an Issue in the official `godot-docs <https://github.com/godotengine/godot-docs/issues>`_ GitHub repository to report it."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:59
msgid "You can hold :kbd:`Ctrl` (macOS :kbd:`Cmd`) and then mouseover text like the name of a class, property, method, signal, or constant to underline it, then :kbd:`Ctrl + Click` (macOS :kbd:`Cmd + Click`) it to jump to it."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:63
msgid "Learning to think like a programmer"
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:65
msgid "Teaching programming foundations and how to think like a game developer is beyond the scope of Godot's documentation. If you're new to programming, we recommend two excellent free resources to get you started:"
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:69
msgid "GDQuest's *Learn GDScript From Zero* is a free and open source interactive tutorial for absolute beginners to learn to program with Godot's GDScript language. It is available as a `desktop application <https://gdquest.itch.io/learn-godot-gdscript>`__ or `in the browser <https://gdquest.github.io/learn-gdscript>`__."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:75
msgid "If you prefer books, check out the free ebook `Automate The Boring Stuff With Python <https://automatetheboringstuff.com/>`_ by Al Sweigart."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:79
msgid "Learning with the community"
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:81
msgid "Godot has a growing community of users. If you're stuck on a problem or need help to better understand how to achieve something, you can ask other users for help on one of the many `active communities <https://godotengine.org/community>`_."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:86
msgid "The best place to ask questions and find already answered ones is the official `Godot Forum <https://forum.godotengine.org/>`_. These responses show up in search engine results and get saved, allowing other users to benefit from discussions on the platform. Once you have asked a question there, you can share its link on other social platforms. Before asking a question, be sure to look for existing answers that might solve your problem on this website or using your preferred search engine."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:94
msgid "Asking questions well and providing details will help others answer you faster and better. When asking questions, we recommend including the following information:"
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:98
msgid "**Describe your goal**. You want to explain what you are trying to achieve design-wise. If you are having trouble figuring out how to make a solution work, there may be a different, easier solution that accomplishes the same goal."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:103
msgid "If there is an error involved, **share the exact error message**. You can copy the exact error message in the editor's Debugger bottom panel by clicking the Copy Error icon. Knowing what it says can help community members better identify how you triggered the error."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:108
msgid "If there is code involved, **share a code sample**. Other users won't be able to help you fix a problem without seeing your code. Share the code as text directly. To do so, you can copy and paste a short code snippet in a chat box, or use a website like `Pastebin <https://pastebin.com/>`_ to share long files."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:114
msgid "**Share a screenshot** of your *Scene* dock along with your written code. Most of the code you write affects nodes in your scenes. As a result, you should think of those scenes as part of your source code."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:120
msgid "Also, please don't take a picture with your phone, the low quality and screen reflections can make it hard to understand the image. Your operating system should have a built-in tool to take screenshots with the :kbd:`PrtSc` (Print Screen) key (macOS: use :kbd:`Cmd + Shift + 3` for a full screen shot, `more information here <https://support.apple.com/guide/mac-help/take-a-screenshot-mh26782/mac>`_)."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:126
msgid "Alternatively, you can use a program like `ShareX <https://getsharex.com/>`_ on Windows, or `Flameshot <https://flameshot.org/>`_ on Windows/macOS/Linux."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:129
msgid "Sharing a video of your running game can also be really **useful to troubleshoot your game**. You can use programs like `OBS Studio <https://obsproject.com/>`_ and `Screen to GIF <https://www.screentogif.com/>`_ to capture your screen."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:134
msgid "You can then use a service like `streamable <https://streamable.com/>`_ or a cloud provider to upload and share your videos for free."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:137
msgid "If you're not using the stable version of Godot, please mention the version you're using. The answer can be different as available features and the interface evolve rapidly."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:141
msgid "Following these guidelines will maximize your chances of getting the answer you're looking for. They will save time both for you and the persons helping you."
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:145
msgid "Community tutorials"
msgstr ""
#: ../../docs/getting_started/introduction/learning_new_features.rst:147
msgid "This manual aims to provide a comprehensive reference of Godot's features. Aside from the 2D and 3D getting started series, it does not contain tutorials to implement specific game genres. If you're looking for a tutorial about creating a role-playing game, a platformer, or other, please see :ref:`doc_community_tutorials`, which lists content made by the Godot community."
msgstr ""