# @capotej/create-content-repo 中文文档

规范地址：https://npmcn.com/package/%40capotej/create-content-repo/

版本：0\.18\.0
npm 元数据更新时间：2026-10-27T02:26:15.729Z
中文译文更新时间：2026-11-09T14:42:08.821Z
软件包许可：BSD-3-Clause

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40capotej/create-content-repo
原文对照：https://npmcn.com/package/%40capotej/create-content-repo/?lang=original
项目主页：https://github.com/capotej/create-content-repo
源码仓库：https://github.com/capotej/create-content-repo

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：137 kB，29 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：0 个
- 首次发布：2026-09-19T13:12:48.632Z
- 最新版本发布：2026-10-27T02:26:15.373Z
- 近 30 天下载量：2447（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

脚手架 a内容-repo:.typ source + 代理技能 + stdlib-Python 构建管弦乐器. 通过 npx 运行@capotej/ create-content-repo .

## 安装

```sh
npm install @capotej/create-content-repo
```

也可以使用：`pnpm add @capotej/create-content-repo`、`yarn add @capotej/create-content-repo`、`bun add @capotej/create-content-repo`

## README

# @ capotej/ 创建- content- repo

脚手架 内容-repo: Typst (英语)`.typ`(a) 内容、代理技能 stdlib- Python 构建由错误绑定的工具链管弦乐器和Netlify 部署。 运行通过 `npx @capotej/create-content-repo <name>`。 。 。 .

## 使用量

```
npx @capotej/create-content-repo my-blog
```

这就是整个设置。 若为 `git` 脚手架已经运行在路径上 `git init` (处) `main`并作最初的记念;否则,记念 其下一步骤输出的手动步骤.

从那里, **向生成的回波点出您的代理设备** - 技能 里面是接口。 归宿 `AGENTS.md` 合同加 `.agents/skills/{build,new-content,serve,publish}/` 告诉探员如何 创建内容, 构建和验证, 运行 dev 循环, 并发布; 无原始 需要蟒蛇或打字命令。 典型的第一届会议:要求新的 帖子(新内容),在当地观看(服务于3:00),然后出版.

生成的回波 :

-   `content/{posts,links,papers,pages}/` 一个 `.typ` 实例 (单位:千美元)`#let meta` 命令 + `#context metadata((meta))` 标记)
-   `.agents/skills/{build,new-content,serve,publish}/` - 代理人 界面: 在 `.agents/skills/build/scripts/build.py` (python3 stdlib只引用HTML所标注的打字; `--verify` 检查构建/ 是在重建时的字节- 等同, dev 服务器 + watch at `.agents/skills/serve/scripts/serve.py` (3: 00,重建-改变)
-   `.pre-commit-config.yaml` + 键 `.typos.toml` ——预留钩(打字式格式+) 输入拼写 `.typ` ),所有工具通过 mise 被绑定
-   `AGENTS.md` ——代理人内容合同
-   `mise.toml` 被钉住的打字机、打字机、打字机、打字机
-   `netlify.toml` ——自开机建设(如果有的话,其他) • 出版 `build/`

选项 : `--typst-version <ver>` (默认 0.15.1), `--force`。 。 。 .

## 建筑

零依赖性类型Script CLI(`tsc`\- 编成的). 没有子命令, 没有运行时间 deps——argv只解析,如创建-反应-app. 模板文件机构是 真实文件 `template/`,在 npm 包中运出 (单位:千美元)`files: ["dist", "template"]`) (中文(简体) ).

-   输入点 : `src/cli.ts` → `dist/cli.js` (单位:千美元) `bin` 目标)
-   `src/scaffold.ts` 副本 `template/` 输入 `./<name>`,替换 `{{NAME}}` 编号 : `{{TYPST_VERSION}}` 编号 : `{{DATE}}` 并重命名 `DATE-*.typ` 示例文件到今天的日期; `template/gitignore` 无点船舶(npm) 剥去根 `.gitignore`) 写作真实 `.gitignore`
-   `template/` 保存每个生成的文件正文

### 加入脚手架

1.  编辑文件 `template/` - 这是整个生成的回波.
2.  `pnpm build && node dist/cli.js test-repo` 并检查树.
3.  运行生成的 repo 构建以证明模板编译 : `cd test-repo && mise install && python3 .agents/skills/build/scripts/build.py`

## 软件包管理器

这个项目使用 **小时**,通过 `packageManager` 输入 `package.json`不使用 npm 或纱线.

所有依附关系都固定在准确的版本上——没有浮动范围(`^`, (中文(简体) ), `~`) (中文(简体) ). pnpm执行7天的放出冷却通过 `minimumReleaseAge: 7` 内 `pnpm-workspace.yaml` 作为供应链的守护者.

## 工具版本

这个项目使用 `mise.toml` 作为所有工具唯一的真相来源 语言版本。 不在全球或通过临时命令安装工具—— 使用 mise 代替 .

## 格式化/ Linting 格式化

克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克 线人运行林特, 类型检查、格式:检查、构建和E2E脚手架+构建步骤.

## 释放

OIDC信任的出版——推出 `v*` 标签触发器 `.github/workflows/release.yml` 它出版到npm。 没有npm的标志. 见 `.agents/skills/release/SKILL.md` 完全释放程序.

## 常见问题

### @capotej/create-content-repo 是什么？

脚手架 a内容-repo:\.typ source \+ 代理技能 \+ stdlib-Python 构建管弦乐器\. 通过 npx 运行@capotej/ create-content-repo \.

### 如何安装 @capotej/create-content-repo？

在项目目录运行 npm install @capotej/create-content-repo，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 create-content-repo，可以用 npx create-content-repo 直接运行。

### @capotej/create-content-repo 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/capotej\_\_create-content-repo 是否存在。

### @capotej/create-content-repo 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @capotej/create-content-repo 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @capotej/create-content-repo 可以商用吗？

@capotej/create-content-repo 使用 BSD-3-Clause 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。另外不得用原作者名义为衍生产品背书。以上为概括，不构成法律意见，请以许可原文为准。

### @capotej/create-content-repo 的下载量有多少？

根据 npm 官方下载统计，@capotej/create-content-repo 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,447 次，日均约 82 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @capotej/create-content-repo 还在维护吗？

最新版本 0\.18\.0 发布于 2026/10/27（13 天前）；至今共发布 19 个版本，其中过去 12 个月发布了 19 个；首次发布于 2026/09/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。