如何使用 docs.page 创建文档 – 初学者教程
原文英文，约2900词，阅读约需11分钟。
📝
内容提要
docs.page是一个开源文档工具，帮助用户快速创建美观的文档网站。它通过从公共GitHub仓库获取内容，简化文档发布流程，具有零配置、可定制、实时预览、热重载和GitHub集成等特点，适合中大型项目使用。
🔎
延伸解读
文档创建的便利性
docs.page通过零配置和GitHub集成，极大简化了文档创建和发布的流程。用户只需创建'docs.json'文件和'docs'目录，即可快速启动项目，适合初学者和开发者使用。
实时预览与协作
docs.page的实时预览功能使得团队协作更加高效。开发者可以在不同分支或拉取请求中即时查看文档更改，减少了沟通成本和错误发生的可能性。
主题与自定义选项
docs.page支持深色和浅色模式的主题自定义，用户可以根据需求调整文档的外观。此外，用户还可以通过简单的配置文件添加社交链接和导航，提升用户体验。
潜在的风险与限制
虽然docs.page是一个免费的开源项目，但未来可能会引入收费政策。用户在使用时应关注其更新动态，以便及时调整文档发布策略，避免服务中断。
❓
Q&A
docs.page的主要功能是什么？
docs.page是一个开源文档工具，帮助用户快速创建美观的文档网站，具有零配置、可定制、实时预览等特点。
如何开始使用docs.page创建文档？
用户只需创建'docs.json'文件和'docs'目录，然后使用docs.page CLI工具初始化项目。
docs.page支持哪些文档格式？
docs.page支持Markdown和MDX格式，允许在文档中使用React组件。
如何在docs.page中配置主题和logo？
可以通过'docs.json'文件配置主题和logo，包括选择深色或浅色模式以及提供logo的URL。
docs.page如何实现实时预览功能？
用户可以通过访问docs.page并选择本地项目目录来实现实时预览，任何本地更改会立即反映在浏览器中。
如何将文档网站发布到GitHub？
用户只需将代码推送到GitHub仓库，文档网站将自动可用，访问链接为https://docs.page/用户名/仓库名。
🏷️
