Compodoc使用Postmark主题失败求助：报错及主题获取疑问

我来帮你搞定这个问题！你遇到的报错是因为Compodoc的Postmark主题并不是内置主题，直接用--theme postmark会被工具误当成要处理的源文件夹路径，所以才会提示找不到这个文件夹。下面是具体的解决步骤：

1. 安装Postmark主题包 #

首先需要通过npm安装官方维护的Postmark主题包，在项目根目录执行：

npm install @compodoc/theme-postmark --save-dev

2. 正确调用主题的命令 #

安装完成后，你需要指定完整的主题包名来调用，而不是只写postmark。注意如果是通过npm run执行脚本，需要在参数前加上--来传递给Compodoc：

• 如果用你原来的doc:buildandserve脚本：

npm run doc:buildandserve -- --theme @compodoc/theme-postmark

• 如果直接调用compodoc命令：

npx compodoc -p tsconfig.json -s --theme @compodoc/theme-postmark

（这里的-p指定tsconfig文件，-s表示启动本地服务，你可以根据自己的需求调整参数）

3. 可选：在npm脚本中配置默认主题 #

为了避免每次都输入长命令，你可以在项目的package.json的scripts里直接配置好主题：

{
  "scripts": {
    "doc": "compodoc -p tsconfig.json -s --theme @compodoc/theme-postmark"
  }
}

之后直接运行npm run doc就能自动加载Postmark主题了。

内容的提问来源于stack exchange，提问作者Gero