搜索方案集成对比

# config/_default/params.toml
[search]
enable = true
provider = "algolia"

[search.algolia]
app_id = "YOUR_APP_ID"
api_key = "YOUR_SEARCH_ONLY_API_KEY"
index_name = "YOUR_INDEX_NAME"

// scripts/prepare-algolia-index.js
const algoliasearch = require('algoliasearch');

// 初始化 Algolia 客户端
const client = algoliasearch('YOUR_APP_ID', 'YOUR_ADMIN_API_KEY');
const index = client.initIndex('YOUR_INDEX_NAME');

// 准备索引数据
const records = [
  {
    objectID: 'page-1',
    title: '页面标题',
    content: '页面内容',
    url: '/page-url/',
    tags: ['标签 1', '标签 2'],
    categories: ['分类 1'],
    date: '2025-01-01',
    section: 'blog'
  }
  // 更多记录...
];

// 上传到 Algolia
index.saveObjects(records).then(({ objectIDs }) => {
  console.log('索引更新成功：', objectIDs);
});

<!-- layouts/partials/search-algolia.html -->
<div id="algolia-search-box">
  <div id="algolia-hits"></div>
</div>

<script>
  const search = instantsearch({
    indexName: '{{ .Site.Params.search.algolia.index_name }}',
    searchClient: algoliasearch(
      '{{ .Site.Params.search.algolia.app_id }}',
      '{{ .Site.Params.search.algolia.api_key }}'
    ),
  });

  search.addWidgets([
    instantsearch.widgets.searchBox({
      container: '#algolia-search-box',
      placeholder: '搜索...',
    }),

    instantsearch.widgets.hits({
      container: '#algolia-hits',
      templates: {
        item: `
          <div class="hit-item">
            <h3><a href="{{ url }}">{{ title }}</a></h3>
            <p>{{ content }}</p>
            <small>{{ date }}</small>
          </div>
        `,
      },
    }),
  ]);

  search.start();
</script>

// 添加分面搜索
search.addWidgets([
  instantsearch.widgets.refinementList({
    container: '#categories',
    attribute: 'categories',
  }),

  instantsearch.widgets.refinementList({
    container: '#tags',
    attribute: 'tags',
  }),
]);

// 配置自定义排序
index.setSettings({
  ranking: [
    'typo',
    'geo',
    'words',
    'filters',
    'proximity',
    'attribute',
    'exact',
    'custom'
  ],
  customRanking: [
    'desc(date)',  // 新内容优先
    'desc(popularity)', // 热门内容优先
  ],
});

// package.json
{
  "scripts": {
    "build": "hugo && npm run pagefind",
    "pagefind": "pagefind --site public --output-subdir _pagefind"
  }
}

<!-- 搜索界面 -->
<div id="search"></div>
<input type="search" id="search-input" placeholder="搜索...">

<script>
  // 初始化 Pagefind
  window.addEventListener('DOMContentLoaded', () => {
    const searchInput = document.getElementById('search-input');
    const searchResults = document.getElementById('search');

    searchInput.addEventListener('input', async (e) => {
      const query = e.target.value;

      if (query.length > 2) {
        const search = await window.pagefind.search(query);
        const results = await Promise.all(
          search.results.slice(0, 10).map(r => r.data())
        );

        searchResults.innerHTML = results.map(result => `
          <div class="search-result">
            <h3><a href="${result.url}">${result.meta.title}</a></h3>
            <p>${result.excerpt}</p>
          </div>
        `).join('');
      }
    });
  });
</script>

// 配置搜索索引
const index = elasticlunr(function () {
  this.addField('title');
  this.addField('content');
  this.addField('tags');
  this.setRef('id');
});

// 添加文档
index.addDoc({
  id: 'doc1',
  title: 'Hugo 搜索指南',
  content: '本文介绍如何在 Hugo 中集成搜索功能...',
  tags: ['hugo', 'search']
});

// 执行搜索
const results = index.search('hugo search', {
  fields: {
    title: {boost: 2},
    content: {boost: 1},
    tags: {boost: 3}
  }
});

// 搜索性能监控
const searchMetrics = {
  queryCount: 0,
  averageResponseTime: 0,
  noResultsCount: 0
};

// 监控搜索行为
function trackSearch(query, results, responseTime) {
  searchMetrics.queryCount++;
  searchMetrics.averageResponseTime =
    (searchMetrics.averageResponseTime + responseTime) / 2;

  if (results.length === 0) {
    searchMetrics.noResultsCount++;
  }

  // 发送到分析服务
  analytics.track('search', {
    query,
    resultCount: results.length,
    responseTime
  });
}

// scripts/search-index.js
const algoliasearch = require('algoliasearch');
const fs = require('fs');
const path = require('path');

async function updateSearchIndex() {
  // 从 Hugo 生成的 JSON 获取数据
  const searchData = JSON.parse(
    fs.readFileSync('public/index.json', 'utf-8')
  );

  // 初始化 Algolia 客户端
  const client = algoliasearch(
    process.env.ALGOLIA_APP_ID,
    process.env.ALGOLIA_ADMIN_KEY
  );

  const index = client.initIndex(process.env.ALGOLIA_INDEX_NAME);

  // 上传索引数据
  await index.saveObjects(searchData);

  console.log(`已更新 ${searchData.length} 条搜索记录`);
}

updateSearchIndex().catch(console.error);

# .github/workflows/update-search.yml
name: Update Search Index
on:
  push:
    branches: [main]
    paths:
      - 'content/**'
      - 'config/**'

jobs:
  update-search:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '18'

      - name: Install dependencies
        run: npm ci

      - name: Build site
        run: npm run build

      - name: Update search index
        run: node scripts/search-index.js
        env:
          ALGOLIA_APP_ID: ${{ secrets.ALGOLIA_APP_ID }}
          ALGOLIA_ADMIN_KEY: ${{ secrets.ALGOLIA_ADMIN_KEY }}
          ALGOLIA_INDEX_NAME: ${{ secrets.ALGOLIA_INDEX_NAME }}

// Algolia 搜索调试
const searchClient = algoliasearch(appId, apiKey);

// 启用调试模式
searchClient.search([
  {
    indexName: 'your_index',
    query: 'debug query',
    params: {
      getRankingInfo: true,  // 获取评分信息
      analytics: false,      // 禁用分析
    }
  }
]).then(({ results }) => {
  console.log('搜索结果详情：', results[0]);
  console.log('评分信息：', results[0].rankingInfo);
});