Whereuat 开源项目使用教程
1. 项目目录结构及介绍
Whereuat 是一个为 Rails 应用添加滑动面板的 Gem,用于将客户端引导至在 Pivotal Tracker 中标记为“已交付”的测试故事。以下是项目的目录结构及其介绍:
whereuat/
├── assets/
├── dev/
├── lib/
├── document/
├── .gitignore
├── Gemfile
├── Gemfile.lock
├── LICENSE
├── README.md
├── Rakefile
├── VERSION
└── whereuat.gemspec
- assets/: 存放项目的静态资源文件。
- dev/: 开发环境相关的文件和配置。
- lib/: 项目的核心代码库,包含主要的 Ruby 代码。
- document/: 项目文档文件。
- .gitignore: Git 忽略文件配置。
- Gemfile: 项目的依赖管理文件。
- Gemfile.lock: Gemfile 的锁定文件,确保依赖版本一致。
- LICENSE: 项目的开源许可证文件。
- README.md: 项目的说明文档。
- Rakefile: Rake 任务配置文件。
- VERSION: 项目的版本号文件。
- whereuat.gemspec: Gem 的规范文件,定义了 Gem 的元数据和依赖。
2. 项目启动文件介绍
Whereuat 项目的启动文件主要是 Rakefile
和 whereuat.gemspec
。
Rakefile
Rakefile
是 Ruby 的构建工具 Rake 的配置文件。它定义了项目的构建任务和开发环境配置。通过运行 rake dev
命令,可以启动一个 Sinatra 应用,用于验证 Whereuat 的工作。
whereuat.gemspec
whereuat.gemspec
是 Gem 的规范文件,定义了 Gem 的元数据和依赖。它包含了 Gem 的名称、版本、作者、描述、依赖等信息。
3. 项目配置文件介绍
Whereuat 的配置文件主要是 Gemfile
和 README.md
。
Gemfile
Gemfile
是 Bundler 的配置文件,用于管理项目的依赖。在 Gemfile
中添加 gem 'whereuat'
可以引入 Whereuat 这个 Gem。
README.md
README.md
是项目的说明文档,包含了项目的安装、配置和使用说明。以下是配置 Whereuat 的步骤:
-
安装: 在
Gemfile
中添加gem 'whereuat'
,然后运行bundle install
。 -
配置: 创建一个初始化文件(例如
config/initializers/whereuat.rb
),添加以下内容:require 'whereuat' Whereuat.configure do |config| config.pivotal_tracker_token = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" config.pivotal_tracker_project = 123456 end
-
使用: 在应用布局文件的
<body>
标签末尾添加以下代码:<%= whereuat %>
这将插入一小段 JavaScript 代码,在页面的左侧添加一个滑动面板。
通过以上步骤,您可以成功配置和使用 Whereuat 这个 Gem,为您的 Rails 应用添加滑动面板功能。