Swinger 项目下载及安装教程

1. 项目介绍

Swinger 是一个基于 CouchDB 的 couchapp，用于创建和展示演示文稿。它类似于 Keynote，但数据存储在 CouchDB 中，并通过 JavaScript 和 Sammy.js 运行。Swinger 提供了一个免费托管版本，用户可以在本地或远程 CouchDB 服务器上运行该项目。

2. 项目下载位置

Swinger 项目托管在 GitHub 上，可以通过以下命令进行下载：

git clone https://github.com/quirkey/swinger.git

3. 项目安装环境配置

3.1 安装 CouchDB

Swinger 项目需要运行在 CouchDB 服务器上，建议安装 CouchDB 0.11 或更高版本。以下是安装步骤：

3.1.1 在 macOS 上安装 CouchDB

1. 使用 Homebrew 安装 CouchDB：

   brew install couchdb
   

2. 启动 CouchDB 服务：

   brew services start couchdb
   

3.1.2 在 Ubuntu 上安装 CouchDB

1. 添加 CouchDB 仓库：

   echo "deb https://apache.bintray.com/couchdb-deb $(lsb_release -cs) main" | sudo tee -a /etc/apt/sources.list
   

2. 更新包列表并安装 CouchDB：

   sudo apt-get update
   sudo apt-get install couchdb
   

3. 启动 CouchDB 服务：

   sudo service couchdb start
   

3.2 安装 CouchApp

Swinger 项目需要使用 CouchApp 工具来推送应用到 CouchDB。以下是安装步骤：

1. 安装 Python 和 pip：

   sudo apt-get install python python-pip
   

2. 使用 pip 安装 CouchApp：

   pip install couchapp
   

3.3 环境配置示例

以下是一个简单的环境配置示例，假设 CouchDB 运行在本地，端口为 5984：

[env]
default = {db = "http://localhost:5984/swinger"}

4. 项目安装方式

1. 进入 Swinger 项目目录：

   cd swinger
   

2. 使用 CouchApp 推送应用到 CouchDB：

   couchapp push
   

3. 推送完成后，CouchApp 会输出应用的访问地址，例如：

   http://localhost:5984/swinger/_design/swinger/index.html
   

5. 项目处理脚本

Swinger 项目包含一个 Rakefile 文件，用于自动化一些常见任务。以下是一些常用的 Rake 任务：

1. 推送应用到 CouchDB：

   rake push
   

2. 清理临时文件：

   rake clean
   

3. 查看所有可用任务：

   rake -T
   

通过以上步骤，您可以成功下载、配置并安装 Swinger 项目，并开始使用它来创建和展示演示文稿。