1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
---
title: Как использовать GitHub Pages?
slug: Learn/Common_questions/Using_Github_pages
translation_of: Learn/Common_questions/Using_Github_pages
---
<p class="summary"><a href="https://github.com/">GitHub</a> является сайтом «социального кодирования». Он позволяет загружать репозитории кода для хранения в системе управления версиями <a href="http://git-scm.com/">Git</a>. Затем вы можете сотрудничать с проектами кода, а система по умолчанию открыта с открытым исходным кодом, что означает, что любой человек в мире может найти ваш код GitHub, использовать его, учиться на нем и улучшать его. Вы можете сделать это и с кодом других людей! В этой статье представлено основное руководство по публикации контента с использованием функции gh-pages Github.</p>
<h2 id="Публикация_контента">Публикация контента</h2>
<p>GitHub - очень важное и полезное сообщество для участия, а Git/GitHub - очень популярная система управления версиями (<a href="http://git-scm.com/book/en/v2/Getting-Started-About-Version-Control">version control system</a>) - большинство технологических компаний теперь используют её в своём рабочем процессе. GitHub имеет очень полезную функцию <a href="https://pages.github.com/">GitHub Pages</a>, которая позволяет публиковать код сайта в прямом эфире в Интернете.</p>
<h3 id="Базовая_установка_Github">Базовая установка Github</h3>
<ol>
<li>Прежде всего, <a href="https://git-scm.com/downloads">установите Git</a> на свой компьютер. Это базовое программное обеспечение для управления версиями, GitHub работает поверх него.</li>
<li>Затем <a href="https://github.com/">зарегистрируйтесь в учётной записи GitHub</a>. Это просто и легко.</li>
<li>После того, как вы зарегистрировались, войдите в <a href="https://github.com">github.com</a> с вашим именем пользователя и паролем.</li>
</ol>
<h3 id="Подготовка_кода_для_загрузки">Подготовка кода для загрузки</h3>
<p>Вы можете хранить любой код, который вам нравится, в репозитории Github, но для полнофункционального использования функции GitHub Pages ваш код должен быть структурирован как типичный веб-сайт, причём основной точкой входа является HTML-файл с именем <code>index.html</code>.</p>
<p>Другое, что вам нужно сделать, прежде чем двигаться дальше - это инициализировать вашу кодовую директорию как репозиторий Git. Сделать это:</p>
<ol>
<li>Направьте командную строку в каталог вашего <code>test-site</code> (или то, что вы назвали каталогом, содержащим ваш сайт). Для этого используйте команду <code>cd</code> (т.е. "<em>c</em>hange <em>d</em>irectory" - «каталог изменений»). Вот что вы набрали, если бы вы разместили свой сайт в каталоге, называемом <code>test-site</code> на рабочем столе:
<pre class="brush: bash">cd Desktop/test-site</pre>
</li>
<li>Когда командная строка указывает внутри вашего каталога веб-сайта, введите следующую команду, которая сообщает инструменту <code>git</code>, чтобы он превратил каталог в репозиторий git:
<pre class="brush: bash">git init</pre>
</li>
</ol>
<h4 id="В_сторону_интерфейсов_командной_строки">В сторону интерфейсов командной строки</h4>
<p>Лучший способ загрузить код в Github - через командную строку - это окно, в котором вы вводите команды, чтобы делать такие вещи, как создавать файлы и запускать программы, а не щёлкать внутри пользовательского интерфейса. Он будет выглядеть примерно так:</p>
<p><img alt="" src="https://mdn.mozillademos.org/files/9483/command-line.png" style="display: block; height: 478px; margin: 0px auto; width: 697px;"></p>
<div class="note">
<p><strong>Примечание</strong><strong>:</strong> вы также можете использовать <a href="https://git-scm.com/downloads/guis">графический пользовательский интерфейс Git </a>для выполнения одной и той же работы, если вам неудобно работать с командной строкой.</p>
</div>
<p>Каждая операционная система поставляется с инструментом командной строки:</p>
<ul>
<li><strong>Windows: Командная строка</strong> (<strong>Command Prompt)</strong> может быть получена нажатием клавиши Windows, набрав <em>Command Prompt</em> и выбрав её из появившегося списка. Обратите внимание, что Windows имеет свои собственные условные обозначения команд, отличные от Linux и OS X, поэтому приведённые ниже команды могут отличаться на вашем компьютере.</li>
<li><strong>OS X: Терминал</strong> (<strong>Terminal)</strong> можно найти в <em>Applications > Utilities</em>.</li>
<li><strong>Linux: </strong>Обычно вы можете вытащить терминал с помощью <em>Ctrl + Alt + T</em>. Если это не сработает, найдите <strong>Terminal</strong> в панели приложений или меню.</li>
</ul>
<p>Сначала это может показаться немного пугающим, но не волнуйтесь - вы скоро почувствуете основы. Вы говорите компьютеру что-то делать в терминале, введя команду и нажав Enter, как показано выше.</p>
<h3 id="Создание_repo_для_вашего_кода">Создание repo для вашего кода</h3>
<ol>
<li>Затем вам нужно создать новое repo для ваших файлов. Нажмите «Плюс» (+) в правом верхнем углу главной страницы GitHub и выберите «Новый репозиторий» (<em>New Repository</em>).</li>
<li>На этой странице в поле Имя репозитория (<em>Repository name</em>) введите имя для своего репозитория, например <em>my-repository</em>.</li>
<li>Также добавьте описание, чтобы сказать, что будет содержать ваш репозиторий. Ваш экран должен выглядеть так:<br>
<img alt="" src="https://mdn.mozillademos.org/files/12143/create-new-repo.png" style="display: block; height: 548px; margin: 0px auto; width: 800px;"></li>
<li>Нажмите Создать репозиторий (<em>Create repository</em>); это приведёт вас к следующей странице:<br>
<img alt="" src="https://mdn.mozillademos.org/files/12141/github-repo.png" style="display: block; height: 520px; margin: 0px auto; width: 800px;"></li>
</ol>
<h3 id="Загрузка_файлов_на_GitHub">Загрузка файлов на GitHub</h3>
<ol>
<li>На текущей странице вас интересует раздел <em>…or push an existing repository from the command line</em> (...или нажмите существующий репозиторий из командной строки). Вы должны увидеть две строки кода, перечисленные в этом разделе. Скопируйте всю первую строку, вставьте её в командную строку и нажмите Enter. Команда должна выглядеть примерно так:
<pre class="copyable-terminal-content js-zeroclipboard-target"><span class="user-select-contain">git remote add origin <span class="js-live-clone-url">https://github.com/chrisdavidmills/my-repository.git</span></span></pre>
</li>
<li>Затем введите следующие две команды, нажав Enter после каждого из них. Они готовят код для загрузки в GitHub и просят Git управлять этими файлами.
<pre class="brush: bash">git add --all
git commit -m 'adding my files to my repository'</pre>
</li>
<li>Наконец, нажмите код до GitHub, перейдя на веб-страницу GitHub, на которой вы находитесь, и введите в терминал вторую из двух команд, которые мы увидели <em>…or push an existing repository from the command line</em>:
<pre class="brush: bash">git push -u origin master</pre>
</li>
<li>Теперь вам нужно создать ветвь gh-pages вашего repo; обновите текущую страницу и вы увидите страницу репозитория, как показано ниже. Вам нужно нажать кнопку, в которой говорится о <em>Branch: <strong>master</strong></em>, введите <em>gh-pages</em> в текстовом вводе, затем нажмите синюю кнопку с надписью <em>Create branch: gh-pages</em>. Это создаёт специальную ветвь кода, называемую gh-pages, которая публикуется в специальном месте. URL-адрес принимает форму <em>username.github.io/my-repository-name</em>, поэтому в моем примере URL-адрес будет <em>https://chrisdavidmills.github.io/my-repository</em>. Отображаемая страница - это страница index.html.<br>
<img alt="" src="https://mdn.mozillademos.org/files/12145/repo-site.png" style="display: block; margin: 0 auto;"></li>
<li>Перейдите на веб-адрес GitHub Pages на новой вкладке браузера, и вы должны увидеть свой сайт онлайн! Отправьте его по электронной почте своим друзьям и продемонстрируйте своё мастерство.</li>
</ol>
<div class="note">
<p><strong>Примечание:</strong> Если вы застряли, страница <a href="https://pages.github.com/">GitHub Pages homepage</a> также очень полезна.</p>
</div>
<h3 id="Дальнейшее_знание_GitHub">Дальнейшее знание GitHub</h3>
<p>Если вы хотите сделать больше изменений на своём тестовом сайте и загрузить их на GitHub, вам просто нужно внести изменения в свои файлы, как и раньше. Затем вам нужно ввести следующие команды (нажав Enter после каждого), чтобы вставить эти изменения в GitHub:</p>
<pre>git add --all
git commit -m 'another commit'
git push</pre>
<p>Вы можете заменить <em>another commit</em> более подходящим сообщением, чтобы описать, какое изменение вы только что сделали.</p>
<p>Мы едва коснулись Git. Чтобы узнать больше, начните с <a href="https://help.github.com/index.html">GitHub Help site</a>.</p>
|
