diff options
author | Yana Klose-Ivanova <75987641+captainspring@users.noreply.github.com> | 2021-05-12 21:37:05 +0300 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-05-12 21:37:05 +0300 |
commit | 3b2844271afa7954bac6f260644ef5580cd42402 (patch) | |
tree | cb1dafcc3f504ada6e9b04087db7562678bca0be | |
parent | 9d6043a2cb863b75644cbe6dd30bfcbeb8c3e71c (diff) | |
download | translated-content-3b2844271afa7954bac6f260644ef5580cd42402.tar.gz translated-content-3b2844271afa7954bac6f260644ef5580cd42402.tar.bz2 translated-content-3b2844271afa7954bac6f260644ef5580cd42402.zip |
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>
-rw-r--r-- | files/ru/learn/common_questions/using_github_pages/index.html | 76 |
1 files 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 --- -<p class="summary"><a href="https://github.com/">GitHub</a> является сайтом «социального кодирования». Он позволяет загружать репозитории кода для хранения в системе управления версиями <a href="http://git-scm.com/">Git</a>. Затем вы можете сотрудничать с проектами кода, а система по умолчанию открыта с открытым исходным кодом, что означает, что любой человек в мире может найти ваш код GitHub, использовать его, учиться на нем и улучшать его. Вы можете сделать это и с кодом других людей! В этой статье представлено основное руководство по публикации контента с использованием функции gh-pages Github.</p> +<p class="summary"><a href="https://github.com/">GitHub</a> — это сайт «социальной разработки». Он позволяет загружать репозитории кода для хранения <strong>в системе управления версиями</strong> <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> +<p>GitHub — очень важное и полезное сообщество для участия, а Git/GitHub — очень популярная <a href="http://git-scm.com/book/ru/v2/%D0%92%D0%B2%D0%B5%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5-%D0%9E-%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%B5-%D0%BA%D0%BE%D0%BD%D1%82%D1%80%D0%BE%D0%BB%D1%8F-%D0%B2%D0%B5%D1%80%D1%81%D0%B8%D0%B9">система управления версиями</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> + <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>В репозитории на Github вы можете хранить любой код, который вам нравится, но для полноценного использования функции GitHub Pages ваш код должен быть структурирован как типичный веб-сайт, то есть, основной точкой входа должен быть HTML-файл с именем <code>index.html</code>.</p> -<p>Другое, что вам нужно сделать, прежде чем двигаться дальше - это инициализировать вашу кодовую директорию как репозиторий Git. Сделать это:</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> на рабочем столе: + <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: + <li>Когда командная строка указывает внутрь вашей папки веб-сайта, введите следующую команду, которая сообщает инструменту <code>git</code>, что папку нужно превратить в репозиторий git: <pre class="brush: bash">git init</pre> </li> </ol> -<h4 id="В_сторону_интерфейсов_командной_строки">В сторону интерфейсов командной строки</h4> +<h4 id="Дополнительно_об_интерфейсах_командной_строки">Дополнительно об интерфейсах командной строки</h4> -<p>Лучший способ загрузить код в Github - через командную строку - это окно, в котором вы вводите команды, чтобы делать такие вещи, как создавать файлы и запускать программы, а не щёлкать внутри пользовательского интерфейса. Он будет выглядеть примерно так:</p> +<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> +<p><strong>Примечание</strong>: вы также можете использовать <a href="https://git-scm.com/downloads/guis">графический пользовательский интерфейс Git</a> для выполнения тех же задач, если вам неудобно работать с командной строкой.</p> </div> -<p>Каждая операционная система поставляется с инструментом командной строки:</p> +<p><span id="Командная_строка">Каждая операционная система поставляется с инструментом командной строки:</span></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> + <li><strong>Windows</strong>: <strong>Командную строку</strong> (<strong>Command Prompt</strong>) можно вызвать, нажав клавишу Windows, набрав <em>Command Prompt</em> и выбрав её из появившегося списка. Обратите внимание, что в Windows свои собственные условные обозначения команд, отличные от Linux и OS X, поэтому приведённые ниже команды могут отличаться на вашем компьютере.</li> + <li><strong>OS X</strong>: <strong>Терминал</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> +<p>Сначала это может показаться немного пугающим, но не волнуйтесь — вы быстро разберётесь в основах. Вы говорите компьютеру что-то сделать в терминале, введя команду и нажав Enter, как показано выше.</p> -<h3 id="Создание_repo_для_вашего_кода">Создание repo для вашего кода</h3> +<h3 id="Создание_репозитория_для_вашего_кода">Создание репозитория для вашего кода</h3> <ol> - <li>Затем вам нужно создать новое repo для ваших файлов. Нажмите «Плюс» (+) в правом верхнем углу главной страницы GitHub и выберите «Новый репозиторий» (<em>New Repository</em>).</li> - <li>На этой странице в поле Имя репозитория (<em>Repository name</em>) введите имя для своего репозитория, например <em>my-repository</em>.</li> - <li>Также добавьте описание, чтобы сказать, что будет содержать ваш репозиторий. Ваш экран должен выглядеть так:<br> + <li>Затем вам нужно создать новый репозиторий для ваших файлов. Нажмите «Плюс» (+) в правом верхнем углу главной страницы 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> + <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. Команда должна выглядеть примерно так: + <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 управлять этими файлами. + <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>: + <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> + <li>Теперь вам нужно включить функционал GitHub Pages для своего репозитория. Чтобы сделать это, зайдите на страницу своего репозитория и выберите «Настройки» (<em>Settings</em>), прокрутите страницу вниз, пока не увидите секцию <em>GitHub Pages</em>. В разделе <em>Source</em> выберите ветку master. Страница должна обновиться.</li> + <li>Вновь пролистайте до секции GitHub Pages. Вы должны увидеть надпись «Ваш сайт готов к публикации на https://xxxxxx» («Your site is ready to be published at https://xxxxxx»).</li> + <li>Если вы кликните на ссылку, вам должна открыться страница с живой демонстрацией вашего примера, при условии, что домашняя страница называется <code>index.html</code> — по умолчанию ссылка ведет именно на неё. Если точка входа на ваш сайт называется как-то иначе, например <code>myPage.html</code>, то чтобы увидеть её, вам нужно открыть <code>https://xxxxxx/myPage.html</code>.</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> +<h3 id="Больше_информации_о_GitHub">Больше информации о GitHub</h3> -<p>Если вы хотите сделать больше изменений на своём тестовом сайте и загрузить их на GitHub, вам просто нужно внести изменения в свои файлы, как и раньше. Затем вам нужно ввести следующие команды (нажав Enter после каждого), чтобы вставить эти изменения в GitHub:</p> +<p>Если вы хотите поменять что-то на своем тестовом сайте и загрузить результат на GitHub, вам просто нужно внести изменения в свои файлы, как и раньше. Затем вам потребуется ввести следующие команды (нажимая Enter после каждой), чтобы загрузить их на GitHub:</p> <pre>git add --all git commit -m 'another commit' git push</pre> -<p>Вы можете заменить <em>another commit</em> более подходящим сообщением, чтобы описать, какое изменение вы только что сделали.</p> +<p>Вы можете написать более подходящее сообщение вместо <em>another commit</em>, чтобы уточнить, что именно вы только что изменили.</p> -<p>Мы едва коснулись Git. Чтобы узнать больше, начните с <a href="https://help.github.com/index.html">GitHub Help site</a>.</p> +<p>Мы едва коснулись Git. Чтобы узнать больше, начните с нашей статьи <a href="/ru/docs/Learn/Tools_and_testing/GitHub">Git и GitHub</a>.</p> |