Mudanças entre as edições de ":WWW"

De Stoq Wiki
Ir para: navegação, pesquisa
Linha 7: Linha 7:
 
O primeiro passo é fazer um checkout do site do stoq:
 
O primeiro passo é fazer um checkout do site do stoq:
  
* bzr co bzr+ssh://dragon/var/www/stoq.com.br/stoqwww/
+
bzr co bzr+ssh://dragon/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 ===
 
=== Organização do site ===
Linha 49: Linha 55:
 
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.
 
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.
  
O Django possui um script que auxilia na gerencia das traduções. Na raiz do site, existe um script chamado manage.py. Vc pode executar:
+
Para atualizar e compilar arquivos de tradução, execute:
 
 
./manage.py help
 
 
 
para ver uma lista dos comandos oferecidos. Os que nos interessam agora são: makemessages e compilemessages
 
 
 
Para atualizar os arquivos.po contendo as traduções, execute:
 
 
 
./manage.py makemessages -a -e txt,html
 
 
 
E após atualizar esses arquivos de tradução, execute:
 
 
 
./manage.py compilemessages
 
  
para compilar as traduções.
+
  make
  
 
=== Testando as modificações ===
 
=== Testando as modificações ===
Linha 69: Linha 63:
 
Outra facilidade oferecida pelo Django é um servidor para poder testar as modificações. Para usá-lo rode:
 
Outra facilidade oferecida pelo Django é um servidor para poder testar as modificações. Para usá-lo rode:
  
* ./manage.py runserver
+
make runserver
  
 
Depois disso, vc poderá acessar o site pelo endereço: http://127.0.0.1:8000/
 
Depois disso, vc poderá acessar o site pelo endereço: http://127.0.0.1:8000/
Linha 77: Linha 71:
 
Depois de feitas as modificações, basta fazer um commit para o branch principal:
 
Depois de feitas as modificações, basta fazer um commit para o branch principal:
  
* bzr ci
+
make update

Edição das 18h31min de 3 de outubro de 2008

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://dragon/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