jasper2
1.0.0
Это полнофункциональный порт темы Casper v2.1.9 по умолчанию Ghost для Jekyll/GitHub Pages.
Каспер Призрака // Jasper2
Встроенная поддержка нескольких авторов (через _data/authors.yml ).
Полная информация об авторе, включая изображение, биографию, веб-сайт, Twitter, Facebook и т. д.
Описание тегов и персонализированные обложки (через _data/tags.yml ).
Похожие сообщения отображаются внизу каждого сообщения.
Все страницы Ghost по умолчанию: страницы автора, страницы тегов, страницы «О программе», 404 и т. д.
Пагинация (бесконечная прокрутка или стандартная нумерация страниц, т. е. сообщения на нескольких страницах)
Atom Feeds от Jekyll-feed
Переключаемая кнопка подписки (требуется внешняя служба)
Выделение синтаксиса кода с помощью Highlight.js
Поддержка отслеживания Google Analytics
Поддержка комментариев Disqus (не стандарт Ghost)
Существует несколько альтернатив созданию и развертыванию сайта:
создайте сайт с помощью GitHub Actions, который отправит полученные файлы (содержимое _site/ или ../jasper2-pages/ ) в ветку gh-pages . Именно такой подход используется в настоящее время. Дополнительную информацию см. в jekyll_build.yml.
сгенерируйте сайт локально (подробнее ниже) и отправьте полученный HTML-код в репозиторий Github, на котором затем будут размещаться страницы GitHub;
создайте сайт с помощью travis-ci (с плюсами от jekyll-travis), автоматически помещая сгенерированные HTML-файлы в ветку gh-pages .
разверните статический веб-сайт с помощью хостеров, совместимых с Jekyll, таких как https://www.netlify.com/, которые позволяют развертывание из репозитория Github, и опубликуйте веб-сайт с помощью CDN. У Netlify есть бесплатное стартовое предложение.
Для варианта 2) просто клонируйте этот репозиторий ( основную ветку ), а затем запустите bundle exec jekyll serve внутри каталога. Загрузите полученное содержимое _site/ (или ../jasper2-pages/ ) в свой репозиторий ( главная ветка , если вы загружаете как свою личную страницу (например, username.github.io) или ветку gh-pages, если вы загружаете как страницу проекта (как для демо).
Для варианта 3) вам нужно будет настроить travis-ci для вашего личного форка. Вкратце, все, что вам нужно, это изменить свои данные в _config.yml , чтобы вы могли отправить их в свой репозиторий GitHub. Вам также потребуется сгенерировать безопасный ключ для добавления в ваш .travis.yml (более подробную информацию о том, как это сделать, вы можете найти в этом файле). Также обязательно прочтите документацию jekyll-travis. Этот подход имеет явные преимущества в том, что вы просто отправляете изменения в файле на GitHub, и все HTML-файлы генерируются для вас и отправляются на gh-pages . Также вы узнаете, все ли в порядке со сборками вашего сайта. Не стесняйтесь обращаться ко мне, если у вас все еще возникнут какие-либо проблемы (об отслеживании проблем см. ниже).
Чтобы правильно создавать страницы автора, вам необходимо переименовать поле «Автор» в начале каждого сообщения, чтобы оно соответствовало имени пользователя каждого автора, как определено в файле _data/authors.yml . Благодаря последнему обновлению теперь по умолчанию поддерживаются блоги с несколькими авторами.
Следуя способу компиляции стилей Casper, как описано здесь:
Стили Jasper2 компилируются с использованием Gulp/PostCSS для заполнения будущих спецификаций CSS. Вам понадобятся Node и Gulp, установленные глобально. После этого из корневого каталога темы:
$ НПМ установить $ глоток
Теперь вы можете редактировать файлы /assets/css/ , которые будут автоматически скомпилированы в /assets/built/ .
Эта установка хорошо работает с Ruby v2.6.3 и Jekyll v3.9.0. Если у вас возникнут какие-либо проблемы, зарегистрируйте их в системе отслеживания проблем.
Не стесняйтесь запрашивать свои патчи и исправления.
Огромное спасибо команде Ghost за всю дизайнерскую работу. Также большое спасибо всем участникам, которые помогают поддерживать и обновлять проект.
Та же лицензия, что и предоставленная командой Ghost. См. лицензию темы Casper.
Авторское право (C) 2015–2021 гг. — Выпущено по лицензии MIT.
Настоящим бесплатно любому лицу, получившему копию данного программного обеспечения и связанных с ним файлов документации («Программное обеспечение»), предоставляется разрешение на работу с Программным обеспечением без ограничений, включая, помимо прочего, права на использование, копирование, изменение, объединение. публиковать, распространять, сублицензировать и/или продавать копии Программного обеспечения, а также разрешать лицам, которым предоставлено Программное обеспечение, делать это при соблюдении следующих условий:
Вышеупомянутое уведомление об авторских правах и данное уведомление о разрешении должны быть включены во все копии или существенные части Программного обеспечения.
ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ЯВНЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ, ГАРАНТИЯМИ ТОВАРНОЙ ЦЕННОСТИ, ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЕННОЙ ЦЕЛИ И НЕНАРУШЕНИЯ ПРАВ. АВТОРЫ ИЛИ ОБЛАДАТЕЛИ АВТОРСКИХ ПРАВ НИ ПРИ КАКИХ ОБСТОЯТЕЛЬСТВАХ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ ЗА ЛЮБЫЕ ПРЕТЕНЗИИ, УБЫТКИ ИЛИ ДРУГУЮ ОТВЕТСТВЕННОСТЬ, БУДЬ В ДЕЙСТВИЯХ ПО КОНТРАКТУ, ПРАВОНАРУШЕНИЮ ИЛИ ДРУГИМ ОБРАЗОМ, ВОЗНИКАЮЩИЕ ОТ, ИЗ ИЛИ В СВЯЗИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ ИЛИ ИСПОЛЬЗОВАНИЕМ ИЛИ ДРУГИМИ СДЕЛКАМИ, ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ.
