Link para oficina de Jekyll: https://lief.if.ufrgs.br/~pezzi/Curso_Jekyll/. Como os computadores deste curso já tem os requisitos, podemos iniciar na etapa 3: Primeiro Projeto Jekyll. Para praticidade de publicação, recomendo criação de script de atualização do site que faz uso do rsync.
Uso do Jekyll
Crie seu primeiro site Jekyll em projeto_1
$ jekyll new projeto_1
Entre no diretório do novo projeto
$ cd projeto_1
Construa o site
$ jekyll build
O comando acima irá criar a versão estática do site na pasta _site
. Também existe a possibilidade de ativar um servidor web local para visualizar o resultado do website. Construa o site e sirva-o localmente com
$ jekyll serve
Agora visite http://localhost:4000
com o navegador. Atenção, este endereço pode mudar de acordo com as configurações do computador em uso. Confira na saída do comando a URL.
O Jekyll é uma ferramenta concebida para a criação de blogs. Cada post corresponde a um arquivo na pasta _posts
que e deve seguir a notação ANO-MES-DIA-título.md
.
O site deste curso fez uso e algumas customizações partindo do tema padrão, chamado minima. Esta oficina não abordará como fazer estas modificações e foca na alteração de sites e modelos existentes. Caso deseje se aventurar visite a documentação oficial do Jekyll.
Exercício 1
Crie sua primera página
-
Faça uma cópia de uma página existente
$ cp about.md sobre.md
-
Altere o título no cabeçalho e o permalink. Mude o conteúdo da página.
$ nano sobre.md
Dica: Coloque o título de um projeto e escreva uma frase a respeito do mesmo.
Visite o site e perceba a indicação da página no menu do site, assim como o seu endereço.
Exercício 2
Altere a configuração do site
A configuração geral do site está contida no arquivo _config.yml
, localizada na raiz do site.
$ nano _config.yml
baseurl:
indica o sub-caminho do seu site.
Dica: Configure o site para ser publicado com baseurl: "/~meu_login/projeto_1"
Altere a descrição do site e remova configurações desnecessárias. Salve e saia do editor nano
`Ctrl + o` salva arquivo
-> digite enter para confirmar o nome do arquivo
`Ctrl + x` sai do nano
Alterações no arquivo _config.yml
não são detectadas automaticamente pelo Jekyll. Para implementar as alterações, interrompa o Jekyll com Ctrl + c
e inicie-o novamente. Atenção para o novo caminho: o site passará a ficar disponível localmente em
`http://localhost:4000/~meu_login/projeto_1`
Ajuste a baseurl:
para refletir o caminho do site do projeto no servidor web.
Exercício 3
Crie o script de sincronização
Toda vez que o site é gerado em seu computador ele é armazenado no diretório _site
. Para publicar o site basta copiar o conteúdo deste para o servidor. Para isto o rsync
é muito útil.
-
Crie o script de sincronização e ajuste a permissão de execução
$ echo "rsync -av ./_site/ teu_login@lief.if.ufrgs.br:/home/teu_login/public_html/Projeto_1" > atualiza.sh
$ chmod +x atualiza.sh
-
Execute o comando de atualização
$ ./atualiza.sh
-
Se tudo ocorreu bem os arquivos foram transferidos. Verifique as alterações no site utilizando o seu navegador favorito.
Exercício 4
Crie seu primeiro post
-
Edite o arquivo localizado em
_posts
$ nano _posts/AAAA-MM-DD-welcome-to-jekyll.markdown
-
Altere o título e o conteúdo.
-
Salve o arquivo, atualize o site e visite o blog.
É uma boa prática renomear o arquivo de acordo com o título do post.