wpbrasil / odin

Framework and base theme for development with WordPress.
http://wpod.in
563 stars 196 forks source link

Documentação e website #52

Closed claudiosanches closed 10 years ago

claudiosanches commented 11 years ago

Esta na hora de documentar e ter um website de verdade.

Podemos fazer isso usando o WordPress mesmo, hospedando em algum lugar, ou podemos hospedar no GitHub o site e usar a Wiki que já temos.

Também podemos hospedar no GitHub e fazer um blog/documentação em HTML estático. Para fazer isso da para usar o Jeckyll ou Octopress.

Bom, para quem não sabe o Jeckyll serve para desenvolver blogs usando o GitHub Pages. O Octopress é um sistema um pouco mais treta que faz isso também, mas com suporte de temas, plugins já prontos e etc. Gostei pra caramba dele xD

Documentação do Octopress: http://octopress.org/

Octopress é bem legal, tem gente até migrando do WordPress e usando ele. Todos os posts e páginas são escritos em Markdown e o Octopress converte para HTML, instala temas, configura plugins e fazer deploy pro GitHub xD. E essa é a vantagem, HTML estático, leve, limpo e hospedado de graça no GitHub.

Enfim, podemos usar ele para gerar a nossa documentação. No caso vamos precisar trocar o /blog por /docs e ai esta tudo ok...

Qual a vantagem de usar o Octopress no lugar de WordPress? Vantagem seria ter ele hospedado gratuitamente no GitHub Pages e também que qualquer um do grupo vai poder atualizar ele usando GIT, em vez de distribuir usuário e senha para 100 pessoas xD (além que com GiT, podemos ver o que foi atualizado e por quem).

Vantagem do WordPress eu nem preciso falar né? Todo mundo aqui usa xD

Enfim as opções são:

  1. Criar um site em WordPress e documentar nele.
  2. Criar um site em WordPress e usar a Wiki do GitHub como documentação.
  3. Criar um site no GitHub Pages com Octopress e usar a Wiki do GitHub como documentação.
  4. Criar um site no GitHub Pages com Octopress e documentar nele.
claudiosanches commented 11 years ago

Esqueci de falar xD Eu posso hospedar no WP.

AgtLucas commented 11 years ago

Acho que a documentação poderia ser feita aqui no GitHub mesmo, usando Jekyll ou Octopress...

Por ironia eu acabei de migrar meu blog do WordPress para o Jekyll, ainda estou fazendo alguns ajustes, mas achei legal :)

claudiosanches commented 11 years ago

@AgtLucas eu achei legal pra caramba isso. E como o projeto é aberto mesmo, não precisaria ficar criando login para todo mundo.

AgtLucas commented 11 years ago

Exato, e como é documentação, algo que se atualiza, acredito que seria mais fácil usar um gerador de conteúdo estático mesmo. Eu migrei pro Jekyll pois não estava postando muito e precisava fazer umas economias :dart:

deblynprado commented 11 years ago

Pô eu já tinha ouvido falar nesse Jekyll, mas não cheguei a usar não...

Mas pelo fato do Odin ser desenvolvido para o WP eu acharia melhor ter os showcases em WP e a documentação aqui no Git. Até pq a documentação é mais colaborativa do que o site com o showcase.

A ideia do showcase é só pra sabermos o que andam inventando com o Odin e quem sabe desses showcases tirar algumas ideias para as futuras versões do Odin.

Eu fico com a opção #2.

Ah, eu tenho revenda também. Então não haveria problema em hospedar um site para o Odin ;)

RafaelFunchal commented 11 years ago

Opção 4, com certeza.

"Criar um site no GitHub Pages com Octopress e documentar nele."

Acho que ficaria mais fácil para criar a Wiki e fazer alterações no site quando necessário.

Concordo com o @claudiosmweb , imaginem ter que distribuir usuários de WP para todos os envolvidos?! Acho essa opção inviável.

@deblyn , acho que o showcase pode ser administrado pelo OctoPress também. Acho mais organizado manter tudo no mesmo lugar :)

deblynprado commented 11 years ago

Mas acho que a "colaboração em massa" é só na documentação mesmo. Pra inserir os cases no site acho oque 2 pessoas, no máximo 3 já é bem suficiente.

Sei não, eu acho que talvez a credibilidade fosse maior se a parada estivesse no sistema para o qual foi desenvolvido =P

claudiosanches commented 11 years ago

Realmente, tem esse lado, fazer no WP é melhor por causa disso. Falei de manter no GitHub apenas por ser gratuito e qualquer um poder colocar o dedo xD.

RafaelFunchal commented 11 years ago

Ter uma instalação do WP só para manter o showcase eu acho desperdício, afinal, será apenas imagem e link.

Acho que manter tudo aqui dará menos dor de cabeça.

claudiosanches commented 11 years ago

Mas pensando aqui xD

Se for usar WordPress podemos usar ele para publicar notícias sobre atualizações. Instalar o bbPress para criar fórum de suporte e etc. Daria para fazer coisa pra caramba em vez apenas de ter algumas poucas páginas estáticas.

RafaelFunchal commented 11 years ago

Isso sim justificaria ter um WP :+1:

claudiosanches commented 11 years ago

Pois é, já instala para matar dragões logo xD

deblynprado commented 11 years ago

aeeeee vai ser em WP #todosComemora

Minha revenda aqui é Kinghost... a tua qual é @claudiosmweb ?

claudiosanches commented 11 years ago

Os que eu vendo são da Iweb, mas tenho um servidor que eu posso zuar no Hostgator xD

claudiosanches commented 11 years ago

@deblyn quer instalar ai já que você comprou o domínio? Se não já te passo os meus Name Servers e instalo na hospedagem que eu tenho no HostGator.

Vamos ver de instalar o bbPress e fazer um tema ou instalar o Bootstrap agora no começo.

claudiosanches commented 11 years ago

Alguém tem ideia de layout agora para o começo?

Podemos fazer ele com o Odin mesmo e usar Bootstrap com um desses caras: http://bootswatch.com/

deblynprado commented 11 years ago

Eu faço a instalação aqui mesmo, só pra deixar tudo junto.

Eu acho que layout pra agora podemos ficar com o default do Odin mesmo, coloca o bbPress e depois pensamos em um layout mais robusto.

Hoje ainda faço a instalação e aviso vocês.

claudiosanches commented 11 years ago

Combinado.

deblynprado commented 11 years ago

A instalação tá feita. Vamos rodar ele pelo endereço alternativo e depois de pronto altero o DNS, ok?

http://odin-theme.web817.uni5.net

Eu to com uma conta de admin, o @claudiosmweb vai ficar com outra. Vai ter a necessidade de mais alguma?

RafaelFunchal commented 11 years ago

Acho que com o bbPress não é necessário todos serem administradores.

deblynprado commented 11 years ago

Nunca trabalhei com o bbPress =x

claudiosanches commented 11 years ago

Nunca usei muito também... Mas vamos aprender xD

fdaciuk commented 11 years ago

Tentei acessar aqui, mas não consegui. Tá fora do ar @deblyn?

claudiosanches commented 11 years ago

@fdaciuk se for esse link http://odin-theme.web817.uni5.net esta rolando xD

fdaciuk commented 11 years ago

Agora deu xD

deblynprado commented 11 years ago

tá só com o link temporário por enquanto =P

deblynprado commented 11 years ago

Qual seria nosso próximo passo agora, após ter o domínio funcionando com o WP e Odin? Instalar o bbPress?

Vamos mostrar o máximo de features do Odin no site?

claudiosanches commented 11 years ago

Apontar o domínio mesmo. E vamos escrevendo xD

ruanbarbosa commented 11 years ago

Em relação ao layout, uma outra opção seria foundation (http://foundation.zurb.com/). O que acham? Já funciona com o Compass e a documentação é bem completa.

RafaelFunchal commented 11 years ago

Eu fiz o portfolio adaptando o Odin ao Foundation, mas acho que essa não é a finalidade do tema, que é ter seu próprio grid e, com o tempo, seu "Boostrap" próprio.

ruanbarbosa commented 11 years ago

@rafaelfunchal, seria em relação ao layout do site do odin.

RafaelFunchal commented 11 years ago

Não usaremos o próprio Odin no site?

ruanbarbosa commented 11 years ago

É que comentei em relação ao trecho do @claudiosmweb: "Alguém tem ideia de layout agora para o começo? Podemos fazer ele com o Odin mesmo e usar Bootstrap com um desses caras: http://bootswatch.com/"

RafaelFunchal commented 11 years ago

Eu entendi, @ruanbarbosa . Mas se formos usar um desses Frameworks CSS já existentes, atualmente teremos que mudar bastante coisa no Odin padrão.

Mas se formos para esse lado, por mim beleza.

deblynprado commented 11 years ago

O que acho que falta definirmos mesmo é a "cara" que o site vai ter. Isso que dá só colocar desenvolvedor junto ahahaha.

Mas eu particularmente acho melhor seguirmos no nosso grid e irmos montando nosso bootstrap mesmo...

E procura-se um designer pra nos ajudar =D

claudiosanches commented 11 years ago

É que estou sem tempo se não eu fazia. Mas precisávamos encontrar um designer para fazer uma interface de botões e etc, assim podemos ter o nosso Framework de CSS com SASS. Além que já usamos para os shortcodes e etc. Com o SASS podemos fazer algo que o cara modifique tudo bem fácil.

Ou partir para as viadagens xD Por exemplo, aproveitar agora que temos o site e usar ele para gerar custons builds do Odin. Podemos usar o https://github.com/leafo/scssphp e deixar quem for fazer o download personalizar no site e baixar já com os botões, menus e etc já nas cores que irá usar.

Além que também podemos melhorar a estrutura do Odin. Deixar o Core, SASS e outras coisas em repositórios separados e no Odin juntar tudo com Git Submodule. Até mesmo os plugins que temos dentro do Core do Odin, assim sempre vamos baixar os últimos releases de tudo (Colorbox, bxSlider, Socialite.js, PhotoSwipe, Lazy Load e etc).

RafaelFunchal commented 11 years ago

Tá bom vai, vou assumir essa bagaça. Só não falei nada antes porque tinha uns caras melhores na parada mas já que ninguém falou mais nada. Estou aqui pra isso :)

Aceito sugestões.

claudiosanches commented 11 years ago

xD

Fazer isso com PSD mesmo no começo ou PNG do Fireworks. Eu ajudo, só não vou conseguir parar e fazer algo do zero agora, nem cabeça pra isso eu estou no momento xD

claudiosanches commented 11 years ago

Bom podemos pedir ajuda da galera no Grupo também xD

RafaelFunchal commented 11 years ago

Agora tenho que aprender a instalar o Fireworks no Ubuntu.

Abre um tópico lá, @claudiosmweb , você é mais respeitado kkkkk

claudiosanches commented 11 years ago

Eu uso VM mesmo para abrir PS e FW no Ubuntu xD Quando é rápido eu uso o Pinta ou o GIMP pelo Ubuntu.

Vou abrir xD

luizfreires commented 11 years ago

Comentando muito tarde aqui, mas posso ajudar nessa parte do layout, @rafaelfunchal e @claudiosmweb posso ajudar mais nos fins de semana por causa da faculdade e trabalho, mas vamos tocar isso aí. Quando aos programas, particularmente uso Photoshop, mas sem problemas, só exportar ou uso mesmo o Fireworks.

deblynprado commented 11 years ago

Aeee @rafaelfunchal nosso herói!!! =D

Cara, não sei se é útil pra você ou vai ser útil pra quem baixar o Odin mas se precisar eu posso fazer os wireframes no Balsamiq

E outra parada, seria uma boa ter um UI Kit em PSD depois do layout pronto?

claudiosanches commented 11 years ago

@deblyn pode fazer sim cara, vale apena.

@luizrw pode usar o PS sem problema.

luizfreires commented 11 years ago

Beleza @claudiosmweb. Vamos começar quando, final de semana agora?

claudiosanches commented 11 years ago

Combinado.

deblynprado commented 11 years ago

Quais são os "pages templates" que podemos ter?

Acho que seria uma boa definir isso pra ajudar a galera que vai meter a mão na massa pra criar o layout.

claudiosanches commented 11 years ago

Então, precisamos listar mesmo essas coisas para ajudar a galera. Um amigo meu da facul quer ajudar também.

deblynprado commented 11 years ago

Então, os template-page que eu acho que podem estar:

Form - com todos os tipos de input's, botões e etc Full Width Left Sidebar Right Sidebar Slideshow - mostrando os slides e carroceis do bxSlider Shortcodes - com todos os shorcodes do Odin (depois de prontos)

claudiosanches commented 11 years ago

@deblyn perfeito cara o/