hyla 1.0.7.pre.2 → 1.0.7.pre.3

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    MjNjM2MzODViOTJjMGJmMzA5MDZmYTE3N2FmZGFiZmQ4NDY5ZThhYQ==
+    YzBmZWMxMGYwMDM2MzEwNmI5NzMzOWJiYzQ4OTIyOTEyMjc2ZmI2MA==
   data.tar.gz: !binary |-
-    YWYzNmY3N2Q3YThmMGVjYmIyZjVjNDJhZTFlMzllMGViNTAyM2EzOQ==
+    ZDQ4NTQ1MzE5ZWZhYmM4M2Q5Njg0ZTIxZTBkYThlN2JmZTlkNWM5Ng==
 SHA512:
   metadata.gz: !binary |-
-    NDAwMjRhZjlkNzczMDM3NmRmZWE5MjUyMDE0MTg4ZDQzNjZiZWQzMWJlZDYz
-    YjgwZDMyNWMyMzBlMjRhOTM3ZDdlM2RjYTVjNTNiODI4NTFmNmZmYjlmODgw
-    ZmVjYzlmMGMxNDFlN2E0NDhiY2Y3NDI1MGQyMDBiODNmMzdmODQ=
+    OGVmZGM2M2FlNjI0NjE4MGYyMzNjYTE5NWYyNmE2OWQ2OTZmMWI4NWFjODFh
+    MWFmYzIxYzQxNDhhNzVjNWFhMTE0ZmMzNjVjNjk0ZTAzZTM5NDBjOWYwY2Y0
+    ZWI1OGYzNDMxYjQ2MjU1NzdiNzIwNjI4YjdjYzAwOWRiNjEwNDc=
   data.tar.gz: !binary |-
-    NmJlMzcxYThhODcyOTFmMmU1ZmQ5NDkzZDUzMmUyNmYyZDU5OTU4Mzk0ODc4
-    ODA5MGM5YTU4ZjBhMWIwNmY1MGQxY2I0ODVkNDIwNzgyZDdhZmU1YTg0ZjZi
-    ZTExYmJlMGM1ZGQ0N2YxMTMwM2YxM2E5YWMwOWZmY2MzODI5NWQ=
+    YWJlZWM2N2M1OTEwZTVkY2E5MjdkMDM4MTdiYjdiMjRlNzY5MGFjMWIwMmQ0
+    NDYyYzkxZDNlYTgyNGI0ODcwZjAzZGIzM2RkNWVkNzc4MzM4ZGMyMDFmMjVh
+    MzhiYzNjZGI0Yjc1MDQ1NTg4MTQ5NzRkYzM2M2ZmODNhM2M2MDc=

data/.gitignore

@@ -3,6 +3,8 @@
 **/lib/resources/assets/sass/.sass-cache/
 **/lib/resources/assets/sass/styles
 
+gh-pages/
+
 *.gem
 *.rbc
 *.lock

data/README.adoc

@@ -10,7 +10,7 @@
 image:https://raw.github.com/cmoulliard/hyla/master/documentation/image/hyla_frog.jpg[Hyla, 100, 100, role="left"] **Hyla** is a Ruby command line tool to create a new
 documentation/training/blog/static web site project, add artefacts (articles, blog, audio, video, content, code source, ...), render it in HTML, SlideShow, ... using asciidoc(tor) as markup language.
 
-Until now, hyla looks like asciidoctor client but is is more similar to Jekyll on the principle but here we support 'asciidoc, asciidoctor' formats and not markdown.
+Until now, hyla looks like asciidoctor client but it is more similar to Jekyll on the principle but here we support 'asciidoc, asciidoctor' formats and not markdown.
 
 The tool allows to :
 
@@ -83,7 +83,7 @@ Issue tracker (GitHub):: {issues}
 
 == Changelog
 
-=== v1.0.7 - @cmoulliard
+=== v1.0.7 (2015-03-xx) - @cmoulliard
 
 Enhancements / Improvements::
 

data/Rakefile

@@ -1,28 +1,13 @@
 libdir = File.expand_path("../lib", __FILE__)
 $LOAD_PATH.unshift(libdir) unless $LOAD_PATH.include?(libdir)
 
-#require 'compass'
-#require 'compass/sass_compiler'
-
-# Dir["#{dir}/*.scss"].select do | f |
-#   p "File : #{f}"
-#   Compass.add_configuration({
-#                                 :sass_dir => '.',
-#                                 :css_dir => 'styles',
-#                                 :fonts_dir => 'fonts',
-#                                 :output_style => :compressed
-#                             }, 'alwaysmin' # A name for the configuration, can be anything you want
-#   )
-#   Compass.sass_compiler.compile(f.to_s, '#{f.to_s}.css')
-# end
-
 require 'rubygems'
 require 'rake'
 require 'rake/testtask'
-require 'bundler/version'
+# require 'bundler/version'
 require 'sass'
 require 'hyla/configuration'
-require 'font-awesome-sass'
+# require 'font-awesome-sass'
 
 #############################################################################
 #
@@ -54,6 +39,10 @@ def sass_assets
   Hyla::Configuration.assets
 end
 
+def revealjs_redhat_css_theme_assets
+  [Hyla::Configuration.assets, 'revealjs-redhat', 'lib', 'css'] * '/'
+end
+
 def revealjs_css_theme_assets
   [Hyla::Configuration.assets, 'revealjs', 'css', 'theme'] * '/'
 end
@@ -71,6 +60,7 @@ end
 #
 
 style = ENV["STYLE"] || "nested"
+tag_release = ENV["TAG_RELEASE"] || "#{name}-#{version}"
 
 #############################################################################
 #
@@ -94,19 +84,28 @@ task :compass do
   puts "\n## Compiling Sass"
 
   # path = Gem.loaded_specs['font-awesome-sass'].full_gem_path + "/assets/stylesheets"
-  
+
   #Go to the compass project directory
   Dir.chdir File.join(sass_assets, "sass") do |dir|
     puts "Sass dir : #{dir}"
     # -s #{style} -I #{path}
-    system "compass compile --fonts-dir 'fonts' --css-dir 'styles' --sass-dir '.' "
+    # To generate the sourcemap --> --sourcemap
+    system "compass compile --fonts-dir 'fonts' --css-dir 'styles' --sass-dir '.'"
 
     # Copy css to RevealJS theme
     # p revealjs_css_assets
-    system "cp styles/gpe.css #{revealjs_css_theme_assets}"
-    system "cp styles/font-awesome.css #{revealjs_css_vendor_assets}/font-awesome-4.3.0.css"
+    sh "cp styles/gpe.css #{revealjs_css_theme_assets}"
+    sh "cp styles/font-awesome.css #{revealjs_css_vendor_assets}/font-awesome-4.3.0.css"
+
+    sh "cp styles/gpe2.css #{revealjs_redhat_css_theme_assets}/gpe.css"
+    sh "cp styles/font-awesome.css #{revealjs_redhat_css_theme_assets}/font-awesome-4.3.0.css"
+
+    # sh "cp gpe.scss #{revealjs_css_theme_assets}"
+    # sh "cp styles/gpe.css.map #{revealjs_css_theme_assets}"
+    # sh "cp styles/font-awesome.css.map #{revealjs_css_vendor_assets}/font-awesome-4.3.0.css.map"
+
   end
-  
+
 end
 
 # Build the Gem
@@ -124,9 +123,79 @@ task :deploy => :install do
   system "gem push #{gem_file}"
 end
 
-# Build the Gem and move it under the pkg directory
-task :build_pkg => :gemspec do
+# Tag the release 
+task :tag_release do
+  system "git tag -a #{name}-#{version} -m 'Release of hyla #{version}'"
+  system "git push origin #{name}-#{version}"
+end
+
+desc "Delete the git tag"
+task :tag_delete do
+  p "Tag to be removed: #{tag_release}"
+  sh "git tag -d #{tag_release}"
+  sh "git push origin :#{tag_release}"
+end
+
+desc "Build the Gem and move it under the pkg directory"
+task :build_pkg do
   sh "mkdir -p pkg"
   sh "gem build #{gemspec_file}"
   sh "mv #{gem_file} pkg"
 end
+
+#
+# Generate doc for gh-pages
+#
+desc "Commit the local site to the gh-pages branch and publish to GitHub Pages"
+task :publish do
+  # Ensure the gh-pages dir exists so we can generate into it.
+  puts "Checking for gh-pages dir..."
+  unless File.exist?("./gh-pages")
+    puts "Creating gh-pages dir..."
+    sh "git clone git@github.com:cmoulliard/hyla.git gh-pages"
+  end
+
+  # Ensure latest gh-pages branch history.
+  Dir.chdir('gh-pages') do
+    sh "git checkout gh-pages"
+    sh "git pull origin gh-pages"
+  end
+
+  # Proceed to purge all files in case we removed a file in this release.
+  puts "Cleaning gh-pages directory..."
+  purge_exclude = %w[
+      gh-pages/.
+      gh-pages/..
+      gh-pages/.git
+      gh-pages/.gitignore
+    ]
+  FileList["gh-pages/{*,.*}"].exclude(*purge_exclude).each do |path|
+    sh "rm -rf #{path}"
+  end
+
+  # Copy site to gh-pages dir.
+  puts "Building site into gh-pages branch..."
+
+  # Generate HTML site using hyla
+  sh "hyla generate -c config.yaml"
+
+  # Commit and push.
+  puts "Committing and pushing to GitHub Pages..."
+  sha = `git rev-parse HEAD`.strip
+
+  Dir.chdir('gh-pages') do
+    sh "git add ."
+    sh "git commit --allow-empty -m 'Updating to #{sha}.'"
+    sh "git push origin gh-pages"
+  end
+  puts 'Done.'
+end
+
+desc 'Say Hello'
+task :hello, [:msg1, :msg2] do |t, args|
+  msg1 = args.msg1 or
+      fail "Msg1 is mandatory"
+  msg2 = args[:msg2] || "Man"
+  puts msg1.upcase + '!'
+  puts msg2.downcase + '!'
+end

data/config.yaml

@@ -0,0 +1,49 @@
+#
+# Common options
+#
+source: documentation
+destination: gh-pages # or . or ~/Hyla or generated_content
+# end common options
+
+#
+# Styles
+# Supported :  liberation, asciidoctor, colony, foundation, foundation-lime, foundation-potion, github, golo, iconic, maker, readthedocs, riak, rocket-panda, rubygems
+#
+style: asciidoctor
+
+#
+# Asciidoctor and attributes options
+#
+backend: html5
+doctype: book
+attributes:
+   source-highlighter: coderay
+   linkcss!: true
+   data-uri: true
+   allow-uri-read: true
+   linkattrs: true
+   sectanchors: true
+   setlinks: true
+   last-update-label!:
+   
+   stylesdir: /Users/chmoulli/.rbenv/versions/1.9.3-p484/lib/ruby/gems/1.9.1/gems/hyla-1.0.7.pre.3/lib/resources/assets/styles
+   safe: unsafe
+   
+   toc: right
+   toclevel: 4
+
+   # Font Icons - http://fortawesome.github.io/Font-Awesome/icons/
+   icon-arrow-left: <i class="fa fa-arrow-right"></i>
+   icon-arrow-right: <i class="fa fa-arrow-right"></i>
+   icon-exclamation-mark: <i class="fa fa-exclamation"></i>
+   icon-question-mark: <i class="fa fa-question"></i>
+
+   icons: font
+   iconfont-remote: true
+   iconfont-cdn: http://maxcdn.bootstrapcdn.com/font-awesome/4.3.0/css/font-awesome.min.css
+
+   footer_copyright: Copyright ©2015 Charles Moulliard - Hyla # Copyright Text
+   nofooter: true
+
+# end asciidoctor attributes
+rendering: index2html

data/documentation/developer.adoc

@@ -3,7 +3,7 @@
 :sources: https://github.com/cmoulliard/hyla
 :issues: https://github.com/cmoulliard/hyla/issues/
 
-== Install the gem
+=== Install the gem
 
 Use `gem install` command to deploy Hyla :
 
@@ -11,7 +11,7 @@ Use `gem install` command to deploy Hyla :
 
 NOTE :  The option `-y` will tell to rubyGems to deploy the gem but also the dependencies required
 
-== Build the project from the code 
+=== Build the project from the code
 
 * Generate the gem
 
@@ -34,13 +34,13 @@ This command will create a gem of the project
 
     rake deploy
 
-* To create a release, generate a tagged release and publish it to Gem Repo
+* To create a build, generate a git tag and publish it to the Gem Repo
 
     rake install
-    git commit -m "Release Hyla 1.0.7.pre.x" -a
+    git commit -m "Release Hyla 1.0.x" -a
     git push
-    git tag -a hyla-1.0.7.pre.x -m "Release hyla 1.0.7.pre.x"
-    git push origin hyla-1.0.7.pre.x
+    git tag -a hyla-1.0.x -m "Release hyla 1.0.x"
+    git push origin hyla-1.0.x
 
     rake deploy
     

data/documentation/imgkit.adoc

@@ -0,0 +1,44 @@
+
+
+== Imgkit installation
+
+[source,txt]
+----
+gem install imgkit -v 1.6.0
+Fetching: imgkit-1.6.0.gem (100%)
+******************************************************************
+
+Now install wkhtmltoimage binaries:
+Global: sudo `which imgkit` --install-wkhtmltoimage
+        rvmsudo imgkit --install-wkhtmltoimage
+(installs to default /usr/local/bin/wkhtmltoimage)
+
+inside RVM folder: export TO=`which imgkit | sed 's:/imgkit:/wkhtmltoimage:'` && imgkit --install-wkhtmltoimage
+(you'll have to configure the location of the binary if you do this!)
+
+(run imgkit --help to see more options)
+******************************************************************
+----
+
+Execution of the command `sudo `which imgkit` --install-wkhtmltoimage` has generated this error :
+
+[source,txt]
+----
+/Users/chmoulli/.rbenv/versions/1.9.3-p484/lib/ruby/gems/1.9.1/gems/imgkit-1.6.0/bin/imgkit:12: Use RbConfig instead of obsolete and deprecated Config.
+Sorry, I couldn't find the binary for your architecture (OSX)
+  at http://code.google.com/p/wkhtmltopdf/downloads/list?can=1
+Please go to that page, unzip the appropriate binary, and install
+----
+
+The web site referenced by imgkit is not longer correct and the tool must be installed from this web site now +http://wkhtmltopdf.org/downloads.html+
+The version installed successfully is http://downloads.sourceforge.net/project/wkhtmltopdf/0.12.2.1/wkhtmltox-0.12.2.1_osx-cocoa-x86-64.pkg[0.12.2.1]
+
+Verification of the version installed :
+
+    wkhtmltoimage -V
+    wkhtmltoimage 0.12.2.1 (with patched qt)
+
+
+
+
+

data/documentation/index.txt

@@ -0,0 +1,3 @@
+:numbered:
+
+include::introduction.adoc[]

data/documentation/introduction.adoc

@@ -1,11 +1,3 @@
-:toc:
-:data-uri:
-:linkattrs:
-:sectanchors:
-:setlinks:
-
-toc::[]
-
 == Introduction
 
 image:https://raw.github.com/cmoulliard/hyla/master/documentation/image/hyla_frog.jpg[Hyla, 100, 100, role="left"] **Hyla** is a Ruby command line tool to create a new
@@ -41,11 +33,14 @@ The Hyla project name comes from an arboreal http://en.wikipedia.org/wiki/Hyla[f
 
 == Developer
 
-* link:documentation/prerequisites.adoc[Prerequisites]
-* link:documentation/developer.adoc["How to install, build the gem"]
-* Using a Docker container
+include::prerequisites.adoc[]
+include::developer.adoc[]
 
-== Usage
+//* link:prerequisites.html[Prerequisites]
+//* link:developer.adoc["How to install, build the gem"]
+//* Using a Docker container
+
+== Technical writer
 
 Open a terminal and move to the folder where you would like to create a new project or develop an existing. As Hyla is command line tool, it will be used with one of the following commands :
 
@@ -62,329 +57,7 @@ More info about options and commands available can be find by running the `comma
 
 == Scenario
 
-The following scenario describes how we can can setup a project using one of the option proposed by Hyla : Create, Generate, Watch, ...
-
-==== 1. Delete Temp directory
-
-    rm -rf ~/hyla/MyBlankProject/
-    rm -rf ~/hyla/MyBookProject
-    rm -rf ~/hyla/MyPdfProject/
-    rm -rf ~/hyla/MyTocProject/
-    rm -rf ~/hyla/MyTrainingProject/
-    rm -rf ~/hyla/MyTrainingExercisesProject/
-    rm -rf ~/hyla/MyDeckSlideShow/
-    rm -rf ~/hyla/MyRevealSlideShow/
-    rm -rf ~/hyla/MyEmailProject/
-
-== 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 -d ~/hyla/MyBlankProject
-    hyla new --blank -d ~/hyla/MyBlankProject --force
-
-== 2. Create a Blank Project without _config.yaml config file, add artefact
-
-- Clean and create a MyBlankProject (= directory) using --force option
-
-    cd ~/hyla
-    rm -rf MyBlankProject/
-    hyla new --blank -d MyBlankProject
-
-- Create Asciidoc files from samples (book, article, image, audio, ...)
-
-    hyla add --t asciidoc -a article -d ~/hyla/MyBlankProject
-    hyla add --t asciidoc -a book -d ~/hyla/MyBlankProject
-    hyla add --t asciidoc -a image -d ~/hyla/MyBlankProject
-    hyla add --t asciidoc -a audio -d ~/hyla/MyBlankProject
-    hyla add --t asciidoc -a video -d ~/hyla/MyBlankProject
-    hyla add --t asciidoc -a source -d ~/hyla/MyBlankProject
-    hyla add --t asciidoc -a table -d ~/hyla/MyBlankProject
-
-== 3.  Create a Blank Project using _config.yaml config file, add artefacts
-
-- Clean up project and create a MyBlankProject (= directory) using --force option
-
-    cd ~/hyla
-    rm -rf MyBlankProject/
-
-    # Create a Blank project but containing the yaml config file
-    hyla new --blank -d MyBlankProject
-
-    cd MyBlankProject
-
-- Create Asciidoc files from samples (book, article, image, audio, ...)
-
-    hyla add --a article
-    hyla add --a book
-    hyla add --a image
-    hyla add --a audio
-    hyla add --a video
-    hyla add --a source
-    hyla add --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 : liberation, 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 liberation
-    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 add` command, then we must change the destination directory to `generated_content`. the original file is
-   still available as it will backup by ruby
-
-    ruby -i.bak -pe 'sub(%r{destination: .},"destination: generated_content")' _config.yaml
-    hyla generate
-    hyla generate -y foundation
-
-
-== 2. Project from Template
-
-=== 1. Create a project using a template (training)
-
-    cd ~/hyla
-    hyla new --t training -d MyTrainingProject
-
-    // TODO Refactor Training Exercises Template
-    hyla new --t training-exercises -d MyTrainingExercisesProject
-
-    // TODO - Add images
-    hyla new --t book -d MyBookProject
-
-=== 2. Generate content and watch it
-
-    cd ~/hyla/MyTrainingProject
-    ruby -i.bak -pe 'sub(%r{destination: .},"destination: generated_content")' _config.yaml
-    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
-
-The entry point of a Documentation site, Training, Publication or Book will consist most of the time to create
-a Table Of Content which is a collection of modules with chapters that we will develop. As this process to elaborate
-the structure of the project will consume lot of time/effort, Hyla will simplify your life as it allows from a TOC file
-
-
-    = A. Introduction module
-    >> This is the module 'A. Introduction'
-
-    == 1. Chapter
-    This is a chapter about ...
-
-    == 2. Chapter
-    This is a Chapter about ...
-
-    === 2.1. Section
-    This is a sub chapter
-
-    = B. Instruction module
-    >> This is the module 'B. Instruction module'
-
-    == 1. Chapter
-    This is a Chapter about ...
-
-to generate a collection of folders (= modules) containing files which represent the chapters (== Titles of the TOC ).
-For each module (= Module), an index file is also created including the files listed in a module. That can be serve to generate a
-slideshow presentation using as backend (DeckJS, DZSlides, ...) later on.
-
-- Delete existing project
-
-    cd ~/hyla
-    rm -rf MyTocProject/
-
-- Generate asciidoc files from a Table Of Content (= collection of folders and files) and next HTML
-
-    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
-
-Example about what is generated
-
-    >> Project Name : my-project <<
-    >> Directory created : ~/hyla/MyTocProject/A_Introduction_module <<
-       = File created : 1_Chapter
-       = File created : 2_Chapter
-       = File created : 3_Chapter
-    >> Directory created : ~/Temp/MyTocProject/B_Instruction_module <<
-       = File created : 1_Chapter
-    >> Directory created : /Temp/MyTocProject/C_Installation_module <<
-       = File created : 1_Chapter
-       = File created : 2_Chapter
-
-
-- Watch asciidoc files and generate new HTML content when a modification is detected
-
-While you develop asciidoc(tor) documents, it is interesting to consult the files rendered in HTML. Hyla supports such option with LiverReload
-as a WebSocket server is exposed for the browser. To watch files and let's asciidoctor to render them, simply open a terminal and provide as
- parameter the source directory containing the files to be watched.
-
-    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.yaml
-    hyla generate -r adoc2html
-
-    hyla watch -s ~/hyla/MyTocProject/ -d generated_content
-
-=== 3. Generate a DeckJS Slideshow for a module
-
-    cd ~/hyla/MyTocProject
-    hyla generate --backend deckjs -s  A_Introduction_module/ -d A_Introduction_module/generated_content -r index2html
-
-=== 4. Generate a DeckJS Slideshow for a Project (all the TOC)
-
-    cd ~/hyla/MyTocProject
-    hyla generate --backend deckjs -s  . -d generated_content -r index2html
-
-== 5. Server content locally - HTTP Server
-
-To simplify your life, a simple HTTP Server can be started by Hyla and will allow to consult/browse HTML files generated. In this case, start this
-Hyla command in another Terminal
-
-    hyla serve -P 4000 -H localhost -b /hyla/ --out_dir ~/hyla/MyTrainingProject/generated_content/
-
-== 6. Generate a Slideshow
-
-=== 1. DeckJS
-
-    rm -rf  ~/hyla/MyDeckSlideShow
-    cd ~/hyla
-    hyla new -b -d MyDeckSlideShow
-
-   hyla add --t slideshow -a deckjs -d MyDeckSlideShow
-   hyla generate --backend deckjs -s  ~/hyla/MyDeckSlideShow -d ~/hyla/MyDeckSlideShow/generated_content -r adoc2html
-
-=== 2. Different DeckJS Style options
-
-    hyla generate --backend deckjs -s  ~/hyla/MyDeckSlideShow -d ~/hyla/MyDeckSlideShow/generated_content -r adoc2html -a deckjs_theme=swiss,deckjs_transition=fade
-    hyla generate --backend deckjs -s  ~/hyla/MyDeckSlideShow -d ~/hyla/MyDeckSlideShow/generated_content -r adoc2html -a deckjs_theme=web-2.0,deckjs_transition=horizontal-slide
-
-===  3. RevealJS
-
-    rm -rf ~/hyla/MyRevealSlideShow
-    cd ~/hyla
-    hyla new --blank -d MyRevealSlideShow
-
-    hyla add --t slideshow -a revealjs -d MyRevealSlideShow
-
-    cd MyRevealSlideShow
-
-    hyla generate --backend revealjs -s . -d generated_content -r adoc2html
-
-    open http://localhost:4000/hyla/slideshow_revealjs.html &
-
-    hyla serve -P 4000 -H localhost -b /hyla/ -d generated_content/
-
-== 7. Generate a PDF
-
-A PDF document can be created using the rendering option `html2pdf`. To render the HTML file, Hyla uses the following Ruby
-libraries https://github.com/pdfkit/pdfkit[pdfkit] and https://github.com/wkhtmltopdf/wkhtmltopdf[wkhtmltopdf].
-
-- Clean and create a MyPdfProject (= directory)
-
-    cd ~/hyla
-    rm -rf MyPdfroject/
-    hyla new -b -d MyPdfProject --force
-    cd MyPdfProject
-
-- Create Asciidoc file from sample (book)
-
-    hyla add -a book --t asciidoc -d .
-
-- Generate HTML content using foundation stylesheet
-
-    hyla generate --style foundation
-
-- We change the rendering from adoc2html to html2pdf
-
-    ruby -i.bak -pe 'sub(%r{rendering: adoc2html},"rendering: html2pdf")' _config.yaml
-
-- Source directory & Destination directory
-
-    ruby -i.bak -pe 'sub(%r{source: .},"source: ./generated_content")' _config.yaml
-    ruby -i.bak -pe 'sub(%r{destination: generated_content},"destination: ./generated_content/pdf")' _config.yaml
-
-- We will generate the PDF file for the image and book
-
-    hyla generate -f asciidoc_book.html
-    hyla generate -f asciidoc_image.html
-
-- Result can be opened and viewed
-
-    open generated_content/pdf/asciidoc_book.pdf
-    open generated_content/pdf/asciidoc_image.pdf
-
-== 7. Send Email
-
-An email can be created using as attachment an HTML file based on the information, parameters provided into the
-_config.yaml file. These parameters will allow to populate the email message and add as attachment the HTML
-file generated from an asciidoc file.
-
-    email_attributes:
-        from:     "Charles Moulliard <ch007m@gmail.com>"
-        to:       'cmoulliard@apache.com'
-        subject:  "This is a beautiful HTML document created by Asciidoctor and Hyla Tool"
-        # GMAIL
-        smtp_server:      'smtp.gmail.com'
-        port:             '587'
-        enable_starttls:  'true'
-        user:             'your_gmail_user'
-        password:         'your_gmail_password!'
-
-Two new options are required to process the request on the command line or using _config.yaml file
-
-    source: ./generated_content
-    file: name_of_html_file
-
-- Create a Blank project
-
-    cd ~/hyla
-    rm -rf MyEmailProject/
-    hyla new -b -d MyEmailProject --force
-    cd MyEmailProject
-
-- Add an asciidoc file (report, doc, book, article)
-
-    hyla add --a book --d .
-
-- Edit the _config.yaml file and add the parameters required (see previously)
-
-- Generate HTML content using foundation stylesheet
-
-    hyla generate --style asciidoctor
-
-- Send email to the SMTP server defined
-
-   hyla sendmail
-
-- Consult the message received in your mailbox
-
-image::image/email_send.png[]
-
+include::scenario.adoc[]