index.html

---
layout: core/default
---
<div class="container text-white">
    <h1>Вебсайт гильдии</h1>
    <p>Эта страница поможет тебе построить вебсайт своей гильдии, просто следуй инструкции.<br />
    Здесь будет рассмотрена базовая версия на основе GitLab</p>

    <h2>Подготовка</h2>
    Для работы с нуля тебе потребуется разобраться с несколькими инструментами и сервисами.

    <h5>Инструменты</h5>
    <p><b><a href="https://git-scm.com/download" target="_blank">Git</a></b> - инструмент управления исходным кодом, именно через него ты будешь управлять сайтом.
    Не беспокойся, все нужные команды будут тут же в инструкции, тебе не придется глубоко лезть.</p>
    <p><b><a href="https://rubyinstaller.org" target="_blank">Ruby</a></b> - сайт использует движок на этом языке. По ссылке доступен установщик</p>
    <p><b>Ruby Gems</b> - если ты используешь Windows, открой <code>cmd</code> (Пуск - Выполнить - <code>cmd.exe</code>), в открывшемся окне напиши <code>ridk install</code></p>
    <p><b>Ruby Bundler</b> - в той же консоли выполни <code>gem install bundler</code></p>

    <h5>Сервисы</h5>
    <p>Для старта тебе нужен лишь <a href="https://gitlab.com">GitLab</a>, зарегистрируйся на нем.</p>

    <h2>Глава 1: запуск набора для быстрого старта</h2>

    <p>Здесь ты запустишь вот этот сайт (да, именно тот, что ты смотришь) у себя на компьютере, доступен он будет только тебе</p>

    <h5>Код</h5>
    <p>Для начала, нужно достать и подготовить исходный код вебсайта</p>

    <ol>
        <li>Открой консоль (в Windows - git bash или cmd), перейди в любую подходящую тебе папку</li>
        <li>Скопируй набор быстрого старта себе: <code>git clone https://github.com/forestguild/quickstart</code></li>
        <li>Теперь у тебя есть все, что нужно для старта, перейди (в консоли) в директорую <code>quickstart</code></li>
        <li>Установи все зависимости: <code>bundle install</code> (он может попросить тебя ввести пароль - все ок, не переживай)</li>
        <li>А теперь, магия: <code>jekyll serve</code> - эта команда соберет и запустит этот сайт, он станет доступен на <a href="http://127.0.0.1:4000" target="_blank">http://127.0.0.1:4000</a>
    </ol>

    <h5>Настройка</h5>
    <p>А теперь, настройка самого сайта. <b>Важный момент</b>: при изменении <code>_config.yml</code> тебе нужно перезапустить команду <code>jekyll serve</code></p>

    <ol>
        <li>Открой <code>_config.yml</code> (главный конфигурационный файл) и измени его под себя, там куча комментариев с пояснениями. Для примера, вот <a href="https://github.com/forestguild/website/blob/master/_config.yml" target="_blank">конфиг Ясного Леса</a></li>
        <li>Остальные настройки темы в папке <code>_data/ui</code>. К примеру, меню в шапке - <code>_data/ui/navigation/top.yml</code>, опять же - это можно сделать позже</li>
    </ol>

    <h2>Глава 2: welcome to the Internet</h2>
    <p>А здесь ты опубликуешь свой сайт в сети и сможешь поделиться адресом с гильдией :)</p>

    <h5>GitLab</h5>
    <p>Пришло время сохранить твои наработки в системе контроля версий (чтобы их не потерять)</p>

    <ol>
        <li>В папке с исходным кодом сайта удали папку <code>.git</code> (она может быть невидима)</li>
        <li><a href="https://gitlab.com/projects/new?nav_source=navbar" target="_blank">Создай новый проект на Gitlab</a>, назови его (например) <code>tirisfal</code>
            и выбери видимость (Visibility Level) = Public</li>
        <li>В <code>_config.yml</code> установи в переменную <code>baseurl</code> название своего проекта, пример: <code>baseurl: "/tirisfal"</code> (нюансы Gitlab Pages)</li>
        <li>На открывшейся странице перейди к блоку кода "Existing folder" (существующая директория) и выполни инструкции оттуда</li>
        <li>Переходим к последнему пункту</li>
    </ol>

    <h5>Gitlab CI & Gitlab Pages</h5>
    <p>А теперь - публикация</p>

    <ul>
        <li>Так как в исходном коде уже есть конфигурация для Gitlab CI (файл <code>.gitlab-ci.yml</code>), то тебе остается лишь перейти в Gitlab на страницу своего проекта
            &rarr; CI/CD &rarr; Pipelines. Тут будут отображаться процесс публикации твоего сайта</li>
        <li>Адрес <b>своего</b> сайта ты найдешь на странице проекта в GitLab &rarr; Settings &rarr; Pages. В блоке "Access pages" ты найдешь адрес сайта</li>
        <li>Вот и все :)</li>
    </ul>

    <h2>Глава 3: как жить дальше?</h2>
    <p>Сайт вроде-как сделал и даже опубликовал, а что дальше-то делать?</p>
    <p>А вот тут начинается веселье, вот тебе список литературы на дом:</p>
    <ul>
        <li><a href="https://jekyllrb.com">Jekyll</a> - движок сайта, в его документации ты узнаешь как и что тут делается (начиная от добавления новых страниц и заканчивая разработкой "подкапотных" плагинов, которые будут делать "вжжжух!" магию</li>
        <li><a href="https://typora.io/#download">Typora</a> - классный markdown редактор, который сэкономит тебе много нервов</li>
        <li><a href="https://github.com/forestguild">GitHub Ясного Леса</a> - вот тут лежит все, что используется в твоем сайте, включая документацию и примеры. Очень советую, если не понимаешь, как и нафига</li>
    </ul>
    <h5>Хочу крутых штук</h5>
    <ul>
        <li>Свой собственный домен сайта, к примеру: tirisfal.gg? Дальше сам: <a href="https://docs.gitlab.com/ee/README.html">Документация GitLab</a></li>
        <li>Автоматическое обновление сайта, чтобы прогресс гильдии обновлять, аттенданс трекер и т.д.? (например, раз в час)? Дальше сам: <a href="https://docs.gitlab.com/ee/README.html">Документация GitLab</a></li>
        <li>HTTPS, кэширование, быстрая работа? Дальше сам: <a href="https://cloudflare.com">CloudFlare</a></li>
    </ul>
</div>