Come contribuire

Prima di tutto si deve installare tutto l'ambiente DocBook per provare a tradurre i propri XML in HTML o PDF o qualcos'altro. Quindi si deve mettere su un client CVS.

Se si sta lavorando in un ambiente UNIX o simile, ed in particolare Linux, questi strumenti vengono di default o sono comunque facilmente recuperabili dalla proprio CD di installazione o su Internet.

Anche per Windows ci sono dei pacchetti gratuiti per accedere ad un server CVS ee gestire XML DocBook, ma questi devono essere scaricati dalla rete.

Una volta installato pienamente CVS e DocBook si può scaricare tutta la documentazione XML di Blender e lavorarci!

Se si vuole contribuire con modifiche, aggiunte o correzioni alla documentazione di Blender, si preferisce riceverle come patches ai file XML/DocBook. Acquisire qualche conoscenza base sull'uso di CVS, è semplice. Ecco come lo si fa:

Prima di tutto, prima di iniziare a lavorare, ci si allinea all'ultimo albero di CVS e si lavora direttamente con tali file. Le modifiche vengono effettuate nel repository CVS quasi giornalmente e non si vuol lavorare su file sorpassati. Gli aggiornamenti sono rapidi dato che nella propria workstation vengono scaricate solo le modifiche.

Quando pronti, si possono eseguire i seguente comando:

cvs diff -u -w BlenderManual.xml > BlenderManual.xml.diff

Le differenze tra la propria copia locale e la copia nel repository CVS verranno immagazzinate in BlenderManual.xml.diff. Se si vogliono presentare più patch, si prega di fare un diff per ciascun file separatamente e spedirle alla mailing list di DocBoard.