- 搭建环境
- 导航配置
- 页面配置
本文采用docsfty搭建自己的图书笔记网站(内容包括java、大数据、中间件等)
先放自己搭建的网站:dlw1314.top
源码地址:https://gitee.com/dong-admin/docs.git
准备环境:服务器(云服务器),nginx
- 克隆我的仓库https://gitee.com/dong-admin/docs.git
- 购买一台云服务器(推荐阿里云或者腾讯云)
- nginx配置(博主采用的是腾讯云提供的https的证书):
#user root;
worker_processes 4;
worker_rlimit_nofile 100000;
events {
worker_connections 10240;
use epoll;
}
http {
include mime.types;
default_type application/octet-stream;
sendfile on;
keepalive_timeout 65;
server {
server_name xxxxxxx;
#SSL 访问端口号为 443
listen 443 ssl;
#填写绑定证书的域名
#server_name cloud.tencent.com;
#证书文件名称
ssl_certificate xxxxxx_bundle.crt;
#私钥文件名称
ssl_certificate_key xxxxxx.key;
ssl_session_timeout 5m;
#请按照以下协议配置
ssl_protocols TLSv1.2 TLSv1.3;
#请按照以下套件配置,配置加密套件,写法遵循 openssl 标准。
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
ssl_prefer_server_ciphers on;
#charset koi8-r;
#access_log logs/host.access.log main;
location / {
root /usr/local/nginx/dong-docs/;
index index.html index.htm;
}
location @router {
rewrite ^.*$ /index.html last;
}
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
}
server {
listen 80;
#填写绑定证书的域名
server_name xxxxx;
#把http的域名请求转成https
return 301 https://$host$request_uri;
}
}
导航配置
需要注意的是myDocs目录内的文件下都需要配置
_navbar.md
_sidebar.md
README.md
_coverpage.md:首页配置 _navbar.md:顶部导航栏配置 _sidebar.md:侧边栏目录 myDocs:md笔记页面配置
滚动条美化
主题样式配置(可选项【vue.css dark.css buble.css dolphin.css pure.css】)
功能js引入
//docsify //表情 // 图片放大缩小支持 // 全局搜索 // md文档代码可复制 // 回到顶部 // 翻页
docsify配置
window.$docsify = {
// 项目名称
name: 'notes',
// 仓库地址,点击右上角的Github章鱼猫头像会跳转到此地址
repo: 'https://github.com/dkhsix?tab=repositories',
// 侧边栏支持,默认加载的是项目根目录下的_sidebar.md文件
loadSidebar: true,
// 导航栏支持,默认加载的是项目根目录下的_navbar.md文件
loadNavbar: true,
// 封面支持,默认加载的是项目根目录下的_coverpage.md文件
coverpage: true,
// 最大支持渲染的标题层级
maxLevel: 5,
// 自定义侧边栏后默认不会再生成目录,设置生成目录的最大层级(建议配置为2-4)
subMaxLevel: 4,
// 小屏设备下合并导航栏到侧边栏
mergeNavbar: true,
// 历史路由配置,本地调式需要注释,服务器运行则取消注释,目的是取出路由中的#
// routerMode:'history',
// 回到顶部
scrollToTop: {
auto: true,
text: 'top',
right: 30,
bottom: 30,
// 偏移量,触发按钮
offset: 500,
},
auto2top: true,
// 翻页
pagination: {
previousText: '上一章节',
nextText: '下一章节',
}
}
全局搜索配置
search: {
maxAge: 86400000,// 过期时间,单位毫秒,默认一天
paths: auto,// 注意:仅适用于 paths: 'auto' 模式
placeholder: '搜索',
// 支持本地化
placeholder: {
'/zh-cn/': '搜索',
'/': 'Type to search'
},
noData: '找不到结果',
depth: 4,
hideOtherSidebarContent: false,
namespace: 'Docsify-dkh',
}
至此搭建完毕,有问题欢迎指正



