Cantara 的工作原理

背景故事

高中时，我加入了一个基督教青年团契的领导团队。在举办活动时，我们喜欢在开始时唱几首歌。然而问题出现了——现有的歌本数量不足，内容有时也与大家希望唱的歌曲不符。那时我开始寻找可用的歌曲演示软件，但很快就感到失望。大多数现有程序不是商业软件，就是极其复杂，或者对于这个本质上很简单的目的来说过于"大材小用"：人们应该能够（自发地）选择歌曲，程序随后将其显示出来。

那时，我决定开始开发 Cantara。这个名字来自拉丁语"cantare"（唱歌），但更多是人为选取的而非自然而然。选择这个名字的另一个原因是，同一时期我成了教会的管风琴手——而德语中这个职位的名称是"Kantor"，听起来颇为相似。

后来我有幸领导了世界上最好的学生团契 😃，在此期间，这个程序慢慢成长并更新了新功能，如多屏支持以及将歌词直接导出到剪贴板的功能，使其可以在没有投影仪的小组中使用。Cantara 的开发将继续，我希望它能成为赞美和敬拜我们伟大天父的小工具！

方法

graph LR;
    A[输入文件] -->|收集歌曲| B(歌曲列表)
    B --> C(歌曲选择)
    C --> D{生成演示数据}
    D --> E[直接运行演示]
    D --> F[以标记格式导出歌词]
    D --> G[将演示导出为 PPTX]
    D --> H[将演示导出为图片]

Cantara 从文件系统上的一个特定文件夹获取歌曲，该文件夹称为歌曲仓库（简称 song repo）。每首歌曲都是一个简单的文本文件，可以用您选择的任何文本编辑器进行编辑。Cantara 将根据文件名（不含扩展名）识别歌曲标题。例如，如果您有一个这样的文件：

Amazing Grace.song

Cantara 会将其识别为以歌曲格式书写的"Amazing Grace"（关于格式，请参见下一节）。

Cantara 的窗口/模式

Cantara 由不同的窗口组成，让您可以使用该程序。

窗口

歌曲选择窗口 演示窗口 演示控制器 设置 编辑器

启动 Cantara 后，此窗口将显示出来。它允许您查看可用的歌曲，并选择您想在演示中使用或导出的歌曲。

演示窗口将显示并控制已加载的演示（在单屏模式下）。可以设置为全屏并移动到另一个屏幕。 如果您关闭演示窗口，演示将结束，您将返回到歌曲选择窗口。

在多屏模式下，演示控制器允许您详细控制演示窗口中显示的演示。您可以查看所有幻灯片、直接跳转到某张幻灯片或退出演示。 通常，您会将演示控制器放在第一个屏幕（默认屏幕）上，将演示窗口放在第二个屏幕（显示在投影仪、外部显示器等上）上。

提示

演示控制器使用歌曲选择窗口。

设置窗口允许您调整演示样式并更改歌曲仓库的路径。您可以在歌曲选择窗口中打开设置。

编辑器允许您在歌曲仓库中添加、修改、转换和删除歌曲。您可以通过歌曲选择窗口中的"编辑 -> 歌词..."来打开编辑器。