mirror of
https://github.com/halo-dev/docs.git
synced 2026-01-14 07:02:53 +08:00
重构文档版本结构。 - 移除 1.5/1.4 相关所有 patch 版本的文档,使用 1.5/1.4 版本号代替。 - 创建 1.6 的文档版本。 - 后续针对 1.5 或者 1.6 的更新,可以直接对具体版本进行更改。 本打算使用 [@docusaurus/plugin-client-redirects](https://docusaurus.io/zh-CN/docs/api/plugins/@docusaurus/plugin-client-redirects) 做已删除的 patch 版本的重定向,旦可能不是很好满足匹配重定向的需求。~~所以在此 PR 合并之前我将通过 Nginx 对具体版本进行重定向转发~~。 比如:`/1.4.17/{path}` 重定向到 `/1.4/{path}`,`/1.5.4/{path}` `/1.5.3/{path}` 都从定向到 `/1.5/{path}` /kind documentation /cc @halo-dev/sig-docs > PS: 此 PR 未对新发布的 [1.6.0](https://github.com/halo-dev/halo/releases/tag/v1.6.0) [1.5.5](https://github.com/halo-dev/halo/releases/tag/v1.5.5) [2.0.0-alpha.2](https://github.com/halo-dev/halo/releases/tag/v2.0.0-alpha.2) 做修改,将在后续 PR 更改。 ```release-note None ```
2.5 KiB
2.5 KiB
title, description
| title | description |
|---|---|
| 系统结构 | Halo 项目的构成 |
Halo 博客系统分为以下四个部分:
| 项目名称 | 简介 |
|---|---|
| halo | 提供整个系统的服务,采用 Spring Boot 开发 |
| halo-admin | 负责后台管理的渲染,采用 Vue 开发,已集成在 Halo 运行包内,无需独立部署。 |
| halo-comment | 评论插件,采用 Vue 开发,在主题中运行方式引入构建好的 JavaScript 文件即可 |
| halo-theme-* | 主题项目集,采用 FreeMarker 模板引擎编写,需要包含一些特殊的配置才能够被 halo 所使用 |
自定义配置
为什么要提前讲自定义配置呢?是因为在这里让大家了解到
Halo的配置方式,以及配置优先级,不至于未来运行项目的时候不知道如何优雅地修改配置。
Halo 配置目录优先级如下(从上到下优先级越来越小,上层的配置将会覆盖下层):
Halo自定义配置- file:~/.halo/
- file:~/.halo-dev/
Spring Boot默认配置- file:./config/
- file:./
- classpath:/config/
- classpath:/
在开发的时候,希望大家能够在 ~/halo-dev/application.yml 中进行添加自定义配置。当然后面也会讲到如何用运行参数 和 VM options 进行控制配置,届时可根据具体情况进行选择。
:::warning
开发的时候,我们不建议直接更改项目源码中的所包含的配置文件,包括 application.yml、application-dev.yml、application-test.yml 和 application-user.yml。
:::