No post “Movendo um site construído com Jekyll para dentro de um site construído com Pelican” eu contei a jornada que foi mover o site do PyLadies BR Conf para dentro do site do PyLadies Brasil. Aqui vai o passo a passo final com comandos que usei tudo isso.

Nota da autora: Aqui ensino o passo a passo para novas edições do PyLadies BR Conf, mas os comandos podem ser ajustados para fazer a mesma coisa com outros sites.

Ingredientes

  1. Um repositório do site conferência clonado e configurado
  2. Um repositório do site oficial PyLadies Brasil clonado e configurado

Preparativos

No repositório da conferência, ajuste o arquivo _config.yml:

  • a variável base_url deve conter um valor seguindo o padrão /conf-X onde X indica a edição da conferência
  • a variável url deve conter o domínio https://brasil.pyladies.com

Você pode encontrar um _config.yml ajustado para a primeira edição da conferência aqui.

No repositório do site do PyLadies Brasil, ajuste o arquivo pelicanconf.py:

  • acrescente o nome da pasta nova na variável STATIC_PATHS seguindo o padrão /conf-X onde X indica a edição da conferência;
  • acrescente a cofiguração de metadata da pasta nova na variável EXTRA_PATH_METADATA seguindo o padrão 'conf-X': {'path': 'conf-X'} onde X indica a edição da conferência
  • Crie uma pasta vazia dentro da pasta content/ seguindo o padrão /conf-X onde X indica a edição da conferência

Você pode encontrar um pelicanconf.py ajustado para a primeira edição da conferência aqui.

Misturando ingredientes

A partir de agora todos os comandos vão ser referentes a pasta conf-1/ então, lembre-se de ajustar os comandos para a edição da conferência que estiver criando. No repositório da conferência, rode o comando para fazer build do site:

$ jekyll build

Isso deve gerar a pasta _site/. Agora copie o conteúdo da pasta _site/ para dentro da pasta da conferência que criamos:

$ cp -r conf/_site/* br-pyladies-pelican/content/conf-1/

Levando ao forno

Se tudo funcionou corretamente até aqui faça o build do site do PyLadies Brasil:

$ html serve

e confira se consegue acessar o site da conferência em: https://localhost:8000/conf-1

Servindo

Faça os commits das alterações e abra o pull request 😉

Você pode ver o pull request que eu fiz para a primeira edição aqui.

Xêro.