零基础也能写博客：cpolar简化Docsify远程发布流程

文章目录

- 前言
- [1. 本地部署Docsify](#1. 本地部署Docsify)
- [2. 使用Docsify搭建个人博客](#2. 使用Docsify搭建个人博客)
- - - - 封面配置文件（_coverpage.md）
- [3. 安装Cpolar内网穿透工具](#3. 安装Cpolar内网穿透工具)
- [4. 配置公网地址](#4. 配置公网地址)
- [5. 配置固定公网地址](#5. 配置固定公网地址)
- - - [用 cpolar 让 Docsify 实现博客速成和远程协作就是这么简单！三步轻松搞定：在电脑上创建 Markdown 文件，运行 Docsify 生成博客，用 cpolar 创建协作链接邀请团队成员。这个方法不仅免费，还支持自定义主题，让你的博客个性十足。不管你是程序员、学生还是职场人士，都能通过这个组合快速搭建博客，高效协作编辑。现在就试试吧，让你的知识分享之旅从这里开始！](#用 cpolar 让 Docsify 实现博客速成和远程协作就是这么简单！三步轻松搞定：在电脑上创建 Markdown 文件，运行 Docsify 生成博客，用 cpolar 创建协作链接邀请团队成员。这个方法不仅免费，还支持自定义主题，让你的博客个性十足。不管你是程序员、学生还是职场人士，都能通过这个组合快速搭建博客，高效协作编辑。现在就试试吧，让你的知识分享之旅从这里开始！)

前言

你是否也曾想拥有一个属于自己的技术博客，分享学习心得和项目经验，却被复杂的搭建过程吓退？或者，想和团队一起编写技术文档，却找不到简单高效的协作工具？其实，用 Docsify+cpolar，零编程基础也能在 10 分钟内搭建一个美观的技术博客，还能实现多人远程协作编辑。

Docsify 是一款神奇的工具，它能把你的 Markdown 文件直接变成漂亮的网页博客，不用写一行代码。但很多人不知道，配合 cpolar，它还能变成 "多人协作平台"，让你和团队成员随时随地共同编辑文档。用 Docsify+cpolar，在同一个文档上编辑，实时看到对方的修改，效率提高太多了。"

为什么这个组合能让博客搭建和协作变得如此简单？打个比方，Docsify 就像一个 "智能文档模板"，你往里面填 Markdown 内容，它自动帮你排版成网页。cpolar 相当于给这个模板装了 "共享编辑功能"，让多人可以同时编辑，就像用在线文档一样简单。

接下来，我们就来手把手教你如何用 Docsify 搭建个人技术博客，如何通过 cpolar 实现远程协作。全程都是简单的文件操作和点击，没有难懂的命令，保证你一看就会，让技术分享和团队协作变得前所未有的轻松。

接下来，讲解如何在本地部署Docsify。

1. 本地部署Docsify

本篇文章安装环境：Windows10

Docsify 项目github地址：GitHub - docsifyjs/docsify: 🃏 A magical documentation site generator.

Docsify官方文档教程：https://docsify.js.org/#/zh-cn/

准备工具： node.js、Typora、cpolar内网穿透

Node.js （官网）：https://nodejs.org/zh-cn

Typora（官网）：https://typoraio.cn

首先查看node.js是否已安装

shell 复制代码

node -v

查看npm是否已安装

shell 复制代码

npm -v

如未安装，进入到node.js官网下载安装

安装完后，接下来需要安装Docsify本地全局工具

shell 复制代码

npm i docsify-cli -g

初始化Docsify本地项目

shell 复制代码

docsify init ./docs

启用本地网页预览

shell 复制代码

docsify serve docs

2. 使用Docsify搭建个人博客

打开此电脑------C盘------用户------文档------docs文件夹

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

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

直接编辑 docs/README.md 就能更新文档内容，当然也可以[添加更多页面。

打开 README文档，做为主页内容渲染

在这个文档中进行修改，设计自己的个人博客，修改标题，添加文章内容，并保存

制作一个个人文档，我们只需要配置以下这几个基本文件就可以：

文件作用	文件
基础配置项（入口文件）	index.html
封面配置文件	_coverpage.md
侧边栏配置文件	_sidebar.md
导航栏配置文件	_navbar.md
主页内容渲染文件	README.md
浏览器图标	favicon.ico

还有很多配置项可以参考docsify文档中的定制化-配置项---小节，定制的东西越多，维护的难度就越大。侧边栏、导航栏和封面都建议采用默认的文件渲染：

这里举例官网的封面配置文件

封面配置文件（_coverpage.md）

封面的生成同样是从 markdown 文件渲染来的。开启渲染封面功能后在文档根目录创建 _coverpage.md 文件。渲染效果如本文档。

index.html

html 复制代码

<!-- index.html -->

<script>
  window.$docsify = {
    coverpage: true
  }
</script>
<script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js"></script>
<!-- _coverpage.md -->

![logo](_media/icon.svg)

# docsify <small>3.5</small>

> 一个神奇的文档网站生成器。

- 简单、轻便 (压缩后 ~21kB)
- 无需生成 html 文件
- 众多主题

[开始使用 Let Go](/README.md)

继续回到我们刚才搭建的页面，打开一个新的浏览器，输入localhost:3000，或者本机IP地址:3000

这样我们就在本地搭建了一个简单的个人文档博客，博客排版风格也可以自己随意设计，但是目前我们已经在本地搭建好了博客网站，如果没有公网IP的话，只能在本地局域网环境使用，有一定的局限性。如果出门在外想远程访问使用的话，可以结合cpolar内网穿透生成公网地址，免去了本地重新部署过程，只需要使用公网地址直接进就可以访问本地部署的Docsify，随时管理网站。