github.com/brownsys/tracing-framework-go@v0.0.0-20161210174012-0542a62412fe/go/darwin_amd64/misc/tour/content/welcome.article (about)

     1  Welcome!
     2  Learn how to use this tour: including how to navigate the different lessons and how to run code.
     3  
     4  The Go Authors
     5  https://golang.org
     6  
     7  * Hello, 世界
     8  
     9  Welcome to a tour of the [[https://golang.org/][Go programming language]].
    10  
    11  The tour is divided into a list of modules that you can
    12  access by clicking on
    13  [[javascript:highlight(".logo")][A Tour of Go]] on the top left of the page.
    14  
    15  You can also view the table of contents at any time by clicking on the [[javascript:highlightAndClick(".nav")][menu]] on the top right of the page.
    16  
    17  Throughout the tour you will find a series of slides and exercises for you
    18  to complete.
    19  
    20  You can navigate through them using
    21  
    22  - [[javascript:highlight(".prev-page")]["previous"]] or `PageUp` to go to the previous page,
    23  
    24  - [[javascript:highlight(".next-page")]["next"]] or `PageDown` to go to the next page.
    25  
    26  The tour is interactive. Click the
    27  [[javascript:highlightAndClick("#run")][Run]] button now 
    28  (or type `shift-enter`) to compile and run the program on
    29  #appengine: a remote server.
    30  your computer.
    31  The result is displayed below the code.
    32  
    33  These example programs demonstrate different aspects of Go. The programs in the tour are meant to be starting points for your own experimentation.
    34  
    35  Edit the program and run it again.
    36  
    37  Note that when you click on [[javascript:highlightAndClick("#format")][Format]] or `ctrl-enter`
    38  the text in the editor is formatted using the
    39  [[https://golang.org/cmd/gofmt/][gofmt]] tool. You can switch syntax highlighting on and off
    40  by clicking on the [[javascript:highlightAndClick(".syntax-checkbox")][syntax]] button.
    41  
    42  When you're ready to move on, click the [[javascript:highlightAndClick(".next-page")][right arrow]] below or type the `PageDown` key.
    43  
    44  .play welcome/hello.go
    45  
    46  * Go local
    47  
    48  The tour is available in other languages:
    49  
    50  - [[https://go-tour-br.appspot.com/][Brazilian Portuguese — Português do Brasil]]
    51  - [[https://go-tour-ca.appspot.com/][Catalan — Català]]
    52  - [[https://go-tour-de.appspot.com/][German — Deutsch]]
    53  - [[https://go-tour-es.appspot.com/][Spanish — Español]]
    54  - [[https://go-tour-fr.appspot.com/][French — Français]]
    55  - [[https://go-tour-id2.appspot.com/][Indonesia — Bahasa]]
    56  - [[https://go-tour-ita.appspot.com/][Italian — Italiano]]
    57  - [[https://go-tour-he.appspot.com/][Hebrew — עִבְרִית]]
    58  - [[https://go-tour-jp.appspot.com/][Japanese — 日本語]]
    59  - [[https://go-tour-kr.appspot.com/][Korean — 한국어]]
    60  - [[https://go-tour-ro.appspot.com/][Romanian — Română]]
    61  - [[https://tour.go-zh.org/][Simplified Chinese — 中文（简体）]]
    62  - [[https://go-tour-zh-tw.appspot.com/][Traditional Chinese — 中文（繁體）]]
    63  - [[https://go-tour-ua.appspot.com/][Ukrainian — Українська]]
    64  - [[https://go-tour-uz.appspot.com/][Uzbek — Ўзбекча]]
    65  - [[https://go-tour-turkish.appspot.com/][Turkish - Türkçe]]
    66  
    67  Click the [[javascript:highlightAndClick(".next-page")]["next"]] button or type `PageDown` to continue.
    68  
    69  #appengine: * Go offline
    70  #appengine: 
    71  #appengine: This tour is also available as a stand-alone program that you can use
    72  #appengine: without access to the internet.
    73  #appengine: 
    74  #appengine: The stand-alone tour is faster, as it builds and runs the code samples
    75  #appengine: on your own machine.
    76  #appengine: 
    77  #appengine: To run the tour locally first
    78  #appengine: [[http://golang.org/dl/][download and install Go]]
    79  #appengine: then start the tour from the command line:
    80  #appengine: 
    81  #appengine: 	go tool tour
    82  #appengine: 
    83  #appengine: The tour program will open a web browser displaying
    84  #appengine: your local version of the tour.
    85  #appengine: 
    86  #appengine: Or, of course, you can continue to take the tour through this web site.
    87  
    88  #appengine: * The Go Playground
    89  #appengine: 
    90  #appengine: This tour is built atop the [[https://play.golang.org/][Go Playground]], a
    91  #appengine: web service that runs on [[https://golang.org/][golang.org]]'s servers.
    92  #appengine: 
    93  #appengine: The service receives a Go program, compiles, links, and runs the program inside
    94  #appengine: a sandbox, then returns the output.
    95  #appengine: 
    96  #appengine: There are limitations to the programs that can be run in the playground: 
    97  #appengine: 
    98  #appengine: - In the playground the time begins at 2009-11-10 23:00:00 UTC (determining the significance of this date is an exercise for the reader). This makes it easier to cache programs by giving them deterministic output.
    99  #appengine: 
   100  #appengine: - There are also limits on execution time and on CPU and memory usage, and the program cannot access external network hosts. 
   101  #appengine: 
   102  #appengine: The playground uses the latest stable release of Go.
   103  #appengine: 
   104  #appengine: Read "[[https://blog.golang.org/playground][Inside the Go Playground]]" to learn more.
   105  #appengine: 
   106  #appengine: .play welcome/sandbox.go
   107  
   108  * Congratulations
   109  
   110  You've finished the first module of the tour!
   111  
   112  Now click on [[javascript:highlightAndClick(".logo")][A Tour of Go]] to find out what else
   113  you can learn about Go, or go directly to the [[javascript:click('.next-page')][next lesson]].