Este repositório contém temas para Pelican. Sinta-se à vontade para clonar, adicionar seu próprio tema e enviar uma solicitação pull. É gerenciado pela comunidade!
Uma versão ao vivo pode ser vista em http://www.pelicanthemes.com.
Estas instruções pressupõem que você já leu toda a documentação do Pelican, tem um site funcionando e agora gostaria de aplicar um tema não padrão.
Primeiro, escolha um local para guardar seus temas. Para este exemplo, usaremos o diretório ~/pelican-themes
, mas o seu pode ser diferente. Clone o repositório pelican-themes
para esse local em sua máquina local:
git clone --recursive https://github.com/getpelican/pelican-themes ~ /pelican-themes
Agora você deve ter seu repositório pelican-themes
armazenado em ~/pelican-themes/
.
Para usar um dos temas, edite seu arquivo de configurações do Pelican para incluir esta linha:
THEME = "/home/user/pelican-themes/theme-name"
Então, por exemplo, para usar o tema mnmlist
, você editaria seu arquivo de configurações para incluir:
THEME = "/home/user/pelican-themes/mnmlist"
Salve as alterações em seu arquivo de configurações e, em seguida, gere novamente seu site usando o Makefile que você já deve ter configurado usando pelican-quickstart
:
make html
Os temas também podem ser especificados diretamente através do parâmetro -t ~/pelican-themes/theme-name
para o comando pelican
. Se você quiser editar seu tema, certifique-se de que todas as edições feitas sejam feitas na cópia armazenada em ~/pelican-themes/theme-name
. Quaisquer alterações feitas nos arquivos armazenados no diretório output
do seu site serão excluídas na próxima vez que você gerar o seu site.
A geração de visualizações de temas ocorre automaticamente por meio de um fluxo de trabalho do GitHub Actions, após o qual essas visualizações são publicadas em https://pelicanthemes.com. Se você deseja gerar visualizações localmente em sua estação de trabalho, clone o repositório Pelican (por exemplo, para ~/projects/pelican/), clone este repositório em algum lugar, mude para o diretório raiz desse clone e siga estas etapas:
python -m pip install pelican[markdown] shot-scraper
mkdir _pelican
cp -r ~ /projects/pelican/samples _pelican/
python build-theme-previews.py