-
-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
6 changed files
with
83 additions
and
9 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -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> --> | ||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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日发布 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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/) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters