Skip to content

Commit

Permalink
24/11/27
Browse files Browse the repository at this point in the history
  • Loading branch information
Wcowin committed Nov 27, 2024
1 parent 5ba1f1c commit ba72ad1
Show file tree
Hide file tree
Showing 6 changed files with 83 additions and 9 deletions.
5 changes: 4 additions & 1 deletion docs/about/geren.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:<[email protected]>){.md-button}
!!! note
如果给我发[邮件](mailto:<[email protected]>),或者通过右下角微信添加好友,请写上您的**真名实姓**。对于那些不知来路、上来就问问题的微信和邮件,我通常会直接忽略,谢谢。

[Send Email :fontawesome-solid-paper-plane:](mailto:<[email protected]>){.md-button}

<!-- <a target="_blank" href="mailto:[email protected]""><button class="buttonxuan2" style="vertical-align:middle" ><span>Send Email:fontawesome-solid-paper-plane: </span></button></a> -->

Expand Down
14 changes: 12 additions & 2 deletions docs/about/link.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ t.parentNode.insertBefore(e,t)}})();
</div>
</div>
<div class="card">
<img class="ava" src="https://mungeryang.github.io/images/avatar.png?v=1696728951294" />
<img class="ava" src="https://mungeryang.github.io/img/bg/person1.jpeg" />
<div class="card-header">
<div>
<a href="https://mungeryang.github.io/" target="_blank">Munger yang's Blog</a>
Expand Down Expand Up @@ -638,6 +638,17 @@ t.parentNode.insertBefore(e,t)}})();
</div>
</div>
</div>
<div class="card">
<img class="ava" src="https://magren.cc/avatar.png" />
<div class="card-header">
<div>
<a href="https://magren.cc" target="_blank">Magren's Blog</a>
</div>
<div class="info">
不为繁华易匠心
</div>
</div>
</div>


</div>
Expand All @@ -646,7 +657,6 @@ t.parentNode.insertBefore(e,t)}})();




<!-- <div class="markdown-content">
<h2>失联人员</h2>
</div> -->
Expand Down
19 changes: 19 additions & 0 deletions docs/blog/Mkdocs/mkfirst.md
Original file line number Diff line number Diff line change
@@ -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日发布
38 changes: 38 additions & 0 deletions docs/blog/technique sharing/comkdocs.md
Original file line number Diff line number Diff line change
@@ -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 进行搭建。

<!-- more -->

下面列的是搜集的一些 Mkdocs 主题与站点,以供参考。

- Hello 算法 - <https://www.hello-algo.com/>
- FDU-MSC 论坛 - <https://fdu-msc.github.io/forum/>
- Django REST framework - <https://www.django-rest-framework.org/>
- FastAPI - <https://fastapi.tiangolo.com/>
- Chrisjing 的运维之旅精选 - <http://www.chrisjing.com/>
- 艇仔粥 TingZaiZuk - <https://herointene.github.io/>
- Arisa | Blog - <https://blog.arisa.moe/>
- 嬉戏实验室 - <https://blog.xiiigame.com/>
- 老胡的周刊 - [weekly.howie6879.com](https://weekly.howie6879.com/)
- Jeremy Feng - <https://fengchao.pro/>
- 我的工作学习生活笔记 - <https://hellowac.github.io/>
- Power's Wiki - <https://wiki-power.com/>
---
- [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/)
11 changes: 7 additions & 4 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,10 @@ comments: false
# 主页

<center><font color= #518FC1 size=6 class="ml3">“循此苦旅 以达星辰”</font></center>
<script src="https://cdnjs.cloudflare.com/ajax/libs/animejs/2.0.2/anime.min.js"></script>
<script src="https://cdn.statically.io/libs/animejs/2.0.2/anime.min.js"></script>

<!-- https://cdnjs.cloudflare.com/ajax/libs/animejs/2.0.2/anime.min.js -->



<!-- <center>
Expand Down Expand Up @@ -75,6 +78,7 @@ comments: false

1. 点击右下角与我在线交谈.
2. 18939533255

***

<!-- <strong>推荐文章:material-book:</strong>
Expand Down Expand Up @@ -133,9 +137,8 @@ comments: false
[^Knowing-that-loving-you-has-no-ending]:太阳总是能温暖向日葵
[^see-how-much-I-love-you]:All-problems-in-computer-science-can-be-solved-by-another-level-of-indirection


<head>
<!-- Start of Howxm client code snippet -->
<!-- <head>
<script>
function _howxm(){_howxmQueue.push(arguments)}
window._howxmQueue=window._howxmQueue||[];
Expand All @@ -148,7 +151,7 @@ e.setAttribute('id',scriptId);
e.type='text/javascript';e.async=!0;
e.src='https://static.howxm.com/sdk.js';
t.parentNode.insertBefore(e,t)}})();
</script>
</script> -->
<!-- End of Howxm client code snippet -->

<script src="//code.tidio.co/6jmawe9m5wy4ahvlhub2riyrnujz7xxi.js" async></script>
Expand Down
5 changes: 3 additions & 2 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -318,7 +319,7 @@ extra:

analytics:
provider: google
property: G-29HZMNR0KG
property: G-29HZMNR0KG ##如果你 clone 了my模板,请将这个修改为你的
# !ENV GOOGLE_ANALYTICS_KEY
feedback:
title: 此页面有帮助吗?
Expand Down

0 comments on commit ba72ad1

Please sign in to comment.