Pkmer-Math

基于Obsidian建立公开共享的数学知识库！ PKMer知识管理交流群(QQ): 825255377 PKMer-Math开发者交流群(QQ): 782017903

前言

本系列内容亦在用较为粗略和通俗的语言描述 梳理高等数学的主要内容, 整理为markdown文件, 使用Obsidian的双链语法将其互相连接, 构成一个Obsidian的数学知识库. 由于开发者精力有限, 会优先梳理通识部分大纲内容, 然后根据本人复习掌握情况和偏好决定哪些内容的补充, 如有内容疏漏错误 或欲共同开发者 请联系开发者, 加群, 或者提issue

内容主要来源:

1. 高等数学同济版
2. Wikipedia
3. Chatgpt
4. 开发者们的学识

其他Obsidian数学库

1. 基于Obsidian的新型考研数学笔记原子分子树的构建
2. MathWiki: An Obsidian.md vault for my math course notes in university
3. 09-22年考研数学一真题

---

目录:

总目录的导航页为[[Home]], 包含了以下目录 目录以树状图形式组织, 最上级为总目录[[-高等数学-]], 依次向下细分为[[--微积分--]], [[--线性代数--]], [[--概率论--]]等具体学科分支, 再下一级为章节, 最下级为具体的词条, 文章等 如下所示:

[[-高等数学-]] [[--微积分--]] 极限 导数与微分 ... [[--线性代数--]] 行列式 矩阵 ... [[--概率论--]] ...

---

关于合作开发

本项目在GitHub开源，为了更好地进行和合作开发，计划在此做一些教程和规范

开发原则

1. 尽可能简洁, 让人能够快速理解
2. 对自己写的东西的正确性负责, 多改几次也没有关系
3. 奥卡姆剃刀原理：如无必要 勿增实体. 尽可能在Obsidian的原生功能基础上进行开发
4. 严禁使用任何破坏性插件(quickadd,Linter等需要谨慎操作, 每次用完后需要关闭插件)
5. 允许使用轻量级插件(如快捷表格操作, 数学公式等)
6. 除了Home主页, 必要的流程中严禁使用css,javascript
7. 只能在每章的目录文件中使用dataview查询, 但需要同时保留手写的目录

内容规范

• 所有词条都要按顺序添加上级目录的双链, 如:
• 积分表属于微积分的不定积分章节, 则需要添加名为dlink的property, 类型为list,
• 值要依次添加--高等数学--, 微积分, 不定积分, 共计三项
• 如果是时间来不及则先将文件放到对应的文件夹下, 有时间再做整理

准备条件

大致分为几个部分:

1. 如果在国内需要首先解决科学问题
2. 确保你要有个GitHub账号
3. 向开发者申请权限，有权限才能提交修改
4. 安装Git命令行工具
5. 在Obsidian配置Obsidian Git插件设置
6. 从GitHub第一次拉取项目， 使用clone命令

Obsidian Git(Git插件)

对新手来说命令行太抽象了, 所以我建议在本项目使用Obsidian第三方git插件: Obsidian Git

1. 在Commit Author中设置好自己的Github账号
2. ctrl+p输入obsidian git open source control view 打开Obsidian Git工具的GUI界面, 在此GUI界面点按钮就行

开发步骤

分为拉取同步，提交修改, 推送，冲突处理等

1. 拉取(Pull)

从GitHub拉取(pull)别人的修改

2. 提交(commit)

将你的修改提交到GitHub

3. 推送(Push)

本地的多个修改保存后

4. 冲突处理

这个比较麻烦, 日后有空再写, 简单说一下就是如果发生了冲突就是你本地文件新改动的某行和其他人新改动并提交到云端的这行不一样, 你们又都是从同一个版本衍生来的, 所以合并冲突就是你们商量怎么改动, 商量好了你先把你的改动保存下来然后放弃自己的改动, 从云端拉取他人的改动, 你在他的新改动的基础上再做修改

上述提到的修改指的是 文件以及文本内容的增删改, 而文本内容的增删改是以行为单位进行的

---

一些技术经验

合并分支

如果有多个分支需要合并, 以下是合并步骤:

1. 首先切换到自己主要开发的分支, 比如我在main开发, 就先切换到master
2. 执行命令 git pull origin master 将master合并到main (大概吧,我也没太搞懂谁合并到谁= =)
3. 解决冲突, 这个如果有的话比较麻烦, 没有就不管
4. 将合并后的内容推送到指定分支main, git push origin master

子模块

如果你想把Math库作为子文件夹放在自己的库中使用, 并且希望Math能够实时更新, 不影响你自己的库, 则可以创建子模块submodule 比如你的笔记目录为Note, 这个Note已经与GitHub上的仓库绑定, 你希望把Math库放到Note/Math位置并且能够实时更新, 则

情况一

Note库存在且已经是GitHub仓库, 本地Math库不存在

1. 添加一个新的子模块

cd "E:\Note"
git submodule add https://github.com/PKM-er/Pkmer-Math.git Math

2. 初始化和更新子模块

git submodule init
git submodule update --init

3. 提交更改

git add .
git commit -m "Add Math submodule"
git push

情况二

Note库还不存在, Math库已克隆至本地 上传你的 E:\Note 仓库到 GitHub 需要以下步骤：

1. 创建一个新的 GitHub 仓库:

   • 登录你的 GitHub 账户。
   • 在 GitHub 的首页或仓库页面，点击“New repository”（新建仓库）。
   • 为你的仓库命名（例如 Note），可以选择添加描述。
   • 选择仓库的可见性（公开或私有）。
   • 点击“Create repository”（创建仓库）。

2. 连接本地仓库到 GitHub 仓库:

   • 在创建的 GitHub 仓库页面，找到“Quick setup”区域，复制提供的 URL（HTTPS 或 SSH）。
   • 回到命令行界面，在 E:\Note 目录下运行以下命令，将你的本地仓库与 GitHub 仓库关联起来（这里以 HTTPS URL 为例）： git remote add origin https://github.com/your-username/Note.git 把 https://github.com/your-username/Note.git 替换成你的 GitHub 仓库 URL。

3. 上传你的仓库到 GitHub:

   • 首先，上传你的本地更改： git push -u origin master 这个命令会将你的 master 分支的内容推送到 GitHub 仓库。

4. 处理子模块:

   1. 初始化Note仓库

   cd "E:\Note"#改成你自己Note的路径
   git init

   2. 将 Math 仓库添加为子模块

   git submodule add ./Math Math

   这里的 ./Math 是 Math 仓库的本地路径 Math 是你希望在 Note 仓库中显示的子模块目录名

   3. 提交更改

   git add .
   git commit -m "Add Math as a submodule"

   Math 文件夹已经被正确地添加为子模块。但是这个地址只是你本地的Math文件夹位置, 你的Note项目的GitHub端并不知道这个路径, 所以需要告诉它从哪找到这个Math项目

   4. 修改Math作为子模块的url 将 Note/.gitmodules 文件中的 URL 改为这个地址：

   [submodule "Math"]
    	path = Math	
    	url = https://github.com/PKM-er/Pkmer-Math.git

   这里的配置说明：

   • [submodule "Math"]: 表示这是一个名为 "Math" 的子模块。
   • path = Math: 指定了子模块在 Note 仓库中的相对路径，这里是 Math 目录。
   • url = ./Math: 指定了子模块的源 URL。在这个例子中，使用了相对路径 ./Math。 这个配置通常用于当子模块仓库位于与父仓库相同的物理位置时。 然而，当你准备将 Note 仓库推送到 GitHub 时，这里可能需要更改。

   这样，当其他人克隆你的 Note 仓库并初始化子模块时，Git 会知道从哪里克隆 Math 子模块。

   5. 提交更改 完成更改后，记得在 Note 仓库中提交这些更改：

   git add .gitmodules git commit -m "Update Math submodule URL" git push
   

   这会确保 .gitmodules 文件中的更改被推送到你的远程 Note 仓库。

   这样，Math 仓库就作为一个子模块被添加到了 Note 仓库中。你可以在 Note 仓库中看到一个名为 .gitmodules 的文件，这个文件会记录子模块的相关信息。

.gitignore构建

由于每个人的配置都不一样, 个人可能有需要用到某些插件和主题外观, 所以如有必要请使用.gitignore根据自己的情况来配置, 如果什么额外的插件都不用, 则不用管

# 首先排除自己, 因为每个人情况不一样,单独配置
.gitignore

# 同步.obsidian文件夹下指定的子文件夹, 这些插件都暂时没有用到, 将来找机会剔除
.obsidian/*
!.obsidian/plugins
.obsidian/plugins/*
!.obsidian/plugins/dataview/
!.obsidian/plugins/obsidian-git/
!.obsidian/plugins/obsidian-linter/
!.obsidian/plugins/quickadd/
!.obsidian/plugins/obsidian-outliner/
!.obsidian/plugins/table-editor-obsidian/
!.obsidian/plugins/obsidian-latex-suite/
!.obsidian/plugins/templater-obsidian
!.obsidian/app.json
!.obsidian/snippets

# 其他ob相关文件夹
.history
.trash

# 针对Mac系统的忽略
.DS_Store

# 子模块相关, 暂时没有用到
.gitmodules

# vscode配置文件夹
.vscode