TLDR

Sauce : https://github.com/mbround18/wikijs-module-meilisearch

Le logiciel

Qu'est-ce que Meilisearch

Meilisearch est un moteur de recherche open source conçu pour la rapidité et la simplicité. Écrit en Rust, il est conçu pour fournir des résultats de recherche rapides et pertinents avec une configuration minimale. Meilisearch excelle dans la recherche en texte intégral et est optimisé pour les performances, même avec de grands ensembles de données. Il prend en charge des fonctionnalités telles que la tolérance aux fautes de frappe et le classement de pertinence personnalisable dès la sortie de la boîte.

Lien vers Meilisearch

Qu'est-ce que WikiJS

Wiki.js est un logiciel wiki moderne et open source qui offre une plate-forme puissante et flexible pour gérer et partager du contenu. Construit sur Node.js, il est conçu pour être léger, rapide et facile à utiliser, avec une interface élégante et intuitive qui le rend accessible aux utilisateurs de tous niveaux.

Lien vers Wikijs

Comment intégrer les deux

Conditions préalables

• Exécution de l'instance de Meilisearch
• Exécution d'une instance de wikijs

Si vous ne les avez pas, vous pouvez utiliser ce docker compose.

Utilisation du docker composer

1. Téléchargez le docker compose dans un répertoire.
2. Créez un dossier appelé pkg
3. Créez un dossier appelé tmp
4. Créez un dossier appelé config.
5. Dans le dossier config, pour cette démo téléchargez cette config
6. Exécutez Docker Compose Up pour qu'il génère les fichiers selon vos besoins.

Installation du module

1. Accédez au module qui les intègre sur github.com/mbround18/wikijs-module-meilisearch
2. Accédez à l'onglet des versions
3. Sur la dernière version, téléchargez le fichier Meilisearch.zip.
4. Extrayez le zip dans /wiki/server/modules/search/meilisearch sur votre serveur wikijs. Si vous utilisez composer, docker compose et extrayez le fichier zip dans votre dossier ./pkg.
5. Redémarrez votre serveur wikijs.

Mise en place du module.

Il est recommandé pour une instance de production de demander à Meilisearch de générer une nouvelle clé que votre application pourra utiliser. Vous pouvez le faire via cette commande curl :

curl --request POST \
  --url http://localhost:7700/keys \
  --header 'Authorization: Bearer demo' \
  --header 'Content-Type: application/json' \
  --data '{
    "description": "Wikijs Integration",
    "actions": ["*"],
    "indexes": ["wiki_index"],
    "expiresAt": "2042-04-02T00:42:42Z"
}'

remplacez le mot démo par votre clé principale. Si vous suivez Docker Compose, cela fonctionnera uniquement avec une démo. Sauf si vous l'avez modifié dans le fichier de composition. Utilisez ensuite ce que vous avez défini pour $MEILI_MASTER_KEY.

1. Connectez-vous à votre instance wikijs, pour composer une démo, vous devrez peut-être créer la connexion initiale. N'oubliez pas de définir l'URL sur http://localhost:3000 sur cet écran de configuration initial.
2. Accédez au tableau de bord d'administration.
3. Cliquez sur Moteur de recherche
4. Activer Meilisearch
5. Ajustez la clé API et l'hôte selon vos besoins.
6. Cliquez sur Appliquer. Si vous ne recevez pas de message vert, cliquez simplement à nouveau sur Appliquer. Cela peut se produire en raison du blocage de la tâche dans Meilisearch lors de la création de l'index.

Sa configuration, et maintenant ?

Vous pouvez maintenant commencer à utiliser Meilisearch pour rechercher votre wiki ! Si vous avez du contenu existant, vous pouvez cliquer sur reconstruire et tout votre contenu devrait être ajouté à meilisearch ! :)

Comme vous utilisez wikijs normalement, il créera, mettra à jour et supprimera des documents dans Meilisearch dans le cadre du rendu normal des pages.

Si vous voulez voir un exemple en direct de cela, sur mon wiki Donjons et Dragons, nous l'avons déjà intégré. Il a été incroyable de rappeler les données de personnages ou de scènes du bout des doigts en un instant.

Remarque sur la mise en œuvre, actuellement les suggestions correspondent aux lignes. À l'avenir, je réécrirai ce segment pour le tronquer et avoir des suggestions plus petites.