Sekyoro的博客小屋
·
Vitepress:SSG框架使用
💡
原文中文，约3200字，阅读约需8分钟。
📝
内容提要
推荐使用Vitepress和Mkdocs作为静态网站生成器，前者适合前端文档和博客，后者适合Python库的文档。其他选择包括Docsify、Sphinx、GitBook和语雀。根据需求选择合适的工具。
🎯
关键要点
- 推荐使用Vitepress和Mkdocs作为静态网站生成器。
- Vitepress适合前端文档和博客，Mkdocs适合Python库的文档。
- 其他选择包括Docsify、Sphinx、GitBook和语雀。
- Vitepress由Vue团队打造，自带样式，配置灵活。
- Vitepress的主题配置包括logo、导航、侧边栏和页脚等。
- 使用Vitepress时，可以利用其自带特性，部署过程顺畅。
- Docsify是另一个JavaScript静态网站生成器，但相对Vitepress必要性较小。
- Mkdocs适合Python文档，支持简单配置和部署。
- Sphinx不推荐使用，因为不支持Markdown，界面一般。
- GitBook和语雀是其他在线文档服务，适合制作电子书和知识库。
- 总结：前端技术文档使用Vitepress，其他技术文档使用Mkdocs，面向大众的知识文档使用GitBook。
❓
延伸问答
Vitepress适合用于什么类型的文档？
Vitepress适合前端文档和博客。
Mkdocs与Vitepress有什么区别？
Mkdocs适合Python库的文档，而Vitepress更适合前端文档和博客。
使用Vitepress时需要注意哪些配置？
使用Vitepress时，可以配置主题的标题、描述、logo、导航、侧边栏和页脚等。
有哪些其他的静态网站生成器可以选择？
其他选择包括Docsify、Sphinx、GitBook和语雀。
为什么不推荐使用Sphinx？
Sphinx不支持Markdown，使用的是reStructuredText，界面也一般，因此不推荐使用。
如何部署使用Vitepress生成的网站？
完成文档后，可以通过构建生成的dist目录进行部署，推荐使用Vercel。
➡️
