Primeiros passos com o Docpad

No último post dei uma breve explicação sobre geradores estáticos. Algumas pessoas me pediram para fazer um tutorial básico do Docpad.

NodeJS e o NPM

O primeiro passo, como havia falado, é entender o mínimo do funcionamento do NodeJS e seu gerenciador de pacotes, o NPM.

Se você usa Windows, basta baixar a última versão e instalar.

Nesse momento não é necessária nenhuma configuração especial, apenas deixe todas as opções ativadas e será instalado o NodeJS, alguns módulos nativos e o NPM.

Para instalar em outros sistemas operacionais, pode ler esse passo a passo.

Agora um item importante. No Windows, é necessário dar permissão total para a pasta do NodeJS. Com isso ele conseguirá instalar outros módulos.

  1. Vá até a pasta que instalou o NodeJS. No meu caso: C:\Program Files\nodejs

  2. Botão Direito > Propriedades > Segurança > Editar > Usuários > Marque a caixa "Controle total"

    Propriedades do NodeJS

Instalando o Docpad

  1. Abra o "Node.js command prompt" e terá essa tela:

    NodeJS

  2. Procure atualizações no NPM com o comando

    npm install -g npm

  3. Instale o Docpad

    npm install -g docpad

Criando um projeto

  1. Através do "Node.js command prompt" vá até a pasta que deseja criar o projeto.

  2. Crie uma nova pasta para o projeto

    mkdir NOME-DO-PROJETO

  3. Entre na pasta

    cd NOME-DO-PROJETO

  4. Inicie o projeto

    docpad run

  5. Escolha o esqueleto que deseja usar

    Docpad

Comece a brincar!

Após escolher um esqueleto (menos quando escolher a opção 15), já terá uma base para começar a brincar e entender o como funciona o desenvolvimento.

Para criar esse site, usei o esqueleto 1 - HTML5 Boilerplate.

  1. Aperte "CRTL + C" e saia da aplicação.

  2. Agora considerando que você TENHA escolhido um esqueleto, na pasta do projeto digite

    npm install

    Isso vai instalar as dependências do projeto.

  3. Rode novamente 

    docpad run

Você deve alterar os arquivos da pasta src/, o Docpad automaticamente vai gerar uma pasta out/ com os HTMLs gerados, essa pasta você não deve alterar.

Mais informações

Nesse post, mostrei apenas os primeiros passos.

Para continuar o desenvolvimento, o site do Docpad tem um guia bem bacana de uso.

Não se assuste se achar difícil no começo, garanto que é questão de tempo até que esteja fazendo coisas bem legais com essa ferramenta.

É isso amigos, espero que contribua de alguma forma. Não sou mestre no Docpad, alias domino bem pouco e faço apenas coisas mais básicas. Mas caso tenha dúvidas, pergunte e tento ajudar no que conseguir.