VitePress介绍及使用

VitePress介绍

VitePress是VuePress的小兄弟,建立在Vite和Vue之上的,强大的静态站点生成器。

从根本上说,VuePress v1是一个底层的Webpack应用程序。即使只有两页,它也是一个完整的Webpack项目(包括所有主题源文件)正在编译。当项目有很多页面时,情况会变得更糟——每个页面都必须首先完全编译,然后服务器才能显示任何内容!

Vite 很好地解决了这些问题:几乎即时的服务器启动、仅编译正在服务的页面的按需编译以及闪电般的 HMR。另外,随着时间的推移,在VuePress v1中一些额外的设计问题,也需要大量的重构。

vuepress-next即VuePress v2,这将是VuePress的下一个主要版本。它比VuePress v1做了很多改进,现在也支持Vite。

VuePress介绍及使用

VuePress简介

VuePress是Vue 驱动的静态网站生成器。

主要特点:

(1)简洁至上
以 Markdown 为中心的项目结构,以最少的配置帮助你专注于写作。

(2)Vue 驱动
享受 Vue + webpack 的开发体验,可以在 Markdown 中使用 Vue 组件,又可以使用 Vue 来开发自定义主题。

(3)高性能
VuePress 会为每个页面预渲染生成静态的 HTML,同时,每个页面被加载的时候,将作为 SPA 运行。

VuePress官网地址:
https://vuepress.vuejs.org/zh/guide/

Hugo介绍及安装使用

Hugo介绍

The world’s fastest framework for building websites
Hugo 是世界上最快的构建网站的框架
Hugo 是最流行的开源静态站点生成器之一。凭借其惊人的速度和灵活性,Hugo 让搭建网站再次变得有趣。

英文官网:
https://gohugo.io/

中文官网:
https://www.gohugo.cn/

Hugo主题:
https://themes.gohugo.io/

Hugo快速入门

GitBook安装及使用

1、简介
GitBook 是基于Node.js的命令行工具,可以使用GitHub/Git和Markdown来制作精美的电子书。

GitBook支持多种文档格式,如pdf、epub、mobi等格式。

GitBook目前已停止更新,所以如果还要继续使用GitBook的话,建议使用低版本的NodeJS或按下文所述修改报错地方。另外,推荐使用VuePress来搭建自己的技术文档。

VuePress官方地址:
https://vuepress.vuejs.org/zh/guide/

VuePress Demo地址:
https://vuepress-theme-blog.billyyyyy3320.com/

大家可以对比GitBook和VuePress的示例,选择自己喜欢的方式搭建技术文档。