Como fazer um blog com Jekyll

octojekyll

Ou você quer aprender como criar um blog, ou gostaria de escrever algo em particular, é verdade que manter um blog leva tempo e dinheiro, mas ainda existem ferramentas gratuitas e de código aberto que irão lhe poupar muitas coisas e que fazem você apenas escrever.

Vou ensinar como usar o Jekyll pela facilidade e uso do Markdown e, embora existam muitas alternativas, o Jekyll interage bem com o Github.

Requisitos:

  1. Tempo
  2. Internet
  3. Conta Github

instalação

No Debian / Ubuntu e derivados:

sudo apt-get install git ruby ​​jekyll

No Fedora e derivados:

sudo yum install git ruby ​​gem install jekyll

Em Arch e derivados (paciência):

sudo pacman -S git ruby ​​yaourt -S ruby-jekyll

Configuração de base:

Configuramos o git com nossos dados do Github

git config --global user.name "nome de usuário" git config --global user.email "email_id"

Criamos o repositório git no qual trabalharemos localmente, deve ser chamado igual ao seu nome de usuário no Github

git init youruser.github.io

Uma vez que o diretório do blog é criado, temos que procure um tópico para jekyll em, ou deixando de criar um. Então você deve copiar o conteúdo do tema para o diretório criado com git, no exemplo use o tema Compass

Neste diretório você encontrará vários arquivos e diretórios, embora o tema possa ser organizado de forma diferente, a maioria usa este formato de organização

/ _includes Diretório do corpo da página
/ _layouts Diretório do corpo da página
/ _Postagens Diretório para onde vão as entradas
/ _css o / scss Diretório onde estão os css
/ _img o / imagens Diretório para onde vão as imagens
/_config.yml O arquivo de configuração
/404.md A página de erro 404
/ CNAME Link para um domínio
/sobre.md A página «sobre»
/index.html Pagina inicial

Agora preencha o arquivo de configuração _config.yml com os dados de sua preferência, no meu caso deixei assim:

-_config.yml (~ -Blog-desktop) - gedit_003

Vá para o terminal no diretório com o qual trabalhamos e escreva

jekyll servir

Em um navegador, digite localhost: 4000 ou 127.0.0.1:4000 e você verá o site funcionando, você pode começar a modificar o conteúdo do blog localmente através de seu editor de código preferido, o meu é um texto sublime.

Bússola

Aqui Jekyll com o tema já instalado.

Quando você decidir que o blog está pronto para ser publicado ou para atualizar as entradas, escreva

git add --all git commit -m "Mensagem que você deseja mostrar" git push -u origin master

Ele pedirá seu nome de usuário e senha do github; escreva e acesse

www.seuusuário.github.io

Bem, até aqui a entrada, espero que tenha sido clara. Ferramenta PilhaEditar permite que você escreva e exporte os arquivos markdown para um repositório github, se você precisar de informações do jekyll você pode usar o site oficial jekyll ou do página de ajuda das páginas do github.


13 comentários, deixe o seu

Deixe um comentário

Seu endereço de email não será publicado. Campos obrigatórios são marcados com *

*

*

  1. Responsável pelos dados: Miguel Ángel Gatón
  2. Finalidade dos dados: Controle de SPAM, gerenciamento de comentários.
  3. Legitimação: Seu consentimento
  4. Comunicação de dados: Os dados não serão comunicados a terceiros, exceto por obrigação legal.
  5. Armazenamento de dados: banco de dados hospedado pela Occentus Networks (UE)
  6. Direitos: A qualquer momento você pode limitar, recuperar e excluir suas informações.

  1.   elav. dito

    Bom artigo, mas há muitos outros CMS ou aplicativos da web para criar blogs que realmente fazem você se concentrar na escrita. Acho muito complicado usar Jekyll, embora para gosto ..

    1.    caçador dito

      O apelo sexual de Jekyll, Pelican e outros é o fato de eles gerarem sites estáticos a partir do Markdown RestructuredText ou etc, e assim você cria blogs que podem ser hospedados nas páginas do github e colocar comentários externos com o Disqus.

      Meu blog é Pelican por exemplo, criar um novo post é criar um primeiro arquivo e recompilar, eu me comprometo com o branch gh-pages do repo no github e é isso.

      1.    elav. dito

        Uff, super fácil né? Crie um arquivo, recompile, submeta .. Tem WordPress (e similares), a cada dia eu te amo mais 😛

      2.    caçador dito

        Como um fato curioso, kernel.org usa um gerador destes.

        https://www.kernel.org/pelican.html

    2.    umohtrês dito

      Bem, são duas coisas diferentes, mas eu mudaria completamente o WordPress para qualquer construtor de sites estáticos. A complicação está no início, quando você tem que montar o layout e outros, outra coisa é justamente o que você fala, concentra-se na escrita, você simplesmente gera um arquivo de texto puro e com o markdown BAM você cria o post. Não vejo nada de complicado nisso.

      lembranças

      1.    elav. dito

        Não estou dizendo que seja o seu caso, mas alguns travaram uma guerra santa no WordPress (como Joomla ou Drupal) em favor de geradores de conteúdo estático. Sim, são rápidos, são simples, mas são mais problemáticos quando se trata de fazer o que o WordPress faz, sem falar que a ferramenta é algo colaborativo, onde muitos podem participar, onde é preciso moderar ... etc .

      2.    andrew dito

        Você está certo, elav, wordpress é melhor, dependendo da necessidade. um blog como desdelinuxPoderia funcionar com um gerador de conteúdo estático mas para muita gente participar seria um problema, além do fato de que embora seja fácil de configurar pode ter problemas de segurança, não como o WordPress. É por isso que para iniciantes eu recomendo Jekyll e não Wordpres, pois é mais fácil e você pode aprender com tutoriais simples em HTML/CSS sem usar PHP, o que assustaria um novato.

    3.    andrew dito

      Este que escrevi é a mesma tecnologia que as páginas do github usam, mas não permite que você use seus próprios temas, você tem que usar os temas padrão. Claro que existem outras mais fáceis, mas eu estava procurando uma instalação e configuração simples, sem ter que trabalhar em Domínios, Hospedagem, SEO, Segurança, etc.

    4.    Há Day dito

      Demorei muito a criá-lo com o wordpress, mas vou experimentar, muito obrigado partilho o seu artigo 🙂

  2.   MD dito

    Mas ... uma pergunta ... não é um blog?

    É uma página plana, pois não permite comentários.

    1.    Jesus Ballesteros dito

      Digamos que seja tecnicamente uma página estática. Mas se ele permite que você instale o Disqus para os comentários então aí ele complementaria o que for necessário.

      1.    MD dito

        Interessante, obrigado.

  3.   Oscar dito

    Obrigado. Muito bom.