Skip to content

Tips.md

Latest commit

 

History

History
135 lines (104 loc) · 3.63 KB

Tips.md

File metadata and controls

135 lines (104 loc) · 3.63 KB
title 标题
hide
tags
comments false

https://s3.bmp.ovh/2026/02/18/ZqgpJ3ih.png pip install --upgrade --force-reinstall zensical

常用环境与命令

启动虚拟环境（推荐使用 Anaconda 管理 Python 环境）

conda activate Mkdocs

Git 基本操作流程

git init  # 初始化本地仓库
git config --global user.name "myname"  # 配置用户名
git config --global user.email "myname@mymail.com"  # 配置邮箱
git remote add origin code@github.git  # 绑定本地和远程仓库 
git pull   # 拉取远程仓库的变化同步本地状态
git add .  # 添加所有更改到暂存区
git commit -m "描述信息"  # 提交更改
git push   # 推送到远程仓库
git status   # 查看当前仓库状态

常用 Git 命令速查

命令 作用
git status 查看当前修改状态
git add 文件名 添加指定文件到暂存区
git add . 添加所有修改的文件
git commit -m "说明" 提交更改
git push 推送到远程仓库
git pull 拉取远程最新代码
git log 查看提交历史

在 VS Code 中使用 Git

  1. 左侧源代码管理图标（或按 Ctrl+Shift+G）
  2. 点击 + 号暂存修改的文件
  3. 输入提交信息，点击 ✓ 提交
  4. 点击 ... → 推送

在终端中快速提交

# 进入项目目录
cd /Users/wangkewen/Wcowin.github.io

# 查看修改了哪些文件
git status

# 添加所有修改
git add .

# 提交
git commit -m "你的提交说明"

# 推送
git push

MkDocs 安装与升级

pip install mkdocs-material  # 安装 mkdocs-material
pip install --upgrade --force-reinstall mkdocs-material  # 强制升级 mkdocs-material

MkDocs 构建与本地预览

mkdocs build --clean  # 构建静态站点
mkdocs serve          # 本地预览，支持热更新

常见问题解决

  • 如果遇到依赖问题（如 cairo），可用 Homebrew 安装依赖： 
    brew install cairo
  • 若 mkdocs serve 报错，建议检查 Python 环境与依赖架构一致性。

Markdown 使用技巧

  • 新标签页打开链接：
    [Wcowin's web](https://wcowin.work/){target="_blank"}

  • 隐藏页面模块（如导航、目录、页脚等），可在页面头部 Front Matter 中配置 hide 字段。

常用资源

如需更多 MkDocs 配置、插件、主题美化等技巧，可参考 Wcowin's web{target="_blank"} 或查阅官方文档。

  • :octicons-bookmark-16:{ .lg .middle } 推荐的文章

<iframe id="google-map-frame" src="https://www.google.com/maps/d/embed?mid=1r5_nsemni9ylpFNBFTWFhGaEkwGrFf0&ehbc=2E312F" width="100%" height="500"></iframe>
<script> fetch('https://ipapi.co/json/') .then(res => res.json()) .then(data => { if (data && data.country_code === 'CN') { // 中国大陆IP，隐藏地图 document.getElementById('map-container').innerHTML = '

因为采用了谷歌地图，仅中国大陆之外的IP可见

'; } }) .catch(() => {}); </script>