[Tsp-devel] Apache Forrest

[Stephane Galles]

Pour la doc, une petite suggestion :

Je ne sais pas si cela conviendrait, mais j'ai utilisé un truc il y a 
pas longtemps,
qui est à la fois trés simple à mettre en oeuvre, mais le résultat est 
trés pro.

Mais surtout, pour un même source de doc, on peut générer un site web 
complet,
des PDF, du TXT, et je ne sais quoi encore.

La rédaction se fait en XML, la syntaxe est très simple et le framework 
génère
tout le reste.

C'est :

http://forrest.apache.org/

Le site de Forrest est lui même fait avec Forrest, et un nombre de plus 
en plus grands de sites sont
faits avec Forrest.

On peut générer un PDF de la totalité du site, ou bien page par page 
(cliquez sur
le lien PDF en haut à droite dans les sites). On peut également obtenir 
les pages en TXT

De plus, on trouve des modules pour faires les pages typiques que l'on 
retrouve dans ce genre de
doc, genre FAQ : http://jakarta.apache.org/tapestry/faq.html, ou 
historique des changements.

L'intéret d'avoir des targets en TXT est que l'on peut les distribuer 
avec les sources (pour
les fichiers TODO, FAQ, README, etc...) en ayant un seul doc à gérer, on 
met tout à jour
en même temps. Même les tableaux que l'on peut faire rendent très bien 
en TXT.

Cela vaut le coup de l'essayer, car en 10 minutes téléchargement 
compris, vous avec une première
version de votre site grâce au template par défaut distribué, et donc 
également, une première version
de vos PDF.

De plus, le framework a un mode 'serveur' qui vous permet de voir en 
temps réel vos modif sur le XML. Puis
après vous pouvez générer vos pages en statique (en mode serveur vous 
vous connectez au serveur et à chaque fois
que vous modifier le XML et que vous voulez voir le résultat, vous faite 
refresh dans votre navigateur)

Quelques site faits avec Forrest :
http://forrest.apache.org/live-sites.html


A+

Steph G.



Erk wrote:

> Sinon orienté utilisateur et qui se gère bien en conf
> y'a aussi HTML pur.
>
> Ca s'édite peinard en WYSIWYG avec Nvu (http://www.nvu.com/) ou ses amis
> et puis c'est du texte donc assez bien géré par CVS.
>
>
> Erk
>
> Le 05/12/05, Stef Euskadi<address@hidden> a écrit :
>  
>
> > Je m'attendais à ce genre de réponse.
> > Je partirais plutôt sur un truc de haut niveau (cad pas XML et vi), plutôt
> > orienté utilisateur.
> > OK pour OpenOffice. Je propose quelque chose.
> > Stef
> >
> >
> >
> > Le 05/12/05, Erk <address@hidden> a écrit :
> >    
> >
> > > Le 05/12/05, Stef Euskadi<address@hidden> a écrit :
> > >      
> > >
> > > > Moi aussi j'ai des remarques ci-après.
> > > >
> > > > Sinon, j'aimerais centraliser ce genre de remarques dans un fichier
> > > >        
> > quelconque.
> >    
> >
> > > > XLS ? Comme ça, vous pouvez l'enrichir.
> > > >        
> > > Très bonne idée le fichier qui regroupe toutes ces  TODO/Remark
> > >
> > > Mais comment dire, un fichier excel ....hum
> > > sans vouloir faire mon intégriste de base je préfèrerais
> > > un format plus "ouvert" :))
> > >
> > > Genre un format OpenOffice .sxc voire un bête fichier
> > > texte ou XML pourquoi pas, comme ça on peut
> > > -  le lire avec n'importe quoi y compris 'vi'
> > > -  le gérer en conf à la racine de gdisp+
> > >
> > > Mais comme d'habitude ... ce n'est que mon avis :))
> > > Erk
> > >
> > >      
> >
> > --
> > --
> > Euskadi.
> >    
>
>
> --
> Erk
>
>
> _______________________________________________
> Tsp-devel mailing list
> address@hidden
> http://lists.nongnu.org/mailman/listinfo/tsp-devel
>
>
>