-
-
Notifications
You must be signed in to change notification settings - Fork 5
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
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