From 3b2844271afa7954bac6f260644ef5580cd42402 Mon Sep 17 00:00:00 2001 From: Yana Klose-Ivanova <75987641+captainspring@users.noreply.github.com> Date: Wed, 12 May 2021 21:37:05 +0300 Subject: Update translation of Using GitHub Pages (#832) * Update translation * Apply suggestions from code review Co-authored-by: Maxim Postautov <54762420+mpstv@users.noreply.github.com> * Apply suggestions from code review 2 Co-authored-by: Maxim Postautov <54762420+mpstv@users.noreply.github.com> --- .../common_questions/using_github_pages/index.html | 76 ++++++++++++---------- 1 file changed, 40 insertions(+), 36 deletions(-) diff --git a/files/ru/learn/common_questions/using_github_pages/index.html b/files/ru/learn/common_questions/using_github_pages/index.html index 38a3443ce3..fbeb77a8ef 100644 --- a/files/ru/learn/common_questions/using_github_pages/index.html +++ b/files/ru/learn/common_questions/using_github_pages/index.html @@ -2,99 +2,103 @@ title: Как использовать GitHub Pages? slug: Learn/Common_questions/Using_Github_pages translation_of: Learn/Common_questions/Using_Github_pages +tags: + - Beginner + - GitHub + - Guide + - Web + - gh-pages + - git + - publish --- -

GitHub является сайтом «социального кодирования». Он позволяет загружать репозитории кода для хранения в системе управления версиями Git. Затем вы можете сотрудничать с проектами кода, а система по умолчанию открыта с открытым исходным кодом, что означает, что любой человек в мире может найти ваш код GitHub, использовать его, учиться на нем и улучшать его. Вы можете сделать это и с кодом других людей! В этой статье представлено основное руководство по публикации контента с использованием функции gh-pages Github.

+

GitHub — это сайт «социальной разработки». Он позволяет загружать репозитории кода для хранения в системе управления версиями Git. После загрузки вы можете сотрудничать с другими участниками для работы над общим проектом, а ещё это система с открытым исходным кодом по умолчанию: любой человек в мире может найти ваш код на GitHub, использовать его, учиться по нему и улучшать его. Вы тоже можете взаимодействовать с кодом других людей! В этой статье представлено базовое руководство по публикации контента с использованием функции gh-pages Github.

Публикация контента

-

GitHub - очень важное и полезное сообщество для участия, а Git/GitHub - очень популярная система управления версиями (version control system) - большинство технологических компаний теперь используют её в своём рабочем процессе. GitHub имеет очень полезную функцию GitHub Pages, которая позволяет публиковать код сайта в прямом эфире в Интернете.

+

GitHub — очень важное и полезное сообщество для участия, а Git/GitHub — очень популярная система управления версиями — большинство технологических компаний теперь использует её в своём рабочем процессе. У GitHub есть очень полезная функция GitHub Pages, которая позволяет публиковать живую демонстрацию кода в виде сайта в Интернете.

Базовая установка Github

    -
  1. Прежде всего, установите Git на свой компьютер. Это базовое программное обеспечение для управления версиями, GitHub работает поверх него.
    2. -
  2. Затем зарегистрируйтесь в учётной записи GitHub. Это просто и легко.
    3. -
  3. После того, как вы зарегистрировались, войдите в github.com с вашим именем пользователя и паролем.
    4. +
  4. Прежде всего, установите Git на свой компьютер. Это базовое программное обеспечение для управления версиями, поверх которого работает GitHub.
    5. +
  5. Затем зарегистрируйтесь на GitHub. Это просто.
    6. +
  6. После того, как вы зарегистрировались, войдите в свою учётную запись на github.com с помощью своих имени пользователя и пароля.

Подготовка кода для загрузки

-

Вы можете хранить любой код, который вам нравится, в репозитории Github, но для полнофункционального использования функции GitHub Pages ваш код должен быть структурирован как типичный веб-сайт, причём основной точкой входа является HTML-файл с именем index.html.

+

В репозитории на Github вы можете хранить любой код, который вам нравится, но для полноценного использования функции GitHub Pages ваш код должен быть структурирован как типичный веб-сайт, то есть, основной точкой входа должен быть HTML-файл с именем index.html.

-

Другое, что вам нужно сделать, прежде чем двигаться дальше - это инициализировать вашу кодовую директорию как репозиторий Git. Сделать это:

+

Прежде чем двигаться дальше, вам необходимо инициализировать вашу папку (директорию) с кодом как репозиторий Git. Как это сделать:

    -
  1. Направьте командную строку в каталог вашего test-site (или то, что вы назвали каталогом, содержащим ваш сайт). Для этого используйте команду cd (т.е. "change directory" - «каталог изменений»). Вот что вы набрали, если бы вы разместили свой сайт в каталоге, называемом test-site на рабочем столе: +
  2. Направьте командную строку в вашу папку test-site (или папку с любым другим названием, содержащую ваш сайт). Для этого используйте команду cd (т.е. «change directory» — «поменяй директорию»). Вот что вы бы набрали, если бы разместили свой сайт в папке test-site на рабочем столе: 
    cd Desktop/test-site
    3. -
  3. Когда командная строка указывает внутри вашего каталога веб-сайта, введите следующую команду, которая сообщает инструменту git, чтобы он превратил каталог в репозиторий git: +
  4. Когда командная строка указывает внутрь вашей папки веб-сайта, введите следующую команду, которая сообщает инструменту git, что папку нужно превратить в репозиторий git: 
    git init
-

В сторону интерфейсов командной строки

+

Дополнительно об интерфейсах командной строки

-

Лучший способ загрузить код в Github - через командную строку - это окно, в котором вы вводите команды, чтобы делать такие вещи, как создавать файлы и запускать программы, а не щёлкать внутри пользовательского интерфейса. Он будет выглядеть примерно так:

+

Лучший способ загрузить код в Github — использовать командную строку. Это окно, в котором вы вводите команды, чтобы делать такие вещи, как создавать файлы и запускать программы, вместо того чтобы кликать внутри пользовательского интерфейса. Оно будет выглядеть примерно так:

-

Примечание: вы также можете использовать графический пользовательский интерфейс Git для выполнения одной и той же работы, если вам неудобно работать с командной строкой.

+

Примечание: вы также можете использовать графический пользовательский интерфейс Git для выполнения тех же задач, если вам неудобно работать с командной строкой.

-

Каждая операционная система поставляется с инструментом командной строки:

+

Каждая операционная система поставляется с инструментом командной строки:

-

Сначала это может показаться немного пугающим, но не волнуйтесь - вы скоро почувствуете основы. Вы говорите компьютеру что-то делать в терминале, введя команду и нажав Enter, как показано выше.

+

Сначала это может показаться немного пугающим, но не волнуйтесь — вы быстро разберётесь в основах. Вы говорите компьютеру что-то сделать в терминале, введя команду и нажав Enter, как показано выше.

-

Создание repo для вашего кода

+

Создание репозитория для вашего кода

    -
  1. Затем вам нужно создать новое repo для ваших файлов. Нажмите «Плюс» (+) в правом верхнем углу главной страницы GitHub и выберите «Новый репозиторий» (New Repository).
    2. -
  2. На этой странице в поле Имя репозитория (Repository name) введите имя для своего репозитория, например my-repository.
    3. -
  3. Также добавьте описание, чтобы сказать, что будет содержать ваш репозиторий. Ваш экран должен выглядеть так:
    +
  4. Затем вам нужно создать новый репозиторий для ваших файлов. Нажмите «Плюс» (+) в правом верхнем углу главной страницы GitHub и выберите «Новый репозиторий» (New Repository).
    5. +
  5. На этой странице в поле «Имя репозитория» (Repository name) введите имя для своего репозитория, например my-repository.
    6. +
  6. Также добавьте описание, чтобы уточнить, что будет содержать ваш репозиторий. Ваш экран должен выглядеть так:
    7. -
  7. Нажмите Создать репозиторий (Create repository); это приведёт вас к следующей странице:
    +
  8. Нажмите «Создать репозиторий» (Create repository); откроется следующая страница:

Загрузка файлов на GitHub

    -
  1. На текущей странице вас интересует раздел …or push an existing repository from the command line (...или нажмите существующий репозиторий из командной строки). Вы должны увидеть две строки кода, перечисленные в этом разделе. Скопируйте всю первую строку, вставьте её в командную строку и нажмите Enter. Команда должна выглядеть примерно так: +
  2. На текущей странице вас интересует раздел …or push an existing repository from the command line («...или загрузите существующий репозиторий с помощью командной строки»). В этом разделе вы должны увидеть две строки кода. Скопируйте всю первую строку, вставьте её в командную строку и нажмите Enter. Команда должна выглядеть примерно так: 
    git remote add origin https://github.com/chrisdavidmills/my-repository.git
    3. -
  3. Затем введите следующие две команды, нажав Enter после каждого из них. Они готовят код для загрузки в GitHub и просят Git управлять этими файлами. +
  4. Затем введите следующие две команды, нажимая Enter после каждой из них. Они готовят код для загрузки в GitHub и просят Git управлять этими файлами. 
    git add --all
 git commit -m 'adding my files to my repository'
    5. -
  5. Наконец, нажмите код до GitHub, перейдя на веб-страницу GitHub, на которой вы находитесь, и введите в терминал вторую из двух команд, которые мы увидели  …or push an existing repository from the command line: +
  6. Наконец, загрузите код на GitHub, для чего вернитесь к текущей веб-странице GitHub и введите в терминал вторую из двух команд, которые мы увидели в секции …or push an existing repository from the command line: 
    git push -u origin master
    7. -
  7. Теперь вам нужно создать ветвь gh-pages вашего repo; обновите текущую страницу и вы увидите страницу репозитория, как показано ниже. Вам нужно нажать кнопку, в которой говорится о Branch: master, введите gh-pages в текстовом вводе, затем нажмите синюю кнопку с надписью Create branch: gh-pages. Это создаёт специальную ветвь кода, называемую gh-pages, которая публикуется в специальном месте. URL-адрес принимает форму username.github.io/my-repository-name, поэтому в моем примере URL-адрес будет https://chrisdavidmills.github.io/my-repository. Отображаемая страница - это страница index.html.
    -
    8. -
  8. Перейдите на веб-адрес GitHub Pages на новой вкладке браузера, и вы должны увидеть свой сайт онлайн! Отправьте его по электронной почте своим друзьям и продемонстрируйте своё мастерство.
    9. +
  9. Теперь вам нужно включить функционал GitHub Pages для своего репозитория. Чтобы сделать это, зайдите на страницу своего репозитория и выберите «Настройки» (Settings), прокрутите страницу вниз, пока не увидите секцию GitHub Pages. В разделе Source выберите ветку master. Страница должна обновиться.
    10. +
  10. Вновь пролистайте до секции GitHub Pages. Вы должны увидеть надпись «Ваш сайт готов к публикации на https://xxxxxx» («Your site is ready to be published at https://xxxxxx»).
    11. +
  11. Если вы кликните на ссылку, вам должна открыться страница с живой демонстрацией вашего примера, при условии, что домашняя страница называется index.html — по умолчанию ссылка ведет именно на неё. Если точка входа на ваш сайт называется как-то иначе, например myPage.html, то чтобы увидеть её, вам нужно открыть https://xxxxxx/myPage.html.
-
-

Примечание: Если вы застряли, страница GitHub Pages homepage также очень полезна.

-
- -

Дальнейшее знание GitHub

+

Больше информации о GitHub

-

Если вы хотите сделать больше изменений на своём тестовом сайте и загрузить их на GitHub, вам просто нужно внести изменения в свои файлы, как и раньше. Затем вам нужно ввести следующие команды (нажав Enter после каждого), чтобы вставить эти изменения в GitHub:

+

Если вы хотите поменять что-то на своем тестовом сайте и загрузить результат на GitHub, вам просто нужно внести изменения в свои файлы, как и раньше. Затем вам потребуется ввести следующие команды (нажимая Enter после каждой), чтобы загрузить их на GitHub:

git add --all
 git commit -m 'another commit'
 git push
-

Вы можете заменить another commit более подходящим сообщением, чтобы описать, какое изменение вы только что сделали.

+

Вы можете написать более подходящее сообщение вместо another commit, чтобы уточнить, что именно вы только что изменили.

-

Мы едва коснулись Git. Чтобы узнать больше, начните с GitHub Help site.

+

Мы едва коснулись Git. Чтобы узнать больше, начните с нашей статьи Git и GitHub.

-- cgit v1.2.3-54-g00ecf