网站目录结构 - sofastack/sofastack.tech GitHub Wiki

SOFAStack 官网使用 Hugo 构建,目录结构遵从 Hugo 内容管理规范

SOFAStack 新官网目录结构如下:

.
├── archetypes # 文档模板,主要是文档的头信息
│   ├── default.md
├── config.toml # Hugo 配置文件
├── content # 文档目录
│   ├── _index.md # 首页配置
│   ├── en # 英文文档路径
│   │   ├── _index.md # 表示这是一个 bundle,有子路径
│   │   ├── activities
│   │   │   └── _index.md
│   │   ├── blog
│   │   │   └── welcome
|   |   |       └── index.md
│   │   └── projects
│   │       ├── _index.md
│   │       ├── sofa-rpc
│   │       │   ├── _index.md
│   │       │   ├── getting-started-with-rpc
│   │       │   │   └── index.md
│   │       ├── sofa-rpc.md
│   │       └── sofa-tracer.md
│   └── zh # 中文文档路径
│       ├── _index.md
│       ├── activities
│       │   └── _index.md
│       ├── blog
│       │   └── welcome
|       |       └── index.md
│       └── projects
│           ├── _index.md
│           ├── sofa-rpc
│           │   ├── _index.md
│           │   ├── getting-started-with-rpc
│           │   │   └── index.md
│           │   └── intro
│           │       ├── home_1.png # 所有静态文件跟文档保存在同级目录下
│           │       └── index.md
│           ├── sofa-rpc.md
│           └── sofa-tracer.md
├── data # 一些元数据配置
├── layouts # 嵌套主题配置
│   ├── 404.html # 404 页面
│   ├── _default # 基本样式配置
│   │   ├── baseof.html
│   │   ├── list.html
│   │   └── single.html
│   ├── blog
│   │   └── single.html # 博客首页
│   ├── index.html # 首页
│   ├── partials # 主题各个组件
│   │   ├── favicon.html
│   │   ├── footer.html
│   │   ├── header.html
│   │   ├── meta
│   │   │   ├── name-author.html
│   │   │   └── ogimage.html
│   │   ├── page-summary.html
│   │   ├── pagination.html # 分页
│   │   ├── post # 单篇文章配置
│   │   │   ├── byauthor.html
│   │   │   ├── category-link.html
│   │   │   ├── meta.html
│   │   │   ├── related-content.html
│   │   │   └── tag-link.html
│   │   ├── scripts
│   │   │   └── animation.html
│   │   ├── site-verification.html
│   │   └── toc.html # Table of content
│   └── section # 子模块配置
│       ├── activities.html
│       ├── guides.html
│       └── projects.html
└── static # 主题静态文件目录
    ├── css
    ├── font
    ├── img
    └── js

以上结构中没有使用出现 theme 目录,即无引用的主题。