Repositorio do site Python Brasil 2023

Site Python Brasil

O Projeto utiliza Pelican como framework!

A maioria dos dados sensiveis que podem ser alterados com facilidade editando o arquivo pelicanconf ou publishconf

Dentro da pasta theme tem o tema que esta sendo usado na compilação, por ser estatico muita coisa esta informada dentro dele mesmo mas é possivel ir externalizando utilizando alguns recursos do pelican vide doc .

Por favor use os arquivos html dentro da pasta theme para editar o conteúdo e a estrutura do site, leia com atenção por que o thema tem variáveis específicas e também pode usar alguns recursos do jinja para o adicionar o conteúdo a pagina.

O arquivo CNAME é automaticamente copiado para dentro do output, levando os dados necessarios junto com o tema e os estilos.

O tema foi atualizado e escrito utilizando SASS e as alterações devem ser feitas nos arquivos no path \theme\resources\scss. O arquivo styles.css em \theme\static\css\ foi mantido para garantir a compatibilidade.

Toda a pasta static ira para o output na compilação sempre que precisar limpar html,css,js,... apague a pasta output e rode novamente o comando de inicializar ou utilize o comando

invoke clean

lembrando que todos os comandos invoke estão no arquivo tasks.py

resize images generate webp

instale o command line para gerar imagens webp

sudo apt-get install webp

dentro da pasta das imagens que precisam ser recriadas rode o bash

sudo bash [caminho relativo]/scripts/resize_images.sh

Ambiente

gh repo clone pythonbrasil/pybr2023-site;
cd pybr2023-site
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Rodar/Iniciar

Ambiente precisa de docker instalado!!

Todo o build do docker esta abstraido dentro do invoke mas é nesessario uma das ultimas versões do docker ja com o comando via plugin docker compose [up, build, down]

source .venv/bin/activate
invoke livereload

vai rodar em http://127.0.0.1:8000/

Alteração de CSS/JS

Quando alterar css ou js utilize a pasta resources que tem os arquivos SCSS que serão buildados e colocados na static via o comando

invoke build-webpack

que empacotara e minimizara as imagens, fonts, scss, e js.

os demais recursos do pelican estão disponiveis da mesma forma.

Deploy

[dentro da env]$ invoke gh-pages