# PyPI 发布指南

本文档说明如何将 **yakultpdf** 发布到 PyPI。

## 1. 准备工作

### 1.1 更新版本号

### 1.2 清理环境

在构建前，确保清除旧的构建产物：

```bash
rm -rf dist/
```

---

## 2. 构建 (Build)

本项目使用 `hatchling` 作为构建后端，推荐使用 `uv` 进行构建。

```bash
uv build
```

构建成功后，`dist/` 目录下应生成 `.whl` 和 `.tar.gz` 文件。

---

### 3. 发布 (Publish)

使用 `uv publish` 上传到 PyPI：

```bash
uv publish
```

> **注意**: `uv publish` 会自动寻找环境变量 `UV_PUBLISH_TOKEN` 或提示输入 Token。请确保你拥有 PyPI 项目 `yakultpdf` (或 `markdown2pdf`) 的维护权限。

---

## 4. 自动化脚本

项目中包含一个一键发布脚本，自动执行清理、构建与发布：

```bash
./scripts/publish.sh
```
