總長DR

醬：https://github.com/mbround18/wikijs-module-meilisearch

軟體

什麼是美麗搜索

Meilisearch 是一個為速度和簡單性而建立的開源搜尋引擎。它用 Rust 編寫，旨在以最少的配置提供快速、相關的搜尋結果。 Meilisearch 擅長全文搜索，並且針對效能進行了最佳化，即使對於大型資料集也是如此。它支援開箱即用的功能，例如拼字錯誤容忍和可自訂的相關性排名。

美麗搜尋連結

什麼是 WikiJS

Wiki.js 是一款現代化的開源 wiki 軟體，為管理和分享內容提供了強大且靈活的平台。它基於 Node.js 構建，設計輕量、快速且易於使用，具有時尚直覺的介面，適合所有技能水平的用戶使用。

連結至 Wikijs

如何整合兩者

先決條件

• 美麗搜尋運行實例
• 運行 wikijs 實例

如果你沒有這些，你可以使用這個docker compose。

使用 docker 撰寫

1. 將 docker compose 下載到目錄中。
2. 建立一個名為pkg的資料夾
3. 建立一個名為 tmp 的資料夾
4. 建立一個名為config的資料夾。
5. 在設定資料夾中，對於此演示，下載此配置
6. 運行 docker compose up 以使其根據需要產生檔案。

安裝模組

1. 導航到 github.com/mbround18/wikijs-module-meilisearch 上整合它們的模組
2. 導覽至發布標籤
3. 在最新版本上下載Meilisearch.zip 檔案。
4. 將 zip 解壓縮到 wikijs 伺服器上的 /wiki/server/modules/search/meilisearch。如果您使用 compose，請 docker compose down 並將 zip 檔案解壓縮到您的 ./pkg 資料夾中。
5. 重新啟動您的 wikijs 伺服器。

設定模組。

建議在生產實例中，讓 meilisearch 產生一個新密鑰供您的應用程式使用。您可以透過以下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"
}'

將“demo”一詞更改為您的主密鑰。如果您正在使用 docker compose，那麼這將僅適用於演示。除非您在撰寫文件中更改了它。然後使用您為 $MEILI_MASTER_KEY 設定的內容。

1. 登入您的 wikijs 實例，對於撰寫演示，您可能必須建立初始登入。只要記住在初始設定畫面上將 url 設定為 http://localhost:3000。
2. 導航至管理儀表板。
3. 點選搜尋引擎
4. 啟用美麗搜尋
5. 根據需要調整 API 金鑰和主機。
6. 點擊“應用”，如果沒有收到綠色提示訊息，只需再次點擊“應用”即可。發生這種情況的原因是創建索引時 Meil​​​​isearch 中的任務停滯。

現在它的設定是什麼？

現在您可以開始使用美麗搜尋來搜尋您的維基了！如果您有現有內容，您可以點擊“重建”，它會將您的所有內容新增至 meilisearch！ :)

當您正常使用 wikijs 時，它會在 Meil​​search 中建立、更新和刪除文檔，作為正常頁面渲染的一部分。

如果您想查看這方面的即時範例，在我的《龍與地下城》維基上，我們已經整合了此功能。觸手可及的角色數據或場景數據的瞬間回憶起來真是太神奇了。

關於實施的注意事項，目前建議與 who 行相符。將來，我會重寫該段落以截斷並提供更小的建議。