= IIS Handbook

Welcome to the 2017 edition of the Institute for Intelligent Systems Handbook.

You can find this book online at: http://iis.memphis.edu/book

The IIS Handbook is open source under a Creative Commons license and uses the build structure of the 2nd edition Pro Git book.

Most changes to the book can be made by modifying a text file in the appropriate section of the book, but roles and responsibilities are stored as variables in iis-handbook.asc at the top level.

== How To Make Major Changes to the Book

• Install http://asciidoctor.org/[Asciidoctor]
• Install an http://asciidoctor.org/docs/editing-asciidoc-with-live-preview/[AsciiDoc editor]
• run gem install bundler
• Install https://git-scm.com/[Git]
• Prepare a https://yangsu.github.io/pull-request-tutorial/[pull request], change the source, and complete the request

== How To Make Minor Changes to the Book

• Execute the above pull request steps directly in browser at GitHub because GitHub allows direct editing of AsciiDoc
• https://help.github.com/articles/creating-an-issue/[Create an issue] of the suggested change an let the maintainer deal with it (check that the issue isn't already reported)

== How To Generate the Book

• Follow the steps on "How to Make Major Changes to the Book" above.
• Run the commands below

$ bundle install $ bundle exec rake book:build Converting to HTML... -- HTML output at progit.html Converting to EPub... -- Epub output at progit.epub Converting to Mobi (kf8)... -- Mobi output at progit.mobi Converting to PDF... -- PDF output at progit.pdf

This uses the asciidoctor, asciidoctor-pdf and asciidoctor-epub projects.