docs(tools): add pyenv/*

Author: Sun-ZhenXing

.github/workflows/deploy-docs.yml

@@ -3,7 +3,6 @@ name: Deploy Docs
 on:
   push:
     branches:
-      # make sure this is the branch you are using
       - main
 
 jobs:
@@ -14,8 +13,6 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-          # if your docs needs submodules, uncomment the following line
-          # submodules: true
 
       - name: Install pnpm
         uses: pnpm/action-setup@v2
@@ -24,7 +21,7 @@ jobs:
           run_install: true
 
       - name: Setup Node.js
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: 20
           cache: pnpm
@@ -39,6 +36,5 @@ jobs:
       - name: Deploy Docs
         uses: JamesIves/github-pages-deploy-action@v4
         with:
-          # This is the branch where the docs are deployed to
           branch: gh-pages
           folder: docs/.vuepress/dist

.markdownlint.yaml

@@ -1,16 +1,8 @@
 default: true
 
-# unordered-list-indent (default: 2)
-MD007:
-  indent: 4
-
 # line-length (default: 80)
 MD013: false
 
-# single-title (allow title in frontmatter)
-MD025:
-  front_matter_title: ''
-
 # no-inline-html (allow only AutoCatalog)
 MD033:
   allowed_elements:

Dockerfile

@@ -1,5 +1,5 @@
 # Builder
-FROM node:20.7.0-bookworm as builder
+FROM node:20.9.0-bookworm as builder
 
 WORKDIR /app
 
@@ -16,7 +16,7 @@ RUN npm -v \
     && pnpm build
 
 # Nginx Server
-FROM nginx:1.25.2-alpine3.18-slim
+FROM nginx:1.25.3-alpine3.18-slim
 
 WORKDIR /usr/share/nginx/html/vuepress-python-notes/
 

docs/.vuepress/config.ts

@@ -6,6 +6,7 @@ import { copyCodePlugin } from 'vuepress-plugin-copy-code2'
 import { searchProPlugin } from 'vuepress-plugin-search-pro'
 import { autoCatalogPlugin } from 'vuepress-plugin-auto-catalog'
 import { shikiPlugin } from '@vuepress/plugin-shiki'
+import { slug as slugify } from 'github-slugger'
 
 const __dirname = getDirname(import.meta.url)
 const isProd = process.env.NODE_ENV === 'production'
@@ -29,7 +30,11 @@ export default defineUserConfig({
     importCode: {
       handleImportPath: str => str
         .replace(/^\//, ROOT_PATH.replace(/(?:|\\|\/)$/, '/'))
-        .replace(/^@/, CURRENT_PATH),
+        .replace(/^@\//, CURRENT_PATH.replace(/(?:|\\|\/)$/, '/')),
+    },
+    anchor: {
+      level: [1, 2, 3, 4, 5, 6],
+      slugify,
     },
   },
   theme: defaultTheme({
@@ -72,8 +77,8 @@ export default defineUserConfig({
       codetabs: true,
       include: {
         resolvePath: (file) => {
-          if (file.startsWith('@'))
-            return file.replace('@', CURRENT_PATH)
+          if (file.startsWith('@/'))
+            return file.replace(/^@\//, CURRENT_PATH)
           if (file.startsWith('/'))
             return file.replace(/^\//, ROOT_PATH.replace(/(?:|\\|\/)$/, '/'))
           return file

docs/.vuepress/styles/index.scss

@@ -11,17 +11,6 @@
     }
   }
 
-  h1,
-  h2,
-  h3,
-  h4,
-  h5,
-  h6 {
-    margin-top: 1.5rem;
-    margin-bottom: 0.5rem;
-    padding-top: 0;
-  }
-
   // optimize: code
   code {
     padding: 0.25rem 0.15rem;
@@ -58,5 +47,16 @@
   }
 }
 
+// fix: copy katex code when selected
+.katex {
+  * {
+    user-select: none;
+  }
+
+  annotation {
+    user-select: all;
+  }
+}
+
 @import 'print.scss';
 @import 'private.scss';

docs/pypi-package/nuitka/index.md

@@ -0,0 +1,3 @@
+# Nuitka 教程
+
+<AutoCatalog />

docs/quicknote/cython-build-image.md

@@ -25,9 +25,9 @@ EXPOSE 8081
 CMD [ "python", "server.py" ]
 ```
 
-每次我们都从项目中复制源代码，然后安装依赖。对于微服务来说，直接使用源代码发布到生产环境不安全，容易在部署中泄漏重要信息。
+每次我们都从项目中复制源代码，然后安装依赖。对于任何应用，直接使用源代码发布到生产环境不安全，容易在部署中泄漏重要信息。
 
-而且原始的 Python 代码执行比较低效，需要从头开始解释执行，在第一次启动时需要编译为字节码，如果我们使用字节码发布同样不安全（字节码可以轻易逆向为源代码）。
+而且原始的 Python 代码执行比较低效，需要从头开始解释执行。Python 会在第一次执行项目时，将包内的代码编译为字节码（`.pyc` 文件），这样可以提高 Python 运行的效率。同样我们也可以直接发布字节码文件，但是我们使用字节码发布同样不安全（字节码可以轻易逆向为源代码）。
 
 下面我们将介绍 Cython，它可以帮助我们解决这些问题。
 
@@ -210,7 +210,7 @@ pip-delete-this-directory.txt
 
 我们在构建网络服务时常常使用一些元编程技巧，这常常需要借助运行时反射来实现。如 SpringBoot 中的 `@ComponentScan` 能够自动扫描并加载所有的 `@Component` 注解的类，然后将它们注册到 IoC 容器中。
 
-通常静态构建后会损失一些元信息，如果有特定模块这些元信息则会导致一些问题。
+通常静态构建后会损失一些元信息，如果有特定模块或库依赖这些元信息运行则会导致一些问题。
 
 在 Python 中，我们常常使用自定义装饰器来完成相应的功能。例如，在 [Sanic](https://sanic.dev/) 中我们可以使用 [自动路由发现](https://sanic.dev/en/guide/how-to/autodiscovery.html) 来自动注册路由，从而无需编写引入代码。
 

docs/quicknote/temp.md

@@ -15,6 +15,22 @@
 - [ ] Celery：Python 异步任务调度
 - [ ] Rocketry：Python 下的轻量调度框架
 
+## Python 环境管理
+
+- [x] `pipx`：管理全局命令行工具
+- [ ] `pipenv`：虚拟环境
+- [ ] `conda`：Anaconda 工具
+- [ ] `virtualenv`：虚拟环境工具包
+- [ ] `virtualenvwrapper`
+- [ ] `pew`
+- [ ] `tox`
+- [ ] `nox`
+
+## Cython
+
+- [ ] <https://www.zhihu.com/column/c_1284193666899787776>
+- [ ] <https://www.zhihu.com/column/c_1277937360727257088>
+
 ## OpenCV 增加图像对比度
 
 当使用Python和OpenCV增加图像的对比度时，可以使用`cv2.convertScaleAbs()`函数。该函数可以根据给定的对比度参数对图像进行线性变换。下面是一个详细的代码示例：

docs/tools/pyenv/index.md

@@ -0,0 +1,3 @@
+# Python 环境管理工具
+
+<AutoCatalog />

docs/tools/pyenv/pipx/index.md

@@ -0,0 +1,3 @@
+# pipx
+
+<AutoCatalog />