{"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-23T00:46:15","modified_gmt":"2024-10-22T22:46:15","slug":"lrob-documentation-migration-from-mediawiki-to-wordpress","status":"publish","type":"post","link":"https:\/\/www.lrob.fr\/en\/blog\/news\/documentation-lrob-migration-de-mediawiki-a-wordpress\/","title":{"rendered":"LRob Documentation: Migrating from MediaWiki to WordPress"},"content":{"rendered":"<h2 class=\"wp-block-heading\">Replacing a wiki with WordPress: a simpler solution for documentation<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">At <strong>LRob<\/strong>Documentation management is essential, but until recently was handled by <strong>MediaWiki<\/strong>. Although this tool is effective for collaborative projects, it becomes cumbersome and complicated to manage when you're the only one writing and maintaining documentation.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Working on a site <strong>WordPress<\/strong> to the numerous pages used as categories that the idea came to me: why not use WordPress to manage documentation, without the need for an additional plugin?<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Why switch to WordPress?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>WordPress<\/strong>which runs www.lrob.fr, already offers all the basic functionality needed to organize documentation, without having to install any additional plugins. Here are some of the native advantages that prompted me to make the switch:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Page hierarchy<\/strong> Creating pages and sub-pages, as in a wiki, is very simple thanks to WordPress' native structure.<\/li>\n\n\n\n<li><strong>Gutenberg block for tree structure<\/strong> A block is available to display the sub-page tree of a parent page, making it easier to navigate through the documentation.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">To complete this configuration, I used <strong>RankMath SEO<\/strong>already present on lrob.fr, who helped me integrate two key features for a documentation site:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Breadcrumbs<\/strong> A breadcrumb trail to improve navigation and referencing.<\/li>\n\n\n\n<li><strong>Automatic summary<\/strong> An index of headings and subheadings, ideal for well-structured pages such as a wiki.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">As a bonus, the wiki can be automatically translated into English thanks to TranslatePress and the DeepL API, which works wonders.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">The transition to WordPress<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">On the evening of October 17th, I transferred the documentation to WordPress. The block editor <strong>Gutenberg<\/strong> made the process easy, preserving titles, lists and links when copying and pasting from MediaWiki. Next, I set up <strong>301 redirects<\/strong> from the wiki to the new WordPress documentation pages, then deactivated the old wiki.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This morning, I took advantage of the migration to reorganize and improve part of the documentation, with a clearer, more modern layout, while adding internal links for better navigation.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Simpler, more efficient results<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The switch to <strong>WordPress<\/strong> simplifies documentation management. Not only has this enabled me to eliminate the cumbersome maintenance of MediaWiki, it's also a more flexible and easy-to-use solution for me, while offering more accessible content to my customers.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Thanks to <strong>RankMath SEO<\/strong>The documentation is better structured and more optimized for SEO, which should improve its online visibility.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can consult the new documentation here : <a href=\"https:\/\/www.lrob.fr\/en\/doc\/\">https:\/\/www.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":[4,5],"tags":[],"class_list":["post-5579","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-news","category-blog"],"_links":{"self":[{"href":"https:\/\/www.lrob.fr\/en\/wp-json\/wp\/v2\/posts\/5579","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.lrob.fr\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.lrob.fr\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.lrob.fr\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.lrob.fr\/en\/wp-json\/wp\/v2\/comments?post=5579"}],"version-history":[{"count":3,"href":"https:\/\/www.lrob.fr\/en\/wp-json\/wp\/v2\/posts\/5579\/revisions"}],"predecessor-version":[{"id":5736,"href":"https:\/\/www.lrob.fr\/en\/wp-json\/wp\/v2\/posts\/5579\/revisions\/5736"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.lrob.fr\/en\/wp-json\/wp\/v2\/media\/5511"}],"wp:attachment":[{"href":"https:\/\/www.lrob.fr\/en\/wp-json\/wp\/v2\/media?parent=5579"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.lrob.fr\/en\/wp-json\/wp\/v2\/categories?post=5579"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.lrob.fr\/en\/wp-json\/wp\/v2\/tags?post=5579"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}