Prechádzať zdrojové kódy

Improve Creating your first script page

- Add godot.svg icon according to comment.
- Update link to intro section based on comment.
- Update some styling to match current guidelines.
tetrapod00 5 mesiacov pred
rodič
commit
45ba52453e

+ 1 - 1
getting_started/introduction/introduction_to_godot.rst

@@ -84,7 +84,7 @@ Software Development Kits (SDK) in the engine.
 Of course, you can also directly add modules and features to the engine, as it's
 Of course, you can also directly add modules and features to the engine, as it's
 completely free and open source.
 completely free and open source.
 
 
-.. doc_learning_programming
+.. _doc_introduction_learning_programming:
 
 
 What do I need to know to use Godot?
 What do I need to know to use Godot?
 ------------------------------------
 ------------------------------------

+ 1 - 0
getting_started/step_by_step/img/scripting_first_script_icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128"><rect width="124" height="124" x="2" y="2" fill="#363d52" stroke="#212532" stroke-width="4" rx="14"/><g fill="#fff" transform="translate(12.322 12.322)scale(.101)"><path d="M105 673v33q407 354 814 0v-33z"/><path fill="#478cbf" d="m105 673 152 14q12 1 15 14l4 67 132 10 8-61q2-11 15-15h162q13 4 15 15l8 61 132-10 4-67q3-13 15-14l152-14V427q30-39 56-81-35-59-83-108-43 20-82 47-40-37-88-64 7-51 8-102-59-28-123-42-26 43-46 89-49-7-98 0-20-46-46-89-64 14-123 42 1 51 8 102-48 27-88 64-39-27-82-47-48 49-83 108 26 42 56 81zm0 33v39c0 276 813 276 814 0v-39l-134 12-5 69q-2 10-14 13l-162 11q-12 0-16-11l-10-65H446l-10 65q-4 11-16 11l-162-11q-12-3-14-13l-5-69z"/><path d="M483 600c0 34 58 34 58 0v-86c0-34-58-34-58 0z"/><circle cx="725" cy="526" r="90"/><circle cx="299" cy="526" r="90"/></g><g fill="#414042" transform="translate(12.322 12.322)scale(.101)"><circle cx="307" cy="532" r="60"/><circle cx="717" cy="532" r="60"/></g></svg>

+ 19 - 14
getting_started/step_by_step/scripting_first_script.rst

@@ -4,7 +4,7 @@
     - Giving a *short* and sweet hands-on intro to GDScript. The page should
     - Giving a *short* and sweet hands-on intro to GDScript. The page should
       focus on working in the code editor.
       focus on working in the code editor.
     - We assume the reader has programming foundations. If you don't, consider
     - We assume the reader has programming foundations. If you don't, consider
-      taking the course we recommend in the :ref:`introduction to Godot page <doc_learning_programming>`.
+      taking the course we recommend in the :ref:`introduction to Godot page <doc_introduction_learning_programming>`.
 
 
     Techniques:
     Techniques:
 
 
@@ -19,9 +19,12 @@ Creating your first script
 ==========================
 ==========================
 
 
 In this lesson, you will code your first script to make the Godot icon turn in
 In this lesson, you will code your first script to make the Godot icon turn in
-circles using GDScript. As we mentioned :ref:`in the introduction
-<toc-learn-introduction>`, we assume you have programming foundations.
-The equivalent C# code has been included in another tab for convenience.
+circles. As we mentioned :ref:`in the introduction
+<doc_introduction_learning_programming>`, we assume you have programming
+foundations. 
+
+This tutorial is written for GDScript, and the equivalent C# code is included in
+another tab of each codeblock for convenience.
 
 
 .. image:: img/scripting_first_script_rotating_godot.gif
 .. image:: img/scripting_first_script_rotating_godot.gif
 
 
@@ -37,10 +40,10 @@ Please :ref:`create a new project <doc_creating_and_importing_projects>` to
 start with a clean slate. Your project should contain one picture: the Godot
 start with a clean slate. Your project should contain one picture: the Godot
 icon, which we often use for prototyping in the community.
 icon, which we often use for prototyping in the community.
 
 
-.. Godot icon
+.. image:: img/scripting_first_script_icon.svg
 
 
 We need to create a Sprite2D node to display it in the game. In the Scene dock,
 We need to create a Sprite2D node to display it in the game. In the Scene dock,
-click the Other Node button.
+click the **Other Node** button.
 
 
 .. image:: img/scripting_first_script_click_other_node.webp
 .. image:: img/scripting_first_script_click_other_node.webp
 
 
@@ -54,7 +57,7 @@ Your Scene tab should now only have a Sprite2D node.
 .. image:: img/scripting_first_script_scene_tree.webp
 .. image:: img/scripting_first_script_scene_tree.webp
 
 
 A Sprite2D node needs a texture to display. In the Inspector on the right, you
 A Sprite2D node needs a texture to display. In the Inspector on the right, you
-can see that the Texture property says "[empty]". To display the Godot icon,
+can see that the **Texture** property says ``<empty>``. To display the Godot icon,
 click and drag the file ``icon.svg`` from the FileSystem dock onto the Texture
 click and drag the file ``icon.svg`` from the FileSystem dock onto the Texture
 slot.
 slot.
 
 
@@ -73,15 +76,16 @@ Creating a new script
 ---------------------
 ---------------------
 
 
 To create and attach a new script to our node, right-click on Sprite2D in the
 To create and attach a new script to our node, right-click on Sprite2D in the
-scene dock and select "Attach Script".
+Scene dock and select **Attach Script**.
 
 
 .. image:: img/scripting_first_script_attach_script.webp
 .. image:: img/scripting_first_script_attach_script.webp
 
 
-The Attach Node Script window appears. It allows you to select the script's
+The **Attach Node Script** window appears. It allows you to select the script's
 language and file path, among other options.
 language and file path, among other options.
 
 
-Change the Template field from "Node: Default" to "Object: Empty" to start with a clean file. Leave the
-other options set to their default values and click the Create button to create the script.
+Change the **Template** field from ``Node: Default`` to ``Object: Empty`` to
+start with a clean file. Leave the other options set to their default values and
+click the **Create** button to create the script.
 
 
 .. image:: img/scripting_first_script_attach_node_script.webp
 .. image:: img/scripting_first_script_attach_node_script.webp
 
 
@@ -246,9 +250,10 @@ our sprite's rotation every frame. Here, ``rotation`` is a property inherited
 from the class ``Node2D``, which ``Sprite2D`` extends. It controls the rotation
 from the class ``Node2D``, which ``Sprite2D`` extends. It controls the rotation
 of our node and works with radians.
 of our node and works with radians.
 
 
-.. tip:: In the code editor, you can Ctrl-click (Cmd-click on MacOS) on any built-in property or
-         function like ``position``, ``rotation``, or ``_process`` to open the
-         corresponding documentation in a new tab.
+.. tip:: In the code editor, you can :kbd:`Ctrl + Click` (:kbd:`Cmd + Click` on
+         macOS) on any built-in property or function like ``position``,
+         ``rotation``, or ``_process`` to open the corresponding documentation
+         in a new tab.
 
 
 Run the scene to see the Godot icon turn in-place.
 Run the scene to see the Godot icon turn in-place.