From ba72ad1af6770a0f77419e439c8df17513cf3860 Mon Sep 17 00:00:00 2001 From: Wcowin <1135801806@qq.com> Date: Wed, 27 Nov 2024 09:12:53 +0800 Subject: [PATCH] 24/11/27 --- docs/about/geren.md | 5 +++- docs/about/link.md | 14 +++++++-- docs/blog/Mkdocs/mkfirst.md | 19 +++++++++++++ docs/blog/technique sharing/comkdocs.md | 38 +++++++++++++++++++++++++ docs/index.md | 11 ++++--- mkdocs.yml | 5 ++-- 6 files changed, 83 insertions(+), 9 deletions(-) create mode 100644 docs/blog/Mkdocs/mkfirst.md create mode 100644 docs/blog/technique sharing/comkdocs.md diff --git a/docs/about/geren.md b/docs/about/geren.md index bfe4f3dd3..bfddf219b 100644 --- a/docs/about/geren.md +++ b/docs/about/geren.md @@ -116,7 +116,10 @@ t.parentNode.insertBefore(e,t)}})(); ## 须知 如果你在浏览博客的过程中发现了任何问题，欢迎前往 GitHub 的[代码仓库](https://github.com/Wcowin/Wcowin.github.io)提交 [Issues](https://github.com/Wcowin/Wcowin.github.io/issues) 或直接修改相关文件后提交 Pull Requests。如果你有其他事情想要咨询，可以通过下方按钮使用邮件联系我,请不要滥用博客的评论功能发表与主题无关言论。 -[Send Email :fontawesome-solid-paper-plane:](mailto:){.md-button} +!!! note + 如果给我发[邮件](mailto:)，或者通过右下角微信添加好友，请写上您的**真名实姓**。对于那些不知来路、上来就问问题的微信和邮件，我通常会直接忽略，谢谢。 + + [Send Email :fontawesome-solid-paper-plane:](mailto:){.md-button} diff --git a/docs/about/link.md b/docs/about/link.md index 67b0049eb..f066be302 100644 --- a/docs/about/link.md +++ b/docs/about/link.md @@ -89,7 +89,7 @@ t.parentNode.insertBefore(e,t)}})();
- +
Munger yang's Blog @@ -638,6 +638,17 @@ t.parentNode.insertBefore(e,t)}})();
+
+ +
+ +
+ 不为繁华易匠心 +
+
+
@@ -646,7 +657,6 @@ t.parentNode.insertBefore(e,t)}})(); - diff --git a/docs/blog/Mkdocs/mkfirst.md b/docs/blog/Mkdocs/mkfirst.md new file mode 100644 index 000000000..bd1c9c99e --- /dev/null +++ b/docs/blog/Mkdocs/mkfirst.md @@ -0,0 +1,19 @@ +--- +title: Mkdocs教程前言 +tags: + - Mkdocs +--- + +## 文档教程 +入门 MKdocs 请看官方教程: +[Mkdocs 官方教程](https://www.mkdocs.org/user-guide/writing-your-docs/){target=“_blank”} + +mkdocs materials 教程: +[Mkdocs Materials](https://squidfunk.github.io/mkdocs-material/){target=“_blank”} + +我写的教程： +[Mkdocs中文教程](https://wcowin.work/Mkdocs-Wcowin/){target=“_blank”} (更全面/观感更纯净) + +## 视频教程 + +暂定于2024年12月31日发布 \ No newline at end of file diff --git a/docs/blog/technique sharing/comkdocs.md b/docs/blog/technique sharing/comkdocs.md new file mode 100644 index 000000000..b715285af --- /dev/null +++ b/docs/blog/technique sharing/comkdocs.md @@ -0,0 +1,38 @@ +--- +title: 基于 Mkdocs 的主题与站点 +number: 14 +slug: discussions-14/ +url: https://github.com/shenweiyan/Knowledge-Garden/discussions/14 +date: 2023-11-08 +authors: [shenweiyan] +categories: + - 好玩 +tags: + - 技术分享 +labels: ['mkdocs'] +--- + +鉴于 MkDocs 的诸多优点，让它被很多知名开源项目选中，用于搭建和项目相关的文档网站。比如 Python 里知名的 Web 圈里的 [django-rest-framework](https://sspai.com/link?target=https%3A%2F%2Fwww.django-rest-framework.org%2F)、[FastAPI](https://sspai.com/link?target=https%3A%2F%2Ffastapi.tiangolo.com%2F) 以及基于 Go 编写的云网关代理服务器 [traefik](https://sspai.com/link?target=https%3A%2F%2Fgithub.com%2Ftraefik%2Ftraefik) 等项目的官方文档站点，都是通过 MkDocs 进行搭建。 + + + +下面列的是搜集的一些 Mkdocs 主题与站点，以供参考。 + +- Hello 算法 - +- FDU-MSC 论坛 - +- Django REST framework - +- FastAPI - +- Chrisjing 的运维之旅精选 - +- 艇仔粥 TingZaiZuk - +- Arisa | Blog - +- 嬉戏实验室 - +- 老胡的周刊 - [weekly.howie6879.com](https://weekly.howie6879.com/) +- Jeremy Feng - +- 我的工作学习生活笔记 - +- Power's Wiki - + --- +- [Lenny's Web](https://lennychen.top) +- [苍镜月's docs](https://pale-illusions.github.io/my-mkdocs/) +- [世界天光的笔记本](https://lastwish.icu/) +- [Wen-Chieh Lee的生活](https://wenchiehlee.github.io/mkdocs-life/) +- [Wcowin's Web](https://wcowin.work/) \ No newline at end of file diff --git a/docs/index.md b/docs/index.md index a30e03353..b9d389aca 100644 --- a/docs/index.md +++ b/docs/index.md @@ -11,7 +11,10 @@ comments: false # 主页
“循此苦旅 以达星辰”
- + + + + + diff --git a/mkdocs.yml b/mkdocs.yml index 8300d3a51..28491ef43 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -13,7 +13,6 @@ theme: # text: Bitter # code: Roboto Mono logo: https://s1.imagehub.cc/images/2024/02/02/91a767e93d1a344e44c69936464c583e.png - #https://s1.imagehub.cc/images/2024/02/02/91a767e93d1a344e44c69936464c583e.png # https://s2.loli.net/2024/02/01/gaE47y5fKM6kosV.png favicon: https://s2.loli.net/2024/04/06/yEOZavwMr6kTWhu.png palette: @@ -81,11 +80,13 @@ nav: - 技术: - blog/indexblog.md - 好用/好玩网站分享: blog/Webplay.md + - 基于 Mkdocs 的主题与站点: blog/technique sharing/comkdocs.md - 甜甜圈🍩代码: blog/technique sharing/ttq.md - Mac/windows软件网站汇总: blog/macsoft.md - 语雀: blog/yuque.md - Telegram 群组、频道、机器人 汇总分享: blog/TG.md - MKdocs教程: + - Mkdocs教程前言: blog/Mkdocs/mkfirst.md - 利用mkdocs部署静态网页至GitHub pages: blog/Mkdocs/mkdocs1.md - Mkdocs部署静态网页至GitHub pages配置说明(mkdocs.yml): blog/Mkdocs/mkdocs2.md - 解决 mkdocs部署 Github Pages 自定义域名失效的问题: blog/Mkdocs/mkdocs3.md @@ -318,7 +319,7 @@ extra: analytics: provider: google - property: G-29HZMNR0KG + property: G-29HZMNR0KG ##如果你 clone 了my模板，请将这个修改为你的 # !ENV GOOGLE_ANALYTICS_KEY feedback: title: 此页面有帮助吗？