1. 什么是 brittanica-c
brittanica-c 是一款基于 Node.js 平台的 CLI 工具，它可以帮助前端开发人员快速生成公司专属的技术百科模板，方便团队合作与知识共享，提升团队技术水平。
2. 安装 brittanica-c
在使用 brittanica-c 之前，需要先安装 Node.js，如果已经安装，请忽略该步骤。
打开终端，输入以下命令安装 brittanica-c：
npm install -g brittanica-c
3. 使用 brittanica-c
3.1 初始化项目
在终端中，进入要创建项目的文件夹，输入以下命令：
brittanica-c init
接着，按照提示输入所需信息即可。例如，我们要创建一个名为 "my-brittanica" 的项目，选择使用默认模板，运行上面的命令后，会看到如下输出：
? 请输入项目名称：my-brittanica ? 请选择模板类型：(Use arrow keys) ❯ default blank ...
依次输入项目名称和选择模板类型，我们选择默认模板，完成后，会在当前文件夹下创建一个名为 "my-brittanica" 的项目。进入该项目的根目录，输入以下命令启动项目：
npm run dev
此时，在浏览器中输入地址 http://localhost:8080，就可以看到本地运行的项目了。
3.2 编写文档
在项目的 src 目录下，有一个 docs 文件夹，里面存放着我们要编辑的文档。对于每一个文档，都有一个对应的 .md 文件和一个 .json 文件。其中，.md 文件是文档的正文，.json 文件是文档的元数据。
我们来看一个示例文档，src/docs/javascript.md，它的内容如下：
-- -------------------- ---- ------- - ---------- -- -- ---------- ------------------ --- ------------------------- ---- - --- ---------------- -- ---- --- ---- ---------- ----------------------------- ---- ------ - --------- - ---- - ------- - ------ - ------ - ------ ---- ------ - ------ --- ---- ---------- --- ------------- ---------- ---- --- --------------------- ---- --- ----------------------- ---- ----- ----------------- -- ---- --- ---- ---------- ------------ ---------- -------------------------- ---- - --- ------ --- ---- -- ---------- --------------- ---------- --------------------------------------- ----------- -- ---- - ---- --- --------------------------------------------------------------
从文件内容中可以看出，其 javascript.md 文件的元数据如下：
{
"title": "JavaScript",
"type": "front-end",
"tags": ["javascript"],
"createdAt": "2021-10-09T16:01:16.698Z",
"updatedAt": "2021-10-09T16:01:21.994Z"
}其中 title 是文档的标题，type 是文档的类型，tags 是文档的标签，createdAt 是创建时间，updatedAt 是更新时间。这些元数据可以用来进行文档的分类和搜索。
3.3 编译文档
编辑好文档后，需要使用 brittanica-c 进行编译，将其转化成标准的 HTML 格式，并生成索引文件。
在项目的根目录下，输入以下命令编译文档：
brittanica-c build
编译后的结果存放在 dist 文件夹下，其中 index.html 是文档索引页面，其他文件夹和文件则是文档的具体内容。
3.4 部署文档
最后，将编译后的文档部署到服务器上，供团队成员访问和使用。
将 dist 文件夹中的文件上传到服务器上的指定目录下，在浏览器中输入地址 http://yourdomain.com/path/to/docs 即可访问文档。
4. 总结
使用 brittanica-c，我们可以快速构建公司的技术百科文档，有效提升团队的协作和知识共享能力。希望本文对于初学者能有所帮助，如果有任何问题和建议，欢迎留言交流。
示例代码：https://github.com/brittanica-c/docs-example
参考资料：
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/66639