Files
godot-docs-l10n/sphinx/templates/getting_started/scripting/gdscript/gdscript_styleguide.pot
2019-01-09 10:58:46 +01:00

167 lines
6.5 KiB
Plaintext

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2014-2019, 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"
"POT-Creation-Date: 2019-01-09 10:56+0100\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/scripting/gdscript/gdscript_styleguide.rst:4
msgid "GDScript style guide"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:7
msgid "Description"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:9
msgid "This styleguide lists conventions to write elegant GDScript. The goal is to encourage writing clean, readable code and promote consistency across projects, discussions, and tutorials. Hopefully, this will also encourage development of auto-formatting tools."
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:14
msgid "Since GDScript is close to Python, this guide is inspired by Python's `PEP 8 <https://www.python.org/dev/peps/pep-0008/>`__ programming styleguide."
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:18
msgid "Godot's built-in script editor uses a lot of these conventions by default. Let it help you."
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:22
msgid "Code structure"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:25
msgid "Indentation"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:27
msgid "Indent type: Tabs *(editor default)*"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:29
msgid "Indent size: 4 *(editor default)*"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:31
msgid "Each indent level should be one greater than the block containing it."
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:33
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:53
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:83
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:107
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:127
msgid "**Good**:"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:40
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:61
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:93
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:114
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:137
msgid "**Bad**:"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:50
msgid "Use 2 indent levels to distinguish continuation lines from regular code blocks."
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:70
msgid "Blank lines"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:72
msgid "Surround functions and class definitions with a blank line."
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:74
msgid "Use one blank line inside functions to separate logical sections."
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:77
msgid "One statement per line"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:79
msgid "Never combine multiple statements on a single line. No, C programmers, not with a single line conditional statement (except with the ternary operator)!"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:102
msgid "Avoid unnecessary parentheses"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:104
msgid "Avoid parentheses in expressions and conditional statements. Unless necessary for order of operations, they only reduce readability."
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:122
msgid "Whitespace"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:124
msgid "Always use one space around operators and after commas. Avoid extra spaces in dictionary references and function calls, or to create \"columns.\""
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:147
msgid "**NEVER**:"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:156
msgid "Naming conventions"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:158
msgid "These naming conventions follow the Godot Engine style. Breaking these will make your code clash with the built-in naming conventions, which is ugly."
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:163
msgid "Classes and nodes"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:165
msgid "Use PascalCase: ``extends KinematicBody``"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:167
msgid "Also when loading a class into a constant or variable:"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:174
msgid "Functions and variables"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:176
msgid "Use snake\\_case: ``get_node()``"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:178
msgid "Prepend a single underscore (\\_) to virtual methods (functions the user must override), private functions, and private variables: ``func _ready()``"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:183
msgid "Signals"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:185
msgid "Use past tense:"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:193
msgid "Constants"
msgstr ""
#: ../../docs/getting_started/scripting/gdscript/gdscript_styleguide.rst:195
msgid "Use CONSTANT\\_CASE, all caps, with an underscore (\\_) to separate words: ``const MAX_SPEED = 200``"
msgstr ""