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.
Vá até a pasta que instalou o NodeJS. No meu caso: C:\Program Files\nodejs
Botão Direito > Propriedades > Segurança > Editar > Usuários > Marque a caixa "Controle total"
Instalando o Docpad
Abra o "Node.js command prompt" e terá essa tela:
Procure atualizações no NPM com o comando
npm install -g npm
Instale o Docpad
npm install -g docpad
Criando um projeto
Através do "Node.js command prompt" vá até a pasta que deseja criar o projeto.
Crie uma nova pasta para o projeto
mkdir NOME-DO-PROJETO
Entre na pasta
cd NOME-DO-PROJETO
Inicie o projeto
docpad run
Escolha o esqueleto que deseja usar
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.
Aperte "CRTL + C" e saia da aplicação.
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.