浏览代码

Added new "getting started" page. Language fixes to editor introduction.

Mikael Säker 7 年之前
父节点
当前提交
4e6d24579f

+ 5 - 6
docs/en/manuals/editor.md

@@ -9,26 +9,25 @@ The editor allows you to browse and manipulate all files in your game project in
 
 ## Starting the editor
 
-When you start Defold you are met by a project selection dialog. On the left side there are three main operations available. Click to select what you want to do:
+When you run the Defold editor, you are presented with a project selection and creation screen. On the left side there are three main views available. Click to select what you want to do:
 
 Home
-: Lists your recently opened projects so you can quickly access them.
+: Click to show a lists your recently opened projects so you can quickly access them. This is the default view.
 
 New
-: Allows you to create a new Defold project. Select if you want to base your project on a basic template from the *From Template* tab, follow a tutorial from the *From Tutorial* tab, or check out a game sample from the *From Sample* tab.
+: Click if you want to create a new Defold project, then select if you want to base your project on a basic template (from the *From Template* tab), if you would like to follow a tutorial (the *From Tutorial* tab), or try one of the sample projects (the *From Sample* tab).
 
   ![new project](images/editor/new_project.png){srcset="images/editor/[email protected] 2x"}
 
-  New projects are stored on your local drive, but you can use the *Synchronize* feature in the editor to create a Defold cloud Git storage project and push your changes to it.
+  When you create a new project it is stored on your local drive and any edits you do are saved locally. To share the project with members of your team, use the *Synchronize* feature in the editor. It creates a Defold cloud Git storage project for you through which you and your team can synchronize work.
 
 Import project
-: Import a project from you Defold cloud Git storage and create a working copy on your local drive so you can do changes to the project and synchronize against the cloud storage.
+: Create a working copy from an existing project from you Defold cloud Git storage account. The local copy is linked to the cloud Git project so it's ready for team synchronization.
 
   ![import project](images/editor/import_project.png){srcset="images/editor/[email protected] 2x"}
 
   Access to the Defold cloud git storage requires that you provide your Defold account credentials.
 
-
 ## The editor views
 
 The Defold editor is separated into a set of panes, or views, that display specific information.

+ 1 - 1
docs/en/manuals/introduction.md

@@ -23,7 +23,7 @@ The Lua language
 : ![Lua overview](images/introduction/lua.png){.left} [Defold uses Lua](/manuals/lua/) for all its logic control. The engine is a fast C++ piece of machinery, but it is controlled on a high level by Lua programs. If you have programmed in Python, Javascript or any other high level language, you will find Lua pretty easy to grasp and can probably follow along a tutorial just fine. Otherwise, read through our Lua manual and take it from there.
 
 Game tutorials
-: ![Tutorials](images/introduction/tutorials.jpg){.left} We believe that you learn best by doing. That is why we have a variety of tutorials available at different skill and complexity level available directly from [the editor](/manuals/editor/). Fire it up and follow one or two of the tutorials to learn how to build things and how Defold works.
+: ![Tutorials](images/introduction/tutorials.jpg){.left} We believe that you learn best by doing. That is why we have a selection of tutorials at various skill and complexity level available directly from [the editor](/manuals/editor/). Fire it up and follow one or two of the tutorials to learn how to build things and how Defold works.
 
 The building blocks of Defold
 : ![Building blocks](images/introduction/building_blocks.png){.left} [Defold games are build by composing simple blocks](/manuals/building-blocks/), some of which seem familiar if you have used other engines. There are some architectural design decisions that make the blocks of Defold special and it takes a little while to be comfortable working with them. Our building blocks manual is a good start if you feel you need to understand thoroughly how it's working.

+ 32 - 1
docs/en/tutorials/getting-started.md

@@ -1,4 +1,35 @@
+---
+title: Getting started
+brief: This tutorial explains how to get started doing tutorials in Defold.
+---
 
+# Getting started with Defold
 
+The Defold engine and editor are powerful tools but takes takes a little while to get accustomed to. You should expect having to spend some time working in Defold before you know how to use it well. To help you on your way we have created a variety of tutorials. They are available directly from within the editor so you can start your journey towards becoming a Defold pro right away.
 
-:[link](side-scroller.md)
+## Starting a tutorial
+
+When you run the Defold editor, you are presented with a project selection and creation screen. From here you can easily select which tutorial you want to try out:
+
+1. Start Defold.
+2. Select *New Project* on the left.
+3. Select the *From Tutorial* tab.
+4. Select a tutorial that you are interested in.
+5. Select a location for the project on your local drive.
+6. Click *Create New Project*.
+
+![create project](images/getting-started/new-project.png){srcset="images/getting-started/[email protected] 2x"}
+
+The editor now automatically downloads the tutorial project, opens it in the editor and opens the tutorial text (the "README" file in the project root).
+
+![tutorial text](images/getting-started/tutorial-text.png)
+
+Now follow the tutorial text! If you want to get back to the text, <kbd>double click</kbd> the "README" file in the *Assets* view. You can also <kbd>right click</kbd> the tab of open files and select <kbd>Move to Other Tab Pane</kbd> to view the tutorial text side by side with the file you are working on.
+
+![side by side](images/getting-started/side-by-side.png)
+
+If you are totally new to Defold, you might also want to check out the [editor introduction](/manuals/editor).
+
+If you ever get stuck, please head over to the [Defold Forum](//forum.defold.com) where you will get help from the Defold developers and many friendly users.
+
+Happy Defolding!

二进制
docs/en/tutorials/images/getting-started/new-project.png


二进制
docs/en/tutorials/images/getting-started/[email protected]


二进制
docs/en/tutorials/images/getting-started/side-by-side.png


二进制
docs/en/tutorials/images/getting-started/tutorial-text.png


+ 1 - 1
docs/en/tutorials/runner.md

@@ -1,5 +1,5 @@
 ---
-title: Getting started in Defold
+title: Endless runner tutorial
 brief: In this tutorial you start with an empty project and build a complete runner game with an animated character, physics collision, pickups and scoring.
 ---