Skip to content

Commit

Permalink
Merge pull request obsidianmd#53 from obsidianzh/master
Browse files Browse the repository at this point in the history
basically completed
  • Loading branch information
ericaxu authored Feb 1, 2021
2 parents 2b2bbd8 + 8beb704 commit 306a8ed
Show file tree
Hide file tree
Showing 73 changed files with 963 additions and 371 deletions.
42 changes: 20 additions & 22 deletions zh/Obsidian/Obsidian.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,26 @@
## 什么是 Obsidian

Obsidian 是一个基于 Markdown 进行记录的知识库软件
Obsidian 既是一个 Markdown 编辑器,也是一个知识管理软件

你可以简单地将其作为一个 Markdown 编辑器,来编辑并预览 Markdown 文件。如果你希望更好地使用它,请记住这是一个基于密集型知识网络的管理软件
你可以简单地将 Obsidian 作为一个 Markdown 编辑器,来编辑、预览 Markdown 文件。但如果你希望更好地使用它,请记住它真正的力量在于管理密集的网络化知识库

如何开始创建一个知识网络?请先从这里 [[内部链接]] 开始!
如何开始创建一个知识网络?请先从创建一条[[内部链接]]开始!

## 跟其他软件有何不同

==*我们希望你拥有并掌控你的数据*==

我们相信,在某些程度上,你的文件数据同知识库本身同等重要。若不愿受制于人,则勿以笔记安全为儿戏
我们相信,纯文本的知识形式与你知识库本身同样重要。这就好比你不会想把自己的脑袋放到别人的脖子上。所以,我们要以一样的方式对待我们的第二大脑——若不愿受制于人,则勿以笔记数据安全为儿戏

设备同步仅仅是作为一个设备间同步的方案,数据将优先存储在你的本地硬盘上
对于 Obsidian 来说,同步服务仅仅是作为多设备间同步的方案,笔记数据将优先并且始终存储在你的本地硬盘上

提供本地文件管理而非纯云端的方式,你将会拥有更加灵活的办公模式:你可以将他们在Dropbox上进行备份,使用Git来进行版本管理,或在你的硬盘上加密以提高安全性。无论使用那种模式,你都可以使用 Obsidian 来作为你的知识库管理
由于 Obsidian 采用本地而非纯云端的文件管理方式,因此你可以更灵活地处理你的笔记数据:你可以使用 Dropbox 备份它们,使用 Git 来进行版本管理,或者在你的硬盘上对它们进行加密以提高安全性……任何对你的文件系统有效的方式都会对你在 Obsidian 中的知识库有效

==*链接是第一优先梯队*==

链接跟互联将可以为我们的知识提供一座探索与发现的桥梁
链接可以为我们提供一座知识探索与发现的桥梁,它对于发现已知事物之间的关系至关重要

这正是 Obsidian 的价值所在,也是我们推荐使用 [[内部链接]][[关系图谱]] 以及其他诸多功能的原因。
这正是 Obsidian 的价值所在,也是我们推荐使用[[内部链接]][[关系图谱]]以及其他诸多功能的原因。

正如 John Locke 所说

Expand All @@ -31,30 +31,28 @@ Obsidian 是一个基于 Markdown 进行记录的知识库软件。
\- John Locke, An Essay Concerning Human Understanding (1690)

等级制度为我们带来了第一种笔记思维,链接给了我们第二种。我们仍未确定是否需要第三种笔记思维,如果它诞生的化,或许会跟编程或者宏指令有些关联吧。
分类为我们带来了第一种笔记思维,链接给了我们第二种。我们仍未确定是否需要第三种笔记思维,如果它诞生的话,或许会跟编程或者宏指令有些关联吧。

==*你的私人工具箱*==

介于记笔记是一件高度私人化的行为,因而没有一种方式可以做到普适大众。
记笔记是一个高度私人化的行为,因而没有一种方式可以做到普适大众。

比起大刀阔斧为你决定好一切[[Obsidian]] 更愿意为你提供多种可选功能,让你可以依照自身需求进行个性化定制。
比起固执己见地为你决定好一切[[Obsidian]] 更愿意通过插件为你提供多种可选功能,让你可以依照自身需求进行个性化定制。

软件为你提供了文件浏览、文件编辑、文件搜索功能。对于初级玩家,这已然足够。
Obsidian 为你提供了文件浏览、文件编辑、文件搜索等插件。对于极简主义者来说,这已然足够。

而对于高级玩家,则可以使用多种不同的功能块,来为你的笔记记录增光添彩:
当然,你也可以使用其他多种插件,来为你的笔记记录增光添彩:

- 如果你希望记录课堂笔记,那么 [[录音机]] 和 LaTeX 数学或许会很有帮助
- 如果你进行工作笔记[[幻灯片]][[反向链接]]或许能助你一臂之力 。
- 如果你是一个科研工作者,[[关系图谱]][[字数统计]] 将是你必不可少的利器。
- 如果你希望记录课堂笔记,那么[[录音机]]和 LaTeX 公式或许会很有帮助
- 如果你希望记录工作笔记[[幻灯片]][[反向链接]]或许能助你一臂之力 。
- 如果你是一个科研工作者,[[关系图谱]][[字数统计]]将是你必不可少的利器。

我们不希望插件成为解决难题的万金油,但它确实可以简化个性化的过程,而不必面对冗杂的界面与功能
我们不期望插件能成为解决所有问题的灵丹妙药,但它们确实比那些希望集成所有功能的单一解决方案更贴近我们的个性化需求,也使界面更加简洁

我们支持了[[自定义主题]] 并且准备在v1.0.0之后开放一个插件的API,来使得软件在不增添基础功能的情况下,可以做到更强大
现在,我们支持[[自定义 CSS]]并且开发了[[第三方插件|插件 API]],这将使 Obsidian 能支持那些更小众的使用方法,更加个性化

## 关注我们的进展

Obsidian 目前正在内测。我们有一个[发展规划](https://trello.com/b/Psqfqp7I/obsidian-roadmap) 供你监督
Obsidian 目前正在公开测试。如果想了解我们的开发计划,可以查看我们的[发展规划](https://trello.com/b/Psqfqp7I/obsidian-roadmap)

我们的推特订阅地址是[@obsdmd](https://twitter.com/obsdmd),目前内容不多,但值得关注。我们将在公测版本推出之后开始进行推送。

Obsidian 文档由[@mediapathic](http://mediapathic.net)起草, @reggie提供了巨大的帮助,同样感谢大家的监督及论坛的讨论。
我们的推特订阅地址是 [@obsdmd](https://twitter.com/obsdmd),欢迎关注。当 Obsidian 有了更新,我们会及时地在上面发布通知。
42 changes: 42 additions & 0 deletions zh/Obsidian/索引.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
## About this site

欢迎来到 Obsidian 官方帮助文档。这篇笔记是一篇索引,能让你快速找到你感兴趣的内容。

官方发布的网页版帮助文档见:https://publish.obsidian.md/help

如果你在帮助文档中发现了一些错误,你可以到这里修正它们:https://github.com/obsidianmd/obsidian-docs/

## 贡献者

[[贡献者]]名单列出了那些让 Obsidian 从0到1的人💜。

如果想了解更多关于开发者的信息,可以查看我们官方网站的[关于页面](https://obsidian.md/about)

## Obsidian

### APP 相关

- 请参阅[[Obsidian|我们的产品哲学]]

### 快速开始

- 寻找一些功能?尝试打开[[命令面板]]看看,命令面板中包含 Obsidian 的所有操作。按下 `Ctrl/Cmd-P` 即可唤起命令面板。
- 了解 Obsidian 中的语法?请查看[[格式化你的笔记]]这篇笔记。
- [[开始一篇新笔记]]
- 你可能需要一些关于[[内部链接]]的帮助
- 了解如何[[嵌入文件]]
- 查看[[快捷键]]

### 官方插件

![[插件列表]]

### 进阶用法

- [[标签的使用]]
- [[反向链接的使用]]
- [[多笔记协同]]
- [[面板布局]]
- [[多库协同]]
- [[多光标协同]]
- [[使用 obsidian URI]]
51 changes: 51 additions & 0 deletions zh/Obsidian/贡献者.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
名字先后并非按照贡献大小排序的,而是按字母顺序排列。

### 开发团队

- Licat (Shida Li)<span class='flair mod-pop'>Obsidian office cat</span>
- Silver (Erica Xu)<span class='flair mod-pop'>Team Little Silvers</span>

### Moderators

- anthonyg ([Anthony Gold](https://www.anthonypgold.com/))<span class='flair mod-pop' style='background-color:#F1C40F;color:#000;'>Team Gold</span><span class='flair mod-pop'>Think Tank</span>
- argentum<span class='flair mod-pop'>Team Little Silvers</span><span class='flair mod-pop'>Linux master</span><span class='flair mod-pop'>Zotero master</span>
- cotemaxime ([Maxime Côté](https://www.maximecote.me/))<span class='flair mod-pop'>Linux master</span>
- death_au ([website](https://about.me/death.au))<span class='flair mod-pop'>the Magician</span><span class='flair mod-pop' style='background-color:#F1C40F;color:#000;'>Team Gold</span>
- Eleanor ([Eleanor Konik](https://eleanorkonik.com))
- mediapathic ([Steen Comer](http://mediapathic.net/))<span class='flair mod-pop'>Bad Cop</span>
- nickmilo ([Nick Milo](https://publish.obsidian.md/lyt-kit/_START+HERE))<span class='flair mod-pop'>Mappy McMapster</span>
- Reggie<span class='flair mod-pop' style='background-color:#0a8c28'>Go green or go home</span>
- rigmarole ([Chris Lesage](http://rigmarolestudio.com))<span class='flair mod-pop'>Forum master</span>
- ryanjamurphy ([Ryan](https://fulcra.design/) [J. A. Murphy](https://axle.design/))<span class='flair mod-pop'>That funny guy</span><span class='flair mod-pop'>Apple Fanboy</span><span class='flair mod-pop'>Forum master</span>
- Sam Baron ([website](https://sambaron.coach/))<span class='flair mod-pop'>Think Tank</span><span class='flair mod-pop'>Forum master</span>
- WhiteNoise<span class='flair mod-pop'>Think Tank</span><span class='flair mod-pop'>Zotero master</span><span class='flair mod-pop'>Bug report exterminator</span>
- Carl the Turtle<span class='flair mod-pop'>Online 24/7</span><span class='flair mod-pop'>Easily triggered</span><span class='flair mod-pop'>Good and pure</span><span class='flair mod-pop' style='background-color:#0a8c28'>Go green or go home</span>

### 翻译

- Andrea Brandi (Italian)
- canzi-teacher, 蚕子 (Chinese Simplified)
- k-andzhanovskii, Константин Анджановский (Russian)
- lisachev, Сергей Лисачев (Russian)
- mafsi, (Patrick Danilevici) (Română)
- VKondakoff, Валерий Кондаков (Russian)
- yo-goto, ぱだわん (Japanese)
- Daniel Mathiot (French)

### Builds

- jstone for maintaining our builds on flathub
- adamgibbins and ran-dall for maintaining our builds on homebrew

### 文档

帮助文档的第一个版本是由 Silver 撰写的。后来,[@mediapathic](http://mediapathic.net)也参与了部分文档的撰写。文档撰写过程中,Reggie 提供了巨大的帮助。当然,社区成员们的帮助与指正也功不可没。

现在,我们允许任何人参与文档的撰写。如果你有撰写文档的愿望,请查看文档的[ github 仓库](https://github.com/obsidianmd/obsidian-docs/)

##### 添加你的名字

如果你参与了翻译工作,你可以在文档的 github 仓库中提交请求,从而在文档中加上你的名字。当然,加上名字后请让名单仍以英文字母顺序排列,谢谢💜。

如果你的名字不能用英文书写以及英文按照字母顺序排序,请参考以下格式:
`你的-github-用户名, [用你的语言书写的你的名字] (翻译的语言名)`.
10 changes: 5 additions & 5 deletions zh/个性化定制/外观.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,11 @@

Obsidian 有两种基础颜色,黑暗模式和明亮模式。默认为黑暗模式。我们称它为“基础颜色”而不是“主题”,因为基础颜色是自定义主题工作的基础。

您可以在 `设置`-> `外观` 中更改您的基础颜色模式。
您可以在 `设置` -> `外观` 中更改您的基础颜色模式。

### 自定义主题

Obsidian 允许你使用自定义主题。我们的社区成员共享了很多他们制作的自定义主题。你可以通过 `设置`-> `外观` -> `查看社区主题` 来浏览、使用社区主题。社区主题会保存在 Obsidian 的主题文件夹下。
Obsidian 允许你使用自定义主题。我们的社区成员共享了很多他们制作的自定义主题。你可以通过 `设置` -> `外观` -> `查看社区主题` 来浏览、使用社区主题。社区主题会保存在 Obsidian 的主题文件夹下。

当然,你也可以把自己写好的 CSS 文件存入主题文件夹中,从而在 Obsidian 中使用你自己设计的主题。

Expand All @@ -15,10 +15,10 @@ Obsidian 允许你使用自定义主题。我们的社区成员共享了很多

所谓 CSS 代码段,指的是 Obsidian 中优先级比主题文件更高的 CSS 代码。当 CSS 代码段和主题文件同时对某个界面元素进行设置时,Obsidian 会优先使用 CSS 代码段的设置。

你可以把自己写好的代码段放入 CSS 代码段文件夹中,然后在 `设置`-> `外观` 中开启你的代码段。
你可以把自己写好的代码段放入 CSS 代码段文件夹中,然后在 `设置` -> `外观` 中开启你的代码段。

### 半透明效果

你可以在 `设置`-> `外观` 中启用此选项,从而使 Obsidian 的窗口变为半透明状态。目前这个选项只适用于 Windows 和 macOS。
你可以在 `设置` -> `外观` 中启用此选项,从而使 Obsidian 的窗口变为半透明状态。目前这个选项只适用于 Windows 和 macOS。

但是,在 Windows 下启用半透明效果时,拖动窗口是非常慢的。这是由于一个 Windows 漏洞导致的。漏洞的修复进度可以看: https://github.com/riverar/sample-win32-acrylicblur/issues/2
但是,在 Windows 下启用半透明效果时,拖动窗口是非常慢的。这是由于一个 Windows 漏洞导致的。漏洞的修复进度可以看:https://github.com/riverar/sample-win32-acrylicblur/issues/2
2 changes: 1 addition & 1 deletion zh/个性化定制/自定义快捷键.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,4 @@

### 设置快捷键

你可以 `设置` - `快捷键` 中添加、删除快捷键,或还原默认快捷键。如果觉得命令太多不好查找,你可以使用该页面顶部的筛选功能。
你可以 `设置` -> `快捷键` 中添加、删除快捷键,或还原默认快捷键。如果觉得命令太多不好查找,你可以使用该页面顶部的筛选功能。
10 changes: 5 additions & 5 deletions zh/使用指南/为笔记添加别名.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,22 +16,22 @@ aliases: [AI, Artificial Intelligence]
---
```

请注意,Front matter 需要放在笔记开头才能生效。同时,`aliases`需要使用英文。
请注意,Front matter 需要放在笔记开头才能生效。同时,`aliases` 需要使用英文。

未来,我们会考虑采取更友好的方式来让用户使用、管理别名,而不是让用户手动在笔记的 Front matter 中输入。

### 链接别名

一旦你为笔记设置了别名,你就可以通过`[[别名]]`的方式来引用这篇具有多个名称的笔记。引用时,对话框中会显示重定向标志,如下图所示:
一旦你为笔记设置了别名,你就可以通过 `[[别名]]` 的方式来引用这篇具有多个名称的笔记。引用时,对话框中会显示重定向标志,如下图所示:

![[使用别名进行链接.png]]

按下回车后,插入的链接会这样显示:`[[笔记原名称|别名]]`

可以发现,Obsidian 并没有直接以`[[别名]]`的方式插入链接,而是用别名对原标题进行了修饰,这样别的软件也能轻松识别你链接了别名的笔记。
可以发现,Obsidian 并没有直接以 `[[别名]]` 的方式插入链接,而是用别名对原标题进行了修饰,这样别的软件也能轻松识别你链接了别名的笔记。

### 提到当前标题

当你为某一笔记设置别名后,其他笔记无论是提到当前笔记的原标题还是别名,都会在`提到当前标题`中显示。
当你为某一笔记设置别名后,其他笔记无论是提到当前笔记的原标题还是别名,都会在 `提到当前标题` 中显示。

比如,当你为一篇名为“人工智能”的笔记设置了“AI”这个别名后,你就可以在[[反向链接]]中找到其他提到了“AI”的笔记,从而将“人工智能”这篇笔记与这些笔记链接起来。当你点击`转为内部链接`按钮后,这些笔记中的“AI”就会被替换为`[[人工智能|AI]]`这样的链接。
比如,当你为一篇名为“人工智能”的笔记设置了“AI”这个别名后,你就可以在[[反向链接]]中找到其他提到了“AI”的笔记,从而将“人工智能”这篇笔记与这些笔记链接起来。当你点击 `转为内部链接` 按钮后,这些笔记中的“AI”就会被替换为 `[[人工智能|AI]]` 这样的链接。
12 changes: 6 additions & 6 deletions zh/使用指南/内部链接.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,19 +2,19 @@

### 链接文件

创建内部链接非常简单,只需要输入`[[`,并从弹出的列表里选择自己需要链接的文件即可。你可以通过上下方向键或输入关键词来选择文件,当所需文件被选中(高亮)时按下回车键即可完成链接。
创建内部链接非常简单,只需要输入 `[[`,并从弹出的列表里选择自己需要链接的文件即可。你可以通过上下方向键或输入关键词来选择文件,当所需文件被选中(高亮)时按下回车键即可完成链接。


### 链接标题

笔记文件一般都有标题。因此,除了链接整篇笔记外,你也可以单独链接到笔记的某个标题。链接到标题的步骤非常简单,首先还是输入`[[`,并通过方向键选择所需链接的笔记。当该笔记被选中(高亮)时,按下`#`(即`shift-3`)来代替回车键。此时,弹出的列表将显示该笔记中的标题。然后,你可以通过上下方向键或输入关键词来选择所需链接的标题。当然,如果这个标题下还有更小的标题的话,你可以继续通过按下`#`来查看。当你选中了你想链接的标题后,按下 `Enter`完成链接。
笔记文件一般都有标题。因此,除了链接整篇笔记外,你也可以单独链接到笔记的某个标题。链接到标题的步骤非常简单,首先还是输入 `[[`,并通过方向键选择所需链接的笔记。当该笔记被选中(高亮)时,按下 `#`(即 `shift-3`)来代替回车键。此时,弹出的列表将显示该笔记中的标题。然后,你可以通过上下方向键或输入关键词来选择所需链接的标题。当然,如果这个标题下还有更小的标题的话,你可以继续通过按下 `#` 来查看。当你选中了你想链接的标题后,按下 `Enter` 完成链接。

在预览模式下,内部链接可以显示为其他文字。要实现这点,只需通过`|`来修饰内部链接。比如,[[另一篇笔记名称|预览模式下显示的自定义字段]]。这可以与链接标题语法一起使用,比如[[折叠#举个例子|举个折叠的例子]]
在预览模式下,内部链接可以显示为其他文字。要实现这点,只需通过 `|` 来修饰内部链接。比如,[[另一篇笔记名称|预览模式下显示的自定义字段]]。这可以与链接标题语法一起使用,比如[[折叠#举个例子|举个折叠的例子]]

### 打开链接

- 在预览模式下,点击内部链接即可在当前面板打开链接
- 在预览模式下,如果想在新面板中打开链接,则需按住`Ctrl/Cmd`再点击内部链接
- 在编辑模式下,按住`Ctrl/Cmd`点击内部链接即可在当前面板打开链接
- 在编辑模式下,如果想在新面板中打开链接,则需按住`Ctrl/Cmd+Shift`再点击内部链接
- 在预览模式下,如果想在新面板中打开链接,则需按住 `Ctrl/Cmd` 再点击内部链接
- 在编辑模式下,按住 `Ctrl/Cmd` 点击内部链接即可在当前面板打开链接
- 在编辑模式下,如果想在新面板中打开链接,则需按住 `Ctrl/Cmd+Shift` 再点击内部链接
- 如果想预览链接内容,但又不想离开当前笔记,则可以打开[[页面预览]]插件。这样,鼠标悬停在内部链接上时,你就可以通过一个小弹窗来预览链接中的内容。
Loading

0 comments on commit 306a8ed

Please sign in to comment.