Como criar site com Jekyll - PT

Você é proprietário de um site que é procurando uma maneira fácil de criar sites rápidos? Embora a maioria dos sistemas populares de gerenciamento de conteúdo, como o WordPress, geralmente sejam para essas tarefas, eles não são rápidos. Eles contam com bancos de dados, scripts pesados ​​e plugins para finalmente entregar na página. Mas e se houver uma maneira melhor? Jekyll é muito melhor do que outras opções semelhantes! É um gerador de site estático - tudo que você precisa fazer é levar suas postagens, formate-o de acordo e execute-o através do mecanismo. Isso resultará na criação de arquivos compatíveis com HTML que podem ser facilmente carregados em qualquer host.

Jekyll 4.1.0 Atualizações

Jekyll foi atualizado no final de maio 2020 com uma nova atualização com o número v4.1.0 no qual o componente do servidor agora suporta certificados ECC, entre outras coisas. Esse é um recurso importante quando um tipo de chave diferente de RSA é usado. Outra coisa importante que é a otimização do mecanismo Markdown — a formatação usada nos rascunhos e direciona a saída das páginas. Com Jekyll 4.1.0 os blogueiros podem optar por desativar cache de disco o que pode ser benéfico em alguns casos, especialmente quando testes mais complexos de projetos são feitos.

Outros aprimoramentos importantes do ponto de vista do proprietário do site incluem os seguintes:

• Configuração do idioma padrão para incluir realce de sintaxe. Anteriormente, isso precisava ser feito manualmente.
• Os administradores agora podem desativar a importação da configuração do tema
• O módulo PageDrop pode ser usado com os modelos Liquid.

Como sempre, a nova versão do Jekyll inclui importantes correções de erros que foram relatadas pelos usuários.

Por que Jekyll para sites estáticos

Os geradores de sites estáticos são uma das ferramentas mais populares usadas para gerar sites de alta qualidade e fáceis de usar e gerenciar que não dependem de um sistema dinâmico de gerenciamento de conteúdo como o WordPress. Os sites estáticos são pequenos e produzidos como saída do projeto depois que os proprietários do site executam o conteúdo por meio do aplicativo Jekyll. Por design, Jekyll é um Aplicativo executável Ruby que é muito fácil de usar e é multiplataforma. Um recurso muito conveniente é que o Jekyll inclui um servidor da Web local interno que permite que os proprietários do site visualizem ao vivo as alterações feitas antes que o site seja publicado on-line. Há alguns vantagens distintas de confiar em um site estático em oposição aos dinâmicos, tendo Jekyll em mente como gerador de sites:

• atuação - Os sites criados por Jekyll são muito mais rápidos que o número de seus equivalentes. Eles são produzidos em código HTML limpo, que é facilmente legível pelos navegadores da web e é muito mais rápido para carregar. Não há elementos dependentes do banco de dados e consultas complexas que são comuns em outros tipos de sites.
• Processo de criação - Em comparação com sistemas dinâmicos de gerenciamento de conteúdo, os Jekyll gerados são construídos de uma maneira diferente. Os desenvolvedores precisam formatar o conteúdo de acordo com o mecanismo de modelo usado pelo Jekyll e correspondente ao arquivo de configuração principal. O Jekyll transformará os arquivos de rascunho em sites HTML, que deverão ser carregados nos servidores web.
• Requisitos do servidor - Os sites Jekyll precisam de suporte de scripts ou bancos de dados especiais, o que facilita muito a localização de uma hospedagem barata.

Configuração do Jekyll: O básico

Jekyll 4.0.0 é essencialmente o que é chamado de gem Ruby - esse é um tipo especial de código instalado no ambiente Ruby. Ruby é uma linguagem de programação moderna geralmente usada para criar sites e aplicativos. Um Gem é um tipo de programa que pode ser baixado do repositório Ruby e funcionará de uma determinada maneira. Possível funcionalidade inclui ferramentas de embalagem, ações repetidas, estruturas e etc. Como resultado, Jekyll pegará os arquivos de conteúdo, processe-os e produza arquivos HTML prontos para serem carregados nos servidores da web.

Para começar a funcionar com os possíveis proprietários de sites Jekyll, é necessário ter o seguinte software instalado: O principal ambiente Ruby (incluindo todos os cabeçalhos de desenvolvimento), Os pacotes Ruby Gems suportam e o gcc e make tools. Uma descrição detalhada de como instalar e preparar o ambiente está disponível no site Página de instalação do Jekyll.

O processo de criação de sites Jekyll

Para ter um site pronto, construído por um Jekyll 4.0.0 aplicativo instalado no sistema local usado pelos proprietários do site. Antes de tudo, eles precisarão configurar o Jekyll definindo os ambientes globais para o projeto. Quando o Jekyll estiver instalado e funcionando em um determinado sistema, os proprietários do site precisarão criar um diretório que hospedará todos os arquivos de projeto do site - isso será designado como o “raiz do site” . Nele um Jekyll index.htm É necessário criar um arquivo que abrigue o conteúdo da página inicial e os arquivos importantes. Um modelo vazio incluirá o seguinte código:

doctype html>
<html>
<cabeça>
<meta charset =? utf-8?>
<título>Casa</título>
</cabeça>
<corpo>
<h1>Olá Mundo!</h1>
</corpo>
</html></p>

Este é o geral “Olá Mundo!” site de saudação a partir do qual os desenvolvedores da Web podem começar a criar suas criações. No diretório raiz, os desenvolvedores podem executar dois comandos:

• jekyll build - Isso criará o site e produzirá o código final em um subdiretório separado chamado “_local”.
• jekyll serve - Isso monitorará as alterações do site e o reconstruirá automaticamente, conforme o logon estiver em execução no aplicativo jekyll. Isso também ativará o servidor interno do site, que permitirá aos desenvolvedores visualizar ao vivo seu projeto. Por padrão, é acessível a partir do seguinte URL: http://localhost:4000

Tudo o que os usuários precisam fazer é decidir sobre um layout de site adequado e gerar o conteúdo. Isso pode ser feito de duas maneiras principais:

• Arquivos HTML - Esses são arquivos HTML padrão criados pelos proprietários do site. Eles enfrentarão as configurações definidas por Jekyll.
• Arquivos de modelo de remarcação - Os proprietários do site também podem impor arquivos gravados com descontos, que serão gerados de acordo com um determinado modelo. Isso significa que os usuários podem formatar texto e código de acordo com um formato Markdown fácil de seguir. Ele será processado de acordo com as regras definidas e, no final, retornará um arquivo HTML compatível com o padrão.

Markdown é uma linguagem de marcação fácil de usar que é popular entre desenvolvedores e usuários avançados de desenvolvedores da web. É muito conveniente, pois vários programas de processamento de texto e editores especiais podem gerá-los em formatos padrão. Jekyll pegará os arquivos do Markdown (com a extensão .md apropriada) e usando os arquivos de modelo definidos, gere um arquivo HTML otimizado.

O mecanismo Jekyll diferencia páginas normais criadas em HTML e os chamados arquivos especiais. Isso é feito digitando as informações necessárias Matéria da frente do YAML- isso deve ser colocado no início de cada página. YAML é uma linguagem de marcação prática e amigável ao ser humano, lida por Jekyll. Um exemplo típico desse arquivo é o seguinte:

—
disposição: postar
título: Blogging 101 Página
—

Neste exemplo, o assunto principal especificará os disposição tipo (neste exemplo, essa será uma postagem de blog padrão) e a título da página. Existem duas outras variáveis ​​globais que podem ser colocadas na matéria da frente - permalink (que permitirá ao usuário configurar seu próprio link permanente para o post e Publicados (valores verdadeiros ou falsos podem ser colocados) o que pode impedir que uma determinada postagem seja publicada on-line. Isso é particularmente útil quando os rascunhos são planejados.

Usando o mecanismo de modelo Jekyll e os arquivos de configuração os usuários podem criar suas próprias variáveis também. Quando se trata do tipo de postagem, existem várias opções que podem ser usadas:

• encontro - Isso substituirá a data da postagem, como mostrado na saída do site.
• categoria / categorias - Isso permitirá uma melhor organização das postagens quando visualizadas pelos visitantes. Ao especificar esse valor, as postagens serão organizadas nas respectivas categorias. As "categorias" plurais podem ser especificadas em uma lista YAML ou separadas por espaço, como na maioria dos sistemas de gerenciamento de conteúdo dinâmico.
• Tag - Essa é uma opção popular para permitir que as postagens sejam marcadas pelos usuários. Essa é mais uma conveniência separada das categorias mencionadas acima.

Mecanismo de estrutura e layout do site Jekyll

Assim que o mecanismo Jekyll for iniciado pela primeira vez em um determinado site (projeto) basicamente, tudo o que os proprietários do site precisam fazer é chamar o jekyll new $ sitename (Onde $nome do site é o diretório do projeto). Todas as versões modernas do Jekyll criarão um layout de diretório estruturado. Por padrão, o arquivo de configuração principal usará um modelo padrão chamado mínimos que podem ser aprimorados ou alterados dependendo das preferências dos usuários. O diretório conterá os seguintes arquivos e pastas:

• pasta _posts - Isso conterá as postagens individuais. No caso típico, eles terão o seguinte formato —XXXX-XX-XX- $ postname.markdown (ou .md). As três primeiras cadeias de caracteres serão o ano-mês-dia, seguidas de traços com o nome da postagem na estrutura do link permanente. Um exemplo de nome de postagem será 2020-01-03-hello.markdown, que produzirá uma postagem chamada "Hello" e publicada em janeiro 3 2020.
• _config.yml - Este é o principal arquivo de configuração usado pelo Jekyll.
• 404.html - Isso conterá a página de erro padrão Página não encontrada, também conhecida como 404 erro.
• about.markdown - Esta é a página "Sobre", normalmente encontrada na maioria dos blogs.
• Gemfile - Este é um arquivo criado automaticamente pelo ambiente Gemfile.
• index.markdown - Esta é a página inicial padrão que, por padrão, começará a indexar todas as postagens de tipo de blog com base na data em uma ordem decrescente.

Para mais informações sobre opções de layout, estrutura de diretórios e mais informações, você pode conferir as páginas relevantes no Documentação Jekyll.

Liberte todo o poder de Jekyll

Existem muitos recursos que os proprietários de sites Jekyll podem usar, fornecendo a capacidade de personalizar verdadeiramente seus sites até os mínimos detalhes. Como mencionamos anteriormente, todas as instalações padrão do site usam um tema padrão chamado mínimos. tem muitos repositórios de temas Jekyll de terceiros que aproveitam as muitas opções de personalização. O que é único no sistema de modelos Jekyll é que ele é baseado em Gemas - bibliotecas que podem incluir funcionalidade rica. As instalações Jekyll usam um utilitário chamado Bundler que acompanha as várias dependências. Uma função alternativa é usar modelos regulares - eles usarão os arquivos tradicionais que são apresentados no diretório do site Jekyll.

O sistema de plug-ins é um dos mais avançados encontrados em geradores de sites estáticos semelhantes e até em alguns dos famosos sistemas de gerenciamento de conteúdo dinâmico. Os plug-ins podem fornecer funcionalidade aprimorada que não é encontrada na instalação básica do Jekyll. Usando ganchos personalizados e o núcleo flexível, muitas outras opções podem ser adicionadas. Existem várias categorias principais de plugins que podem ser categorizadas:

• Geradores - Esta é uma função que será usada para permitir que o Jekyll crie conteúdos adicionais. Regras personalizadas podem ser usadas para direcionar o mecanismo para a implementação da nova funcionalidade.
• Conversores - Esses plugins permitem que os usuários usem outras linguagens de marcação e opções de temas para implementar o layout.
• Comandos - Isso estenderá a funcionalidade do mecanismo principal implementando novos comandos.
• Tag- Isso criará tags personalizadas baseadas em líquido.
• Filtros - Plugins que ampliam a funcionalidade de filtros.
• Hooks - Eles permitem extensões durante o processo de compilação.

Opções de implantação do site Jekyll

Existem várias opções compatíveis que podem ser usadas para carregar os sites nos servidores. É uma boa prática criar um gemfile para cada site. Isso permitirá que os plugins e extensões sejam empacotados como um todo. Vários valores do ambiente também podem ser definidos durante o processo de construção - no final da fase de produção, existem parâmetros definidos que podem ser usados ​​para criar a saída do local. Existem duas maneiras principais de carregar os sites:

• Upload simples - A saída da pasta do site pode ser carregada usando o painel administrativo ou um utilitário de upload de arquivos usando as opções de arrastar e soltar e / ou comandos especiais.
• Publicação de Controle de Versão - Os proprietários do site também podem usar sistemas de controle de versão, como git ou svn, para manter as revisões do site.. Essa é uma função avançada usada para armazenar edições e se comunicar com os servidores de uma maneira que facilitará muito mais a documentação das alterações..