Atlassian Team ’21 – Toutes les nouveautés et mises à jour produits à connaitre. Lisez notre blog!

logo-bleu_rvb.png
Back

Universal Wiki Converter: transfert de contenu de votre wiki dans Confluence

Que vous le vouliez ou non, le contenu de votre wiki est souvent d’une grande valeur. L’effort mis dans sa création ne devrait pas tomber aux oubliettes. L’idée de transférer le contenu de votre wiki actuel dans votre nouveau wiki peut provoquer quelques sueurs froides, mais si vous souhaitez vous atteler à ce transfert, voici un outil qui vous facilitera la vie: Universal Wiki Converter (UWC).

Qu’est ce qu’Universal Wiki Converter (UWC)?

Peut-être l’avez vous déjà aperçu quelque part dans la page admin de votre Confluence et avez pensé “Je l’utiliserai peut-être un jour” ou “C’est quoi ce truc?” ou  encore, avec un haussement d’épaule: “ça n’a pas d’intérêt!”. C’est également ce que je me suis dit jusqu’au jour où j’ai dû l’utiliser. Pour faire court, cet outil permet de convertir beaucoup de Wiki en pages compatibles avec Confluence. Développé par Atlassian et repris par AppFusions pour Confluence 4+ (bye bye wiki markup, Hello XHTML), il s’avère très utile pour transférer du contenu d’un Wiki dans Confluence en simplifiant le processus. La plupart de l’automatisation se fait grâce à des scripts qui sont déjà contenus dans l’outil.

Voici une courte explication de comment convertir un MediaWiki en page Confluence avec Mac OS. C’est aussi possible dans Linux et Windows.

Le MediaWiki auquel j’ai été confronté était écrit en PHP, mais ceci ne nous concerne pas pour le moment – grâce à l’outil ! Cependant, UWC ne supporte pas tous les wikis, vous devez donc connaître le type de Wiki que vous convertissez. Voici une liste des Wikis actuellement supportés par UWC :

  • TWiki
  • PmWiki
  • DokuWiki
  • Mediawiki
  • MoinMoin
  • Jotspot
  • Tikiwiki
  • Jspwiki
  • Sharepoint
  • SWiki
  • Vqwiki
  • XWiki
  • Trac
  • SMF
  • Socialtext
  • Mindtouch
  • upload a directory of documents
  • Jive

Vous pouvez également retrouver cette liste ici.

Etape 1: Télécharger UWC

Cliquez ici pour télécharger une version zippée de UWC.

Votre machine locale devra pouvoir se connecter à la base de donnée de MediaWiki, il est donc recommandé de l’utiliser sur le réseau de votre entreprise.

Exécuter uwc.jar en double cliquant sur le fichier OU ouvrez le terminal et éxecutez run_uwc_on_mac.sh

./run_uwc_on_mac.sh

 

Screen Shot 2015-03-02 at 15.43.18

Vous aurez besoin d’avoir Java installé sur votre machine locale pour pouvoir ouvrir l’interface utilisateur.

Etape 2: Editer le dossier exporter

D’abord, nous devons exporter les données de l’ancien Wiki. Ceci peut être fait en éditant le dossier exporter qui se trouve sous le dossier conf. Seulement certains wikis requièrent l’édition du dossier pour le connecter à la base de données. D’autres wikis ont un outil qui permet de l’exporter de l’interface utilisateur directement.

Dans ce scénario, nous éditerons exporter.mediawiki.properties .

Dans ce fichier, il faut définir certains paramètres. Ils déterminent l’étendue du détail dans votre export. Vous pouvez consulter ici la liste de tous ces paramètres et comment les définir.

Une fois les paramètres définis, cliquer sur Exporter. Ceci fera l’export avec l’emplacement de destination que vous aurez défini dans le fichier de propriétés.

Etape 3: Editer le fichier converti

Une fois les pages exportées, vous devrez éditer le fichier convertisseur qui se trouve sous le fichier conf et y définir tous les paramètres (qu’est ce qui doit être converti et comment) . Cliquez ici pour des conseils.

Dans ce cas, le dossier va être converter.mediawiki.properties.

Si vous souhaitez garder des dates et identifiants identiques à ceux dans Mediawiki, je vous suggère de prendre une sauvegarde de votre Confluence actuel (en partant du principe ce sont les mêmes identifiants et mots de passe qui sont utilisés), et le restaurer sur votre instance Confluence locale avant tout. Ensuite, ajoutez le plugin UDMF Plugin.
Pour convertir la mise en page des tableaux et l’avoir identique à celle de MediaWiki, vous devrez ajouter Content Formatting plugin à votre Confluence local, selon le résultat souhaité.

Etape 4: Tester la connexion avec votre instance Confluence

Une fois ceci déterminé, il ne vous reste plus qu’à définir les paramètres de Confluence. Cela inclut l’URL – localhost:8080 dans notre cas- , identifiant et mot de passe avec la clé de l’espace Confluence où toutes les données de MediaWiki seront ajoutées.

Une fois tout les détails définis, vous pouvez tout simplement glisser et déposer les pages de l’export à la section Pages dans UWC.  Si vous avez également des pièces jointes, vous pouvez définir le chemin à suivre.

Screen Shot 2015-03-02 at 16.07.20

Vous pouvez tester la connection à Confluence en allant dans “Other tools”.

Screen Shot 2015-03-02 at 16.05.26

Vous êtes maintenant prêt pour la conversion. Cliquez simplement sur “convertir” et laissez la magie opérer.

Quelques notes…

Vous avez peut-être repéré dans le guide fourni par AppFusions que la version supportée de Confluence est 4.3.7. Ne vous en souciez pas trop: pour cet exemple, j’ai utilisé la version 5.5.7 de Confluence.

Si votre Confluence est configuré SSL, vous devrez alors installer la clé de certificat de votre keystore Java qui a été utilisée pour exécuter UWC. Vous pouvez trouver plus de détails sur le sujet ici. Une manière simple d’éviter ceci est d’installer une instance Confluence locale et de transférer l’espace entier ensuite.

Si votre instance est hébergée par Atlassian, donc onDemand, vous devrez soit installer le certificat SSL sur votre keystore Java, soit installer une instance locale de Confluence et exporter ensuite l’espace.

Conclusion

En fin de compte, UWC est un très bon outil pour convertir des wikis complexes en pages Confluence. Bien que cela semble être une tâche compliquée, une fois que vous êtes dans le bain, vous verrez que ce n’est pas aussi dur que ce qu’il n’y paraît. A vous de jouer !

Essayez UWC!

Cutted Triangle

Inscrivez-vous à notre newsletter

Demande enregistrée ! Demande en cours... Ceci n'est pas un email Une erreur s'est produite

Conformément à notre politique de confidentialité, nous nous engageons à respecter vos données personnelles

Contactez-nous

Nos consultants certifiés Atlassian se feront un plaisir de vous répondre.

Rejoignez-nous

Nous sommes en train de construire un équipe extraordinaire. Vous en êtes ?

Suivez-nous

Nous utilisons des cookies pour le fonctionnement de ce site, pour améliorer son utilisation, personnaliser votre expérience et réaliser des statistiques de visite. Vous pouvez gérer les paramètres et choisir d’accepter ou non certains cookies durant votre navigation. Pour plus d’informations, consultez notre politique de confidentialité. Nos politique de confidentialité

Paramètres de confidentialité

Afin de faciliter votre navigation et de vous apporter le meilleur service possible, nous utilisons des cookies pour améliorer le site aux besoins des visiteurs, notamment selon la fréquentation.  Pour plus d’informations, consultez notre politique de confidentialité. Nos politique de confidentialité

Recaptcha

Google reCAPTCHA est un système conçu pour distinguer les humains des ordinateurs, de telle sorte que les bots soient incapables de remplir les formulaires de manière malveillante au nom d’un être humain.

Tag Manager

These cookies allow us to employ data analytics via Google Analytics and Google Tag Manager so we can measure and improve the performance of our site and provide more relevant content to you. These cookies don't collect information that identifies a visitor down to an individual level that is available to us. These cookies are not passing personally identifiable information to any external third party other than in limited cases when we engage a service provider to act on our behalf but who is then unable to use the data for their own purposes.

LinkedIn

Cookies pour une publicité ciblée : Ces cookies peuvent être mis en place au sein de notre site Web par nos partenaires publicitaires. Ils peuvent être utilisés par ces sociétés pour établir un profil de vos intérêts et vous proposer des publicités pertinentes sur d'autres sites Web. Ils ne stockent pas directement des données personnelles, mais sont basés sur l'identification unique de votre navigateur et de votre appareil Internet. Si vous n'autorisez pas ces cookies, votre publicité sera moins ciblée.

Cookies "réseaux sociaux" : Ces cookies sont activés par les services proposés sur les réseaux sociaux que nous avons ajoutés au site Web afin de vous donner la possibilité de partager notre contenu avec votre réseau et vos connaissances. Ils nous permettent également de suivre votre navigation sur d’autres sites Web et d’établir un profil de vos intérêts. Cela peut avoir un impact sur le contenu et les messages affichés sur les autres sites Web que vous consultez. Si vous n'autorisez pas ces cookies, il se peut que vous ne puissiez pas utiliser ou visualiser ces outils de partage.