From e4928c4b1ae5baa93c3317718a37b0dd93ba0b85 Mon Sep 17 00:00:00 2001 From: Wcowin <1135801806@qq.com> Date: Sat, 19 Apr 2025 14:56:23 +0800 Subject: [PATCH] 25/4/19 --- .ignore | 68 ---- LICENSE | 2 +- README.md | 42 +- docs/about/link.md | 21 + docs/about/zcw.md | 69 ++++ docs/blog/MIT.md | 6 + docs/blog/Mkdocs/mkdocsblog.md | 11 +- docs/blog/posts/update2025.md | 27 ++ docs/blog/websitebeauty/404.md | 538 ++++++++++++++++++++++++- docs/blog/websitebeauty/header.md | 4 +- docs/blog/websitebeauty/linktech.md | 249 ++++++------ docs/blog/websitebeauty/mkcomments.md | 14 +- docs/blog/websitebeauty/mkdocsfont.md | 24 +- docs/blog/websitebeauty/shubiao.md | 8 +- docs/blog/websitebeauty/time.md | 9 +- docs/blog/websitebeauty/webtalknow.md | 2 +- docs/blog/websitebeauty/yuanjiaohua.md | 87 ++++ docs/index.md | 5 +- mkdocs.yml | 1 + requirements.txt | 3 +- 快速开始.md | 52 ++- 21 files changed, 998 insertions(+), 244 deletions(-) delete mode 100644 .ignore create mode 100644 docs/about/zcw.md diff --git a/.ignore b/.ignore deleted file mode 100644 index c7b1053..0000000 --- a/.ignore +++ /dev/null @@ -1,68 +0,0 @@ -# Copyright (c) 2016-2024 Martin Donath - -# Permission is hereby granted, free of charge, to any person obtaining a copy -# of this software and associated documentation files (the "Software"), to -# deal in the Software without restriction, including without limitation the -# rights to use, copy, modify, merge, publish, distribute, sublicense, and/or -# sell copies of the Software, and to permit persons to whom the Software is -# furnished to do so, subject to the following conditions: - -# The above copyright notice and this permission notice shall be included in -# all copies or substantial portions of the Software. - -# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -# FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE -# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS -# IN THE SOFTWARE. - -# ----------------------------------------------------------------------------- -# Node, TypeScript, Python -# ----------------------------------------------------------------------------- - -# Dependencies -node_modules -__pycache__ -venv -.venv - -# Build files -blog -build -site -docs/blog -# Distribution files -dist -mkdocs_material.egg-info - -# Caches and logs -*.cpuprofile -*.log -*.tsbuildinfo -.cache -.eslintcache -__pycache__ - -# Examples -example -example.zip - -# ----------------------------------------------------------------------------- -# General -# ----------------------------------------------------------------------------- - -# Never ignore .gitkeep files -!**/.gitkeep - -# macOS internals -.DS_Store - -# Temporary files -TODO -tmp - -# IDEs & Editors -.idea -*~ \ No newline at end of file diff --git a/LICENSE b/LICENSE index 8846f12..f0938df 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ MIT License -Copyright (c) 2024 Wcowin +Copyright (c) 2025 Wcowin Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/README.md b/README.md index ca742b2..6078769 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,18 @@ **- 简单易上手，小白配置** **- 𝕙𝕒𝕧𝕖 𝕒 𝕘𝕠𝕠𝕕 𝕥𝕚𝕞𝕖 !** - +## 目录 +- [Wcowin for MkDocs主题](#wcowin-for-mkdocs主题) + - [目录](#目录) + - [展示](#展示) + - [如何快速使用](#如何快速使用) + - [视频教程](#视频教程) +- [Connect with me](#connect-with-me) + - [案例成果](#案例成果) + - [Star History](#star-history) + - [贡献者](#贡献者) + - [请作者喝杯咖啡](#请作者喝杯咖啡) + - [License](#license) ## 展示 @@ -43,18 +54,28 @@ ## 如何快速使用 -打开终端安装mkdocs: `pip install mkdocs-material`，在你本地的文件夹下(我的就是Wcowin.github.io这个文件夹)的终端执行`git clone git@github.com:Wcowin/Mkdocs-Wcowin.git`克隆本模版到本地 +首先，建议在虚拟环境下安装 mkdocs-material： -把Mkdocs-Wcowin文件里的东西全部复制出来到Wcowin.github.io文件里(如下图)，随后在Wcowin.github.io文件目录终端里`mkdocs serve`即可 +```bash +pip install mkdocs-material +``` + +**方法一：** +直接下载[releases](https://github.com/Wcowin/Mkdocs-Wcowin/releases)里的`Wcowin-for-MkDocs.zip`文件，解压到你本地的文件夹下，随后在文件目录终端里`mkdocs serve`即可 + +**方法二：** +在你本地的文件夹下(我的就是Wcowin.github.io这个文件夹)的终端执行`git clone git@github.com:Wcowin/Mkdocs-Wcowin.git`克隆本模版到本地 + +把克隆下来文件里的东西全部复制出来到Wcowin.github.io文件里(如下图)，随后在Wcowin.github.io文件目录终端里`mkdocs serve`即可运行，另一种运行方法：根目录有一个`Mkdocs-serve.bat`批处理文件，直接双击即可(仅在Windows系统下有效) ![image.png](https://s2.loli.net/2025/01/02/nsDEbN5OPk3atcp.png) -> 另一种运行方法：根目录有一个`Mkdocs-serve.bat`批处理文件，直接双击即可 +!注意：如果提示未安装git-committers等插件，在终端执行`pip install git-committers`即可，缺少什么就安装什么，直接执行`pip install -r requirements.txt`也可以安装所有插件 -详细的初步教程见：[利用Mkdocs部署静态网页至GitHubpages](TECH.md) +初步教程见：[利用Mkdocs部署静态网页至GitHubpages](快速开始.md) ## 视频教程 -[Mkdocs中文教程视频](https://space.bilibili.com/1407028951/lists/4566631?type=series) +[Mkdocs中文教程视频](https://space.bilibili.com/1407028951/lists/4566631?type=series)（手把手教学，首次使用MKdocs建议观看） # Connect with me @@ -77,6 +98,7 @@ + ## 案例成果 [Lenny's Web](https://lennychen.top) @@ -105,6 +127,14 @@ +## 请作者喝杯咖啡 + + +
+ +
+ + ## License diff --git a/docs/about/link.md b/docs/about/link.md index 52af4ad..b5572dc 100644 --- a/docs/about/link.md +++ b/docs/about/link.md @@ -71,6 +71,27 @@ t.parentNode.insertBefore(e,t)}})();
+ diff --git a/docs/about/zcw.md b/docs/about/zcw.md new file mode 100644 index 0000000..207a80c --- /dev/null +++ b/docs/about/zcw.md @@ -0,0 +1,69 @@ +--- +title: 支持作者 +status: new +--- + +# 支持作者 + +
+ +- :material-email-mark-as-unread: 给我发送[邮箱](mailto:wcowin@qq.com) + +- :material-github: [点击此处](https://github.com/Wcowin/Wcowin.github.io){target="\_blank" rel="noopener"}访问Github仓库 + +
+ + +可以的话 请我喝一杯咖啡吧☕️ + +## **:simple-alipay:** **Alipay** + + + + + +

+ +

+ +## **:simple-wechat:** **WeChat Pay** + + + +

+ +

+ + +*** +## **:simple-kofi:ko-fi** + +[请作者喝杯咖啡](https://ko-fi.com/wcowin){ .md-button target=_blank} + + + +## **赞助列表** + +赞助人|赞助金额|赞助时间 +-|-|- +*急|15￥|25/04/18 +千平|100￥|25/04/16 diff --git a/docs/blog/MIT.md b/docs/blog/MIT.md index e08427f..3a78153 100644 --- a/docs/blog/MIT.md +++ b/docs/blog/MIT.md @@ -1,6 +1,12 @@ --- title: 许可声明 status: new + +hide: +# - navigation +# - toc +# - feedback + - footer --- ![](https://pic3.zhimg.com/80/v2-a0c07e85f2dfdfa5f1eed932883daa50_1440w.webp) diff --git a/docs/blog/Mkdocs/mkdocsblog.md b/docs/blog/Mkdocs/mkdocsblog.md index de5994b..be2756b 100644 --- a/docs/blog/Mkdocs/mkdocsblog.md +++ b/docs/blog/Mkdocs/mkdocsblog.md @@ -10,7 +10,7 @@ tags: 与所有内置插件一样，博客插件的入门非常简单。只需将以下行添加到mkdocs.yml -``` +``` hl_lines="2" plugins: - blog ``` @@ -34,10 +34,11 @@ draft: true # 是否为草稿 categories: #分类 - Hello --- -``` -作者信息在docs/blog/.authors.yml里配置（没有.authors.yml新建即可） +``` +作者信息在docs/blog/.authors.yml里配置（没有.authors.yml新建即可） + ```yml authors: Wcowin: @@ -45,7 +46,5 @@ authors: description: Free and casual # Author description avatar: https://s1.imagehub.cc/images/2024/02/02/91a767e93d1a344e44c69936464c583e.png # Author avatar -``` - -``` +``` 结束 diff --git a/docs/blog/posts/update2025.md b/docs/blog/posts/update2025.md index 4240dba..cfbb1e3 100644 --- a/docs/blog/posts/update2025.md +++ b/docs/blog/posts/update2025.md @@ -6,6 +6,33 @@ categories: - 网站更新记录 readtime: 2 --- +##

2025-04-19

+* 优化网站流畅度（玄学） +* 修改教程中的各种小错误 + +##

2025-04-13

+* 优化网站流畅度（玄学） +* 修复在 Markdown 文件中，HTML 和 Markdown 混用可能导致解析器无法正确渲染。 + +##

2025-04-10

+* 优化网站流畅度（玄学） +* 优化[友链](../../about/link.md)统计方式，更加准确计数 +* 修复评论区重定位的bug，防止他人网站测试评论区导致评论区覆盖到我的网站 + +##

2025-03-30

+* 优化网站流畅度（玄学） +* 我回来了 +* 开启博客半月更模式 +* 一战考研失利 + +##

2025-03-14

+* 优化网站流畅度（玄学） +* π日快乐！ + +##

2025-02-24

+* 优化网站流畅度（玄学） +* 一切都是最好的安排 + ##

2025-02-19

* 优化网站流畅度（玄学） * 更新了MKdocs教程，适应官方最新版本 diff --git a/docs/blog/websitebeauty/404.md b/docs/blog/websitebeauty/404.md index 8bc46d9..a6c98f8 100644 --- a/docs/blog/websitebeauty/404.md +++ b/docs/blog/websitebeauty/404.md @@ -18,7 +18,7 @@ docs/overrides文件下新建404.html即可 树状结构如下 树状结构如下: -``` +``` hl_lines="11" $ tree -a . ├── .github @@ -35,4 +35,538 @@ $ tree -a │ └──comments.html │ └── mkdocs.yml -``` \ No newline at end of file +``` + +## 404公益页面 + +??? note "点击展开" + ```html + + + + + + 404 - 页面不存在``` + + + + + + + 404 您访问的页面搞丢了 + + + + +

+ 404!您要访问的页面走丢了! +
+

404 NOT Found

+

您访问的页面走丢在寻找梦想的路上了

+

不过您还可以和腾讯志愿者一起

+ 为孩子们点亮一个梦想 +
+
+ + 点击进入支持页面 +
扫码点亮一个梦想 + +
+

照片拍摄于湖南省岳阳市平江县三市镇新村完小

+

拍摄时间：二零二三年七月十一日

+

（感恩基金会供稿）

+ 我要反馈 +
+
+
+ + + ``` + + +## 404骰子页面 + +目前更换了新的404页面： + +??? note "点击展开" + ```html + + + + + 404 + + + +
+
4
+
0
+
4
+
0
+
4
+
0
+
4
+
0
+
4
+
0
+
4
+
0
+
4
+
0
+
4
+
0
+
4
+
0
+
4
+
0
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + + ``` \ No newline at end of file diff --git a/docs/blog/websitebeauty/header.md b/docs/blog/websitebeauty/header.md index 4fb555a..16071a2 100644 --- a/docs/blog/websitebeauty/header.md +++ b/docs/blog/websitebeauty/header.md @@ -14,7 +14,7 @@ comments: false #评论，默认不开启 docs/overrides下新建main.html ，针对main.html文件 树状结构如下: -``` +``` hl_lines="11" $ tree -a . ├── .github @@ -32,7 +32,7 @@ $ tree -a └── mkdocs.yml ``` -```html +```html hl_lines="9-22" {#- This file was automatically generated - do not edit -#} diff --git a/docs/blog/websitebeauty/linktech.md b/docs/blog/websitebeauty/linktech.md index 590ec03..3c92822 100644 --- a/docs/blog/websitebeauty/linktech.md +++ b/docs/blog/websitebeauty/linktech.md @@ -6,144 +6,161 @@ hide: - feedback --- -复制后在需要添加友链的.md文件页面粘贴即可 +复制后在需要添加友链的.md 文件页面粘贴即可 -```html +```html hl_lines="67-104"
-