Pedro Jefferson
Header

Python Pelican #2: Instalação

Por Pedro Jefferson

Python Pelican

Olá, é bom ter você de volta! Nessa parte iremos instalar o pelican mais o esqueleto do site e algumas configurações básicas.

Instalando o virtualenv e pelican

Sem muita demora, vamos correndo instalar o nosso virtual environment. Apenas para informação, estarei utilizando o Python 3.5.2

Vamos começar instalando o virtualenv que eu falei no post anterior:

    sudo pip install virtualenv

Vou criar o projeto com o nome pelican-blog:

    virtualenv pelican-blog

Antes de tudo, vamos ativar nosso virtual environment, pois da forma que está ele não passa de uma pasta e alguns arquivos dentro.

    cd pelican-blog
    source bin/activate

Pronto! tendo isso, já estamos em um ambiente diferente da maquina local.

Em seguida temos que instalar todas as nossas coisas, teremos que instalar os pacotes pelican e markdown (Como disse no post anterior o markdown é opcional, instalarei pois prefiro a sintaxe do markdwon ao invés do reStructuredText)

    sudo pip install pelican markdown

Criando esqueleto do blog

Se tudo deu certo na instalação, passaremos para a próxima fase.

Vamos agora rodar o comando que nos dará o esqueleto do blog de forma automágicamente.

    pelican-quickstart

Após executar o comando acima o script irá te fazer algumas perguntas sobre o site:

    Welcome to pelican-quickstart v3.6.0.

    This script will help you create a new Pelican-based website.

    Please answer the following questions so this script can generate the files
    needed by Pelican.


    > Where do you want to create your new web site? [.]
    > What will be the title of this web site? Functional Developers
    > Who will be the author of this web site? Pedro Jefferson
    > What will be the default language of this web site? [en] pt
    > Do you want to specify a URL prefix? e.g., http://example.com   (Y/n) n
    > Do you want to enable article pagination? (Y/n) y
    > How many articles per page do you want? [10]
    > What is your time zone? [Europe/Paris] America/Bahia
    > Do you want to generate a Fabfile/Makefile to automate generation and publishing? (Y/n) y
    > Do you want an auto-reload & simpleHTTP script to assist with theme and site development? (Y/n) y
    > Do you want to upload your website using FTP? (y/N) n
    > Do you want to upload your website using SSH? (y/N) n
    > Do you want to upload your website using Dropbox? (y/N) n
    > Do you want to upload your website using S3? (y/N) n
    > Do you want to upload your website using Rackspace Cloud Files? (y/N) n
    > Do you want to upload your website using GitHub Pages? (y/N) y
    > Is this your personal page (username.github.io)? (y/N) n
    Done. Your new project is available at /home/pedro/projetos/pelican-sites/pelican-blog

As perguntas correspondem respectivamente a:

  1. Local onde será criado a estrutura, mantive a opção padrão pra ele não criar nenhuma outra subpasta que seria desnecessário.

  2. Nome do Blog

  3. O Autor do blog

  4. Lingua do blog, mais a frente veremos a tradução como funciona.

  5. URL do blog, por enquanto mantive sem, pode ser adicionado depois.

  6. Paginação por artigo.

  7. Quantos artigos por página até que uma nova página seja criada. mantive o padrão de 10.

  8. Configuração de Timezone

  9. Criação do Fabfile/Makefile, são arquivos bastante interessantes principalmente para configurar nosso site pra hospedagem externas.

  10. Esta opção cria um arquivo chamado develop_server.sh é muito útil pois cria uma especie de live reloading, recarregando o blog após cada modificação sem ter que ficar rodando comandos toda hora. (O Makefile tem uma opção semelhante, então pode ser ignorado.)

  11. Os proximos 6 passos são referentes a configuração de hospedagens, como dropbox, github, amazon s3 e etc.. apenas mantive o github pois é onde estarei colocando este site em especifico e mais pra frente abordarei como sincronizar com os outros.

Criando um arquivo de postagem

Atenção meus amigos, o pelican não roda sem ter algum arquivo de postagem. portanto é necessário criar um arquivo de teste como este:

    Title: Teste de postagem
    Date: 2016-11-12 00:50

    Este é um teste de uma postagem em markdown pro melhor blog do mundo! :)

Salve como exemplo.md dentro da pasta content e pronto, já temos nosso primeiro post de exemplo.

Gerando o site

Pra gerar o site executamos:

    pelican content -s pelicanconf.py

Agora basta entrar no diretório output/ que é o diretório padrão os arquivos gerados do blog e executar

    python -m pelican.server

E acessar seu navegador na url http://localhost:8000 e pronto!

Seu blog deve se parecer com isso:

Python Pelican

Mas calma, esse é apenas o tema padrão, óbvio que vamos modificar algumas coisas e seu blog vai ser o melhor entre todos!

Por hoje é só, segue um resumo doque conseguimos fazer com grande honra hoje!!

  1. Instalar o Virtualenv e o Pelican
  2. Criamos o esqueleto do blog com pelican-quickstart
  3. Criamos uma primeira postagem de teste.

Obrigado, agradeço ter conferido o post até o fim. Até mais!!