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.

Instalando o Docpad

  1. Abra seu terminal
  2. Procure atualizações no NPM com o comando
npm install -g npm
  1. Instale o Docpad
npm install -g docpad

Criando um projeto

1. No terminal 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.

Agora considerando que você tenha escolhido um esqueleto, na pasta do projeto digite

npm install

Isso vai instalar as dependências do projeto.

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.