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

  1. Faça uma cópia de uma página existente

    $ cp about.md sobre.md

  2. 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.

  1. 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

  2. Execute o comando de atualização

    $ ./atualiza.sh

  3. 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

  1. Edite o arquivo localizado em _posts

    $ nano _posts/AAAA-MM-DD-welcome-to-jekyll.markdown

  2. Altere o título e o conteúdo.

  3. 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.