如何添加新文章

概述

本文档介绍如何向工业Docs文档中心添加新的文章。

目录结构

src/content/docs/
├── index.mdx              # 首页
├── guides/                # 指南目录
│   └── getting-started.md
├── best-practices/        # 最佳实践目录
│   └── getting-started.md
└── en/                   # 英文版本
    ├── index.mdx
    ├── guides/
    └── best-practices/

添加新文章的步骤

1. 创建 Markdown 文件

在对应的目录下创建新的 .md 或 .mdx 文件。

# 示例：创建新的指南文章
touch src/content/docs/guides/my-new-article.md

2. 编写 Frontmatter

每个文档文件顶部需要包含 frontmatter：

---
title: 文章标题
description: 文章描述（显示在搜索结果中）
---

3. 编写内容

使用 Markdown 语法编写文档内容。

## 标题

这是正文内容。

### 小标题

- 列表项 1
- 列表项 2

4. 添加英文版本

在 en 目录下创建对应的英文文章：

# 示例：为新文章创建英文版本
touch src/content/docs/en/guides/my-new-article.md

5. 验证

运行构建命令验证：

npm run build

Starlight 组件

可以使用 Starlight 提供的组件增强文档：

提示框

:::tip
这是一个提示
:::

:::note
这是一个备注
:::

:::caution
这是一个警告
:::

代码块

\`\`\`javascript
console.log('Hello World');
\`\`\`

卡片

import { Card, CardGrid } from '@astrojs/starlight/components';

<CardGrid>
  <Card title="标题">内容</Card>
</CardGrid>

注意事项

• 文件名使用连字符 - 分隔单词
• frontmatter 中的 title 和 description 必须填写
• 建议为每个中文文章创建对应的英文版本
• 中英文文章的路径保持一致

相关链接

• Starlight 官方文档
• Markdown 语法指南