docsify 如何写博客

痛定思痛。 2023-07-17 02:42 96阅读 0赞

# 1. 安装node #

下载安装即可： [https://nodejs.org/zh-cn/][https_nodejs.org_zh-cn]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbHZpbmU_size_16_color_FFFFFF_t_70][]

下载文件：

[https://nodejs.org/dist/v12.16.1/node-v12.16.1-x64.msi][https_nodejs.org_dist_v12.16.1_node-v12.16.1-x64.msi]

[https://nodejs.org/dist/v13.11.0/node-v13.11.0-x64.msi][https_nodejs.org_dist_v13.11.0_node-v13.11.0-x64.msi]

# 2. 安装git #

[https://git-scm.com/][https_git-scm.com]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbHZpbmU_size_16_color_FFFFFF_t_70 1][]

下载文件：

[https://github.com/git-for-windows/git/releases/download/v2.25.1.windows.1/Git-2.25.1-32-bit.exe][https_github.com_git-for-windows_git_releases_download_v2.25.1.windows.1_Git-2.25.1-32-bit.exe]

[https://github.com/git-for-windows/git/releases/download/v2.25.1.windows.1/Git-2.25.1-64-bit.exe][https_github.com_git-for-windows_git_releases_download_v2.25.1.windows.1_Git-2.25.1-64-bit.exe]

# 3.npm安装docsify #

[docsify中文官方地址：https://docsify.js.org/\#/zh-cn/quickstart][docsify_https_docsify.js.org_zh-cn_quickstart]

## 1). 安装 `docsify-cli` 工具 ##

推荐安装 `docsify-cli` 工具，可以方便创建及本地预览文档网站。

$npm i docsify-cli -g

## 2). 初始化新项目 ##

如果想在项目的 `./docs` 目录里写文档，直接通过 `init` 初始化项目。

$docsify init ./docs

## 3). 项目结构说明 ##

初始化成功后，可以看到 `./docs` 目录下创建的几个文件

*  `index.html` 入口文件
 *  `README.md` 会做为主页内容渲染
 *  `.nojekyll` 用于阻止 GitHub Pages 会忽略掉下划线开头的文件

直接编辑 `docs/README.md` 就能更新网站内容，当然也可以多个页面。

## 4). docsify命令启动项目 ##

运行一个本地服务器通过 `docsify serve` 可以方便的预览效果，而且提供 LiveReload 功能，可以让实时的预览。默认访问 [http://localhost:3000][http_localhost_3000] 。

$docsify serve docs

更多命令行工具用法，参考 [docsify-cli 文档][docsify-cli]。

更多用法请参考官网：[https://docsify.js.org/][https_docsify.js.org]

**笔者的微信公众号，每天一篇好文章：**

![70][] 标题

[https_nodejs.org_zh-cn]: https://nodejs.org/zh-cn/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbHZpbmU_size_16_color_FFFFFF_t_70]: /images/20230528/c653ba289b8147b2a6e9ea816d672f73.png
[https_nodejs.org_dist_v12.16.1_node-v12.16.1-x64.msi]: https://nodejs.org/dist/v12.16.1/node-v12.16.1-x64.msi
[https_nodejs.org_dist_v13.11.0_node-v13.11.0-x64.msi]: https://nodejs.org/dist/v13.11.0/node-v13.11.0-x64.msi
[https_git-scm.com]: https://git-scm.com/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JlbHZpbmU_size_16_color_FFFFFF_t_70 1]: /images/20230528/d542a24500d34f3080492284e7c4acfa.png
[https_github.com_git-for-windows_git_releases_download_v2.25.1.windows.1_Git-2.25.1-32-bit.exe]: https://github.com/git-for-windows/git/releases/download/v2.25.1.windows.1/Git-2.25.1-32-bit.exe
[https_github.com_git-for-windows_git_releases_download_v2.25.1.windows.1_Git-2.25.1-64-bit.exe]: https://github.com/git-for-windows/git/releases/download/v2.25.1.windows.1/Git-2.25.1-64-bit.exe
[docsify_https_docsify.js.org_zh-cn_quickstart]: https://docsify.js.org/#/zh-cn/quickstart
[http_localhost_3000]: http://localhost:3000/
[docsify-cli]: https://github.com/docsifyjs/docsify-cli
[https_docsify.js.org]: https://docsify.js.org/
[70]: /images/20230528/a93abff54fa94c69ac2390ec6c50de87.png