Decker 项目下载及安装教程

1. 项目介绍

Decker 是一个多媒体平台，用于创建和分享包含声音、图像、超文本和脚本行为的交互式文档。它支持在 MacOS 和 Windows 上运行，并且还提供了一个基于 JavaScript 的 Web 版本。Decker 的脚本语言是 Lil，它是一个轻量级的脚本语言，适合用于创建和操作多媒体文档。

2. 项目下载位置

Decker 项目托管在 GitHub 上，可以通过以下命令克隆项目到本地：

git clone https://github.com/JohnEarnest/Decker.git

3. 项目安装环境配置

3.1 环境要求

• 操作系统: MacOS、Windows、Linux
• 编译器: C 编译器（如 GCC 或 Clang）
• 依赖库: SDL2、SDL2_image
• 工具: xxd（通常随 MacOS 和大多数 *nix 发行版一起提供）

3.2 环境配置示例

3.2.1 MacOS 环境配置

在 MacOS 上，可以使用 Homebrew 安装所需的依赖库：

brew install sdl2 sdl2_image

3.2.2 Linux 环境配置

在 Debian 或 Ubuntu 上，可以使用 apt 安装所需的依赖库：

sudo apt install libsdl2-2.0-0 libsdl2-dev libsdl2-image-dev

3.2.3 Windows 环境配置

在 Windows 上，可以使用 MSYS2 或 Chocolatey 安装所需的依赖库。以下是使用 MSYS2 的示例：

pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-SDL2 mingw-w64-x86_64-SDL2_image

4. 项目安装方式

4.1 Web-Decker 安装

Web-Decker 是一个基于 JavaScript 的 Web 应用程序，可以通过以下步骤构建和运行：

make testjs
make web-decker
make runweb # (可选) 在默认浏览器中打开

4.2 Native-Decker 安装

Native-Decker 是一个基于 C 语言的本地应用程序，可以通过以下步骤构建和安装：

make lilt # (可选) 命令行工具
make docs # (可选) 构建文档 (需要 Lilt)
make decker # 构建 decker 本身
make test # (可选) 回归测试套件
sudo make install # (可选) 安装 lilt、decker 和 lil 语法配置文件

5. 项目处理脚本

Decker 使用 Lil 脚本语言来处理和操作多媒体文档。以下是一个简单的 Lil 脚本示例，用于读取和操作一个多媒体文档：

$ lilt d:readdeck["examples/decks/color.deck"]
<deck>
d.card:d.cards.colhex
<card>
d.card.widgets.hex.text:"FFAA00" "FFAA00"
d.card.widgets.hex.event["change"] 0
d.card.widgets.rgb.text "16755200"
writedeck["color.html" d] 1

这个脚本读取了一个名为 color.deck 的多媒体文档，并将其转换为一个 HTML 文件。

---

通过以上步骤，您可以成功下载、配置和安装 Decker 项目，并开始使用 Lil 脚本语言创建和操作多媒体文档。