跳转至

MkDocs+Github建站教程

☯ 前言 ☯

教程共计四套:

🍀简明教程:3集 / 60min / MkDocs快速建站、GitHub部署

🍀详细教程:24集 / 3h / MkDocs手把手详细建站流程、GitHub部署及问题解决

🍀进阶教程:35集 / 5h / MkDocs网站架构丰富、文章优化、GitHub进阶应用

🍀高阶教程:19集 / 4h / MkDocs个性化定制、站点盈利方案


一、简明教程

录制完成 / 已发布 / 2025.02.10 / 免费

📺B站合集 | 给纯小白做的MkDocs+Github建站、优化教程(简明教程)


📺B站单集 | 1.MkDocs创建个人网站(介绍、安装、主题、本地服务器)

📺B站单集 | 2.将MkDocs个人网站免费托管到Github

📺B站单集 | 3.MkDocs网站优化(界面优化、文章添加)

二、详细教程

录制中 / 待发布 / 预计发布时间 2025.02.20 / 首发价格 9.9元

✅ 课程目录:

1.MkDocs快速建站
1.0 为什么录制收费的进阶教程、你能学到什么?
1.1 环境配置 - Python、pip安装工具、环境变量配置
1.2 编程软件 - VSCode安装、配置
1.3 静态站点生成器 - MkDocs安装、常用命令
1.4 MkDocs - 新建项目、目录详解、主题分类、Material主题配置
1.5 本地服务器介绍、启动

2.MkDocs站点架构
2.1 网站名称、图标定义修改(顶部)
2.2 明暗模式按钮添加(顶部)
2.3 版权声明、MkDocs内容隐藏(底部页脚)
2.4 社交网络图标和链接(底部页脚)
2.5 导航目录分类及自定义
2.6 顶部标签页设置
2.7 文章编辑、导航关联设置
2.8 Markdown常用语法使用(文章中、导航目录) 2.9 代码块
2.10 文章插入图片方法(本地)
2.11 站点语言定义、搜索相关设置

3.GitHub托管部署
3.1 GitHub账号注册
3.2 加速器下载安装、使用
3.3 新建仓库、权限修改(user和project的区别)
3.4 Git工具安装、配置
3.5 MkDocs项目推送到GitHub、部署
3.6 分支、网站访问、本地修改内容部署
3.7 高质量参考资源汇总、高阶课程介绍

三、进阶教程

录制中 / 待发布 / 预计发布时间 2025.02.28 / 首发价格 29.9元

✅ 课程目录:

1.MkDocs文档美化、拓展
1.0 学习进阶教程、你能掌握哪些技能?
1.1 符号:简约及彩色符号运用、符号资源汇总
1.2 图片:MkDocs图片扩展插件markdown-include安装、配置、使用
1.3 图片:插入在线图片、图床平台选择创建及使用
1.4 视频:MkDocs视频扩展插件mkdocs-video安装、配置、使用
1.5 音频:MkDocs音频扩展插件mkdocs-audio安装、配置、使用
1.6 文件下载:MkDocs下载扩展插件mkdocs-static-i18n安装、配置、使用
1.7 PDF:手动嵌入
1.8 PDF:MkDocs页面PDF导出、PDF预览插件mkdocs-pdf-export-plugin
1.9 PDF:MkDocs页面PDF导出、PDF预览插件mkdocs-with-pdf

2.MkDocs站点架构美化、拓展
2.1 网站Logo:不同在线库使用
2.2 按钮:网站语言切换 | 自动翻译
2.3 按钮:回到顶部、翻页
2.4 公告栏:Follow - 首次访问网站
2.5 GitHub仓库显示
2.6 时间戳:文档修订时间显示、git-revision-date-localized-plugin
2.7 贡献者显示
2.8 此页面有帮助吗?大拇指推荐或不推荐按钮
2.9 访问量显示
2.10 标签Tags:定义、使用
2.11 Tips设置方法 2.12 网站字体修改
2.13 鼠标样式
2.14 页面背景特效
2.15 评论系统设置
2.16 友链板块添加
2.17 404页面:公益、宣传、哲学
2.18 支持我!Buy me a coffee!
2.19 博客系统:MkDocs内置blog插件
2.20 天气信息获取及展示 - 天气组件

3.GitHub托管部署相关、问题解决
3.1 域名:个性化域名购买、绑定、失效问题解决
3.2 加速器:下载安装、使用
3.3 新建仓库、权限修改(user和project的区别)
3.4 Git工具安装、配置(邮箱、用户名、SSH)
3.5 GitHub Desktop克隆仓库、非代码推送

四、高阶教程

录制中 / 待发布 / 预计发布时间 2025.03.15 / 首发价格 69.9元

✅ 课程目录:

1.MkDocs文档HTML/CSS拓展
1.0 学习MkDocs高阶教程,实现网站盈利
1.1 图片:HTML标签插入图片、显示尺寸调整
1.2 视频:HTML标签嵌入本地、在线视频
1.3 音频:HTML标签嵌入本地、在线音频
1.4 文件下载:HTML标签定义浏览器直接下载
1.5 文件下载:HTML和CSS自定义下载按钮样式
1.6 PDF.js功能、使用
1.7 Google Docs文档嵌入

2.MkDocs站点架构美化、拓展
2.1 网站主页:页面设计 | 哲理诗词等随机显示、侧边栏目录隐藏
2.2 网站Logo:个性化绘制、替换
2.3 页面圆角化:CSS方法 - 搜索框/按钮圆角化
2.4 在线聊天:Tidio
2.5 导航界面个性化定制
2.6 观世界界面定制:最新 | 热点 | 价值
2.7 内容盈利:收费系统 | 加密方法
2.8 内容盈利:广告联盟、收益

3.GitHub自动化部署、站点矩阵、优化
3.1 自动化部署解决方案
3.2 网站矩阵规划、配置
3.3 域名、子域名与网站矩阵设置

3.4 Cookie设置
3.5 社交媒体分享按钮
3.6 如何支持Latex
3.7 网页渲染速度
3.8 移动端效果优化
3.9 引入AI机器人
3.9 Ask agent 3.10 如何优化网站图片加载流畅度
3.11 倒计时功能 - 动态
3.12 搜索引擎收录 - 百度/谷歌
3.13 图床 smms
3.14 在mkdocs.yml的plugins模块中引入!ENV [CI, false]语句,极大缩短mkdocs serve静态预览时间(3-5s)
3.15 使用软编码配置友链界面
3.16 CDN 加速
3.17 glightbox插件(已取消),图片查看更方便
3.18 优秀参考站点
3.19 MkDocs - Open in new tab plugin
3.20 文本框
3.21 此时此刻感受界面
3.22 分类标签放置到顶部导航标签