:WWW

De Stoq Wiki
Revisão de 18h32min de 3 de outubro de 2008 por Johan Dahlin (Discussão | contribs)

(dif) ← Edição anterior | Revisão atual (dif) | Versão posterior → (dif)
Ir para: navegação, pesquisa

Esta página contém instruções básicas sobre como atualizar o site www.stoq.com.br

Para modificar o site, é necessário ter o django 1.0 instalado. vc pode encontrá-lo aqui: https://bugs.launchpad.net/~django-nightly-ppa/+archive

Checkout

O primeiro passo é fazer um checkout do site do stoq:

bzr co bzr+ssh://www.stoq.com.br/var/www/stoq.com.br/stoqwww/

Depois precisa preparar o repositorio para poder ver ele localmente:

make setup

Depos está pronto para hackear o site.

Organização do site

Dentro da pasta stoqwww encontramos 3 diretórios importantes:

  • locale: Contém as traduções para os diversos idiomas
  • media: Arquivos estáticos (imagens, css, javascript, etc) devem vir aqui, em especial:
    • screenshots: Screenshots dos aplicativos
    • gallery: Javascript da galeria de screenshots
  • main: É onde o site do stoq realmente fica.
    • pages: Conteúdo das páginas.
    • templates: Estruturas das páginas.


Atualizando o conteúdo

Dentro do diretório pages, vc irá encontrar vários arquivos.txt e diretórios. Cada pagina no stoq corresponde a um desses arquivos, por exemplo: http://www.stoq.com.br/download corresponde ao arquivo download.txt e http://www.stoq.com.br/more/features exibirá o conteúdo do arquivo more/features.txt

Esses arquivos usam um template chamado textile [1]. Veja o site para referencias.

Para adicionar uma página nova, basta criar um novo arquivo nessa pasta.

Atualizando traduções

O texto nos templates deve estar marcado da seguinte forma:

{% trans "This is the title." %}

Com o texto a ser traduzido em uma única linha ou

{% blocktrans %}
This string will have
inside.
{% endblocktrans %}

com o texto podendo estar dividido em várias linhas. No momento, parece existir um bug no django que não está funcionando o blocktrans.

Para atualizar e compilar arquivos de tradução, execute:

 make

Testando as modificações

Outra facilidade oferecida pelo Django é um servidor para poder testar as modificações. Para usá-lo rode:

make runserver

Depois disso, vc poderá acessar o site pelo endereço: http://127.0.0.1:8000/

Enviando as modificações

Depois de feitas as modificações, basta fazer um commit para o branch principal:

make update