пеликаны темы

Пеликан Темы

В этом репозитории собраны темы для Pelican. Не стесняйтесь клонировать, добавлять свою собственную тему и отправлять запрос на включение. Это управляется сообществом!

Живую версию можно увидеть на http://www.pelicanthemes.com.

Использование тем

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

Сначала выберите место для хранения тем. В этом примере мы будем использовать каталог ~/pelican-themes , но у вас он может быть другим. Клонируйте репозиторий pelican-themes в это место на вашем локальном компьютере:

git clone --recursive https://github.com/getpelican/pelican-themes ~ /pelican-themes

Теперь ваш репозиторий pelican-themes должен храниться в ~/pelican-themes/ .

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

 THEME = "/home/user/pelican-themes/theme-name"

Так, например, чтобы использовать тему mnmlist , вам нужно отредактировать файл настроек, включив в него:

 THEME = "/home/user/pelican-themes/mnmlist"

Сохраните изменения в файле настроек, а затем заново создайте свой сайт с помощью Makefile, который вы уже должны были настроить с помощью pelican-quickstart :

make html

Темы также можно указать напрямую с помощью параметра -t ~/pelican-themes/theme-name команды pelican . Если вы хотите отредактировать свою тему, убедитесь, что все вносимые вами изменения вносятся в копию, хранящуюся в ~/pelican-themes/theme-name . Любые изменения, внесенные в файлы, хранящиеся в output каталоге вашего сайта, будут удалены при следующем создании сайта.

Создание превью тем

Создание предварительных просмотров тем происходит автоматически с помощью рабочего процесса GitHub Actions, после чего эти предварительные просмотры публикуются на https://pelicanthemes.com. Если вы хотите создавать предварительные просмотры локально на своей рабочей станции, клонируйте репозиторий Pelican (например, в ~/projects/pelican/), клонируйте этот репозиторий куда-нибудь, перейдите в корневой каталог этого клона и выполните следующие действия:

python -m pip install pelican[markdown] shot-scraper
mkdir _pelican
cp -r ~ /projects/pelican/samples _pelican/
python build-theme-previews.py