Uma das dificuldades que experimentei quando tente passar de Worpress para Jekyll fDevo entender para que servia cada componente e como eles interagiam entre si. Eu encontrei a solução quando parei de tentar criar meu blog do zero e comecei a fazer engenharia reversa um tema desenvolvido por outra pessoa. As vantagens do código aberto.
Para começar, supondo que você tenha instalado os pré-requisitos descritos nos artigos anteriores, construiremos nosso site. O exemplo é um blog de jardinagem.
jekyll new blog_de_jardineria
Se você for para a pasta, verá o seguinte:
- Uma pasta chamada _Postagens.
- Dois arquivos com extensão markdown
- Uma página da web.
- Um arquivo de configuração com uma extensão .yml que discutiremos detalhadamente no próximo artigo.
- Um arquivo Gemfile que lista os componentes do site e outro com o mesmo nome, mas com uma extensão .lock que evita modificações inadvertidas.
A estrutura do projeto
Como qualquer site baseado em WordPress, Jekyll também cria uma estrutura de pastas onde armazena todos os arquivos, e faz isso pelos mesmos motivos. Permite que o usuário agrupe arquivos de maneira ordenada e, conforme o projeto cresce, permanece gerenciável.
Nós criamos a pasta base com o comando jekyll new. Dentro dele, encontramos dois tipos de pastas; aqueles que estão relacionados à configuração do blog que são identificados com um hífen antes do nome (no nosso caso a pasta _post e aqueles que possuem recursos que não serão incluídos como parte do processo de criação. Por exemplo, aqueles que contém imagens.
Pastas baseadas em conteúdo
Neste grupo se armazena conteúdo destinado aos visitantes do site
_ publicar
A pasta _POST contém todas as entradas do blog. Aqui, um formato muito específico é usado para cada um dos arquivos salvos nele. O nome do arquivo deve estar no formato date-filename - year-month-date-full_filename.md - e esta data de postagem será exibida como a data em que esta postagem do blog Jekyll foi feita. Devemos ter em mente que embora a pasta seja chamada _ Postagens, aqui está todo o conteúdo que os leitores do blog verão, por exemplo, o formulário de contato ou as biografias dos autores. Mais tarde veremos que é possível atribuir diferentes designs às páginas.
_rascunhos
É o equivalente a salvar rascunhos do WordPress. Seu uso recomendado é para postagens que não estão prontas para serem publicadas, embora possam ser usadas para armazenar listas de ideias, designs para uso posterior, etc.
_inclui
Neste espaço podemos armazenar o código html que pode ser reutilizado várias vezes. Por exemplo, no nosso caso um banner que saúda o início de uma temporada dependendo do hemisfério em que o usuário se encontra.
_layouts
Como dissemos acima, diferentes partes do conteúdo podem precisar de layouts diferentes. Por exemplo, para mostrar um vídeo, podemos querer que a página seja uma coluna única, enquanto se for um autor convidado precisaríamos de uma coluna para mostrar sua biografia e informações de contato. Os diferentes designs que o site usará estão armazenados nesta pasta.
Pastas de informação
Essas duas pastas são utilizados pelo site para o seu funcionamento.
_dados
Em um blog individual, o arquivo de configuração pode armazenar todos os dados necessários. Mas, se temos um blog com muitos autores, é necessária outra forma de gerenciar as informações. A pasta _dados É usado para armazenar dados nos formatos JSON ou CSV que o site pode recuperar de acordo com a interação com os usuários.
_se vocês
A pasta _se vocês O site o completa com todas as informações disponíveis nas pastas anteriores. Aqui encontraremos o site que faremos upload para o servidor para que os usuários possam acessar. Obviamente, como se trata de um código html e css, é possível fazer modificações como em qualquer outro site.
No próximo artigo, começaremos a modificar o arquivo de configuração.