2026/4/17 17:36:27
网站建设
项目流程
网站做交叉连接,个人简介网站html代码,网站建设的主题,怎么找人做淘宝网站Docsify 是一款轻量级文档网站生成工具#xff0c;能直接将 Markdown 文件转换成带目录、搜索、代码高亮的在线文档#xff0c;无需构建编译#xff0c;修改后保存即生效。它适合技术团队维护 API 手册、教师整理课程资料、个人搭建学习笔记库#xff0c;优点是零配置上手快…Docsify 是一款轻量级文档网站生成工具能直接将 Markdown 文件转换成带目录、搜索、代码高亮的在线文档无需构建编译修改后保存即生效。它适合技术团队维护 API 手册、教师整理课程资料、个人搭建学习笔记库优点是零配置上手快、全平台兼容手机和电脑都能流畅访问且无需掌握专业前端知识。使用时能感受到它的便捷性但也有小细节需要注意建议用清晰的文件夹结构管理 Markdown 文件方便后续查找默认侧边栏和封面足够日常使用过度定制插件可能增加维护成本如果文档包含大量图片建议统一存储路径避免链接失效。不过 Docsify 默认仅支持局域网访问限制了使用场景团队成员异地办公时无法实时查看最新的文档更新个人想把学习笔记分享给外地朋友只能通过文件传输无法提供在线浏览体验教师在机房搭建的编程教程学生回家后就无法继续查阅复习。而 Docsify 与 cpolar 结合后这些问题都能轻松解决。cpolar 能为局域网内的 Docsify 文档生成公网访问地址无需购买云服务器或配置域名支持一键分享。借助这个公网链接团队成员异地也能协同维护文档个人笔记可直接分享给他人教师的课程资料学生在家也能随时访问大大拓展了文档的使用范围。好的软件当然不能光说不练教程已经准备如下有需要的小伙伴快去安装起来吧接下来讲解如何在本地部署Docsify。1. 本地部署Docsify本篇文章安装环境Windows10Docsify 项目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-cnTypora官网https://typoraio.cn首先查看node.js是否已安装node-v查看npm是否已安装npm-v如未安装进入到node.js官网下载安装安装完后接下来需要安装Docsify本地全局工具npmi docsify-cli -g初始化Docsify本地项目docsify init ./docs启用本地网页预览docsify serve docs2. 使用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!-- index.html --scriptwindow.$docsify{coverpage:true}/scriptscriptsrc//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js/script!-- _coverpage.md -- # docsifysmall3.5/small 一个神奇的文档网站生成器。 - 简单、轻便 (压缩后 ~21kB) - 无需生成 html 文件 - 众多主题 [开始使用 Let Go](/README.md)继续回到我们刚才搭建的页面打开一个新的浏览器输入localhost:3000或者本机IP地址:3000这样我们就在本地搭建了一个简单的个人文档博客博客排版风格也可以自己随意设计但是目前我们已经在本地搭建好了博客网站如果没有公网IP的话只能在本地局域网环境使用有一定的局限性。如果出门在外想远程访问使用的话可以结合cpolar内网穿透生成公网地址免去了本地重新部署过程只需要使用公网地址直接进就可以访问本地部署的Docsify随时管理网站。3. 安装Cpolar内网穿透工具下面是安装cpolar步骤Cpolar官网地址: https://www.cpolar.com点击进入cpolar官网点击免费使用注册一个账号并下载最新版本的Cpolar登录成功后点击下载Cpolar到本地并安装一路默认安装即可本教程选择下载Windows版本。Cpolar安装成功后在浏览器上访问http://localhost:9200使用cpolar账号登录,登录后即可看到Cpolar web 配置界面,结下来在web 管理界面配置即可。4. 配置公网地址接下来配置一下本地 Docsify 的公网地址登录后点击左侧仪表盘的隧道管理——创建隧道创建一个 个人博客网站 的公网http地址隧道隧道名称可自定义命名注意不要与已有的隧道名称重复协议选择 http本地地址3000域名类型免费选择随机域名地区选择China VIP点击创建隧道创建成功后点击左侧的状态——在线隧道列表,查看所生成的公网访问地址有两种访问方式,分别是http和https。使用任意一个上面Cpolar生成的公网地址,在电脑或任意设备在浏览器进行登录访问,即可成功看到 本地博客网站 界面,这样一个可以远程访问的公网地址就创建好了,使用了Cpolar的公网域名,无需自己购买云服务器,即可在公网访问本地部署的服务了5. 配置固定公网地址我们接下来为其配置固定的HTTP端口地址该地址不会变化方便分享给别人长期查看你的本地服务而无需每天重复修改服务器地址。配置固定http端口地址需要将cpolar升级到专业版套餐或以上。登录cpolar官网点击左侧的预留选择保留二级子域名设置一个二级子域名名称点击保留,保留成功后复制保留的二级子域名名称。本教程中我创建的是二级子域名是 myhugo1大家可以自定义创建。返回登录Cpolar web UI管理界面点击左侧仪表盘的隧道管理——隧道列表找到所要配置的隧道 myblog 点击右侧的编辑修改隧道信息将保留成功的二级子域名配置到隧道中域名类型选择二级子域名Sub Domain填写保留成功的二级子域名点击更新(注意,点击一次更新即可,不需要重复提交)更新完成后,打开在线隧道列表,此时可以看到公网地址已经发生变化,地址名称也变成了固定的二级子域名名称的域名最后我们使用固定的公网地址在任何浏览器打开访问可以看到成功访问使用Docsify搭建好的本地博客网站这样一个固定且永久不变的二级子域名公网地址就设置好了。以上就是如何在Windows系统电脑本地使用Docsify搭建一个博客网站并结合cpolar内网穿透工具实现一键发布公网随时随地远程访问的全部流程。感谢您的观看有任何问题欢迎留言交流。总之Docsify 简化了专业文档站的搭建流程cpolar 则让局域网内的文档突破网络限制。二者组合为个人、团队和教育场景提供了高效、低成本的文档管理与分享方案让文档的创建、更新和传播变得更加灵活便捷。cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站