把我的网站内容构建方式开源给大家:用 docs 作为文档骨架,让 AI 和人一起写内容,具有非常高的可扩展性,核心是templates/pages+components
思路:templates 定义页面类型和章节顺序,section 定义每块内容的格式、字数和组件用法,technical 负责技术实现。
每一层都有规则,互不重复,引用优先。这样写作、SEO、翻译都能按同一套规范执行。
docs/
├── README.md # 文档中心索引,按重要程度排序
│
├── pages/ # 独立单页(非内容型模板)
│ ├── README.md # 独立页面说明
│ ├── page-404.md # 404 错误页
│ ├── page-about.md # 关于我们
│ ├── page-betalist.md # Betalist 推广页
│ └── page-customer-stories.md # 客户案例
│
├── section/ # 跨页面通用章节规范(格式、字数、组件)
│ ├── README.md # Section 索引
│ ├── section-article-intro.md # 文章简介(110-150字)
│ ├── section-what-is.md # 什么是 XXX(主题介绍)
│ ├── section-how-it-works.md # 技术概述(HowItWorks)
│ ├── section-types-list.md # 分类/类型列举
│ ├── section-use-cases.md # 应用场景(UseCases)
│ ├── section-best-tools.md # 产品展示(BestTools)
│ ├── section-comparison-table.md # 对比表格(Table/DataTable)
│ ├── section-how-to.md # 如何选择(HowToChoose,5步)
│ ├── section-seo.md # SEO 规范(Meta、Schema、图片、日期、学习参考)
│ ├── section-conclusion.md # 结论(必须在 FAQ 之前)
│ ├── section-faq.md # 常见问题(禁止内链)
│ ├── section-references.md # 参考文献
│ ├── section-links.md # 内链、外链、全站链接规则
│ ├── section-youtube-thumbnail.md # YouTube 视频
│ ├── section-generic.md # 通用纯文字章节
│ ├── section-also-interested-in.md # 可能感兴趣
│ ├── section-nav.md # 导航栏(Header、Footer)
│ ├── section-breadcrumb.md # 面包屑
│ ├── section-hero.md # Hero 区域(H1、Excerpt)
│ └── section-share-buttons.md # 分享按钮
│
├── technical/ # 技术实现文档
│ ├── README.md # 技术文档索引
│ ├── technical-config-files.md # 项目配置文件
│ ├── technical-indexnow.md # IndexNow 协议集成
│ ├── technical-component-imports.md # 组件导入规范
│ └── technical-mdx-syntax.md # MDX 语法规范
│
└── templates/ # 按页面类型复用的模板
├── README.md # 模板索引
├── template-tools.md # Tools 工具推荐/对比
├── template-seo.md # SEO 类页面
├── template-marketing.md # Marketing 营销策略
├── template-bloglayout.md # BlogLayout 通用布局
├── template-landing.md # 首页(含 Logo 素材)
├── template-aggregate.md # 聚合页(/blog、/tools 等)
└── template-glossary.md # 术语表