anchor.diff:  
   Feel free to use the {project-issues-uri}[issue tracker] or http://discuss.asciidoctor.org[Asciidoctor mailing list] to provide feedback or suggestions in other ways.
   
  +== Development
  +
  +To help develop Asciidoctor EPUB3, or to simply test drive the development version, you need to get the source from GitHub.
  +Follow the instructions below to learn how to clone the source and run it from your local copy.
  +
  +=== Retrieve the Source Code
  +
  +You can retrieve {project-name} in one of two ways:
  +
  +. Clone the git repository
  +. Download a zip archive of the repository
  +
  +==== Option 1: Fetch Using `git clone`
  +
  +If you want to clone the git repository, simply copy the {project-repo-uri}[GitHub repository URL] and pass it to the `git clone` command:
  +
  + $ git clone https://github.com/asciidoctor/asciidoctor-epub3
  +
  +Next, change to the project directory:
  +
  + $ cd asciidoctor-epub3
  +
  +==== Option 2: Download the Archive
  +
  +If you want to download a zip archive, click on the btn:[icon:cloud-download[\] Download Zip] button on the right-hand side of the repository page on GitHub.
  +Once the download finishes, extract the archive, open a console and change to that directory.
  +
  +TIP: Instead of working out of the {project-handle} directory, you can simply add the absolute path of the [path]_bin_ directory to your `PATH` environment variable.
  +
  +We'll leverage the project configuration to install the necessary dependencies.
  +
  +=== Prepare RVM (optional step)
  +
  +If you're using {rvm-uri}[RVM], we recommend creating a new gemset to work with {project-name}:
  +
  + $ rvm use 2.2@asciidoctor-epub3-dev --create
  +
  +We like RVM because it keeps the dependencies required by various projects isolated.
  +
  +=== Install the Dependencies
  +
  +The dependencies needed to use {project-name} are defined in the [file]_Gemfile_ at the root of the project.
  +We can use Bundler to install the dependencies for us.
  +
  +To check if you have Bundler available, use the `bundle` command to query the version installed:
  +
  + $ bundle --version
  +
  +If it's not installed, use the `gem` command to install it.
  +
  + $ gem install bundle
  +
  +Then use the `bundle` command to install the project dependencies:
  +
  + $ bundle
  +
  +NOTE: You need to call `bundle` from the project directory so that it can find the [file]_Gemfile_.
  +
  +=== Build and Install the Gem
  +
  +Now that the dependencies are installed, you can build and install the gem.
  +
  +Use the Rake build tool to build the gem:
  +
  + $ rake build
  +
  +The build will report that it built the gem into the [path]_pkg_ directory.
  +
  +Finally, install the gem.
  +
  + $ gem install pkg/asciidoctor-epub3-1.5.0.dev.gem
  +
  +Once the development version of the gem is installed, you can run {project-name} by invoking the `asciidoctor-epub3` script:
  +
  + $ asciidoctor-epub3 -v
  +
  +If you see the version of {project-name} printed to your console, you're ready to use {project-name}!
  +
  +=== Shortcut: Run the Launch Script Directly
  +
  +Assuming all the required gems install properly, you can run the `asciidoctor-epub3` script directly out of the project folder using either:
  +
  + $ bin/asciidoctor-epub3 -v
  +
  +or
  +
  + $ bundle exec bin/asciidoctor-epub3 -v
  +
  +You're now ready to test drive the development version of {project-name}!
  +
  +Jump back to <<Getting Started>> to learn how to create an AsciiDoc document and convert it to EPUB3.
  +
   == Authors
   
   {project-name} was written by https://github.com/mojavelinux[Dan Allen] and https://github.com/graphitefriction[Sarah White] of OpenDevise on behalf of the Asciidoctor Project.
  
positive.code: The theme's CSS files are located in the [path]_data/style_ directory.
  
  IMPORTANT: {project-name} only provides one theme, and, at this time, you can not replace it with a custom theme using the `stylesheet` attribute.
  
  === Fonts
  
  
negative.code: 
  CAUTION: {project-name} is currently _alpha_ software.
  Use accordingly.
  Although the bulk of AsciiDoc content is converted, there's still work needed to fill in gaps where conversion is incomplete or unstyled.
  
  NOTE: {project-name} only produces variable layout (i.e., reflowable) EPUB3 documents since this layout is best suited for the types of documents typically written in AsciiDoc.
  We may explore the use of fixed layout documents in the future if the need arises.
  