dromara / dromara.github.io

Dromara Official Website

Dromara 官方网站

此项目保存了用于构建 Dromara 官方网站的所有资源，网站托管在 https://dromara.org/.

此网站使用 VuePress Theme Hope 主题的 V2 版本构建。V2 基于 VuePress2， 带有 Vite4 / Webpack5 和 Vue3 的强大功能。

新增文档

1. 定位到源文件夹

• 对于英文内容，请导航至相应的文件夹，例如 src\news。
• 对于中文内容，请导航至中文的相应文件夹，例如 src\zh\news。

2. 复制已有文档

• 从相应的文件夹中找到一篇已有的文档作为模板进行复制，鉴于文档格式有特殊要求。

3. 修改 Frontmatter

• 更新复制文档中的 Frontmatter 信息。需要修改的信息包括：

  • 标题
  • 作者
  • 标签：此项为可选，无特殊要求时删除亦可。
  • 日期
  • 封面

• 请注意，head 部分的内容应与文件夹内的其他文档一致。由于在 head 中，meta 的 name 属性会影响文档在哪个模块显示。例如：

  • 如果 name 设置为“新闻”，文档将出现在 https://dromara.org/zh/news/；如果 name 设置为“News”，则文档将出现在 https://dromara.org/news/。
  • 如果 name 设置为“活动”，文档将出现在相应的“活动”模块中；如果 name 设置为“Activity”，则文档将出现在“Activity”模块中。
  • 如果 name 设置为“博客”，文档将出现在相应的“博客”模块中；如果 name 设置为“Blog”，则文档将出现在“Blog”模块中。

通过遵循以上步骤，你应该可以顺利地新增所需的文档。

4. Markdown 文件的标题格式

• 在 Markdown 文件中，请从 "##" 开始作为标题，避免使用 "#"，因为这会影响侧边栏的识别。

安装

pnpm install

本地开发

• 使用以下命令启动本地化网站。然后，您的网站可以在 http://localhost:8080/ 上访问。

pnpm start

• 更改完成可使用以下命令检查格式。

pnpm lint

贡献

• 创建新分支
• 提交并推送内容更改 (例如 /src/zh/activity 中的 .md 文件，须遵守同类型文章的 frontmatter).
• 翻译 markdown 文件，提交并推送内容更改 (例如 /src/activity 中的 .md 文件).
• 向 master 分支提交 pull request

许可

Apache 2.0 License.