Я думаю, что на ваш вопрос можно ответить с двух точек зрения: 1) Как запустить и запустить Jekyll и 2) Как перевести ваш текущий контент Wordpress в jekyll.Вот ответы, которые помогут вам начать с каждого по очереди.
Часть 1. Начало работы и запуск Jekyll
Первое, что нужно понять, это то, что Jekyll предназначен для генерации набора статических файлов HTML, которыеможет обслуживаться практически с любого веб-сервера без необходимости PHP, Ruby, Perl или любой другой динамической обработки на стороне сервера.
Конечно, Jekyll использует Ruby, так что вы должны запускать его везде, где вы делаете генерацию файлов.Хотя это может быть на том же сервере, который обслуживает файл, важно отметить, что это не обязательно.Например, все это допустимые рабочие процессы для публикации с помощью Jekyll:
Создайте необработанные файлы на своем персональном компьютере, запустите там Jekyll, чтобы сгенерировать статические файлы HTML, а затем перенести их на удаленный компьютер.веб-сервер для обозрения.
Запустите Jekyll непосредственно на вашем сервере, выполнив все редактирование и создание необработанных файлов, чтобы Jekyll обработал их для обслуживания программным обеспечением веб-сервера на этом компьютере.,
Запустите Jekyll на своем сервере, но отредактируйте необработанные файлы на локальном компьютере и отправьте их на сервер, когда вы будете готовы к публикации.Движок Jekyll будет принимать необработанные файлы и генерировать статические HTML-файлы на самом сервере.
Люди также имеют гораздо более сложные настройки, которые позволяют им отправлять сообщения с любого ноутбука,телефоны и сам сервер и получить все синхронизировано по всем направлениям через Dropbox.Вы можете проявить себя настолько креативно, насколько захотите, но я думаю, что самый простой способ начать - это первый.Редактируйте ваши необработанные файлы локально, запускайте Jekyll локально, а затем переносите полученные HTML-файлы на ваш веб-сервер, когда вы будете готовы к их запуску.
Локальная установка Jekyll
Очевидно, для этого вам понадобится установить Jekyll на локальном компьютере.Направления для этого можно найти на странице Github .Для меня, работающего под управлением Mac OS X 10.6, следующие команды помогли мне выполнить настройку.
sudo gem install rubygems-update
sudo update_rubygems
sudo gem update
sudo gem update --system
sudo gem install rails
sudo gem install maruku
sudo gem install jekyll
Примечание: я не думаю, что вам действительно нужны рельсы, но это те шаги, которые я прошел, и они работали для меня
Настройка для использованияJekyll
Если у вас есть Jekyll на вашем компьютере, базовая настройка сайта относительно проста.Создайте следующую структуру в пустом каталоге:
Каталоги:
Файлы и их содержимое:
_config.yml
safe: false
auto: false
server: false
server_port: 4000
base-url: /
source: .
destination: ./_site
plugins: ./_plugins
future: true
lsi: false
pygments: false
markdown: maruku
permalink: date
maruku:
use_tex: false
use_divs: false
png_engine: blahtex
png_dir: images/latex
png_url: /images/latex
rdiscount:
extensions: []
kramdown:
auto_ids: true,
footnote_nr: 1
entity_output: as_char
toc_levels: 1..6
use_coderay: false
coderay:
coderay_wrap: div
coderay_line_numbers: inline
coderay_line_numbers_start: 1
coderay_tab_width: 4
coderay_bold_every: 10
coderay_css: style
Это настройка конфигурации по умолчанию для Jekyll.Вы можете обойтись без этого файла, но при запуске процесса выдается предупреждение, что он не может найти файл.Итак, я бы пошел вперед и настроить его.Это также значительно облегчает работу с вещами, вместо того, чтобы посылать аргументы jekyll в командной строке.
_layouts / default.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en">
<head>
<meta charset="utf-8">
<title>My Jekyll Site</title>
</head>
<body>
<!-- This will be replaced with your content -->
{{ content }}
{{ site.posts }}
</body>
</html>
Строка {{ content }} будет заменена обработанным содержимым файла "index.md", указанного ниже.Строка {{ site.posts }} будет заменена обратным хронологическим списком файлов в каталоге "_posts".GitHub имеет полный список фрагментов кода шаблона .
_posts / 2011-07-29-my-first-jekyll-post.md
---
layout: default
---
# My first Jekyll post.
This is the content from 2011-07-29-my-first-jekyll-post.md
index.md
---
layout: default
---
# My Jekyll site
This is the content from index.md
Здесь стоит указать, что вы можете использовать файлы .html или .textile вместо версий .md.До тех пор, пока у него есть Front Matter, который является первыми тремя строками, состоящими из тире и «layout: default», они будут обрабатываться Jekyll.
Генерация статических файлов с помощью Jekyll
Теперь, когда ваш исходный файл и структура каталогов настроены, просто откройте командную строку, перейдите в каталог, где вы создаете файл index.md, и выполните команду jekyll.Предполагая, что все прошло хорошо, вы должны увидеть краткий журнал процесса, и теперь у вас будет два HTML-файла:
_site/index.html
and
_site/2011/07/29/my-first-jekyll-post.html
Стоит указать файлы Markdown (.md) для исходного файла.,Вы также можете использовать .textile или .html.
Передача / Развертывание файлов.
Последний шаг в этом подходе - просто использовать FTP или rsync, чтобы передать файлы в корень вашего веб-сервера и поделиться ими со всем миром.Так как они представляют собой обычный HTML, это должно быть быстро и безболезненно, так как любой хостинг готов к работе.
(В своем вопросе вы упоминаете Git и Mercurial. Вы можете использовать либо для управления версиями и / или развертывания ваших необработанных файлов, а также статических файлов HTML, которые генерирует Jekyll, но ни один из них не требуется для запуска Jekyllили для передачи ваших файлов. Это все о том, как вы хотите настроить процесс развертывания.)
Часть 2. Перенос данных из WordPress
Все выше было посвящено использованию самого Jekyll с самого начала с нуля.,Если вы использовали WordPress (или любой другой движок в этом отношении) и хотите сохранить созданные вами страницы и посты, вам нужно перенести их из WordPress в Jekyll.
Основная идея заключается в том, что вы должны переместить свои посты и страницы в соответствующие места внутри каталога Jekyll и позволить ему перейти оттуда.Я бы начал ваше исследование по этой теме на странице Jekyll Blog Migrations .
(). В личной заметке моя первая попытка миграции на WordPress не сработалаЯ не имел возможности вернуться к нему, чтобы начать работу, но я стремлюсь заставить его работать. Переход на гораздо более простой статический сайт, который уменьшает потенциальные проблемы безопасности, загружает быстрее и проще в обслуживаниидля меня абсолютно стоит иметь дело с миграцией. )