Executando Jekyll no Windows – Parte 3

Executando Jekyll no Windows – Parte 3

Ta chegando agora? Veja os anteriores:

Executando Jekyll no Windows – Introdução
Executando Jekyll no Windows – Parte 1
Executando Jekyll no Windows – Parte 2

Visão Geral

Se você estiver usando Markdown ou HTM, Jekyll torna mais fácil para você inserir belos blocos de código em suas páginas.

Por padrão, Jekyll vem com o ‘highlights’ pygments.rb, que é um marcador de sintaxe baseado em Python. Para usá-lo no Windows, você precisará instalar o Python e algumas ferramentas extras.

Uma boa alternativa é o Rouge baseado em Ruby, que é mais rápido e mais fácil de instalar, mas não suporta as mesmas línguas que pygments.

Abaixo, você encontrará instruções para ambos os marcadores de sintaxe. Escolha o que melhor se adapta às suas necessidades. Mais informações podem ser encontradas no site oficial Jekyll.

Instalando Rougue

Rápido e simples: Abra o prompt de comando e digite o seguinte comando.

Então, abre o arquivo _config.yml (na raíz de seu projeto Jekyll), defina Rouge como seu marcador sintaxe:

Prontinho!

Tornando Pygments Funcional

Se você quiser usar pygments, que é uma dependência padrão do Jekyll, para destaque de sintaxe no Windows, você precisará instalar Python, pip e a base de Python pygments.rb.

Nota: Depois de concluir as etapas a seguir, Jekyll pode ainda conter erros de saída na construção ou servindo sites. Estes não devem causar nenhum problema real embora, assim você pode ignorá-los com segurança.

Instalando Python

A última versão do Python no momento é v2.7.10. Python 3 não vai funcionar. Clique no aqui para baixar o instalador v2.7 que de acordo com arquitetura de seu sistema (x86 / x64).

Execute o arquivo baixado e siga os passos da instalação.

Quando você chegar à tela abaixo, certifique-se de clicar na caixa ao lado de “Add python.exe to Path”.

Instalando pip

Pip é uma ferramenta para instalação e gerenciamento de pacotes Python , semelhante ao Ruby Gems. Você vai precisar dele para instalar pygments, o pacote Python que pygments.rb usa para realçar seu código.

Primeiro, clique aqui e baixe get-pip.py através do link no site.

Nota: O arquivo get-pip.py é um arquivo de texto comun com extensão do python, portando salve este arquivo em c:/pip

Agora abra o prompt de comando e vá até o local onde o arquivo esta.

Em seguida, execute o seguinte comando para fazer o download e instalar automagicamente todos os componentes necessários.

Instalando a base do Python para Pygments

A partir do prompt de comando, execute o seguinte comando para instalar a base de Python pygments.

Definir Pygments como seu marcador de sintaxe highlight

Se ainda não estiver definido, adicione o seguinte ao seu _config.ymlpara definir pygments como seu marcador de sintaxe.

Resumo

Jekyll agora usará o marcador que você escolheu para fazer todos os seus blocos de código olhar super elegante. Estamos quase acabado. Neste momento seu Jekyll já esta totalmente funcional, no próximo post iremos abordar algumas funções complementares do Jekyll. Até a próxima.

Related Posts