Afficher la pageAnciennes révisionsLiens de retourHaut de page Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu’il s’agit d’une erreur. {{indexmenu_n>10}} # Documentation (doc.picasoft.net) <bootnote warning>On suppose que vous êtes connecté au domaine `stph` du serveur MyScenari et en mode `Explorateur` (sinon voir [[technique:adminserv:sites:picasoft]]</bootnote> ## Modifier un module existant Pour mettre à jour un élément de documentation qui existe déjà, rendez-vous dans l'atelier `picasoft-dokiel`. On trouve les différents modules existants (documentation de Mattermost, documentation de AIL...). {{ :technique:adminserv:sites:scenari_dokiel_arb.png |}} Mettre à jour les fichiers concernés. Souvent, il s'agira de modifier un fichier `.scen` ou d'en ajouter un pour ajouter une nouvelle section. Une fois les modifications effectués, se rendre sur le fichier `.pub` du module. Vérifier via la prévisualisation que vos modifications sont correctement apportées. Exemple pour Mattermost : {{ :technique:adminserv:sites:scenari_dokier_prev.png |}} //[Copie d'écran correspondant à la version 4 de Scenari, obsolète ; dans la version 6 choisir l'onglet `Relecture` ou `Prévisualisation`]// Une fois que l'on est satisfait·e, on peut `Générer` une archive contenant les fichiers du module. {{ :technique:adminserv:sites:scenari_dokiel_generate.png |}} //[Copie d'écran correspondant à la version 4 de Scenari, obsolète ; dans la version 6 choisir l'onglet `Publications` tout en bas à gauche]// On clique ensuite sur `Télécharger` pour télécharger l'archive. ## Ajout d'un nouveau module ### Rédaction du module dans Dokiel Pour ajouter de la documentation sur un nouveau service, par exemple. Commencer par créer un nouveau dossier dans l'atelier Dokiel depuis l'arborescence. {{ :technique:adminserv:sites:scenari_dokiel_create_space.png |}} Ajouter un guide utilisateur, qui sera la base du module (clic droit → créer un item). Exemple : {{ :technique:adminserv:sites:scenari_dokiel_create_guide.png |}} Ajoutez lui un titre et une première section, sans quoi il subsiste des erreurs. Exemple : {{ :technique:adminserv:sites:scenari_dokiel_add_section.png |}} Construire votre documentation, puis pour finir, ajouter un guide web (utilisé pour la génération). Exemple : {{ :technique:adminserv:sites:scenari_dokiel_add_pub.png |}} Générer et télécharger l'archive, comme pour une modification classique. ### Mise à jour de la page d'accueil dans Optim Se connecter sur l'atelier `picasoft-optim`. Se rendre dans le dossier `doc`, puis modifier `doc.website` pour ajouter un lien vers votre nouveau module. Le lien prendra la forme `doc.picasoft.net/modules/<nom_nouveau_module>`. Générer et publier le support web, comme pour le module. ## Mise en ligne du nouveau site Voir [[technique:adminserv:sites:update_from_archive|la page de mise à jour à partir d'une archive Scenari.]] <bootnote warning> Pour mettre à jour le module généré, on copiera les fichiers dans le dossier `modules` du site ! Tandis que pour mettre à jour la page d'accueil du site, on copiera les fichiers à la racine du site. </bootnote> technique/adminserv/sites/doc.txtde crozatst