跳到主要内容

Sparks NMN 指南

文档版本:Sparks NMN 1.14.24

这是 Sparks NMN 指南的引入页,概述了 Sparks NMN 的用处和设计思想。

向我们反馈问题

如果文档内有一些科学性错误或者无效的链接,请点击右上角链接前往 Github 向我们反馈。
如果你认为我们引用作品侵犯了你的利益,请通过页面底部的电子邮件地址反馈。

关于 Sparks NMN 后续更新

目前作者任务比较繁重,短期内可能没有时间考虑新的功能与较大的改动,但是仍然会积极地修复程序漏洞。如果你发现漏洞,请及时上报。请优先考虑通过 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 的语言是被设计成尽可能自然且与简谱相似的样子的。你甚至可以尝试自己猜猜它们是什么意思。