Fumadocs核心库升级：Algolia搜索集成与国际化优化

项目简介

Fumadocs是一个现代化的文档系统构建工具，旨在为开发者提供高效、灵活的文档解决方案。其核心库fumadocs-core作为基础架构，提供了文档处理、搜索集成等关键功能。本次发布的15.4.0版本带来了Algolia搜索服务的重要升级以及国际化相关功能的优化。

Algolia搜索服务升级至v5

本次更新的核心内容是将Algolia搜索服务从v4升级至v5版本。Algolia作为一款强大的搜索即服务(SaaS)解决方案，广泛应用于各类文档系统，其v5版本带来了性能提升和API改进。

主要变更点

1. 客户端初始化方式变化： 新版本要求显式指定索引名称(indexName)，这提高了代码的明确性和可维护性。开发者现在需要在同步文档和搜索时都明确指定目标索引。

2. API兼容性调整： 由于v4和v5之间存在显著差异，相关接口也进行了相应调整。这种变化虽然带来了一定的迁移成本，但长期来看能获得更好的性能和更现代的API设计。

升级指南

对于文档同步功能，新的推荐用法如下：

import { algoliasearch } from 'algoliasearch';
import { sync } from 'fumadocs-core/search/algolia';

const client = algoliasearch('应用ID', 'API密钥');

void sync(client, {
  indexName: '文档索引名称',
  documents: 文档记录,
});

对于前端搜索组件，配置方式也相应调整：

'use client';

import { liteClient } from 'algoliasearch/lite';
import SearchDialog from 'fumadocs-ui/components/dialog/search-algolia';

const client = liteClient(应用ID, API密钥);

function CustomSearchDialog(props) {
  return (
    <SearchDialog
      searchOptions={{
        client,
        indexName: '文档索引名称',
      }}
      {...props}
      showAlgolia
    />
  );
}

Markdown组件引入

本次更新新增了<Markdown />组件，为开发者提供了更便捷的Markdown内容渲染方案。这个组件经过优化，能够高效处理文档内容，支持常见的Markdown语法扩展，并确保与文档系统的样式体系无缝集成。

国际化功能优化

针对多语言文档场景，本次更新改进了两个关键功能：

1. createRelativeLink函数增强： 现在能更好地处理不同语言环境下的相对链接生成，确保链接在不同语言版本间正确跳转。

2. getPageByHref方法改进： 优化了基于href查找页面的逻辑，使其在i18n配置下能准确识别和返回目标页面。

这些改进使得Fumadocs在多语言文档项目中的表现更加稳定可靠，为国际化项目提供了更好的支持。

升级建议

对于正在使用Algolia搜索服务的项目，建议尽快升级至15.4.0版本，并按照新的API规范进行调整。虽然v4和v5之间存在差异，但这次升级带来的性能提升和功能改进值得投入迁移成本。对于国际化项目，新版本提供的链接处理改进也能显著提升多语言文档的维护体验。

对于新项目，可以直接采用新版本的API设计，享受更现代的搜索集成方案和更完善的国际化支持。