diff --git a/ru/01.1.md b/ru/01.1.md index f69b1cec..4c865d9c 100644 --- a/ru/01.1.md +++ b/ru/01.1.md @@ -25,7 +25,7 @@ На Windows для установки gcc Вам нужно сначала установить MinGW. Не забудьте настроить переменные окружения после завершения установки. ( ***Все, что выглядит таким образом - здесь и далее добавлено переводчиком на английский - если Вы используете 64-битную Windows, Вам нужно будет установить 64-битную версию MiniGW*** ) -Итак, для того, чтобы скачать исходные коды Go и скомпилировать их, выполните следующие команды ( ***При этом исходники скачаются в ту директорию, в которой Вы находитесь. Для того, чтобы скачать их в другую директорию, сначала перейдите в нее.***): +Итак, для того, чтобы скачать исходные коды Go и скомпилировать их, выполните следующие команды ( ***При этом исходники скачаются в тот каталог, в которой Вы находитесь. Для того, чтобы скачать их в другой каталог, сначала перейдите в нее.***): git clone https://go.googlesource.com/go cd go/src @@ -117,4 +117,4 @@ Homebrew - это инструмент для управления пакета - [Содержание](preface.md) - Предыдущий раздел: [Настройка окружения Go](01.0.md) -- Следующий раздел: [$GOPATH и рабочая директория](01.2.md) +- Следующий раздел: [$GOPATH и рабочий каталог](01.2.md) diff --git a/ru/01.2.md b/ru/01.2.md index 931b217b..29dfad0c 100644 --- a/ru/01.2.md +++ b/ru/01.2.md @@ -1,16 +1,16 @@ -#1.2 $GOPATH и рабочая директория +#1.2 $GOPATH и рабочий каталог ## $GOPATH -Все команды Go зависят от переменной окружения $GOPATH. Имейте в виду, что это не переменная $GOROOT, в которой хранится путь установки Go. Эта переменная указывает на рабочую директорию Go на Вашем компьютере (я использую этот путь у себя на компьютере; Вы можете заменить его по своему усмотрению, если структура каталогов на вашем компьютере другая). +Все команды Go зависят от переменной окружения $GOPATH. Имейте в виду, что это не переменная $GOROOT, в которой хранится путь установки Go. Эта переменная указывает на рабочий каталог Go на Вашем компьютере (я использую этот путь у себя на компьютере; Вы можете заменить его по своему усмотрению, если структура каталогов на вашем компьютере другая). В Unix-подобных системах переменную можно задать следующим образом: export GOPATH=/home/apple/mygo -В Windows Вам нужно создать новую переменную окружения GOPATH, а затем задать ей значение `c:\mygo`( ***Оно заваисит от того, где расположена Ваша рабочая директория*** ) +В Windows Вам нужно создать новую переменную окружения GOPATH, а затем задать ей значение `c:\mygo`( ***Оно заваисит от того, где расположен Ваш рабочий каталог*** ) -$GOPATH при Вашем желании может содержать больше одного пути к рабочим директориям, но помните, что следует использовать знак `:`(или `;` в Windows) для того, чтобы разделять их. В этом случае `go get` будет сохранять содержимое в первый путь из тех, что указаны в $GOPATH. +$GOPATH при Вашем желании может содержать больше одного пути к рабочим каталогам, но помните, что следует использовать знак `:`(или `;` в Windows) для того, чтобы разделять их. В этом случае `go get` будет сохранять содержимое в первый путь из тех, что указаны в $GOPATH. В $GOPATH должно находиться три следующих папки: @@ -24,7 +24,7 @@ $GOPATH при Вашем желании может содержать боль Создайте каталоги и исходные файлы пакетов, такие как `$GOPATH/src/mymath/sqrt.go` (где `mymath` - имя пакета) ( ***Автор использует `mymath` в качестве имени пакета и в качестве имени каталога, где располагаются исходные файлы этого пакета***) -Каждый раз при создании пакета Вы должны создать новый каталог в каталоге 'src'. Каталог обычно называется так же, как и пакет, который предполагается использовать. Можно использовать многоуровневую структуру каталогов, если нужно. Например, если создать каталог `$GOPATH/src/github.com/astaxie/beedb`, то путь к пакету будет `github.com/astaxie/beedb`. Имя пакета - это имя последней директории в пути, в данном случае `beedb`. +Каждый раз при создании пакета Вы должны создать новый каталог в каталоге 'src'. Каталог обычно называется так же, как и пакет, который предполагается использовать. Можно использовать многоуровневую структуру каталогов, если нужно. Например, если создать каталог `$GOPATH/src/github.com/astaxie/beedb`, то путь к пакету будет `github.com/astaxie/beedb`. Имя пакета - это имя последнего каталога пути, в данном случае `beedb`. Выполните следующие команды: ( ***Сейчас автор возвращается к примеру*** ) @@ -148,4 +148,4 @@ $GOPATH при Вашем желании может содержать боль - [Содержание](preface.md) - Предыдущий раздел: [Установка](01.1.md) -- Следующий раздел: [Команды Go](01.3.md) +- Следующий раздел: [Утилиты Go](01.3.md) diff --git a/ru/01.3.md b/ru/01.3.md index fd916c9c..905483a4 100644 --- a/ru/01.3.md +++ b/ru/01.3.md @@ -16,8 +16,8 @@ - Если имя пакета не `main`, а, например, `mymath` из раздела 1.2, то после того, как Вы выполните `go build`, ничего не скомпилируется. Если Вы хотите скомпилировать файл `.a` в `$GOPATH/pkg`, Вам вместо этого нужно выполнить `go install`. - Если имя пакета - `main`, то в каталоге, откуда Вы запустили утилиту, будет создан исполняемый файл. Если Вы хотите, чтобы файл был создан в `$GOPATH/bin`, используйте `go install` или `go build -o ${указать путь}/a.exe.` -- Если в каталоге много файлов, но Вы хотите скомпилировать только один, Вам нужно добавить имя файла после `go build`. Например, `go build a.go`. `go build` скомпилирует все файлы в каталоге. -- Вы также можете указать имя исполняемого файла, который будет создан. Например, в проекте `mathapp` (раздел 1.2), команда `go build -o astaxie.exe` создаст `astaxie.exe` вместо `mathapp.exe`. Именем по умолчанию для исполнямеого файла является имя каталога (если пакет не main) или название первого файла-исходника (если пакет - main). +- Если в каталоге много файлов, но Вы хотите скомпилировать только один, Вам нужно добавить имя файла после `go build`. Например, `go build a.go`. Просто `go build` скомпилирует все файлы в каталоге. +- Вы также можете указать имя исполняемого файла, который будет создан. Например, в проекте `mathapp` (раздел 1.2), команда `go build -o astaxie.exe` создаст `astaxie.exe` вместо `mathapp.exe`. Именем по умолчанию для исполняемого файла является имя каталога (если пакет не main) или название первого файла-исходника (если пакет - main). (Согласно [The Go Programming Language Specification](https://golang.org/ref/spec) имя пакета должно следовать после слова `package` в первой строке исходного файла. Оно не обязательно должно быть таким же, как имя каталога, и имя исполняемого файла по умлочанию будет таким же, как и имя каталога.) @@ -47,7 +47,7 @@ ## go fmt и gofmt -Те из вас, которые работают с C/C++, должны знать, что люди часто дискутируют, какой стиль написания кода лучше: K&R-стиль или ANSI-стиль. Однако же в Go есть только один стиль написания кода. Например, левые скобки могут быть только в конце строк, а не на своих отдельных строках, иначе Вы получите ошибку компиляции! К счастью, Вам не нужно запоминать все эти правила. `go fmt` сделает всю работу за Вас. Просто выполните команду `go fmt <Имя файла>.go` в терминале. Я не пользуюсь этой командой часто, поскольку среды разработки делают то же самое автоматически при сохранении проекта. Я расскажу о средах разработки подробнее в следующем разделе. +Те из вас, которые работают с C/C++, должны знать, что люди часто дискутируют, какой стиль написания кода лучше: K&R-стиль или ANSI-стиль. Однако же в Go есть только один стиль написания кода. Например, левые скобки могут быть только в конце строк, а не на своих отдельных строках, иначе Вы получите ошибку компиляции! К счастью, Вам не нужно запоминать все эти правила. `go fmt` сделает всю работу за Вас. Просто выполните команду `go fmt <Имя файла>.go` в терминале. Я не пользуюсь этой командой часто, поскольку среды разработки делают то же самое автоматически при сохранении проекта. О средах разработки я расскажу подробнее в следующем разделе. `go fmt` - это алиас(сокращение) для `gofmt -l -w` для пакетов, указанных в пути команды import. diff --git a/ru/preface.md b/ru/preface.md index 3f97cd99..75a0417d 100644 --- a/ru/preface.md +++ b/ru/preface.md @@ -1,7 +1,7 @@ - 1.[Настройка среды разработки на Go](01.0.md) - 1.1. [Установка](01.1.md) - - 1.2. [$GOPATH и рабочая директория](01.2.md) - - 1.3. [Команды Go](01.3.md) + - 1.2. [$GOPATH и рабочий каталог](01.2.md) + - 1.3. [Утилиты Go](01.3.md) - 1.4. [Go development tools](01.4.md) - 1.5. [Summary](01.5.md) - 2.[Go basic knowledge](02.0.md)