Cherchord 使用教程

1. 项目介绍

Cherchord 是一个命令行应用程序，用于寻找任何弦乐器的和弦指法。它的名字来源于法语单词 "chercher"，意为 "搜索"。Cherchord 支持多种弦乐器，如吉他、尤克里里、曼陀林、布祖基和巴格拉马斯等，并且用户还可以自定义乐器的弦音和长度。

2. 项目快速启动

在开始之前，请确保您的系统中已安装了 Haskell Stack，这是一个用于 Haskell 项目的封装构建和依赖管理工具。

# 安装 Haskell Stack
curl -sSL https://get.haskellstack.org/ | sh

# 克隆项目仓库
git clone https://github.com/DataKinds/cherchord.git

# 切换到项目目录
cd cherchord

# 构建和安装 Cherchord
stack install

安装完成后，您可以在 ~/local/.bin/ 目录下找到 Cherchord 的可执行文件。

3. 应用案例和最佳实践

以下是使用 Cherchord 查找和弦指法的一个简单示例：

# 查找 C 大和弦的指法
cherchord Cmaj

这将输出 C 大和弦的所有可能的指法。

自定义乐器

如果您想为自定义的乐器查找和弦指法，可以使用 -i 选项来指定乐器的定义。以下是为一个自定义的乐器定义和弦指法的示例：

# 为自定义乐器查找和弦指法
cherchord Dminadd9/F -i "D16,A16,D16,G16,B16,E16"

这里的乐器定义是吉他的 Drop D 调音。

输出选项

Cherchord 提供了多个选项来自定义输出，例如：

• -f 或 --finger-stretch：指定手指的伸展距离。
• -n 或 --print-n：指定打印的指法数量。
• --horizontal：以水平方式打印和弦指法。

# 限制手指伸展距离并打印指定数量的指法
cherchord Cmaj -f 2 -n 5

4. 典型生态项目

Cherchord 作为开源项目，是 Haskell 社区中的一部分。以下是一些与 Cherchord 相关的生态系统项目：

• Haskell：Cherchord 使用 Haskell 语言编写，Haskell 是一种通用纯函数式编程语言。
• Stack：用于构建 Haskell 项目的工具，Cherchord 的构建依赖于 Stack。
• GitHub：Cherchord 项目的托管平台，用于版本控制和协作。

请注意，以上提到的项目链接仅用于说明，实际文档中不应包含任何链接。