Hayagriva YAML文献格式详解：用parent层级告别字段爆炸的简单方法
Hayagriva YAML文献格式详解用parent层级告别字段爆炸的简单方法【免费下载链接】hayagrivaRusty bibliography management.项目地址: https://gitcode.com/gh_mirrors/ha/hayagrivaHayagriva 是一款用 Rust 编写的开源文献管理工具其核心的YAML文献格式用一套parent父级层级取代了传统格式的成堆字段论文、期刊、会议、视频之间的从属关系只需复用同一批字段就能完整表达从根源上解决了 BibTeX、RIS 等格式的字段爆炸难题。本文带你快速上手这种简单直观的文献库写法。 30秒上手一个文献文件长什么样Hayagriva 的文献文件本质上是一份 YAML 文档每条文献用一个键名key标识下面缩进列出它的字段fields。harry: type: Book title: Harry Potter and the Order of the Phoenix author: Rowling, J. K. volume: 5 page-total: 768 date: 2003-06-21三个要点新手只要记住这些就不会写错键名永远在最前后跟冒号用来在引用时唯一定位这条文献字段值通常就是冒号后的文本比如author: Rowling, J. K.列表有两种等价写法紧凑的方括号数组author: [Omarova, Saule, Steele, Graham]或每个作者一行、行首带-的项目符号形式。完整格式说明在 docs/file-format.md其中还收录了所有字段与数据类型的全量参考。 为什么需要 parent告别字段爆炸传统文献格式BibTeX、RIS的思路是每一种信息都配一个专属字段。想记录论文发表的期刊用journaltitle收录在书里用booktitle会议论文集又是另一个字段……几十种字段各自为政写作时只能靠翻文档记忆。Hayagriva 反其道而行把字段数量压到最小让格式好记到可以脱稿手写。它的方案是——许多文献本来就发布在别的载体里论文之于期刊、章节之于书、演讲之于会议与其为每种载体造新字段不如用parent字段把包含关系表达出来。每一层级顶层条目和所有父级都可用同一批字段title、author、volume在各层含义一致写起来零心智负担。 写法一单父级——给论文挂上期刊一篇期刊论文的典型写法如下完整示例见 tests/data/basic.yml 中的kinetics条目kinetics: type: Article title: Kinetics and luminescence of the excitations ... serial-number: doi: 10.1103/PhysRevB.102.165126 page-range: 165126-165139 date: 2020-10-14 parent: type: Periodical title: Physical Review B volume: 102 issue: 16 publisher: American Physical Society含义一目了然这篇文章发表于《Physical Review B》第 102 卷第 16 期。注意title字段同时用于文章本身和它的父级——这正是字段不膨胀的关键。还有一个贴心细节type: Periodical这行其实可以省略。每种条目类型都定义了默认父级类型例如Article的默认父级就是期刊省掉了大量样板代码。 写法二多父级——一份内容多种发布方式有些媒体是多重发布的一篇会议演讲既有会议记录又有官方录像。这时把parent写成列表即可wwdc-network: type: Article author: [Mehta, Jiten, Kinnear, Eric] title: Boost Performance and Security with Modern Networking date: 2020-06-26 parent: - type: Conference title: World Wide Developer Conference 2020 organization: Apple Inc. - type: Video runtime: 00:13:42 url: https://developer.apple.com/videos/play/wwdc2020/10111/与author列表的规则完全一样出现-即表示一个新的父级。引用时到底依据哪个来源读者心里有数。 写法三嵌套父级——层层向上追溯源父级条目自己还可以拥有父级。比如一块博物馆信息牌描述一张照片而这张照片属于一个收藏系列plaque: type: Misc title: Informational plaque about Jacobys 1967 photos date: 2020 parent: type: Artwork date: 1967 author: Jacoby, Max parent: type: Anthology title: Bleibtreustraße archive: Landesmuseum Koblenz信息牌 → 艺术作品 → 收藏系列三层关系靠同一个parent字段递归表达不需要任何新字段。这正是该 YAML文献格式 处理复杂文献学关系最优雅的地方。✅ 新手实用小贴士问题答案条目类型有哪些内置约 29 种article、book、web、conference、video、thesis、case等区分大小写不敏感省略时默认MiscURL 想附带访问日期怎么办用复合写法url: { value: ..., date: 2020-11-30 }期刊名总被改大小写加verbatim: true保留原样有 DOI / ISBN / arXiv 号放进serial-number字典Hayagriva 会识别并特殊处理想按类型筛选文献用内置选择器语言见 docs/selectors.md写好文献文件后一行命令即可生成参考文献列表默认芝加哥 Author-Date 风格hayagriva literature.yaml reference 相关文件索引格式官方文档字段与数据类型全量参考docs/file-format.md覆盖各种用法的示例文献库tests/data/basic.yml选择器按结构与元数据查询文献docs/selectors.md项目介绍、安装与 CLI 用法README.md版本变更历史CHANGELOG.md一句话总结学 Hayagriva 的 YAML文献格式核心就是记住parent能套parent、各层字段通用这一条——字段少、好记忆、结构清晰文献库从此告别字段爆炸。【免费下载链接】hayagrivaRusty bibliography management.项目地址: https://gitcode.com/gh_mirrors/ha/hayagriva创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考