== Prerequisites

==== 1. Delete Temp directory

    rm -rf ~/hyla/MyBlankProject/
    rm -rf ~/hyla/MyBookProject
    rm -rf ~/hyla/MyTocProject/
    rm -rf ~/hyla/MyTrainingProject/
    rm -rf ~/hyla/MyTrainingExercisesProject/
    rm -rf ~/hyla/MyDeckSlideShow/
    rm -rf ~/hyla/MyRevealSlideShow/

==== 2. Install Gem Hyla 1.0.x

    gem install hyla -v 1.0.x

== 1. Blank Project & Artefacts

Using hyla we will create a new project (= directory) and add artefacts (article, audio, video, image, source, table)

== 1. Create a Blank Project (with or without --force option)

    hyla new --blank ~/hyla/MyBlankProject
    hyla new --blank ~/hyla/MyBlankProject --force

== 2. Create a Blank Project without _config.yaml config file, add artefact

    cd ~/hyla
    rm -rf MyBlankProject/
    hyla new --blank MyBlankProject --force
    hyla create --t asciidoc --a article --d ~/hyla/MyBlankProject
    hyla create --t asciidoc --a book --d ~/hyla/MyBlankProject
    hyla create --t asciidoc --a image --d ~/hyla/MyBlankProject
    hyla create --t asciidoc --a audio --d ~/hyla/MyBlankProject
    hyla create --t asciidoc --a video --d ~/hyla/MyBlankProject
    hyla create --t asciidoc --a source --d ~/hyla/MyBlankProject
    hyla create --t asciidoc --a table --d ~/hyla/MyBlankProject

== 3.  Create a Blank Project using _config.yaml config file, add artefacts

    cd ~/hyla
    rm -rf MyBlankProject/
    hyla new --blank MyBlankProject --force
    cd MyBlankProject
    hyla create --a article
    hyla create --a book
    hyla create --a image
    hyla create --a audio
    hyla create --a video
    hyla create --a source
    hyla create --a table

=== 4. Generate HTML Content of an existing project (asciidoc 2 html)

    hyla generate --r adoc2html --s ~/hyla/MyBlankProject/ --d ~/hyla/MyBlankProject/generated_content

=== 5. Generate HTML Content of an existing project (asciidoc 2 html) with a different style

    Styles available : redhat, asciidoctor, colony, foundation, foundation-lime, foundation-potion, github, golo, iconic, maker, readthedocs, riak, rocket-panda, rubygems

    hyla generate --r adoc2html --s ~/hyla/MyBlankProject/ --d ~/hyla/MyBlankProject/generated_content --style redhat
    hyla generate --r adoc2html --s ~/hyla/MyBlankProject/ --d ~/hyla/MyBlankProject/generated_content --style github
    hyla generate --r adoc2html --s ~/hyla/MyBlankProject/ --d ~/hyla/MyBlankProject/generated_content --style foundation

=== 6. Generate HTML Content within project

    hyla generate --r adoc2html --s . --d generated_content

=== 7. Generate HTML Content within project & using Config File

   As destination directory is not longer '.' (which is the case when we add artefacts using `hyla create` command, then we must change the destination directory to `generated_content`. the original file is
   still available as it will backuped by ruby

   ruby -i.bak -pe 'sub(%r{destination: .},"destination: generated_content")' _config.yml
   hyla generate


== 2. Project from Template

=== 1. Create a project using a template (training)

    hyla new --t training ~/hyla/MyTrainingProject --force
    hyla new --t training-exercises ~/hyla/MyTrainingExercisesProject --force
    hyla new --t book --force ~/hyla/MyBookProject --force

=== 2. Generate content and watch it

    cd ~/hyla/MyTrainingProject
    ruby -i.bak -pe 'sub(%r{destination: .},"destination: generated_content")' _config.yml
    hyla generate

    hyla watch --s ~/hyla/MyTrainingProject/ --d ~/hyla/MyTrainingProject/generated_content

== 3. Table Of Content To asciidoc

=== 1. Generate an asciidoctor project from a Table of Content

    hyla generate --r toc2adoc --p my-project --d ~/hyla/MyTocProject/ --toc ~/MyProjects/hyla/data/toc.adoc
    hyla generate --r adoc2html --s ~/hyla/MyTocProject/ --d ~/hyla/MyTocProject/generated_content

    hyla watch --s ~/hyla/MyTocProject/ --d ~/hyla/MyTocProject/generated_content

=== 2. Generate an asciidoctor project from a Table of Content using YAML config file and watch content

    rm -rf ~/hyla/MyTocProject
    cd ~/hyla
    hyla new --blank MyTocProject
    cd MyTocProject
    hyla generate --r toc2adoc

    # Change destination in config files or pass info as option
    # cd ../MyTocProject/
    # subl _config.yml
    hyla generate --r adoc2html

    hyla watch --s ~/hyla/MyTocProject/ --d generated_content

== 4. Generate a DeckJS Slideshow from Table Of Content

    hyla generate --backend deckjs --s  ~/hyla/MyTocProject/A_Introduction_module/ --d ~/hyla/MyTocProject/A_Introduction_module/generated_content --r adoc2slide

== 5. Server content locally - HTTP Server

    hyla serve -P 4000 -H localhost --out_dir ~/hyla/MyTrainingProject/generated_content/ -b /hyla/

== 6. Generate a Slideshow

=== 1. DeckJS using a template

   rm -rf  ~/hyla/MyDeckSlideShow
   cd ~/hyla
   hyla new --blank MyDeckSlideShow
   hyla create --t slideshow --a deckjs --d MyDeckSlideShow
   hyla generate --backend deckjs --s  ~/hyla/MyDeckSlideShow --d ~/hyla/MyDeckSlideShow/generated_content --r adoc2slide

=== 2. Different DeckJS Style options

   hyla generate --backend deckjs --s  ~/hyla/MyDeckSlideShow --d ~/hyla/MyDeckSlideShow/generated_content --r adoc2slide --a deckjs_theme=swiss,deckjs_transition=fade
   hyla generate --backend deckjs --s  ~/hyla/MyDeckSlideShow --d ~/hyla/MyDeckSlideShow/generated_content --r adoc2slide --a deckjs_theme=web-2.0,deckjs_transition=horizontal-slide

===  3. RevealJS

   rm -rf ~/hyla/MyRevealSlideShow
   cd ~/hyla
   hyla new --blank MyRevealSlideShow
   hyla create --t slideshow --a revealjs --d MyRevealSlideShow
   cd MyRevealSlideShow
   hyla generate --backend revealjs --s . --d generated_content --r adoc2slide