如何在Quarto站点首页添加原生搜索框并复用Search.json？

完全可以复用Quarto自动生成的search.json来实现首页的自定义搜索框，这个文件本身就是Quarto原生搜索功能的索引数据源。以下是具体实现步骤：

1. 在首页添加搜索UI结构 #

在你的index.qmd文件中，插入自定义的搜索输入框和结果展示区域，比如放在页面顶部或合适的位置：

<div class="google-style-search">
  <input type="text" id="home-search-input" placeholder="搜索本站内容..." />
  <div id="search-results" class="search-results"></div>
</div>

2. 编写谷歌风格的CSS样式 #

在站点的自定义CSS文件（比如styles.css）中添加以下样式，实现类似谷歌搜索栏的外观：

.google-style-search {
  max-width: 600px;
  margin: 2rem auto;
  text-align: center;
}
#home-search-input {
  width: 100%;
  padding: 12px 20px;
  border: 1px solid #dfe1e5;
  border-radius: 24px;
  font-size: 16px;
  outline: none;
  transition: box-shadow 0.2s ease;
}
#home-search-input:hover, #home-search-input:focus {
  box-shadow: 0 1px 6px rgba(32,33,36,0.28);
  border-color: rgba(223,225,229,0);
}
.search-results {
  margin-top: 1rem;
  text-align: left;
  border-top: 1px solid #eee;
  padding-top: 1rem;
  max-height: 400px;
  overflow-y: auto;
}
.search-result-item {
  padding: 0.8rem;
  border-radius: 4px;
  cursor: pointer;
  transition: background-color 0.1s ease;
}
.search-result-item:hover {
  background-color: #f8f9fa;
}
.search-result-title {
  font-weight: bold;
  color: #1a0dab;
}
.search-result-excerpt {
  color: #545454;
  font-size: 0.9rem;
  margin-top: 0.2rem;
}

3. 实现搜索逻辑（JavaScript） #

编写JS代码加载search.json并完成实时搜索功能，你可以把这段代码放在index.qmd的底部，或者单独的JS文件中：

document.addEventListener('DOMContentLoaded', function() {
  const searchInput = document.getElementById('home-search-input');
  const resultsContainer = document.getElementById('search-results');
  let searchIndex = [];

  // 加载Quarto生成的搜索索引文件
  fetch('/search.json')
    .then(res => res.json())
    .then(data => {
      searchIndex = data;
    })
    .catch(err => console.error('搜索索引加载失败:', err));

  // 监听输入事件执行搜索
  searchInput.addEventListener('input', function() {
    const query = this.value.trim().toLowerCase();
    resultsContainer.innerHTML = '';

    if (!query) return;

    // 筛选匹配的内容（标题或正文包含关键词）
    const matchedItems = searchIndex.filter(item => {
      return item.title.toLowerCase().includes(query) || 
             item.content.toLowerCase().includes(query);
    });

    // 渲染搜索结果
    matchedItems.forEach(item => {
      const resultEl = document.createElement('div');
      resultEl.className = 'search-result-item';
      resultEl.innerHTML = `
        <div class="search-result-title">${item.title}</div>
        <div class="search-result-excerpt">${item.content.substring(0, 150)}...</div>
      `;
      // 点击结果跳转到对应页面
      resultEl.addEventListener('click', () => window.location.href = item.url);
      resultsContainer.appendChild(resultEl);
    });
  });
});

4. 注意事项 #

• 确保search.json的路径正确：Quarto默认会在站点构建完成后将该文件放在根目录下，所以/search.json的路径通常是有效的。
• 可以优化搜索逻辑：比如添加关键词权重排序、正则匹配、大小写不敏感优化等，提升搜索精准度。
• 样式兼容：如果你的Quarto主题有全局样式，可能需要微调自定义CSS，避免样式冲突。

内容的提问来源于stack exchange，提问作者Jay