first commit
This commit is contained in:
+34
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: obsidian快捷键
|
||||
date: 2022-03-29 13:39:48
|
||||
excerpt: 掌握常用的快捷键事半功倍。
|
||||
tags: []
|
||||
rating: ⭐
|
||||
status: complete
|
||||
destination: 03-Projects/黑曜石玩家指南
|
||||
share: false
|
||||
created: 2025-08-30T11:45
|
||||
updated: 2025-09-22T13:27
|
||||
---
|
||||
|
||||
![[Pasted image 20220329134340.png]]
|
||||
|
||||
在 obsidian 中查询和自定义快捷键非常方便。有了快捷键,能够提高一些我们日常操作的效率。下方列举了我常用的快捷键:
|
||||
|
||||
- `Ctrl+E`:页面预览
|
||||
- `Ctrl+Shift+E`:幻灯片预览
|
||||
- `Ctrl+Alt+M`:思维导图预览
|
||||
- `Ctrl+Q`:quickAdd命令面板
|
||||
- `Alt+E`:Templater插入模板面板
|
||||
- `Ctrl+L`:锁定页面
|
||||
- `Ctrl+Alt+2`:对选定文字背景橙色高亮
|
||||
- `Ctrl+K`:对选定文字插入超链接
|
||||
- `Ctrl+H`:寻找并替换文字
|
||||
- `Ctrl+/`:注释掉选中的文字
|
||||
- `Ctrl+Enter`:创建或完成TODO清单
|
||||
- `Alt+T`:跳转到今日日志页面
|
||||
- `Ctrl+0` :将编辑器的实时预览切换为纯文本编辑模式
|
||||
|
||||
---
|
||||
|
||||
page:: 26
|
||||
+43
@@ -0,0 +1,43 @@
|
||||
---
|
||||
title: obsidian模板库更新方法
|
||||
date: 2022-05-14 14:46:54
|
||||
excerpt: obsidian和插件的各种功能都在更新,因此这个模板库也得跟上。
|
||||
tags: []
|
||||
rating: ⭐⭐
|
||||
status: complete
|
||||
destination: 03-99-4
|
||||
share: false
|
||||
obsidianUIMode: source
|
||||
created: 2025-08-30T11:45
|
||||
updated: 2025-09-22T13:27
|
||||
---
|
||||
|
||||
此模板库会不定期提交 commit 以及时修改一些 bug。经过一段时间后会发布功能和更新较大的 release。所以更新的方式分为两种:
|
||||
|
||||
1. 直接从 [github 仓库首页](https://github.com/sheldonxxd/obsidian_vault_template_for_researcher)下载最新内容的压缩包
|
||||
|
||||
![[Pasted image 20220514145542.png|400]]
|
||||
|
||||
2. 到 github 仓库[ Release 页面](https://github.com/sheldonxxd/obsidian_vault_template_for_researcher/releases)下载带版本号的压缩包
|
||||
|
||||
![[Pasted image 20220514145752.png|400]]
|
||||
|
||||
|
||||
下载完成后,您可以将其解压到任意位置。注意从 ***v1.3*** 版本之后,每次更新仅对以下目录及内容进行修改:
|
||||
|
||||
- / .obsidian :存放了obsidian主题插件以及相关配置文件
|
||||
- /00-MOC:存放了常用的 dataview query page
|
||||
- /03-Projects/99-黑曜石玩家指南:存放了本模板库的详细说明
|
||||
- /08-Assets/Scripts:存放了本模板库依赖的python脚本和相关文件
|
||||
- /09-Templates :存放一些模板
|
||||
- /README.md:位于 vault 根目录的简要说明文档
|
||||
|
||||
如果您没有对以上内容做自定义的修改,可以直接将解压后的上述内容复制替换您已有的 vault 库。否则请谨慎操作。
|
||||
|
||||
```ad-warning
|
||||
为了测试方便,08-Assets/Scripts 中存放了 MyLibrary.bib,复制更新时注意先删除此文件,避免对您已有的文件造成覆盖。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
page:: 28
|
||||
+47
@@ -0,0 +1,47 @@
|
||||
---
|
||||
title: obsidian第三方插件列表
|
||||
date: 2022-03-29 13:50:06
|
||||
excerpt: 简单罗列模板库中主要使用的插件。
|
||||
tags: []
|
||||
rating: ⭐
|
||||
status: complete
|
||||
destination: 03-99
|
||||
share: false
|
||||
created: 2025-08-30T11:45
|
||||
updated: 2025-09-22T13:27
|
||||
---
|
||||
|
||||
- Admonition:就是提供了一些告示牌的样式,使用频率不高。
|
||||
- Advanced Slides:可以在obsidian中做幻灯片,基于 revealjs,用得比较多。本模板库中做了一些魔改,增强了导出幻灯片功能。
|
||||
- Advanced Tables:表格增强相关插件,好用。
|
||||
- Annotator:可以直接在obsidian中对pdf文件做标注,可通过`quickAdd:PDF批注`在mdnote文献笔记中创建对附件pdf的标注笔记文件,后面zotero6.0 出来之后基本用得比较少了。
|
||||
- Buttons:可以通过按钮的方式执行action,避免quickAdd面板命令太多了。用例参见[[AuthorRanking]]。
|
||||
- Calendar:日历,核心插件。
|
||||
- Clear Unused Images:当你插入一张图片,然后想删除它,仅仅从笔记中删除双链是不够的。可以通过这个插件删除图片文件。
|
||||
- Collapse All:obsidian文件列表到后期会非常长,所以这个功能也非常实用。
|
||||
- Copy Block Link:复制块引用的功能增强。
|
||||
- Copy button for code blocks:同上。
|
||||
- **Dataview**:非常重要且强大的插件,把库内笔记当作数据库进行查询。
|
||||
- Editor Syntax Highlight:编辑器代码语法高亮
|
||||
- Excalidraw:可以直接在markdown中绘制插图
|
||||
- floating-toc Plugin:页面左上角悬浮toc,此插件第三方商店不可见。
|
||||
- Floder Note:给文件夹创建同名笔记页,支持卡片或者列表预览其中笔记内容。
|
||||
- Force note view mode:强制笔记被打开时是进入源码编辑模式还是预览模式。
|
||||
- Gallery:用图库的方式查看所有多媒体附件,实用频率不高。
|
||||
- HoverEditor: 支持对悬浮窗更多操作
|
||||
- Icon Folder:给文件夹添加一个小图标,简单的美化功能。
|
||||
- Kanban:事务项目管理方面的重要插件,参见[[任务看板]]。
|
||||
- MindMap:一个简单的思维导图插件,参见[[思维导图模板]]。
|
||||
- Obsidian Tabs: 开启后支持多标签显示页面。
|
||||
- **QuickAdd**:所有workflow的核心插件,可以组合各种命令,实现一键化操作。
|
||||
- Recent Files:最近打开过的文件列表,非常频繁的实用。
|
||||
- Shell commands:调用python脚本的另一种方式,测试或者与 button 连用。
|
||||
- Style Settings:可以自定义主题或者插件提供的一些样式方面的设置。
|
||||
- Tag & Word Cloud:标签云和词云,在[[阅读清单]]中有运用。
|
||||
- **Templater**:非常核心的插件,利用模板事半功倍,而且提供了与本模板库 python 脚本交互的接口,实现各种骚操作。
|
||||
- 增强编辑:主要是在幻灯片中需要对关键词高亮,可以通过快捷键快速给选定文字插入html标签。
|
||||
|
||||
---
|
||||
|
||||
page:: 27
|
||||
|
||||
+53
@@ -0,0 +1,53 @@
|
||||
---
|
||||
title: python代码说明与调试方法
|
||||
date: 2022-05-14 15:10:15
|
||||
excerpt: 本模板库相关工作流依赖于python脚本实现
|
||||
tags: []
|
||||
rating: ⭐⭐⭐
|
||||
status: complete
|
||||
destination: 03-99-4
|
||||
share: false
|
||||
obsidianUIMode: source
|
||||
created: 2025-08-30T11:45
|
||||
updated: 2025-09-22T13:27
|
||||
---
|
||||
|
||||
本模板库相关工作流依赖于python脚本实现,本着「能用就行」的原则,代码大多比较粗糙,如有问题,请先确认是否为最新版本(参考[[obsidian模板库更新方法]])。更新后还有问题,因为本人通常无法及时回应,更多情况下**需要自行调试解决**。
|
||||
|
||||
所有代码在使用时通过 quickAdd 命令触发 Templater 插件,然后调用各自系统的 terminal 执行相应的命令。代码文件均存放于 `08-Assets/Scripts` 目录下。没有编程基础的用户可通过斜杠命令在任意行开头输入 `/test` 可以找到相关命令,会同时在当前页面当前位置打印正常输出和报错信息。
|
||||
|
||||
![[斜杠命令用于测试.gif|400]]
|
||||
|
||||
以草稿归档命令为例,其正常输出为:
|
||||
|
||||
- [[test3]]
|
||||
|
||||
当 test3 页面中的 destination 错误时,报错信息如下:
|
||||
|
||||
```python
|
||||
Traceback (most recent call last):
|
||||
File "./08-Assets/Scripts/auto_transfer.py", line 103, in <module>
|
||||
main()
|
||||
File "./08-Assets/Scripts/auto_transfer.py", line 37, in main
|
||||
if isShortLink(target):
|
||||
File "./08-Assets/Scripts/auto_transfer.py", line 53, in isShortLink
|
||||
assert '-' in target, "destination is not a valid path!"
|
||||
AssertionError: destination is not a valid path!
|
||||
```
|
||||
|
||||
由于代码颇为简单,有编程基础的用户可使用熟悉的 IDE (如 VSCode)进入该目录进行底层调试。无编程基础的用户建议先查看本项目已经存在的 issue 寻找解决方案。
|
||||
|
||||
|
||||
### 常见issue列表
|
||||
|
||||
- windows 系统无法调用 python,参考 [issue 15](https://github.com/sheldonxxd/obsidian_vault_template_for_researcher/issues/15)
|
||||
- 非 windows 系统无法正常调用 python,参考 [issue 16](https://github.com/sheldonxxd/obsidian_vault_template_for_researcher/issues/16) 和 [issue 20](https://github.com/sheldonxxd/obsidian_vault_template_for_researcher/issues/20#issuecomment-1128860155)
|
||||
- [[AuthorRanking]] 的问题,参考 [issue 13](https://github.com/sheldonxxd/obsidian_vault_template_for_researcher/issues/13) 和 [issue 17](https://github.com/sheldonxxd/obsidian_vault_template_for_researcher/issues/17)
|
||||
- 引文列表功能的问题,参考 issue [#8](https://github.com/sheldonxxd/obsidian_vault_template_for_researcher/issues/8) 和 [issue 28](https://github.com/sheldonxxd/obsidian_vault_template_for_researcher/issues/28#issuecomment-1141619386) 。
|
||||
- 任务存档功能的问题,参考 [issue 16](https://github.com/sheldonxxd/obsidian_vault_template_for_researcher/issues/16)
|
||||
- 草稿归档功能的问题,参考 [issue 15](https://github.com/sheldonxxd/obsidian_vault_template_for_researcher/issues/15)
|
||||
|
||||
|
||||
---
|
||||
|
||||
page:: 29
|
||||
Executable
+71
@@ -0,0 +1,71 @@
|
||||
---
|
||||
created: 2025-08-30T11:45
|
||||
updated: 2025-09-22T13:27
|
||||
---
|
||||
### 更新日志
|
||||
|
||||
**2022年6月3日(v1.8)**
|
||||
|
||||
- [ ] 对已有workflow的内容说明进行新增和优化
|
||||
- [x] 删除05-Life部分及相关的流程和代码,工作和生活最好还是分开
|
||||
- [x] 修改crossref.py 和 ref_list.py 代码使文献笔记的引文列表与pdf保持一致,方便溯源。
|
||||
- [x] 优化日志模板、周小结模板和文献小结模板
|
||||
- [x] 增加foldernote的模板,可以显示项目文件夹内的页面摘要和标签
|
||||
- [x]
|
||||
**2022年5月14日(v1.7)**
|
||||
|
||||
- [x] 增加本库更新与调试说明。
|
||||
- [x] 增加crossref查询的缓存机制,避免频繁连接后crossref拒绝服务。
|
||||
- [x] 更新主题和一些插件
|
||||
|
||||
**2022年4月30日(v1.6)**
|
||||
|
||||
- 进一步适应obsidian新版本,修改编辑器为实时预览模式。按 `Ctrl+0` 可切换为纯文本编辑模式。
|
||||
- 新增 「Obsidian-Tabs」插件以增强 obsidian 使用便捷性。按住Ctrl点击左侧目录、右侧Recent Files 列表、页面中的双链或者日历中的日期,都会新建一个pane打开。
|
||||
- 新增「hover-editor」插件,可以在双链上方按住Ctrl悬停预览小窗口直接编辑内容而无需跳转了。
|
||||
- 修复了fetch_front_matter 函数错误,避免未填写标签时草稿归档失效。
|
||||
- 修复了archived_task_gantt.py中的错误。
|
||||
- 修复了相册多图笔记导出时附件抓取错误。
|
||||
- 修改了 CrossRef 连接设置,减少查询相关文献信息时的错误。
|
||||
- 修改了[[每周小结]]模板。
|
||||
- 更新「黑曜石玩家指南」相关内容。
|
||||
|
||||
**2022年4月2日(v1.5)**
|
||||
|
||||
- [[阅读清单]]的front-matter增加recent_limit项,以控制近期已阅文献表格显示长度。
|
||||
- 使用 [tagcloud 插件](https://github.com/joethei/obsidian-tagcloud),在[[阅读清单]]中增加显示文献库的标签云。
|
||||
- 增加[[阅读清单#Top30被引排行榜]],可以显示文库中的被多次双链引用的文献。
|
||||
- 解决quickAdd:思维导图命令的模板文件缺失错误。
|
||||
- 解决quickAdd:草稿归档命令无效问题。
|
||||
- 解决quickAdd:阅读小结命令模板文件缺失错误。
|
||||
- 整理 quickAdd 命令面版并分类。
|
||||
- 将此模板库内置的mobile版本剥离到[obsidian_mobile_vault_template](https://github.com/sheldonxxd/obsidian_mobile_vault_template)。
|
||||
- 将模板库中内置的zotero插件和其它大文件剥离,以减少此库体积。
|
||||
|
||||
**2022年3月31日(v1.4)**
|
||||
|
||||
- 通过新版obsidian实时阅览模式兼容性测试,增加和删除了部分插件。
|
||||
- 增加 front-matter 中 destination 对于 shortlink 的支持,参考[[../1-obsidian入门/obsidian撰写草稿#front-matter]]。
|
||||
- 增加[[相册模板]],可用于个人收藏重要的照片于`05-Life/01-Album`目录下,具体操作可参考[[obsidian新建个人相片集]]。
|
||||
- 按照`写日志`,`读文献`和`做课题`的三大 workflow对quickAdd命令进行了分组。
|
||||
- 修改了导出项目未包含02-Reading目录的bug。
|
||||
- 大致回顾梳理了《黑曜石玩家指南》并作小幅度的修改。
|
||||
|
||||
**2022年3月29日(v1.3)**
|
||||
|
||||
**重要提示**:此版本对文件目录做出了重大调整,使用之前版本的用户不能直接通过复制粘贴到现有库的方式实现升级,建议先了解模板库中的教程再进行操作。
|
||||
|
||||
- 完善了`写日志`,`读文献`和`做课题项目`的三大 workflow所需的相关功能
|
||||
- 撰写了详细的使用教程《黑曜石玩家指南》并内置库中。
|
||||
|
||||
|
||||
**2022年3月13日(v1.2)**
|
||||
|
||||
- 增加笔记自定义导出为word和html的功能(带参考文献,以及嵌入多媒体),方便分享
|
||||
- 修改更新 readme 文档关于【自定义导出】和【升级】的内容
|
||||
- 调整了[[阅读清单]]的说明和query和文献阅读笔记模板[[Mdnotes Default Template]]
|
||||
|
||||
|
||||
---
|
||||
|
||||
page:: 30
|
||||
Executable
+59
@@ -0,0 +1,59 @@
|
||||
---
|
||||
title: 结束语
|
||||
date: 2022-05-31 15:19:22
|
||||
excerpt: 抛砖引玉之作而已。
|
||||
tags: []
|
||||
rating: ⭐⭐
|
||||
status: complete
|
||||
destination: 03-99-4
|
||||
share: false
|
||||
obsidianUIMode: source
|
||||
created: 2025-08-30T11:45
|
||||
updated: 2025-09-22T13:27
|
||||
---
|
||||
|
||||
上海这波疫情之中,很多事情都在发生[奇妙的变化](https://mp.weixin.qq.com/s/4_n6fX34M70ucR5l6fYjSA)。刚开始憋在家里,差点给我整出幽闭恐惧症来,三个月里日复一日的封控生活早已适应,现在说明天儿童节要解封,反倒有点社恐了。
|
||||
|
||||
言归正传,这个 obsidian 模板库的推出也算是一件有意义的事情。正如天下无不散之筵席,任何项目有开始就会有结束。复工之后,我势必再无时间精力维系于此,所以在封控的最后一天,写一段话,谈一谈自己使用 obsidian 一年来的感受,算是给这个项目一个句号吧。
|
||||
|
||||
### 不要被工具束缚
|
||||
|
||||
相信能看到此处的朋友,必然已经用过许多笔记工具了。以我自己为例,刚读研究生时用的 endnote + word,后来觉得 endnote 不如 mendeley 好用,word 也不如 typora 轻便美观;现在则尝试 zotero + obsidian 实现更加便捷的工作流。工具一直在进步,但是有一点从未变过:**比做笔记更重要的是及时总结分析**。
|
||||
|
||||
不是我故意泼冷水。学术界大牛比比皆是,但我相信大部分仍然是采用 endnote + word 的方式,比较原始地管理着一切学术资料,而且并不算凌乱。因为大家不约而同地都有很好的习惯,就是及时整理资料,分析总结。每一次小结,都是对真正重要信息的筛选和加深对它们的印象。而这种整理总结的工作,又以发表学术论文为一个大阶段终点。
|
||||
|
||||
### 写易于搜索的笔记
|
||||
|
||||
如果记载了重要信息的笔记无法被迅速找到,那么做这样的笔记是毫无意义的。我当初放弃 word 做笔记的原因,也就是文件内的内容是不容易被搜索到的,虽然可以使用 `AnyTxt` 之类的工具,但总归差了点什么。后来我就使用基于纯文本的 markdown 格式的笔记工具比如 typora 了,这样我可以用各种办法(包括写一些简单的代码)找到自己想要的东西。再后来我发现 obsidian 之类的双链笔记和丰富的插件,其实已经很大程度上降低了搜索的成本。
|
||||
|
||||
obsidian 的搜索功能仍然是比较弱的,当然如果你比较熟悉正则表达式就另说。为了方便使用关键词进行搜索,最简单的办法就是模仿学术论文,写「结构化笔记」,特别是要善于利用 Front-Matter 中标题(title)、摘要(excerpt)、标签(tags)、别名(alias)等属性。以标签为例,其实这就是搜索会用到的关键词,那么使用什么关键词能够准确地反映这篇笔记的内容?如果一个不够就再加一个,多少个都可以。另外为了降低日后重新阅读的成本,最好一段话就有一个小标题。总之越结构化越模板化,笔记内容 retrieve 的成本就越低。
|
||||
|
||||
### 写真实真诚的日志
|
||||
|
||||
最近刷到一个B站上讲[天才数学家皮茨的视频](https://www.bilibili.com/video/BV1y5411D7a6),谈到他的陨落的原因时,重要线索是从其师娘的日记中获取的,结果弹幕居然评论「正常人谁写日记呀」?感觉还挺荒谬的,可能这娃小时候日记被爸妈偷看偷怕了吧。
|
||||
|
||||
明心见性。写日志做笔记于已而言最大的作用莫过于此。人的记忆力有限,再加上自己会自动加工脑补,如果不通过日志来及时地真实地记录下来,时间一长,自我认知就会产生很大偏差。这种自己都不了解自己的境地,说实话是有点可悲的。
|
||||
|
||||
另外一个方面,每个人都会有自己的秘密,而人这种奇怪的生物又越是秘密(不管是别人还是自己的)越是想曝光。出于理性的角度,不少坏人会选择写日记倾诉。我想这也是一种「正常人不写日记」的推断的来由吧。但反过来说,只要是真实的,哪怕是坏人的日志,也有很高的价值。因为大家可以由此分析并提炼经验教训。
|
||||
|
||||
|
||||
### 尽量发表出去
|
||||
|
||||
「Publish or perish」,老生常谈了。也有点像所谓的「费曼学习法」,你能把知识传授给别人,那么才算自己掌握了。有价值的信息也是如此,不被分享的信息永远产生不了真正意义上的价值的。还是以坏人的日志为例,也只有被人剖析解读之后才能产生价值。
|
||||
|
||||
与做研究一样,有好的成果就努力发表。如果你觉得什么经验技巧方法很有价值,那就试着跟人分享一下。当然,你也可以凭此或出版、或创业或其它谋生,这些都是某种形式的分享。而分享产生的喜悦,不仅仅是物质上的回报,更多我觉得是类似于自私的基因得到复制和传播的这种喜悦。
|
||||
|
||||
|
||||
### 写在最后
|
||||
|
||||
诚如所见,此模板库虽努力实现开箱即用,但实质上却强行带人入门python,对于三大基本工作流,其实也是浅谈辄止,实感抱歉。
|
||||
|
||||
因为随着进一步使用,每个人都会产生个性化的需求。所以笔记软件是非常特殊的,类似于「一千个读者就有一千个哈姆雷特」,我相信等到大家用了几个月之后,也会不满足于一个两个模板库提供的东西。估计不少同学会自建许多模板、dataview 的 query 甚至修改其它代码。
|
||||
|
||||
所以本库定位仍然是「抛砖引玉」,一方面让更多人能够把 obsidian 用起来,另外一方面也给有能力有兴趣的 obsidian 开发者提供可参考的素材(包括流程和代码)。因此当有人希望我开通打赏,有人希望找我合作,我通通没有回应。一时兴起而作,如今兴尽而归,畅快。
|
||||
|
||||
当然,我偶尔还是会逛下 github,看看有木有什么能够回答帮忙的,只是肯定不如以往频繁了。
|
||||
|
||||
---
|
||||
|
||||
page:: 30
|
||||
Reference in New Issue
Block a user