# directify

**Repository Path**: baklib/directify

## Basic Information

- **Project Name**: directify
- **Description**: Baklib 模板，目录站、数据集、文档库；用于构建同类型多分类的数据集库、目录、各种大型集合类知识库。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-20
- **Last Updated**: 2026-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Directify（`directify`）

[English](README.md) | 简体中文

Baklib **CMS** 目录与文档主题（`theme_scope`: `cms`，版本 **0.0.1**）：用于构建同类型多分类的数据集库、目录站与大型集合类知识库，提供分级导航、全站搜索、AI 助理与响应式亮/暗色界面。

## 适用对象

- 需要在**同一站点**管理多个产品或数据集，并支持版本、标签与独立入口页的团队
- 发布**目录型索引**（资源、链接、清单类内容），需要分类浏览与检索的场景
- 搭建**帮助中心、FAQ 或内部知识库**，强调结构化导航而非单页长文

## 特性

- **多级分类导航** — 可折叠侧栏目录树，适配深层栏目结构
- **全站搜索** — 检索全站内容；支持按产品/版本筛选与热门搜索词
- **AI 智能助理** — 对话式搜索侧栏，支持多轮问答
- **灵活页面模板** — 首页、栏目列表、文档页、产品/公司档案、标签页与搜索页
- **响应式界面** — 适配桌面、平板与手机；亮/暗色切换；两套推荐配色（Airtable、Claude）
- **双语前台** — 英文（`en`）与简体中文（`zh-CN`），支持语言切换
- **内容能力** — 富文本或 HTML；标签；网格/列表布局；分页
- **阅读辅助** — 自动目录、面包屑、代码复制、图片查看、上下篇、外部链接
- **站点信息** — 可配置顶栏菜单、页脚、版权、备案号与用户反馈
- **LLM 工具** — 复制页面为 Markdown、跳转 ChatGPT/Claude、MCP 安装快捷入口（文档页）

## 环境要求

- Node.js（用于 `yarn build` / `yarn dev`）
- Baklib 站点使用 **CMS** 范围并安装本主题

## 目录说明

| 路径 | 说明 |
| --- | --- |
| `config/settings_schema.json` | 主题元数据、全局设置、预览图路径 |
| `layout/` | 基础布局（`theme.liquid`、`simple.liquid`） |
| `templates/` | 首页、栏目、文档、详情变体、搜索、标签、反馈 |
| `snippets/` | 页头、侧栏、Hero、搜索、卡片、AI 区块、分页等 |
| `statics/` | 可选静态 Liquid 端点（`ui.liquid`、`news.liquid`） |
| `locales/` | 前台文案（`*.json`）与编辑器文案（`*.schema.json`） |
| `src/` | 源码 CSS/JS（Tailwind CLI、esbuild） |
| `assets/` | 构建产物与营销截图 |
| `seeds/` | 演示站点结构示例 |

## 模板

### 首页

`templates/index.liquid` — 在 Baklib 后台设为站点首页模板。

含 Hero 搜索、推荐产品、分类侧栏、版本标签与标签云。可在主题编辑器中配置背景图、标语、副标题、热门搜索词与各板块标题。

`templates/index.preview.liquid` — 演示风格首页，含引导说明；首次安装、尚未定制正式首页时可用。

### 栏目（列表）

`templates/channel.liquid` — 栏目下子页面列表，含侧栏导航、搜索与卡片/表格展示。

### 文档页

`templates/page.liquid` — 文档阅读页：左侧目录树、本页 TOC、页面工具与反馈。

### 产品 / 公司页

`templates/post.liquid`（schema 名称：**directify_page**）— 产品、公司或项目档案：Logo、描述、标签、外链及子详情页。

专用详情模板（演示数据中常用固定 slug）：

| 模板 | 作用 |
| --- | --- |
| `post.maturity.liquid` | 企业对外公开站点成熟度扫描报告（雷达图、覆盖度树） |
| `post.crm.liquid` | 内部销售 CRM 记录（需登录） |

### 其他

| 文件 | 作用 |
| --- | --- |
| `templates/search.liquid` | 搜索结果，支持产品/版本筛选与 AI 区块 |
| `templates/tag.liquid` | 按标签浏览 |
| `templates/feedback_turbo_stream.liquid` | 页面反馈的 Turbo Stream 响应 |

Schema 中还定义 **product_index**、**version_index**，用于「产品族 → 版本 → 文章」的多产品文档树。

## 主题设置

`config/settings_schema.json` 中的全局分组：

| 分组 | 可配置项 |
| --- | --- |
| **品牌** | 亮色 / 暗色 Logo |
| **联系信息** | 联系方式；左侧全站导航链接（HTML） |
| **演示区块** | 无子页面时展示的配图与按钮（`demo_image_url`、`demo_cta_title`、`demo_cta_url`） |
| **顶栏** | 背景色、文字色、顶部菜单 HTML |
| **页脚** | 颜色、简介、版权、备案号、底部导航链接 |

**配色预设** — `recommendations.color_schemas` 提供 **Airtable**（白底墨字）与 **Claude**（暖白珊瑚）两套方案，可在站点主题设置中选择后再微调语义色。

## 支持的语言

前台与 schema 已包含：

`en` · `zh-CN`

修改 `locales/<locale>.json`（前台）与 `locales/<locale>.schema.json`（编辑器）。新增语言请在 `config/settings_schema.json` 的 `theme_info.theme_languages` 中登记。

## 快速上手

1. 在 **CMS** 站点安装主题并应用 seeds（或导入自己的栏目/页面结构）。
2. 将**首页**设为 `index.liquid`（或暂用 `index.preview.liquid` 查看演示布局）。
3. 在**品牌**中上传 Logo；配置顶栏/页脚颜色与导航 HTML。
4. 若父级页面无子页时需展示推广卡片，请配置**演示区块**。
5. 在首页模板中设置热门搜索词；在站点设置中启用 AI 助理（如已开通）。
6. 修改 `src/` 后执行 `yarn build` 生成资源。

开发监听（CSS/JS）：

```bash
yarn install
yarn dev
```

生产构建：

```bash
yarn build
```

可选：Liquid / 语言包热更新

```bash
bundle install
yarn livereload
```

## 典型场景

- **多产品文档库** — 集中管理多个产品文档，统一搜索与版本
- **数据集 / 资源目录** — 大型集合的分类展示与标签筛选
- **企业知识库** — 帮助中心、FAQ，强调导航与检索
- **产品手册** — 带版本管理与双语界面的技术文档
- **目录索引站** — 资源、链接类内容的分类与外链跳转

## 预览图

**主题卡片缩略图：**

```text
assets/images/theme/thumb.png
```

**各语言列表封面：**

```text
assets/images/theme/{lang}/cover.png
```

路径在 `config/settings_schema.json` 的 `theme_thumb_url`、`theme_preview_images` 中配置。

## 文档

- 主题说明：<https://help.baklib.cn/theme/directify>
- 支持：<https://help.baklib.cn/theme/directify>

## 许可证

若本主题目录无 `LICENSE` 文件，请参阅上级 Baklib 仓库许可证。