Site Python Floripa 2021 - PythonFloripa/pythonfloripa.github.io GitHub Wiki

Para a atualização do site para a versão 2021, utilizamos o gerador de site estático Nikola. Os dois motivos principais para sua escolha foram o uso de Python pela ferramenta e por uma integrante da comunidade já o utilizar, ajudando no seu uso.

Iniciando um site com Nikola

Depois de instalado o Nikola no seu ambiente virtual, como é mostrado em sua documentação de como iniciar, execute o comando

nikola init nome-da-pasta

Após a execução, uma pasta nome-da-pasta será criada com a estrutura inicial para criação de seu site.

Ao entrar na pasta criada (sempre execute os comandos a seguir na pasta criada pelo Nikola), você já pode ver o site no seu endereço de hospedagem local (o localhost: 127.0.0.1), executando o comando

nikola auto

que irá iniciar o servidor na porta 8000. O servidor irá atualizar o site a cada alteração realizada no código. Para parar o servidor, execute Ctrl+C.

Para ver informações sobre os comandos do Nikola, execute

nikola help

Para ver informações sobre um comando específico do Nikola, execute

nikola help nome-do-comando

Para criar uma nova página no site (separadas por pastas na pasta pages), execute

nikola new_page ./pages/nome-da-pagina/nome-da-pagina.md

Configure o arquivo .meta (caso o comando ou arquivo conf.py tenha especificado a criação de dois arquivos), ou do cabeçalho do arquivo. Para seguir nossso padrão, faça os seguintes passos:

• insira uma descrição;
• apaga tag e link;
• mude o slug para ../slug
• adicione o caminho e o título da página na variável NAVIGATION_LINKS, no arquivo conf.py, seguindo o padrão

('/nome/', 'título'),

o título deve ser igual ao título no arquivo .meta.

Para criar um tema para o site, execute

nikola theme -n nome-do-tema

Para mais informações, confira a documentação!