{"id":15017088,"url":"https://github.com/dragonish/obsidian-abbreviations","last_synced_at":"2025-04-12T11:18:31.841Z","repository":{"id":250538696,"uuid":"832489009","full_name":"dragonish/obsidian-abbreviations","owner":"dragonish","description":"Makes Obsidian can mark abbreviations and acronyms (terminology) automatically.","archived":false,"fork":false,"pushed_at":"2025-04-02T14:28:42.000Z","size":964,"stargazers_count":20,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-12T11:18:22.400Z","etag":null,"topics":["abbreviations","acronyms","markdown","markdown-extra","metadata","obsidian","obsidian-plugin","terminology"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dragonish.png","metadata":{"files":{"readme":"README-zh_CN.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"ko_fi":"monogamy"}},"created_at":"2024-07-23T06:10:15.000Z","updated_at":"2025-04-10T02:59:09.000Z","dependencies_parsed_at":"2024-09-16T06:04:22.081Z","dependency_job_id":"1b5b89d2-2acb-41ef-b1e0-bc0588502165","html_url":"https://github.com/dragonish/obsidian-abbreviations","commit_stats":{"total_commits":22,"total_committers":1,"mean_commits":22.0,"dds":0.0,"last_synced_commit":"16448e6252066a01f085f63a5585eb892ac8be67"},"previous_names":["dragonish/obsidian-abbreviations"],"tags_count":14,"template":false,"template_full_name":"obsidianmd/obsidian-sample-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dragonish%2Fobsidian-abbreviations","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dragonish%2Fobsidian-abbreviations/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dragonish%2Fobsidian-abbreviations/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dragonish%2Fobsidian-abbreviations/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dragonish","download_url":"https://codeload.github.com/dragonish/obsidian-abbreviations/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248557847,"owners_count":21124168,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["abbreviations","acronyms","markdown","markdown-extra","metadata","obsidian","obsidian-plugin","terminology"],"created_at":"2024-09-24T19:49:51.255Z","updated_at":"2025-04-12T11:18:31.835Z","avatar_url":"https://github.com/dragonish.png","language":"TypeScript","funding_links":["https://ko-fi.com/monogamy"],"categories":["TypeScript"],"sub_categories":[],"readme":"# Abbreviations and Acronyms\n\n\u003cp align=\"center\"\u003e\u003ca href=\"./README.md\"\u003eEnglish\u003c/a\u003e | \u003cb\u003e简体中文\u003c/b\u003e\u003c/p\u003e\n\n## 术语解说\n\n- `Abbreviation（缩写）`本身指的是在使用拼音文字的语言中，对于常用词组（多为专有名词）及少数常用词所采用的简便写法，如以 cm 指代 centimeter，No. 指代 numerō 或 UN 指代 the United Nations等情况，缩写后所得到的词称为`略语`。[^1]类似于汉语中的`简称`，如“四化”指代“四个现代化”。\n- `Acronym（首字母缩略词）`常见于英语和法语，它指的是那些以词的形式发音，而非逐字母拼读的`略语`，如以 NATO 指代 North Atlantic Treaty Organization（北约），或是法语中以 UNESCO 指代 Organisation des Nations unies pour l'éducation, la science et la culture（联合国教科文组织）。\n- 此外还存在所谓的`Initialism`，即逐字母拼读的`略语`，如以BBC指代British Broadcasting Corporation（英国广播公司）或以NBA指代National Basketball Association（美国职业篮球联赛）。事实上，不同词典对`Initialism`和`Acronym`的区分并不统一，有的词典会将二者归为一类，在本插件中就没分得那么细。\n- 在了解了基本概念之后，需要明确的是，本插件只是借用了词汇学中的术语，实际上，这里的“Acronym”完全可以不是`略语`，而是一个完整的词语（但中间不能有空格）。`定义语句`的后半部分也完全可以不是单个术语而是长句解释。下文用`略语`指代`定义语句`中的前半部分仅仅是出于简洁需要。\n- 本插件适合用在术语不具有全局性的某篇文献的阅读笔记中，举例来说，我并非医学专业，只是出于个人保健需要阅读中国高血脂防治指南，那么阅读笔记就可以用这个插件来进行术语略语工作，而不像`note definitions`插件那样需要单独增加一个笔记文件，`note definitions`插件的使用方法详见[PKMer_Obsidian 插件：note definitions 创建属于你自己的术语表](https://pkmer.cn/show/20240823150047)。\n\n## 插件用法\n\n以下语法仅作举例，在实际操作中都可以通过命令面板执行相关命令进行快速填写。\n\n在设置中指定某个`属性名称`为存放`定义语句`的位置，`Abbreviations and Acronyms`插件就会自动监测笔记中的`略语`，并为它们添加下划虚线，你既可以用字符串写`定义语句`：\n\n```\n---\nabbr:\n  - \"HTML: HyperText Markup Language\"\n  - \"CSS: Cascading Style Sheets\"\n---\n```\n也可以用键值对写：\n```\n---\nabbr:\n  - HTML: HyperText Markup Language\n  - CSS: Cascading Style Sheets\n---\n```\n\n值得一提的是，如果`定义语句`是由字符串写成，且`OB系统设置→编辑器→笔记属性`选择`显示`或`源码`的情况下，可以在阅读模式的正文中直接编辑或删除`定义语句`。\n\n---\n\n\u003cspan id=\"refs\"\u003e在插件设置中\u003c/span\u003e启用`Enable Markdown Extra syntax support`选项后，你可以在笔记正文中使用Markdown扩展语法在笔记的任何位置添加`定义语句`，或是执行命令面板中的`Abbreviations and Acronyms：Insert extra definition`命令将选中的文本转化为`略语`，建议在定义语句的前后各空一行，一旦添加成功，则直到下一处`定义语句`为止，该`略语`都将指向这里所赋予的定义，`定义语句`只会显示在`实时渲染模式`和`源码模式`中，不会显示在`阅读模式`中[^2]：\n\n```\n*[W3C]: World Wide Web Consortium\n```\n\n如果你想将下文中的`略语`转为普通文本，使其不再指向特定术语，只需在冒号后留空，什么也不填：\n\n```\n*[W3C]: \n```\n\n如此一来，即便在同一篇笔记存在使用相同`略语`文本的不同术语，也可根据需要随时调整`略语`所指代的术语，例：\n\n```\n---\nabbr:\n  - RAM: Random Access Memory\n---\n\nRAM.\n\n*[RAM]: Reliability, Availability, Maintainability\n\nRAM.\n\n*[RAM]: Remote Access Management\n\nRAM.\n\n*[RAM]: \n\nRAM.\n\n```\n\n在以上例子中，当鼠标悬浮在正文中的前三个“RAM.”上时，将依次显示“Random Access Memory”、“Reliability, Availability, Maintainability”、“Remote Access Management”字样，而第四个“RAM.”将什么也不显示。\n\n## 插件选项\n\n- `Metadata keyword`：在空白栏处填入的单词将被视为用来存放`略语`的`属性名称`。\n- `Enable Markdown Extra syntax support`：启用该选项后，则可使用Markdown扩展语法，[详见上文](#refs)。\n- `Mark abbreviations in Source mode`：启用该选项后，在`源码模式`中`略语`也会被添加下划线。\n- `Enable abbreviation detection for languages not separated by spaces`：启用该选项后，插件将侦测以中日韩等不以空格分隔词语的语言写成的`略语`，例：\n\n```\n---\nabbr:\n  - \"北大: 北京大学\"\n---\n\n我是一名北大学子。\n```\n\n- `Global abbreviations`：点击本选项后的`Manage abbreviations`，在弹出的界面中添加`略语`及其定义，可在整个笔记库范围内添加全局`略语`与定义的配对，但它的优先级要低于`笔记属性`中的`定义语句`。如果你不想在某篇特定笔记中采用这一全局`略语`，则可以在`笔记属性`中以空字符串或键值对声明：\n\n```\n---\nabbr:\n  - \"HTML: \" # 字符串\n  - CSS: \"\"  # 键值对\n---\n```\n\n- `Enable detect Suffixes`：启用本选项后，则插件会自动侦测文中带有指定后缀的`略语`，并为它们也添加下划线，举例来说，如将`es`指定为后缀，则`alias`和`aliases`将被视为同一术语的`略语`。\n- `Suffix list`：在空白栏处填入的单词将被视为后缀，不同后缀之间以英文输入法逗号隔开。\n\n[^1]: https://zh.wikipedia.org/wiki/%E7%B8%AE%E5%AF%AB\n[^2]: https://michelf.ca/projects/php-markdown/extra/#abbr\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdragonish%2Fobsidian-abbreviations","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdragonish%2Fobsidian-abbreviations","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdragonish%2Fobsidian-abbreviations/lists"}