Недавно я мигрировали мой блог WordPress от до Джекила, фантастический сайт генератор, который предназначен для строительства минимальные, статические блоги быть размещены на GitHub Pages.Простота тематизации слоя Джекила и писать процесса является фантастическим;Однако, создание мой сайт взял много больше, чем ожидалось .

В этой статье мы будем ходить через следующее:

• Быстрый способ создать Джекил питание блог;
• Как избежать распространенных проблем с использованием Джекил;
• Как импортировать контент из WordPress, использовать собственное доменное имя, и блог в вашем любимом редакторе;
• Как тема в Джекил, с примерами жидких шаблонных;
• Пара новых функций Джекил 2,0, в том числе и Сасс CoffeeScript поддержки и коллекций .

Джекила Простой Purpose

Том Престон-Вернер создал Джекил, чтобы люди в блог с помощью простой статический HTML веб-сайт, с все содержимое размещается и версия под контролем на GitHub.Целью было устранить сложность других платформ блогов, создав рабочий процесс, который позволяет блог вроде hacker __21 | | 1__20 .

Джекил занимает свое содержание, написанный на Markdown, пропускает его через шаблоны и выплевывает в полной статической сайте, можно подавать к столу.GitHub Страницы удобно служит веб-сайт непосредственно из хранилища GitHub, так что вам не придется иметь дело с любым хостинг .

Вот некоторые сайты, которые были созданы с Джекила:

• Blog__20 Барри Кларка | 3 (это я)
• Зака ​​Холмена blog ⁴
• CSS Wizardry ⁵
• Jekyll ⁶
• HealthCare.gov ⁷ ‘ы целевая страница и содержание subpages
• Разработка Seed ⁸

Преимущества Going Static

• SimplicityДжекил-полоски все до минимума, устраняя много сложностей:
  не
  • Нет databaseВ отличие от WordPress и других систем управления контентом (CMS), Джекил не имеют базы данных.Все сообщения и страницы преобразуются в статическом HTML до публикации.Это очень удобно для скорости загрузки, потому что звонки баз данных не производится, когда страница загружена .
  • Нет CMSПросто напишите их содержанием в Markdown, и Джекил будет запустить его через шаблоны для создания статический сайт.GitHub может служить CMS при необходимости, потому что вы можете редактировать контент на нем .
  • FastДжекил быстро, потому что, будучи урезанная и без базы данных, вы просто обслуживает до статические страницы.Мой базовой темы, Джекил Now ^{50 25 15 9} , составляет всего три HTTP запросов — в том числеПрофиль картина и социальные иконки
  • MinimalВаш сайт будет включать в себя Джекил абсолютно не функциональные возможности или функции, которые вы не используете .
• Дизайн controlТратьте меньше времени борьба со сложными шаблонами, написанных другими людьми, и больше времени создания свою собственную тему или настройки несложный базовой темы .
• SecurityПодавляющее большинство уязвимостей, которые влияют на платформы, такие как WordPress не существует, потому что Джекил не имеет CMS, базы данных или PHP.Таким образом, вам не придется тратить столько времени на установку обновлений безопасности .
• Удобный hostingУдобный, если вы уже используете GitHub, что есть.GitHub Страницы будут строить и разместить свой сайт Jekyll бесплатно, в то время как одновременно обращении контроль версий .

Давайте попробуем Out

Есть несколько способов, чтобы начать работу с Джекила, каждый со своими вариациями.Вот несколько вариантов:

• Установка Джекил локально с помощью командной строки, создать новый шаблонный сайт, используя jekyll new, построить его на месте с jekyll build, а затем служить его.( Джекил website ¹⁰ Выставки этот процесс.)
• Clone отправной точкой для вашей локальной машине, установите Джекил локально с помощью командной строки, чтобы обновления на ваш сайт, построить его локально, а затем служить его .
• Вилка отправную точку, внести изменения, а затем служить ему .

Мы начнем с быстрый и простой вариант: порождая запускточка.Это позволит получить нам и работает в течение нескольких минут, и у нас не будет устанавливать какие-либо зависимостей.Вот то, что мы собираемся сделать прямо на GitHub.com в браузере:

1. Создать наша Джекил питание сайт .
2. Разместить его бесплатно на GitHub Pages .
3. Настроить его, чтобы включить наше имя, аватар и социальных связей .
4. Опубликовать наш первый пост блога

1. Вилка Начиная Point

Мы начнем с разветвлением хранилище, которое затем наилучшей практики и рабочие процессы, которые мы будем охватывающих в этой статье.Это позволит получить нам на правильном пути, и сэкономить много времени .

Я подготовил хранилище для нас уже.Отправляйтесь в Джекил Now ¹¹ , и нажмите кнопку “вилка” в верхнем правом углу хранилище раскошелиться копию теме блога на ваш счет GitHub .

¹²

¹⁴

Вот так!Мы движемся быстро здесь.У нас уже есть веб-сайт Джекил и работает!Давайте сделаем шаг назад для второй и посмотреть на некоторые из наиболее распространенных проблем, чтобы быть в курсе, когда хостинг веб-сайт Jekyll на GitHub Страницы .

Общие проблемы # 2 Будьте в курсе разницы между веб-сайтов пользователей и проекта websites ¹⁷ на GitHub.С веб-сайта пользователя (который мы устанавливаем), вам не нужно делать каких-либо разветвление.master Филиал уже настроен для запуска ничего, возложенные на него через Джекила.Вам не нужно настроить gh-pages Филиал .

Общие проблемы # 3 Использование веб-сайта проекта для вашего сайта Джекил вносит некоторую complexity __51 | 18 потому, что ваш сайт будет опубликован в подкаталог.Ссылка будет выглядеть http://yourname.github.io/repository-name, что вызовет проблемы в шаблонах Джекила, такие как нарушение ссылки на изображения, а не позволяя просматривать сайт локально .

Общие проблемы # 4: Джекил имеет много plugins __61 | 19 , но GitHub Страницы поддерживает только несколько из them __67 | 20 .Если вы попытаетесь включить плагин, который не поддерживается, то Джекил удастся при строительстве вашего сайта.Так, придерживаться в список поддерживаемых.К счастью, мой любимый плагин в списке: Jemoji ²¹ позволяет включать в смайлики блоге, как вы бы на GitHub и Basecamp .

3. Настройте Ваше Website

Теперь вы можете изменить вашего сайта имя, описание, аватар и другие варианты, редактируя _config.yml файл.Эти пользовательские переменные были созданы для удобства и потянул в вашей теме, когда ваш сайт будет построен .

Внесения изменений в _config.yml (или любой файл в хранилище) заставит GitHub Страниц восстановить ваш сайт с Джекила.Сайт восстановлен будут видны через несколько секунд при температуре http://yourusername.github.io.Если ваш сайт не жить сразу после шага 2, это будет после этого шага .

Идите вперед и настроить свой сайт, обновляя переменные в _config.yml файл, а затем фиксации изменений .

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

• Редактировать файлы в ваш новый username.github.io хранилище непосредственно в браузере в GitHub.com (как показано ниже) .
• Использование редактора контента GitHub сторонних, как Prose __20 | 22 | __2 семенами развития.Он оптимизирован для Джекила, который позволяет легко редактировать Markdown, написать проекты и загружать изображения .
• Clone репозиторий и сделать обновления локально, а затем подтолкнуть их в репозиторий GitHub ( Atlassian имеет guide __28 | 23 на это) .

²⁴

Общие проблемы # 5: Не думайте, что вам нужно jekyll build сайт локально, чтобы настроить и тематический веб-сайт Джекил.GitHub Страницы сделает это за вас.Вам просто нужно поместить файлы, которые вы хотите быть построен в мастер-филиала репозитория пользователя или в gh-pages филиала любой другойхранилище, а затем GitHub Страницы будут обрабатывать его с Джекила .

4. Опубликовать свой первый блог Post

Ваш сайт в настоящее время настроены, живая и хорошо выглядеть.Вы просто должны опубликовать свой первый пост в блоге:

1. Редактировать /_posts/2014-3-3-Hello-World.md, удаляя при этом содержимое заполнителя и введя свой собственный.Если вам нужно быстро праймер на написание в Markdown, проверить чит sheet__8 Адама Притчарда | 27 .
2. Изменить имя файла, чтобы включить текущую дату и название вашей должности.Джекил требуется сообщения будут названы year-month-day-title.md .
3. Обновление титул в верхней части файла Markdown.Эти переменные в верхней части блоге называются передней вопрос, который мы будем копаться в немного позже.В этом случае, они указывают, макет в использовании и название блоге. Дополнительная передние того, variables ²⁸ существуют, например, permalink, tags и category .

Если вы хотели бы создать новые сообщения в блоге в браузере на GitHub.com, просто нажмите на значок “” в /_posts/.Только не забудьте отформатировать имя файла неправильно и включить блок переднего вещества, так что файл будет обработан Джекила .

²⁹

Тогда, обновления Что Мой DNS ³¹ как сумасшедший, пока вы не распространяются.Если вы столкнулись с проблемами, обратитесь к “ Настройка пользовательского домена с GitHub Pages ³² .”

Импорт вашем блоге сообщения от WordPress

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

Для экспорт от WordPress, я настоятельно рекомендую Бена Балтер один клик WordPress для Джекил Exporter ³³ плагина.Она экспортирует все ваши WordPress содержание в ZIP файле, в том числе сообщений, изображений и мета-данных, преобразование его в формат Джекила, где это необходимо.Хорошо на вас, Бен .

Другой вариант, чтобы экспортировать все сообщения в меню “Инструменты” на приборной панели WordPress, а затем импортировать его с importer ³⁴ .

Далее, нам необходимо, чтобы обновить нашу изображения references.Плагин Бена Балтер будет экспортировать все ваши изображения в папке.Затем, вам нужно скопировать их туда, где вы размещаете ваши изображения на вашем блоге Джекил.Это может быть в /images папки или доставки контента сети .

Тогда, у вас есть забавная задача обновления все ссылки на эти изображения по содержания WordPress.Потому что я был только обновление пяти или шести сообщения, быстро найти и заменить работал хорошо, но если у вас есть много контента, то это может быть стоит писать сценарий или проверить сценарии, другие письменные, такие как Пол Stamatiou’s ³⁵ .

Наконец, мы должны импорт comments.Будучи платформой для статических сайтов, Джекил браузер не поддерживает комментарии.Тем не менее, состоялся решение, как Disqus работает очень хорошо!Я рекомендую импортировать WordPress комментарии Disqus __65 | | 36__14 .Тогда, если вы используете Джекил Теперь вы можете вв� …

Если вы хотите прочитать полностью статью, посетите сайт наших спонсоров