rescenic.github.io

Тема Purelog для Джекила

Адаптивный, хорошо продуманный шаблон, который поможет вам начать работу над следующим блогом или веб-сайтом.
Изучите документацию »

Посмотреть демо · Сообщить об ошибке · Запросить функцию

О проекте

Purelog — это адаптивная тема боковой панели для популярного генератора JAMstack Jekyll, которая использует только минимальную структуру Pure.css (отсюда и название!), но при этом следует лучшим практикам обеспечения доступности и поисковой оптимизации.

Я создал это после завершения Watery (на основе которого построена эта тема), чтобы добавить больше функциональности и дизайна, оставаясь при этом максимально легким.

Этот проект нацелен на тех, кто ищет интересную тему для Jekyll, которая имеет функции, которые обычно не встречаются где-либо еще, в частности, отдельные разделы, посвященные ведению блогов, ведению заметок и ежедневным записям в журнале.

Функции

Вот несколько интересных особенностей этой темы Jekyll:

• Полностью настраиваемый и пустой _BLANK_config.yml , упрощающий запуск и работу.
• Функция быстрого поиска на месте с использованием Simply Jekyll Search.
• Индивидуальные коллекции для различных типов материалов (заметок, записей в журналах и т. д.)
• Автоматически генерируемая страница архива, на которой отображаются все записи из всех коллекций.
• Автоматическое создание тегов и страниц категорий.
• Наличие коллекции _pages для упрощения организации.
• Биография автора в конце каждого поста. (Находится в _inclues/author.html )
• Полная поддержка Rouge для подсветки синтаксиса. (В настоящее время используется base16.solarized.light )
• Автоматически создаваемый RSS-канал, карта сайта, специальные возможности и оптимизация для поисковых систем.

Установка

Предварительные условия

Джекиллу требуется следующее:

• Руби версии 2.5.0 или выше
• RubyGems
• GCC и Make

Руководства и подробную информацию см. в разделе «Требования».

Инструкции

1. Установите все необходимые компоненты.
2. Установите драгоценные камни Jekyll и Bundler.

 gem install jekyll bundler

3. Клонируйте этот репозиторий.

 git clone https://github.com/rescenic/rescenic.github.io.git

4. Перейдите в новый каталог.

 cd rescenic.github.io

5. Установите драгоценные камни из Gemfile .

 bundle install

6. Создайте сайт и сделайте его доступным на локальном сервере.

 bundle exec jekyll serve --livereload

7. Перейдите по адресу http://localhost:4000.

Если во время этого процесса вы обнаружите какие-либо ошибки, убедитесь, что вы установили все необходимые компоненты, указанные в разделе «Требования».

Если у вас все еще есть проблемы, см. раздел «Устранение неполадок».

Начиная

После того, как Jekyll будет запущен, вам останется сделать всего несколько шагов, чтобы сделать эту тему своей собственной:

1. Заполните файл конфигурации _BLANK_config.yml и замените текущий _config.yml
2. Удалите папку example_posts в _posts , _notes , _journals и начните писать свои собственные!
3. Измените или удалите страницы в _pages по своему усмотрению.
4. (Необязательно) Измените или удалите этот README.md содержащий информацию о вашем собственном проекте или блоге.
5. (Необязательно) Измените файлы CSS в папке assets , чтобы настроить сайт.

Дорожная карта

Есть несколько функций, которые я все еще планирую создать и интегрировать, в том числе:

• Создайте тему Gem
• Добавьте простые и автоматические кнопки в «Развертывание в Netlify», Heroku и т. д.
• Добавить проверки непрерывной интеграции Travis
• Добавьте дополнительную документацию для создания пользовательских коллекций и автоматически создаваемых страниц.
• Добавьте больше примеров сообщений и статей.

Список предлагаемых функций (и известных проблем) см. в разделе «Открытые проблемы».

Содействие

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

1. Форкнуть проект
2. Создайте свою ветку функций ( git checkout -b feature/AmazingFeature )
3. Зафиксируйте свои изменения ( git commit -m 'Add some AmazingFeature' )
4. Нажмите на ветку ( git push origin feature/AmazingFeature )
5. Открыть запрос на включение

Лицензия

Распространяется по лицензии MIT. Вы можете использовать этот проект так, как считаете нужным, без указания авторства.

См. LICENSE для получения дополнительной информации.

Ресурсы

Создавая эту тему, я наткнулся на множество полезных и труднодоступных ресурсов. Если вы хотите глубже погрузиться в Джекилла, ознакомьтесь с ними:

• Прыжок в Джекилла: https://dev.to/brennan/jumping-into-jekyll-4o9h
• Шпаргалка по Джекиллу: https://devhints.io/jekyll
• Курс по Джекиллу: https://learn-the-web.algonquindesign.ca/topics/jekyll/
• Jekyll для дизайнеров: http://simpleprimate.com/jekyll-for-designers/index.html.
• Динамическое авторское право на Jekyll: https://michaelsoolee.com/jekyll-copyright/
• Создание хлебных крошек в Jekyll: https://jekyllcodex.org/without-plugin/breadcrumbs/
• Отобразить все элементы из ВСЕХ коллекций: https://stackoverflow.com/questions/31171041/listing-all-collections-in-jekyll

Другие ресурсы

• Для предварительного просмотра уценки: https://jaspervdj.be/lorem-markdownum/
• Практический пример производительности веб-шрифтов: https://www.keycdn.com/blog/web-font- Performance.
• Обширный .gitignore : https://miguelmota.com/bytes/extensive-gitignore/

Кредит

Pure.css был создан группой Pure CSS.

Simple Jekyll Search был создан Кристианом Фей.

Различные заметки и идеи были взяты из книги «Просто Джекилл» Рагхувира С..