继续浏览精彩内容
慕课网APP
程序员的梦工厂
打开
继续
感谢您的支持,我会继续努力的
赞赏金额会直接到老师账户
将二维码发送给自己后长按识别
微信支付
支付宝支付

10 款开源文档框架,你值得看看!

狐的传说
关注TA
已关注
手记 336
粉丝 88
获赞 555

想为你的项目建个文档网站吗?来对地方了,这儿就是你要找的地方!

我们将看看一些你可以用来快速生成项目文档的文档框架。

开始吧!

1. VitePress 第一技术栈

首先,我推荐使用 VitePress,这是一个由 Vue.js 驱动的静态网站生成器,特别适合用来生成文档站点。它专为构建文档网站进行了优化,并从 Markdown 文件生成页面,非常适用于编写和维护技术文档。

默认主题具有现代而美观的外观。它还自带暗模式,并且自带搜索功能。您还可以通过配置 Vitepress 来增加封面页,来展示您项目库的特点。

它上手超级快,基于 Vite,使其变得非常快 ⚡️。

预览

Vitepress 的首页

官网 : Vitepress

GitHub 项目主页 : Vitepress GitHub 项目主页

特性

  • 快速且 SEO 友好
  • 暗模式主题
  • 专注于 Markdown
  • 内置搜索
  • 快速设置

使用AI代理构建文档网站:如果您想使用Vitepress构建一个文档网站,请务必查看这个由Isotope AI代理支持的文档生成器。只需输入您的GitHub仓库地址,您的Vitepress文档网站就会快速生成。

如果你不想从零开始,这些有趣且实用、面向开发者的文档页面(包括入门指南等)会非常有用!

然后你可以将所有代码和文档导出以便添加到你的代码库中。

🍵 Vitepress Catppuccin 主题

为了达到淡雅的效果,一定要看看Catppuccin Vitepress插件,它提供了四个漂亮的主题供选择。

🌞 亮模式

Catppucin轻主题在Vitepress上的演示(Vitepress(一个静态站点生成器))

🌙 夜间模式

Catppucin 暗色主题的 Vitepress 小 demo

提示:你也可以渲染 Vue 组件,这对于展示代码示例或在文档中展示自定义组件非常有用。

Catppucin

……

2. 吸烟档案\Fumadocs

Fumadocs 是一个新的文档框架工具,它利用 Next.js 构建文档站点。它具有极现代的视觉风格和惊艳的用户界面。

它是由 Next.js 驱动的,并且有许多实用的组件可以添加到页面上。

先看一下

Fumadocs 页面,有侧边栏、文本元素和卡片

网站 : Fumadocs

GitHub 仓库 : GitHub

特点

  • 现代界面,惊艳的设计
  • 灵活响应式布局
  • 使用 Markdown 编写的文档
  • 内置搜索
  • 支持本地化设置

……

3. mdBook

我接下来要推荐的一个工具是 mdBook(mdBook),它是一个基于 Rust 的文档站点生成器,安装和设置都很方便快捷。

它有一套很酷的主题,并支持暗模式,暗模式预览如图所示。你可以通过点击顶部栏的画刷图标来切换主题。

MDBook还自带搜索功能和代码语法高亮,这在你想要在文档中插入代码片段时非常有用。

🌞 浅色模式

示例页面

🌙 暗黑模式

mdBook Dark主题页

官网 : Website

GitHub 项目主页 : GitHub Repo

特性:

  • 基于 Rust 技术
  • 简洁现代的界面
  • 支持内置搜索功能
  • 多种主题任您选择

此处省略

4. MkDocs (文档生成工具)章节

接下来,我建议你看看MkDocs!它是用 Python 语言编写的,使用Markdown进行内容编写,提供了多种惊艳的主题。

只需将你的内容文件以 Markdown 格式添加,再用一条命令,你的文档就会自动生成!

我经常用这个来为我的仓库搭建文档站点,非常推荐大家使用,因为它安装和设置都很快。

网站 : MkDocs

GitHub 代码库 : GitHub 代码库

特点

  • 快速安装和设置
  • 多种主题可供选择
  • Markdown 格式的创作
  • 插件众多

MKDocs Material主题

最流行的主题之一是 MKDocs Material,它具有非常现代的美学设计。它支持暗模式和内容搜索功能,还有许多其他实用的功能。

我在一个开源项目中使用它,并强烈推荐这个工具。你可以在这里查看演示:here

下面是一个预览:

图片说明:具体描述

使用AI代理来创建:如果你想为你的库或GitHub仓库生成一个MKDocs Material站点(或页面),可以试一下这个生成器

……

5. Docusaurus - 一个文档生成工具

Docusaurus 是由 Facebook 开发并采用 React 构建的现代文档生成器。它是最受欢迎的文档生成器之一,在 GitHub 上拥有超过 5 万颗星的热度。

它提供了很多自定义选项,让你可以调整生成网站的外观和风格。

🌞 明亮主题

Docusaurus 安装页面图

🌙 暗黑模式 :

Docusaurus配置页面,包含文本元素

网站 : Docusaurus

GitHub 页面仓库 : GitHub 代码库

特色

  • 基于 React 构建
  • 可自定义的主题和布局
  • 全面的文档
  • 版本管理和本地化支持

停停停

6. 瓦片

如果你想构建API文档,我推荐你看看Slate。这是一个流行的开源工具,专为创建美观且响应迅速的API文档而设计。它简洁的布局和简单的导航使其成为记录RESTful API的首选。

预告:

[ Slate 文件 ]

网站 : Slate 仓库

GitHub 代码库 : GitHub 代码库

特点

  • 响应式和现代设计
  • 简洁直观的导航
  • 基于 Markdown 的内容编写
  • 可自定义的样式
  • 详细的文档说明

    • *
7. 星空之旅

Astro 是一个超快的静态网站生成工具,你可以用它来构建博客、文档网站等,用途广泛。它自带一个名为 Starlight 的文档主题,非常实用,拥有内置搜索功能、暗黑主题、多语言支持等特性。

🌙 夜间模式

星空页面的暗主题图

🌞 轻松模式

星光

网站 : Starlight

GitHub 项目 : GitHub

特点:

  • 快速上手
  • 深色模式
  • 详尽的文档和示例
  • 基于 Astro 构建

    • *
8. Docsify 文档

使用 Docsify 可以实时生成文档网站,无需通过静态站点生成器进行构建。只需编写 Markdown 文件即可,接下来 Docsify 就会处理剩下的部分。

你还可以设置 Docsify 来生成一个全屏封面,它的背景有一个酷炫的随机渐变背景。下面是一个预览图:

文档的封面图

无需任何构建步骤,我推荐使用Docsify,它是一个可以直接使用的文档网站。

网站 : Docsify

GitHub 页面 : GitHub 仓库
自动生成仓库 : 生成器链接

特点

  • 无需构建
  • 实时渲染 Markdown
  • 可自定义的主题和插件
  • 轻松集成和设置
9. 佐拉作品

Zola 是一个用 Rust 编写的静态站点生成器。它有一些很棒的文档主题,你可以用它来快速搭建文档网站。其中一个主题是 EasyDocs,其预览如下。该主题采用现代简洁的设计,并且设置简单快捷。

先来看一下:

先来看一下

Zola EasyDocs

网站 : Zola Easy Docs 主题

GitHub 代码库 : GitHub 代码库

特点

  • 从 Markdown 生成静态 HTML 页面
  • 简单的配置和部署
  • 轻量且快速
  • 简洁且响应式的设计
  • 组织良好的文档

    • *
10. 文档

Docus 是一个文档主题,由 Nuxt 和 Vue 驱动。整体设置非常快速,并使用基于 Markdown 的系统进行内容编写。

它包含了一些在构建文档网站时可能很有用的内置组件。你可以在配置选项中快速设置网站的社交媒体链接等信息,这些信息将显示在页面顶部。

先看看预览

Docus 文档示例页

演示版 : Docus 演示

GitHub 仓库 : GitHub 仓库链接

特点

  • 使用 Nuxt 驱动
  • 提供多种布局,如博客文章
  • 采用 Markdown 格式
  • 提供众多实用组件
想要更多这样的资源吗?

如果你想了解更多这样的好东西,记得关注我或者在我的Twitter上关注我@silvia_923,我会在那里分享更多有用的框架汇总,同时也会有代码教程哦。希望你会喜欢!

最后

结尾

结论语

总结一下:

谢谢你的阅读!希望你已经找到了一些新框架可以看看。

你还有其他想推荐的吗?有的话告诉我,我很乐意加上新的例子,更新这个列表!

祝你事事顺心,希望很快再见到你!

打开App,阅读手记
0人推荐
发表评论
随时随地看视频慕课网APP