Documentação de como usar o Grunt.JS

[gugaalves]

Galera,

Criamos aqui no trabalho (@ernandesferreira e eu) uma documentação mais elaborada sobre como utilizar o Grunt.JS. Como faço para editar a página da documentação (http://wpod.in/pt-br/docs/usando-grunt-js/) que explica isso?

[ernandesferreira]

@claudiosmweb fiz uma documentação para o uso do GruntJS depois da uma olhada esta nesse link https://github.com/wpbrasil/odin/wiki/Usando-o-GruntJS

[fdaciuk]

Pow véi.. pegou meu post na íntegra :P

Mas acho legal ter essa page lá sim.. facilita bastante pra quem tá começando xD

Só que seria legal ter somente umas poucas instruções de como usar no Odin mesmo, e talvez alguns links para posts externos, para quem não conhece muito como usar o Grunt.

[ernandesferreira]

Pow post nao ta na integra não. .. o que esta é a parte de como fazer sem ondin... e fom o odin eu juntei um monte de post que achei em uma pesquisa que fiz estudando ele e montei... se vc achou essa post igualzinho esta ai vc com certeza ja tinha postado.... pode procurar que nao acha.... no esquema usando o odin vc nao acha...

[ernandesferreira]

E outra.. eu referênciei o post que eu coloquei na integra... pode olhar la que vc vai achar o link....

[claudiosanches]

Relaxa @ernandesferreira, não sei porque o @fdaciuk esta reclamando se foi praticamente eu que ensinei ele a usar Grunt xD

Corrigi o MD: https://github.com/wpbrasil/odin/wiki/Usando-o-GruntJS

Sem querer ser chato..
Mas tem como escrever isso usando o modelo do Gruntfile.js do Odin?
Assim cabe melhor na documentação.

[vitorbritto]

Vou ler com calma essa documentação. Observei que em alguns pontos pode compactar e deixar mais objetiva. Posso integrar o showterm e/ou uns gifs depois. ;)

[claudiosanches]

@vitorbritto vai ajudar bastante cara.

[vitorbritto]

@claudiosmweb deixa comigo! =]

[fdaciuk]

Tô reclamando não gente.. fico feliz que serviu de referência xD

Acho que não deixei explícito o sarcasmo (até parece que não me conhece :P), haha!

E foi bem na época que o @claudiosmweb tava aplicando o Grunt no Odin que eu comecei a mexer com ele mesmo.. realmente ajudou muito! o/

[ernandesferreira]

@claudiosmweb você quer que eu faça alguma alteração? ou o @vitorbritto vai mexer lá? precisar to aí...

[vitorbritto]

@claudiosmweb como está essa parte da documentação do Grunt?

[claudiosanches]

@vitorbritto então, na real isso dai esta genérico pra caramba.
Precisava dar uma comprimida na explicação total do grunt e explicar as tasks que tem no Odin.
Ai sim estaria ok para publicar.

[vitorbritto]

@claudiosmweb já olhei a documentação atual e o Gruntfile. Esta semana escrevo a nova documentação. =]

[adammacias]

Será que já não vale a pena o Odin começar a usar Gulp.JS?

[claudiosanches]

Eu gostei do Gulp, mas tem umas coisas nele que estão ainda um pouco verdes para serem usadas aqui.

[adammacias]

Entendi, foi o que eu imaginei rs. Eu ainda não tive a oportunidade de testar o Gulp, mas estão falando super bem dele, se a coisa ficar séria podemos abandonar o Grunt, não acho que o pessoal vá ter problemas em entende-lo :)

[RafaelFunchal]

Acho que não precisamos abandonar o Grunt. Não tem como dar suporte ao Grunt e ao Gulp? Não seria só termos duas pastas src?

[fdaciuk]

Nem precisa de duas src, dá pra fazer na mesma. Vou fazer uma proposta do Gulp e enviar com o padrão do Grunt que usamos hoje :)

[claudiosanches]

Até da para fazer os dois funcionarem iguais, problema seria o package.json que é só um na pasta xD
Estou querendo fazer um repo depois a parte apenas com o Gulp certo pro Odin.

[RafaelFunchal]

Pensei em duas pastas (src-gulp e src-grunt) devido o npm install ler o mesmo arquivo. Ou então sou muito newbie rss

[claudiosanches]

Mas ai fica muita coisa para carregar no core xD
Acho que repo separado é melhor.
Ainda queria montar uns esquemas para montar como quer pelo site do Odin e ai quando isso acontecer esse repo aqui vai ter menos coisa ainda.

[fdaciuk]

Pode ser das duas formas.. porque apesar de instalar bastante módulos, vai ficar tudo local mesmo xD

[claudiosanches]

Só começar wpbrasil/odin-gulp#1 xD

[fdaciuk]

o/

[vitorbritto]

Podemos fazer um build da estrutura com NodeJS (usando os módulos shelljs e inquirer) ou Shell Script mesmo.

Assim, podemos atualizar o generator do Yeoman para refletir as mesmas opções.

Não acham melhor?

[claudiosanches]

Não entendi que build agora você esta falando @vitorbritto.
No caso se for build de versões do Odin com features diferentes a ideia é usar o gerador do Yeoman para fazer mesmo.

[vitorbritto]

Para "construir" a estrutura com o Gulp ou Grunt @claudiosmweb, mas você já deu a resposta que é feito com o Generator somente. =]

[claudiosanches]

@vitorbritto isso vai ter apenas no generator e o mais importante, no site do Odin.
Fazer algo similar ao http://www.initializr.com/ para o carra baixar o zip certo já.

[adammacias]

@claudiosmweb é bem show essa proposta, você já tinha comentado isso antes...Eu estou de acordo, vamos ver o que o pessoal acha 👍

[vitorbritto]

Era essa a ideia, @claudiosmweb. Porém, o build se daria no CLI ao inves do site.

Ambos podem ser feitos com JavaScript. E podemos usar o browserify para utilizar os módulos do Node no browser-side a fim de criar algo similar ao Initializr.

Seria bom abrir uma Issue para discutirmos melhor esta situação. O que acha?

[claudiosanches]

Vamos abrir, mas isso é algo futuro.
Não quero usar CLI apenas porque só eu e mais umas 10 pessoas no mundo que vão usar, o resto não vai manjar usar algo assim e por isso que quero algo bem noob em form mesmo.

[vitorbritto]

Sem problemas. Precisando de ajuda, estamos aí. =]

[deblynprado]

Pessoal, fiz uma nova proposta da documentação do Grunt no Odin.

Tentei ser conciso e explicar todas as funções usadas no Odin, mas não entendi a tarefa do bootstrap. Se alguém puder complementar aí ;)

Vejam se ficou boa.

https://github.com/wpbrasil/odin/wiki/Usando-o-GruntJS

[vitorbritto]

@deblynprado ficou bacana.

Só algumas observações:

• Não acho que seja necessário a nota: "Perceba que foi instalado o grunt-cli e não o grunt. Isso permite que você tenha versões diferentes do Grunt rodando para vários projetos sem maiores problemas." Do contrário, se ainda assim achar conveniente, poderia colocar um asterisco ao final do ítem 1 para fazer a referência. E acrescentar que o grunt será instalado localmente com o comando npm install.
• Sugiro reformular para: O comando grunt vai compilar todos os arquivos Sass, fazer o lint (validação) dos scritps e, por fim, concatenar e minificar os mesmos.
• Sugiro reformular para: o comando grunt watch vai observar as mudanças realizadas nas tarefas sass, jshint e uglify. Os arquivos do Sass estão na pasta assets/sass/
• Corrigir o trecho: ...do Odin via ftp para o seu servidor,...
• Uma última observação: poderia ter uma sessão para os alias

[deblynprado]

@vitorbritto

• Esse primeiro item é resquício da edição antiga, matei! ;)
• Misturei os itens 2 e 3 que você propôs com o que eu já tinha escrito
• Fiz a correção, valeu!
• O certo era já estar só o alias. Fiz primeiro com o comando e só depois me liguei nos alias. Substitui tudo no documento pelos alias.

:)

[claudiosanches]

Por enquanto esta tudo ótimo.