Evernote
使用 Markdown 在 Sublime Text 3 中打开和保存 Evernote 笔记
详细信息
安装次数
- 总计 38K
- Win 17K
- Mac 16K
- Linux 4K
8 月 6 日 | 8 月 5 日 | 8 月 4 日 | 8 月 3 日 | 8 月 2 日 | 8 月 1 日 | 7 月 31 日 | 7 月 30 日 | 7 月 29 日 | 7 月 28 日 | 7 月 27 日 | 7 月 26 日 | 7 月 25 日 | 7 月 24 日 | 7 月 23 日 | 7 月 22 日 | 7 月 21 日 | 7 月 20 日 | 7 月 19 日 | 7 月 18 日 | 7 月 17 日 | 7 月 16 日 | 7 月 15 日 | 7 月 14 日 | 7 月 13 日 | 7 月 12 日 | 7 月 11 日 | 7 月 10 日 | 7 月 9 日 | 7 月 8 日 | 7 月 7 日 | 7 月 6 日 | 7 月 5 日 | 7 月 4 日 | 7 月 3 日 | 7 月 2 日 | 7 月 1 日 | 6 月 30 日 | 6 月 29 日 | 6 月 28 日 | 6 月 27 日 | 6 月 26 日 | 6 月 25 日 | 6 月 24 日 | 6 月 23 日 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 2 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 1 | 0 | 1 | 0 | 0 |
Mac | 1 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 2 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Linux | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
README
Sublime Text 中的 Evernote
Sublime Text 的 Evernote 插件。
此包基于 ST2 的 SublimeEvernote,但仅适用于 ST3,并增加了许多新功能。
要开始使用,请从包控制中安装,并在命令框中键入“Evernote”(按ctrl+shift+p)。有关将插件链接到您的帐户的信息,请参阅首次使用。
如果您喜欢此插件并希望支持其开发,请考虑通过 paypal 捐赠 或使用 gratipay 进行捐助。
主要功能
- 发送笔记到 Evernote:将当前视图中的 Markdown 文档转换为富文本并发送到您的 Evernote。您可以选择标题、标签和笔记簿来存储它。
- 从 Evernote 打开笔记:显示面板以从笔记本中选择笔记或通过搜索,将笔记转换为 Markdown 并在视图中呈现。
- 更新笔记:当编辑已打开的笔记的 Markdown 时,您可以将它保存回 Evernote(再次以富文本形式)。您还可以直接从 ST 删除笔记。
- 完整的双向元数据支持:您可以通过在 Markdown 源中提供 YAML 元数据头来设置和更改笔记的标题、笔记本和标签。
- 附件:可以插入、列出、删除和打开附件。
- 剪切到笔记:将当前选择保存为新笔记中的代码片段。
新增功能
v2.7.3
- 修复:修补 Evernote 的 SDK 以修复 API 中由于未记录的更改而导致的问题(修复了 #216)
v2.7.2
- 修复:修复Evernote的SDK,使其与Linux上的ST 3126兼容(修复#150)
查看完整的变更日志。
安装
可以使用Package Control安装Evernote插件。有关详细信息,请参阅wiki。
首次使用
请阅读
Evernote决定暂时禁止向某些用户(没有官方理由)发放新的开发人员令牌。这意味着以下方法可能无法为您使用:您将被重定向到页面上的说法是开发人员令牌已禁用。在这种情况下,您需要联系Evernote客户服务或提交工单以激活您的账户中的开发人员令牌。激活后,您可以按照正常程序配置插件。
当您第一次从命令面板运行此包时,它将启动一个带有您的Evernote开发人员令牌的浏览器窗口。复制令牌并将其粘贴到Sublime窗口底部的提示中。Sublime将在Sublime Text 3/Packages/User/Evernote.sublime-settings
中存储身份验证数据。
如果您需要重新配置插件,请转到首选项 > 包设置 > Evernote
,并选择重新配置授权
,或者转到
命令面板 > Evernote: 重新配置
请注意
认证方法使用与您的账户唯一的开发人员令牌,并授予您对Evernote的读写访问权限。此令牌将保存在您的用户设置中的
Evernote.sublime-settings
文件中,因此请确保您不要公开分享此内容!
问题
您在使用插件时可能会遇到问题。问题可以在GitHub仓库中发布。
在发布新的工单之前
- 在您的
Evernote.sublime-settings
文件中启用debug
设置并再次尝试。如果问题仍然存在,请记录控制台的输出内容。在将输出发布到工单之前,请确保删除个人资料(例如,开发人员令牌)。 - 查看wiki
- 在此处搜索类似的问题
用法
命令
插件不会安装快捷方式映射,如果需要,您可以将以下内容的一个变体添加到您的用户快捷方式映射中
{ "keys": ["super+e"], "command": "show_overlay", "args": {"overlay": "command_palette", "text": "Evernote: "} },
{ "keys": ["ctrl+e", "ctrl+s"], "command": "send_to_evernote" },
{ "keys": ["ctrl+e", "ctrl+o"], "command": "open_evernote_note" },
{ "keys": ["ctrl+e", "ctrl+u"], "command": "save_evernote_note" },
您还可以按如下方式覆盖Evernote笔记的标准“保存”绑定
{ "keys": ["ctrl+s"], "command": "save_evernote_note", "context": [{"key": "evernote_note"}, {"key": "evernote_has_guid"}] },
{ "keys": ["ctrl+s"], "command": "send_to_evernote", "context": [{"key": "evernote_note"}, {"key": "evernote_has_guid", "operator": "equal", "operand": false}] },
您仍然可以使用文件 > 保存
菜单来将笔记保存为文件。
您也可以通过添加以下内容来将绑定限制为显示Evernote笔记的视图
"context": [{"key": "evernote_note"}]
发送到Evernote
命令面板 > Evernote: 发送到Evernote
这将创建一个新的包含您的活动视图的Markdown代码HTML版本的笔记。您可以通过面板或元数据块(如下所示)来指定标题、标签和笔记本。
打开笔记
命令面板 > Evernote: 打开Evernote笔记
这将打开一个面板,您可以从中选择一个笔记本和其中的笔记。选定的笔记将以Markdown格式转换并打开到一个视图中。此命令仅处理笔记的主要内容,忽略附件,但现有的附件将保持原样。
有关此命令参数的更多详细信息,请参阅wiki。
搜索笔记
命令面板 > Evernote: 搜索笔记
您将看到一个提示,您可以在这里使用Evernote查询语言(在这里记录)编写查询。一个面板将显示搜索结果,您可以选择一个笔记。选定的笔记将以Markdown格式转换并打开到一个视图中。
有关此命令的参数详细信息,请参阅wiki。
更新笔记
命令面板
> Evernote: 更新Evernote笔记
当前视图与Evernote笔记关联时(可能是您刚刚将其发送到Evernote或因为它是一个已打开的笔记),您可以使用此命令更新笔记。根据元数据块和存储在原始Evernote笔记中的附件,将更新元数据。将保留存储在Evernote服务器上的附件。
命令面板
> Evernote: 将其重置为Evernote上的版本
当前视图与Evernote笔记关联时,可以用Evernote服务器上存储的笔记内容替换其内容。
命令面板
> Evernote: 删除笔记
当前视图与Evernote笔记关联时,此命令将移动到Evernote的回收站。
附件
命令面板
> Evernote: 将当前文件附加到笔记
这将打开一个面板,您可以从中选择一个笔记本和其中的一个笔记。然后将当前打开的文件附加到所选的笔记中。当前笔记中现有的附件将保持不变。
命令面板
> Evernote: 在此处插入附件
请求路径或URL并将其作为当前笔记的附件插入。如果提供了URL,则会下载文件并将其上传到Evernote。**请注意**:由于Sublime Text在下载/上传大文件时将暂停,请等待传输完成。
命令面板
> Evernote: 显示附件
该命令将打开一个面板,列出当前笔记的所有附件。如果选择了其中一个,则会下载并显示。由于可能需要较长时间处理大文件,因此下载将以异步方式进行。
命令面板
> Evernote: 删除附件
该命令将打开一个面板,列出当前笔记的所有附件。如果选择了其中一个,它将从笔记内容和附件中删除。
剪贴为新笔记
命令面板
> Evernote: 将剪贴板内容粘贴为新的Evernote笔记
此命令将当前选择项格式化为高亮代码片段,将其放入一个新笔记中,让您选择其标题、标签和笔记本。
笔记链接
命令面板
> Evernote: 显示链接的笔记
此命令将显示当前打开的笔记中存在的链接笔记的列表(如果有)。选择列表中的项将在新视图中打开笔记。
命令面板
> Evernote: 在此处插入笔记链接
允许您选择一个笔记并将其链接插入到当前打开的笔记中。
在Web应用/客户端中查看笔记
命令面板
> Evernote: 在Web应用中查看笔记
此命令将在浏览器中打开当前打开的笔记的Evernote WebApp。从这里您可以在Web应用编辑器中查看、分享或继续编辑笔记。您可能需要在能够查看笔记之前登录。
命令面板
> Evernote: 在Evernote客户端中查看笔记
如果已安装,此命令将在本地Evernote客户端中打开当前打开的笔记。
Markdown
您可以使用Markdown编写笔记,但由于Evernote格式的限制,有些限制。例如,class
和id
是Evernote笔记中禁止的属性,因此Markdown转换器已修改为从不输出它们,并且原始HTML不能包含它们。如果您写入非法内容,插件将显示一个对话框,显示Evernote抱怨的原因。
有关更多详细信息,请参阅wiki文档。
元数据
Markdown源可以从如下所示的元数据块开始。
---
title: My Note's Title
tags: misc, sublime
notebook: My Notebook
---
在发送或更新备注时,插件会提取这些元数据并相应地设置或更改它。当这样的标题不完整或缺失时,当将备注发送到Evernote时,插件将要求输入缺失的字段。
tags
字段可以是未引用的列表或如["my long tag", "tag2"]
这样的JSON列表。
如果evernote_autocomplete
为true,笔记本和标签列表将作为元数据块中的自动完成提示提供。
注意:当前元数据的格式相当受限,它只是YAML的一个小子集。仅识别的键有title
、tags
和notebook
,其他键将被忽略并可被丢弃(例如,如果您从其他客户端编辑备注)。
方程式
虽然Evernote本身不支持方程式,但您可以将它们作为图像嵌入。可以使用插入方程式插件来简化将其插入Markdown备注中。
设置
可以从首选项 > 包设置 > Evernote
访问Evernote.sublime-settings
。
两个设置token
和noteStoreUrl
由插件在第一次使用时设置。
以下设置可以进行自定义
设置 | 目的 |
---|---|
md_syntax |
一个指向您想与来自Evernote的备注关联的tmLanguage 文件的字符串。 |
inline_css |
一个将某些HTML元素名称与内联CSS样式关联的字典;此设置在维基中有文档。备注的Markdown可以包含(几乎)任意的HTML块但Evernote只接受一小部分元素和属性(不允许使用class 和id )。有关详细信息,请参阅此处。 |
code_highlighting_style |
一个pygments样式,可以是以下之一:autumn 、default 、github 、monokai 、perldoc 、vim 、borland 、emacs 、igor 、murphy 、rrt 、vs 、bw 、friendly 、native 、tango 、xcode 、colorful 、fruity 、manni 、pastie 、trac 。 |
code_friendly |
如果为true ,则启用markdown2的code-friendly 扩展。 |
evernote_autocomplete |
当此设置为true时,将为元数据中的notebook 和tags 字段提供自动完成建议。默认为true。 |
emphasis_mark |
在从HTML转换为markdown时,使用此标记作为强调标记。有效值是"*" 或"_" (默认)。当code_friendly 为true时,设为"*" 。 |
strong_mark |
在从HTML转换为markdown时,使用此标记作为强调标记。有效值是"__" 或"**" (默认)。 |
item_mark |
在从HTML转换为markdown时,使用此标记作为无序列表项标记。有效值是"+" 、"-" 或"*" (默认)。 |
notes_order |
在面板中排序备注的方式;可能的值有:created 、updated 、relevance 、update_sequence_number 、title 。通过将notes_order_ascending 设置改为true 来反转所选顺序。 |
max_notes |
面板中备注的最大数量;默认为100。 |
update_on_save |
当此设置为true时,保存包含备注的文件将也会更新(覆盖它)在线版本。默认为false。 |
sort_notebooks |
按字母顺序在调色板中排序笔记本。 |
显示笔记本堆栈 |
在调色板中显示笔记本堆栈。 |
open_single_result |
当搜索只返回一个备注时直接打开它,跳过结果面板(默认为true )。 |
warn_on_close |
当关闭未保存到Evernote的修改过的备注时,会提供一个选择以保存或丢弃更改(默认为true )。 |
gfm_tables |
启用GFM表语法(默认true )。 |
默认模板 |
用于新建笔记的Markdown模板文件(例如:"Packages/User/EvernoteNote.md" ) |
tab前缀 |
用于笔记tab的前缀字符串(默认:"Evernote: " ) |
Wiki表格 |
启用Wiki表格语法(默认:false ) |
调试 |
启用在控制台中记录日志 |
鸣谢
当前维护者是 bordaigorl。
如果您喜欢此插件并希望支持其开发,请考虑通过 paypal 捐赠 或使用 gratipay 进行捐助。
如果您想做出贡献,请参阅贡献指南。
插件得以实现得益于多位人士的贡献
- 当前维护者和新特性:bordaigorl
- 原始ST2插件:jamiesun
- 移植到ST3
- 其他贡献者: 358463121, rahul-ramadas, mwcraig, rayou, dimfeld, paki, zsytssk, metalbrick, danielfrg, avcreation, AntonPalich, pimlock, ranmocy.
如果您认为您的名字应该在这里,请通知我们!
还要感谢我们第一位捐赠者,Matthew Baltrusitis!
库(一些改编以用于Evernote格式)
- Markdown2转换器:trentm
- HTML2Markdown:Aaron Swartz
- Evernote API:https://github.com/evernote/evernote-sdk-python