{"id":5579,"date":"2024-10-18T17:05:22","date_gmt":"2024-10-18T15:05:22","guid":{"rendered":"https:\/\/www.lrob.fr\/?p=5579"},"modified":"2024-10-18T17:05:22","modified_gmt":"2024-10-18T15:05:22","slug":"documentation-lrob-migration-de-mediawiki-a-wordpress","status":"publish","type":"post","link":"https:\/\/portail.lrob.fr\/en\/news\/documentation-lrob-migration-de-mediawiki-a-wordpress\/","title":{"rendered":"Documentation LRob : Migration de MediaWiki \u00e0 WordPress"},"content":{"rendered":"<h2 class=\"wp-block-heading\">Remplacer un wiki par WordPress : une solution plus simple pour la documentation<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Chez <strong>LRob<\/strong>, la gestion de la documentation est essentielle, mais elle \u00e9tait jusqu&rsquo;\u00e0 r\u00e9cemment assur\u00e9e par <strong>MediaWiki<\/strong>. Bien que cet outil soit efficace pour des projets collaboratifs, il devient lourd et compliqu\u00e9 \u00e0 g\u00e9rer quand on est seul \u00e0 r\u00e9diger et maintenir la documentation.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">C\u2019est en travaillant sur un site <strong>WordPress<\/strong> aux nombreuses pages utilis\u00e9es comme des cat\u00e9gories que l\u2019id\u00e9e m\u2019est venue : pourquoi ne pas utiliser WordPress pour g\u00e9rer la documentation, sans plugin suppl\u00e9mentaire ?<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Pourquoi passer \u00e0 WordPress ?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>WordPress<\/strong>, qui fait tourner portail.lrob.fr\/, offre d\u00e9j\u00e0 toutes les fonctionnalit\u00e9s de base n\u00e9cessaires pour organiser la documentation, sans avoir \u00e0 installer de plugin suppl\u00e9mentaire. Voici quelques avantages natifs qui m\u2019ont pouss\u00e9 \u00e0 faire la transition :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Hi\u00e9rarchie des pages<\/strong> : Cr\u00e9er des pages et des sous-pages, comme dans un wiki, est tr\u00e8s simple gr\u00e2ce \u00e0 la structure native de WordPress.<\/li>\n\n\n\n<li><strong>Bloc Gutenberg pour l&rsquo;arborescence<\/strong> : Il existe un bloc permettant d\u2019afficher l\u2019arborescence des sous-pages d\u2019une page parente, facilitant la navigation dans la documentation.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Pour compl\u00e9ter cette configuration, j\u2019ai utilis\u00e9 <strong>RankMath SEO<\/strong>, d\u00e9j\u00e0 pr\u00e9sent sur lrob.fr, qui m\u2019a aid\u00e9 \u00e0 int\u00e9grer deux fonctionnalit\u00e9s cl\u00e9s pour un site de documentation :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Breadcrumbs<\/strong> : Un fil d\u2019Ariane pour am\u00e9liorer la navigation et le r\u00e9f\u00e9rencement.<\/li>\n\n\n\n<li><strong>Sommaire automatique<\/strong> : Un index des titres et sous-titres, id\u00e9al pour des pages bien structur\u00e9es comme dans un wiki.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">En prime, le wiki pourra \u00eatre traduit automatiquement en anglais gr\u00e2ce \u00e0 TranslatePress et l&rsquo;API DeepL qui fait des miracles.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">La transition vers WordPress<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Le 17 Octobre au soir, j\u2019ai donc transf\u00e9r\u00e9 la documentation sur WordPress. L&rsquo;\u00e9diteur de blocs <strong>Gutenberg<\/strong> a rendu le processus facile, en conservant les titres, listes, et liens lors du copier-coller depuis MediaWiki. Ensuite, j\u2019ai mis en place des <strong>redirections 301<\/strong> du wiki vers les nouvelles pages de documentation sur WordPress, puis j&rsquo;ai d\u00e9sactiv\u00e9 l&rsquo;ancien wiki.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ce matin, j\u2019ai profit\u00e9 de cette migration pour r\u00e9organiser et am\u00e9liorer une partie de la documentation, avec une mise en page plus claire et plus moderne, tout en ajoutant des liens internes pour une meilleure navigation.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Un r\u00e9sultat plus simple et efficace<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Le passage \u00e0 <strong>WordPress<\/strong> simplifie la gestion de la documentation. Non seulement cela m\u2019a permis d&rsquo;\u00e9liminer les lourdeurs de maintenance de MediaWiki, mais c\u2019est aussi une solution plus flexible et facile \u00e0 utiliser pour moi, tout en offrant un contenu plus accessible \u00e0 mes clients.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Gr\u00e2ce \u00e0 <strong>RankMath SEO<\/strong>, la documentation est mieux structur\u00e9e et plus optimis\u00e9e pour le SEO, ce qui devrait am\u00e9liorer sa visibilit\u00e9 en ligne.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Vous pouvez consulter la nouvelle documentation ici : <a href=\"https:\/\/portail.lrob.fr\/en\/doc\/\">https:\/\/portail.lrob.fr\/doc\/<\/a><\/p>","protected":false},"excerpt":{"rendered":"<p>Remplacer un wiki par WordPress : une solution plus simple pour la documentation Chez LRob, la gestion de la documentation est essentielle, mais elle \u00e9tait jusqu&rsquo;\u00e0 r\u00e9cemment assur\u00e9e par MediaWiki. Bien que cet outil soit efficace pour des projets collaboratifs, il devient lourd et compliqu\u00e9 \u00e0 g\u00e9rer quand on est seul \u00e0 r\u00e9diger et maintenir [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":5511,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[40,39],"tags":[],"class_list":["post-5579","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-blog","category-news"],"_links":{"self":[{"href":"https:\/\/portail.lrob.fr\/en\/wp-json\/wp\/v2\/posts\/5579","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/portail.lrob.fr\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/portail.lrob.fr\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/portail.lrob.fr\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/portail.lrob.fr\/en\/wp-json\/wp\/v2\/comments?post=5579"}],"version-history":[{"count":0,"href":"https:\/\/portail.lrob.fr\/en\/wp-json\/wp\/v2\/posts\/5579\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/portail.lrob.fr\/en\/wp-json\/wp\/v2\/media\/5511"}],"wp:attachment":[{"href":"https:\/\/portail.lrob.fr\/en\/wp-json\/wp\/v2\/media?parent=5579"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/portail.lrob.fr\/en\/wp-json\/wp\/v2\/categories?post=5579"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/portail.lrob.fr\/en\/wp-json\/wp\/v2\/tags?post=5579"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}