一、什么是 Docsify 和 GitHub Pages

Docsify 是一个动态的文档网站生成器,它可以帮助您从 Markdown 文件快速创建文档网站。它具有轻量级、高效、易于使用的特点,可以帮助您快速构建文档网站。GitHub Pages 是一种静态网站托管服务,可以让您将静态网站托管在 GitHub 上,从而免费托管您的网站。

二、如何使用 Docsify 和 GitHub Pages 创建文档网站

1、首先,您需要在 GitHub 上创建一个仓库,并将其命名为“username.github.io”,其中 username 是您的 GitHub 用户名。

2、然后,您需要在本地文件夹中创建一个新文件夹,并将其命名为“username.github.io”,其中 username 是您的 GitHub 用户名。

3、接下来,您需要安装 Docsify,请执行以下命令:

$ npm install docsify-cli -g
JavaScript

4、最后,您需要在本地文件夹中初始化 Docsify,请执行以下命令:

$ docsify init ./username.github.io
JavaScript

三、将文档网站发布到 GitHub Pages

1、首先,您需要将本地文件夹中的文件发布到 GitHub 仓库,请执行以下命令:

$ git init$ git add .$ git commit -m "Initial commit"$ git remote add origin https://github.com/username/username.github.io.git$ git push -u origin master
JavaScript

2、接下来,您需要在 GitHub 仓库中启用 GitHub Pages,请执行以下步骤:

  • 登录 GitHub,然后打开您的仓库;
  • 点击仓库上方的“Settings”按钮;
  • 在“GitHub Pages”部分中,选择“master branch”作为源;
  • 点击“Save”按钮,完成启用 GitHub Pages 的步骤。

3、最后,您可以访问“username.github.io”,就可以看到您的文档网站了。