On Tue, 26 Jul 2011 16:54:04 +0200 Kevin CARDINEAUD <cardineaud@codelutin.com> wrote:
Bonjour, Dernièrement certains changements dans ScmWebEditor ont été effectués. Ces changements ont des conséquences sur l'utilisation de l'application avec les sites Maven. Les URLs et les paramètres envoyés par les sites Maven à ScmWebEditor ne sont plus compatibles avec la nouvelle version. Pour utiliser ScmWebEditor avec les sites Maven, il va donc falloir modifier le plugin de génération de site.
Premièrement, je crois qu'il y a une grosse confusion des genres : ScmWebEditor tel qu'il existe à l'heure actuel est un simple éditeur de contenu svn et donc n'a rien à voir avec un site maven... Si on veut pouvoir utiliser ça dans un maven il faut mettre en place des choses pour que scmwebeditor comprennent Maven et notamment la structure des sites maven avec les convention utilisées pour l'emplacement des fichiers selon la langue (si elle est par défaut), ... et pleins d'autres choses. J'avait proposé la notion de résolver d'url (mais ça a du passer à la trappe... :(). L'idée : on définit des layout d'url svn et ensuite scmwebeditor sait selon la layout utilisé + le paramétrage comment reconstruire l'url complête. Example : svn.layout=maven-site-rst svn.root=http://svn.nuiton.org/svn/scmwebeditor svn.locale=fr_FR svn.defaultLocale=fr_FR svn.path=index.rst => http://svn.nuiton.org/svn/scmwebeditor/src/site/rst/index.rst pour une locale non par défaut : svn.layout=maven-site-rst svn.root=http://svn.nuiton.org/svn/scmwebeditor svn.locale=en svn.defaultLocale=fr_FR svn.path=index.rst => http://svn.nuiton.org/svn/scmwebeditor/src/site/en/rst/index.rst Même idée pour le fichier site.xml : svn.layout=maven-site-site.xml svn.root=http://svn.nuiton.org/svn/scmwebeditor svn.locale=fr_FR svn.defaultLocale=fr_FR http://svn.nuiton.org/svn/scmwebeditor/src/site/site.xml pour une locale non par défaut : svn.layout=maven-site-site.xml svn.root=http://svn.nuiton.org/svn/scmwebeditor svn.locale=en svn.defaultLocale=fr_FR => http://svn.nuiton.org/svn/scmwebeditor/src/site/site_en.xml Pour moi je vois deux layout à implanter : celui pour les fichiers site.xml celui pour les fichiers de docs (rst, apt, ...)
Une des solutions proposées serait un changement de la structure des sites Maven. L'idée est que chaque version du logiciel aurait sa version de la documentation accessible depuis le site Maven, cette documentation serait déployée, dans un répertoire du site à la racine avec comme nom, le numéro de la version, au moment de la release de la version, depuis les fichiers qui se trouvent dans le tag de la version correspondante. les documentations des versions stables ne seront pas modifiables. La documentation principale serait déployée depuis les fichiers qui sont dans le trunk du SVN, ce sont ces fichiers que l'on pourrait modifier avec ScmWebEditor. La question est : est-il plus intéressant de redéployer la documentation, depuis le trunk, une fois par jour, sachant que l'utilisateur ne verra pas les modifications immédiatement, ou serait-il préférable de redéployer seulement le fichier modifié, à chaque commit ?
Oui mais cela ne résoud en rien le problème car on doit au moment de la génération du site savoir faire le lien entre la page à afficher et le svn correspondant... Bref, il faut il me semble qu'on en rediscute lors d'une réunion et surtout pas par mail...
Kevin CARDINEAUD
-- Tony Chemit -------------------- tél: +33 (0) 2 40 50 29 28 email: chemit@codelutin.com http://www.codelutin.com