Sparks NMN 指南
文档版本：Sparks NMN 1.14.23
这是 Sparks NMN 指南的引入页，概述了 Sparks NMN 的用处和设计思想。
如果文档内有一些科学性错误或者无效的链接，请点击右上角链接前往 Github 向我们反馈。
如果你认为我们引用作品侵犯了你的利益，请通过页面底部的电子邮件地址反馈。
目前作者任务比较繁重，短期内可能没有时间考虑新的功能与较大的改动，但是仍然会积极地修复程序漏洞。如果你发现漏洞，请及时上报。请优先考虑通过 GitHub Issues（右上角链接）提交。通过邮件、聊天工具等方式提交，可能无法得到及时回应，也不利于高效跟踪漏洞。
全新 Sparks NMN 2 的开发正在缓慢推进，如果你有关于语法、交互体验、显示效果等方面的建议，也欢迎通过 GitHub Issues 提交。Sparks NMN 2 的标准不需要与当前的 Sparks NMN 兼容，后续会提供相应转换工具转换原有的乐谱。Sparks NMN 1 仍然会继续进行维护性更新。
什么是 Sparks NMN?
Sparks NMN 是一个基于文本格式的简谱（Numbered Music Notation）制作语言。只须输入按规范编写的文本文件，它就能够渲染出最终的简谱界面，供查看和打印。文本规范的设计主要参照作者日常抄谱和扒谱的实践，考虑了许多方面，力求使文本文档简洁而直观，且经得起实践检验。渲染的样式主要参照中国的义务教育音乐课本。
Sparks NMN 是开源软件，核心基于 Web，可以在浏览器中运行。因此，你可以不下载而在线试用。为了方便实际工作场景下的使用，Sparks NMN 还有一个通过 Electron 技术实现的桌面版。
为了让事情清晰一点，来感受一个简单的例子——儿歌《数鸭子》。
教程中所有用作例子的片段，如果不是原创，均会至少注明一次出处（歌曲名，若条件允许会有链接；其中有一个无法找到来源的除外）。示例歌曲的版权归原作者所有，本教程中仅包含必要的乐谱片段以及指向音乐平台播放页的链接，不直接提供歌曲的试听与下载。
如何开始使用？
在线试用
对于尚不熟悉并且不确定是否要下载的用户，我们提供了在线试用版本，使得用户可以快速且便捷地进行尝试，而不需要花时间安装与卸载。点击下面的链接前往试用版。
下载桌面版
如果你在简单试用和了解后决定采用 Sparks NMN，并且希望拥有文件保存、打印以及偏好设置等完整功能，则可以免费下载桌面版。桌面版是免安装的，解压即可使用。
桌面版应用的界面几乎和试用模式一样简洁，没有任何广告和骚扰信息，不需要联网工作，也不会在未明确征得同意的情况下上传你的任何数据，可以放心使用。
设计思想简介
如何学习
如果你喜欢自己探索
如果你更喜欢自己探索语法，而不是按部就班地看着教程学习，你可以阅读并研究我们提供的示例乐谱。然而，这些乐谱中对某些特性的使用可能过于复杂，并且也没能覆盖 Sparks NMN 的所有特性，并不能完全代替教程。
多尝试
此教程中会有不少代码示例。在完整的示例代码下方，都会有一个“在试用模式中尝试”链接，点击即可在试用环境中打开。如果你刚才点开了上面的例子，你应该已经知道这一点了。
当你发现代码中有的地方令你疑惑，可以在试用模式中打开它，然后修改一下看看。这样你的印象和理解就会更加深刻。
克服对文本的恐惧
接下来...
本教程假设你了解音乐的基本维度（音高与节奏）相关知识、简谱的大致格式，以及对一般的旋律进行视唱和听写（扒谱）的技巧。如果你觉得自己对此一无所知，可以先想办法学习一下这些内容。不过，学习这些，光读书往往是没有什么效果的，还要重视实践哦！
教程中有的章节可能很长，是为了把所有事情解释清楚。如果你认为某些部分你不需要，请善用屏幕右侧的目录来跳过它们。
如果你准备好了，那么点击下方的按钮，前往下一个主题开始学习吧！
如果你在教程的乐谱例子中看到了什么超纲的东西，不要惊慌。那些东西不会影响你学习现在的内容。记住，Sparks NMN 的语言是被设计成尽可能自然且与简谱相似的样子的。你甚至可以尝试自己猜猜它们是什么意思。