Récupérer du code localement

Créer une nouvelle branche en local:

$ bzr branch sftp://<login>@code.filyb.info/~/code/<my_project>

Récupérer pour la première fois des modifications distantes:

$ bzr pull sftp://<login>@code.filyb.info/~/code/<my_project>

Les fois suivantes:

$ bzr pull

Travailler localement sur le code

Ajouter un fichier au dépôt:

$ bzr add <fichier>

Enregistrer une modification:

$ bzr commit -m <description>

Envoyer du code sur le dépôt

La première fois:

$ bzr push sftp://<login>@code.filyb.info/~/code/<my_project>

Les fois suivantes:

$ bzr push

Téléchargement anonyme du code

Le code du dépôt bazaar peut être téléchargé anonymement par la commande suivante:

$ bzr branch http://code.filyb.info/<my_project>

De plus, le code peut être parcouru par le web à l'adresse suivante:

http://code.filyb.info/<my_project>

Publier le dépôt sur la Forge

RstForge permet de créer simplement un site sur la forge du serveur. Il suffit de créer à la racine du dépôt un répertoire www, et d'y placer des fichiers au format reStructuredText (la racine correspondra au fichier index.rst).

RstForge fait un rendu html de ces fichiers et peut le faire pour de la documentation inclue hors du répertoire www (n'importe quel fichier rst dans le dépôt).

Par contre, une fois les fichiers pushé sur le serveur, il ne faut pas oublier de faire un up sur le serveur, pour que RstForge puisse lire les fichiers ! Cela peut se faire à distance, avec la commande :

$ ssh <login>@code.filyb.info forgeup <my_project>

ou plus simplement en installant le plugin Bazaar bzr_forgeup.py : téléchargez le fichier, et placez-le dans votre répertoire ~/.bazaar/plugins/. C'est tout, au prochain bzr push, la commande forgeup sera automatiquement lancée sur le serveur.

Il est possible de prévisualiser localement les pages avant de les envoyer sur le serveur. Pour cela, avec le paquet python-docutils d'installé, on peut utiliser le script forgepreview :

$ forgepreview index.rst

Ajouter la gestion des bugs

RstForge s'intègre avec Ditz, un gestionnaire de bugs décentralisé.

Pour l'utiliser la première fois:

$ echo ".ditz-config" >> .bzrignore
$ echo "bugs/html" >> .bzrignore
$ bzr add .bzrignore
$ ditz init
$ ditz add-release
$ bzr add bugs

(pour que votre utilisation de Ditz soit compatible avec RstForge, le répertoire bugs doit se nommer bugs)

Pour ajouter un bug:

$ ditz add

Pour en clôturer un:

$ ditz close <bugid>

Pour voir les bugs actuels:

$ ditz

Pour que les bugs soient consultables sur RstForge, il faut générer la sortie html dans bugs/html sur le serveur. Ça tombe bien, c'est fait via le plugin bzr_forgeup.py ou via la commande:

$ ssh <login>@code.filyb.info forgeup <my_project>