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.

gem install rouge

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

highlighter: rouge

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.

cd C:\pip

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

python get-pip.py

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

python -m pip install Pygments

##Definir Pygments como seu marcador de sintaxe highlight Se ainda não estiver definido, adicione o seguinte ao seu _config.yml para definir pygments como seu marcador de sintaxe.

highlighter: pygments

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

Ta curtindo? Compartilha com sua galera.