[English](https://github.com/any-tdf/stdf/blob/main/packages/create-stdf/README.md)

> v0.2.2 之后支持选择图标使用方式，支持 `stdf-icon` 或 `iconify`。

# create-stdf

一个用于创建新的 [STDF](https://stdf.design) 项目的命令行工具。只需运行以下命令...

<!-- :::code-groups -->
<!-- pnpm -->
```sh
pnpm create stdf@latest
```
<!-- :: -->
<!-- npm -->
```sh
npm create stdf@latest
# 或
npm init stdf@latest
# 或
npx create-stdf@latest
```
<!-- :: -->
<!-- bun -->
```sh
bun create stdf@latest
```
<!-- :: -->
<!-- yarn -->
```sh
yarn create stdf@latest
```
<!-- ::: -->

...然后按照提示进行操作。

你也可以通过额外的命令行选项直接指定项目名称和要使用的模板。例如，如果要使用 **SvelteKit & Tailwind & TypeScript & STDF** 模板创建一个名为 `my-app` 的新项目，请运行：

<!-- :::code-groups -->
<!-- pnpm -->
```sh
pnpm create stdf@latest my-app
```
<!-- :: -->
<!-- npm -->
```sh
npm create stdf@latest my-app
```
<!-- :: -->
<!-- bun -->
```sh
bun create stdf@latest my-app
```
<!-- :: -->
<!-- yarn -->
```sh
yarn create stdf@latest my-app
```
<!-- ::: -->

如果要使用 **SvelteKit & Tailwind & STDF** 模板，请运行：

<!-- :::code-groups -->
<!-- pnpm -->
```sh
pnpm create stdf@latest my-app --template skt
# 或
pnpm create stdf@latest my-app -t skt
```
<!-- :: -->
<!-- npm -->
```sh
npm create stdf@latest my-app --template skt
# 或
npm create stdf@latest my-app -t skt
```
<!-- :: -->
<!-- bun -->
```sh
bun create stdf@latest my-app --template skt
# 或
bun create stdf@latest my-app -t skt
```
<!-- :: -->
<!-- yarn -->
```sh
yarn create stdf@latest my-app --template skt
# 或
yarn create stdf@latest my-app -t skt
```
<!-- ::: -->

# 命令选项

| 命令              | 类型                                                                                       | 默认          | 描述                     |
| ----------------- | ------------------------------------------------------------------------------------------ | ------------- | ------------------------ |
| -                 | string                                                                                     | -             | 项目名称，可以直接输入。 |
| -t / --template   | `'sktt'\|'skt'\|'skut'\|'sku'`                                                             | `'sktt'`      | 要使用的模板。           |
| -l / --language   | `'en_US'\|'zh_CN'\|'zh_TW'\|'ja_JP'\|'ko_KR'\|'es_ES'\|'ru_RU'\|'fr_FR'\|'de_DE'\|'it_IT'` | `'en_US'`     | 提示语言。               |
| -i / --icon-usage | `'stdf-icon'\|'iconify'\|'both'\|'none'`                                                   | `'stdf-icon'` | 图标使用方式。           |

# 模板预设

| 简写 | 模板                              | 描述     |
| ---- | --------------------------------- | -------- |
| sktt | SvelteKit & Tailwind & TypeScript | 默认     |
| skt  | SvelteKit & Tailwind              | -        |
| skut | SvelteKit & UnoCSS & TypeScript   | 暂未适配 |
| sku  | SvelteKit & UnoCSS                | 暂未适配 |

# 语言预设

| 简写  | 语言         |
| ----- | ------------ |
| en_US | 英语（美式） |
| zh_CN | 中文（简体） |
| zh_TW | 中文（繁体） |
| ja_JP | 日语         |
| ko_KR | 韩语         |
| es_ES | 西班牙语     |
| ru_RU | 俄语         |
| fr_FR | 法语         |
| de_DE | 德语         |
| it_IT | 意大利语     |

# 图标使用方式预设

| 简写      | 描述                                                           |
| --------- | -------------------------------------------------------------- |
| stdf-icon | 使用 `rollup-plugin-stdf-icon` 插件管理图标。                  |
| iconify   | 使用 `iconify` 插件管理图标。                                  |
| both      | 同时使用 `rollup-plugin-stdf-icon` 和 `iconify` 插件管理图标。 |
| none      | 不使用任何工具管理图标。                                       |

例如：

<!-- :::code-groups -->
<!-- pnpm -->
```sh
pnpm create stdf@latest my-app -l zh_CN
```
<!-- :: -->
<!-- npm -->
```sh
npm create stdf@latest my-app -l zh_CN
```
<!-- :: -->
<!-- bun -->
```sh
bun create stdf@latest my-app -l zh_CN
```
<!-- :: -->
<!-- yarn -->
```sh
yarn create stdf@latest my-app -l zh_CN
```
<!-- ::: -->

# 许可证

本项目基于 [MIT 许可证](https://github.com/any-tdf/stdf/blob/main/LICENSE)。