hyla 1.0

data/.rakeTasks

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Settings><!--This file was automatically generated by Ruby plugin.
+You are allowed to: 
+1. Remove rake task
+2. Add existing rake tasks
+To add existing rake tasks automatically delete this file and reload the project.
+--><RakeGroup description="" fullCmd="" taksId="rake"><RakeTask description="Build asciidoctor-cli-0.0.1.gem into the pkg directory" fullCmd="build" taksId="build" /><RakeTask description="Build and install asciidoctor-cli-0.0.1.gem into system gems" fullCmd="install" taksId="install" /><RakeTask description="Create tag v0.0.1 and build and push asciidoctor-cli-0.0.1.gem to Rubygems" fullCmd="release" taksId="release" /></RakeGroup></Settings>

data/.travis.yml

@@ -0,0 +1,10 @@
+language: ruby
+cache: bundler
+before_install:
+  - gem install bundler
+rvm:
+  - 2.0.0
+  - 1.9.3
+  - 1.9.2
+  - 1.8.7
+script: bundle exec rake

data/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in asciidoctor-cli.gemspec
+gemspec
+
+# gem 'hyla'
+

data/Gemfile.lock

@@ -0,0 +1,49 @@
+PATH
+  remote: .
+  specs:
+    hyla (1.0)
+      asciidoctor (~> 0.1.4)
+      colorator (~> 0.1)
+      commander (~> 4.1.3)
+      em-websocket (~> 0.5)
+      multi_json (~> 1.8)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    asciidoctor (0.1.4)
+    celluloid (0.15.2)
+      timers (~> 1.1.0)
+    colorator (0.1)
+    commander (4.1.5)
+      highline (~> 1.6.11)
+    em-websocket (0.5.0)
+      eventmachine (>= 0.12.9)
+      http_parser.rb (~> 0.5.3)
+    eventmachine (1.0.3)
+    ffi (1.9.3)
+    highline (1.6.20)
+    http_parser.rb (0.5.3)
+    json (1.8.1)
+    listen (2.4.0)
+      celluloid (>= 0.15.2)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9)
+    multi_json (1.8.2)
+    rake (10.1.0)
+    rb-fsevent (0.9.3)
+    rb-inotify (0.9.2)
+      ffi (>= 0.5.0)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    timers (1.1.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.3)
+  hyla!
+  listen (~> 2.0)
+  rake (~> 10.1)
+  rdoc (~> 3.11)

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Charles Mouliard
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.adoc

@@ -0,0 +1,136 @@
+image:https://raw.github.com/cmoulliard/asciidoctor-hyla/master/hyla_frog.jpg[Hyla, 100, 100, role="left"] **Hyla** is a 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(tro) as markup language. It also support to watch files and render them on the fly for browser configured with Livereload. The content generated is served by a HTTP server.
+
+The Hyla project name comes from an arborical http://en.wikipedia.org/wiki/Hyla[frog] living in equatorial regions of Europe, Asia or Americas. Its name was inspired by the companion of Hercule (Hylas) in Greek mythology.
+
+== Prerequisites
+
+- https://www.ruby-lang.org/en/[Ruby] > 1.9.3
+- http://guides.rubygems.org/[RubyGems] to install Ruby Applications
+
+== Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'hyla'
+
+And then execute:
+
+    $ bundle
+
+**Or** install it yourself as:
+
+    $ gem install hyla
+
+== For Developer's only
+
+    gem build hyla.gemspec
+    sudo gem install hyla-1.0.gem
+
+== Usage
+
+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 :
+
+    create               Creates a new file from asciidoc artefacts for an existing project
+    generate             Generate modules and asciidoc files from an asciidoc Table Of Content file
+    help                 Display global or [command] help documentation.
+    new                  Creates a new Hyla project using a template or blank to the PATH specified
+    serve                Serve locally your site
+    watch                Watch directories for any change, add or file deleted and render document (HTML5)
+
+More info about options and commands available can be find by running the `command line tool`
+
+    hyla --help
+
+Here are some examples of commands to create a new project, add artefacts (asciidoc files) watch resources and serve it using HTTP Server
+
+=== New project
+
+A Blank project
+
+    hyla new --blank ~/Temp/MyBlankProject
+
+
+A  Sample Project using as template --> training
+
+    hyla new --template_type training ~/Temp/MyTrainingProject
+
+
+=== Add an artefact to a project
+
+Asciidoc(tor) documents
+
+    hyla create --t asciidoc --a article --d ~/Temp/MyBlankProject
+    hyla create --t asciidoc  --a audio --d ~/Temp/MyBlankProject
+    hyla create --t asciidoc  --a video --d ~/Temp/MyBlankProject
+    hyla create --t asciidoc  --a source_highlight --d ~/Temp/MyBlankProject
+
+Slideshow
+
+    hyla create --t slideshow  --a deckjs --d ~/Temp/MyBlankProject
+
+=== Generate Asciidoctor project from a Table of Content
+
+The entry point of a Documention 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
+    ...
+    = 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
+
+    hyla generate --p my-project --d ~/Temp/TocProject/  --r toc2html --toc ~/MyProjects/hyla/data/toc.adoc
+
+    >> Project Name : my-project <<
+    >> Directory created : ~/Temp/MyBookProject/A_Introduction_module <<
+       = File created : 1_Chapter
+       = File created : 2_Chapter
+       = File created : 3_Chapter
+    >> Directory created : ~/Temp/MyBookProject/B_Instruction_module <<
+       = File created : 1_Chapter
+    >> Directory created : /Users/chmoulli/Temp/MyBookProject/C_Installation_module <<
+       = File created : 1_Chapter
+       = File created : 2_Chapter
+
+=== Generate HTML pages from Asciidoc
+
+    hyla generate --s ~/Temp/MyTocProject/ --d ~/Temp/MyToCProject/generated_content/ --r adoc2html
+
+=== Watch content Live
+
+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 ~/Temp/MyTocProject/ --d ~/Temp/MyTocProject/generated_content/
+
+=== Serve your content locally
+
+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 --out_dir ~/Temp/MyTrainingProject/generated_content/ -b /hyla/
+
+
+
+
+
+
+
+
+
+
+

data/Rakefile

@@ -0,0 +1,61 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'bundler/version'
+
+$LOAD_PATH.unshift File.expand_path("../lib", __FILE__)
+
+#############################################################################
+#
+# Helper functions
+#
+#############################################################################
+def name
+  @name ||= Dir['*.gemspec'].first.split('.').first
+end
+
+def version
+  line = File.read("lib/#{name}.rb")[/^\s*VERSION\s*=\s*.*/]
+  line.match(/.*VERSION\s*=\s*['"](.*)['"]/)[1]
+end
+
+def date
+  Date.today.to_s
+end
+
+def gemspec_file
+  "#{name}.gemspec"
+end
+
+def gem_file
+  "#{name}-#{version}.gem"
+end
+
+#############################################################################
+#
+# Standard tasks
+#
+#############################################################################
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+end
+
+desc "Run tests"
+task :default => :test
+
+# Simple Test case
+task :test do
+  ruby "test/my_test.rb"
+end
+
+task :build1 do
+  system "gem build #{gemspec_file}"
+end
+
+# Build project
+task :build2 => :gemspec do
+  sh "mkdir -p pkg"
+  sh "gem build #{gemspec_file}"
+  sh "mv #{gem_file} pkg"
+end

data/archive/GruntFile.js

@@ -0,0 +1,72 @@
+module.exports = function (grunt) {
+
+    // Nodes packages
+    grunt.loadNpmTasks('grunt-contrib-watch');
+    grunt.loadNpmTasks('grunt-shell');
+    grunt.loadNpmTasks('grunt-config');
+
+    // Retrieve Module & Mode from command line options
+    var MODULE = grunt.option('module') || 'A';
+    var MODE = grunt.option('mode') || 'LMSClass';
+    var THEME = grunt.option('css') || 'my_theme.css';
+    var BACKEND = grunt.option('backend') || 'html5';
+    var BACKEND_DIR;
+
+    var TARGET_DIR = '.';
+    var GENERATED_DIR = TARGET_DIR + "/content/" + MODULE
+    var SOURCE_DIR = MODULE;
+
+    grunt.initConfig({
+        shell: {
+            run_asciidoctor: {
+                // Options
+                options: {
+                    stdout: true
+                },
+                command:
+                        'asciidoctor'
+                                + ' -b ' + BACKEND
+                                + ' -a embedAssets'
+                                + ' ' + SOURCE_DIR + '/' + '<%= grunt.config.get("asciidocFile") %>'
+                                + ' --out-file ' + GENERATED_DIR + '/' + '<%= grunt.config.get("fileName") %>' + '.html'
+            }
+        },
+        watch: {
+            asciidoc: {
+                files: [SOURCE_DIR + '/*.txt', SOURCE_DIR + '/*.adoc'],
+                tasks: ["shell:run_asciidoctor"],
+                options: {
+                    nospawn: true
+                }
+            },
+            livereload: {
+                files: [GENERATED_DIR + '/*.html'],
+                tasks: [],
+                options: {
+                    livereload: true,
+                    spawn: false
+                }
+            }
+
+        }
+    });
+
+    // on watch events configure asciidoctor to only run on changed file
+    grunt.event.on('watch', function(action, filePath) {
+
+        // Split string receive to get only FileName
+        tokens = filePath.split('/');
+        // Remove file extension
+        fileName = tokens[1].substr(0, tokens[1].lastIndexOf('.'));
+
+        grunt.verbose.writeln("File Path received : " + filePath);
+        grunt.verbose.writeln("Asciidoc FileName : " + tokens[1]);
+        grunt.verbose.writeln("FileName without extension : " + fileName);
+
+        grunt.config.set('asciidocFile', tokens[1])
+        grunt.config.set('fileName', fileName)
+
+        grunt.task.run('shell:run_asciidoctor');
+    });
+
+};

data/archive/watch_files.rb

@@ -0,0 +1,70 @@
+require 'listen'
+require 'asciidoctor'
+require 'erb'
+
+class WatchFiles
+
+  DEFAULT_OPTIONS = {
+      :watch_dir => '.',
+      :watch_ext => %w(ad adoc asc asciidoc),
+      :run_on_start => false,
+      :backend => 'html5',
+      :eruby => 'erb',
+      :doctype => 'article',
+      :compact => false,
+      :attributes => {},
+      :always_build_all => false,
+      :to_dir => '.',
+      :to_file => '',
+      :safe => :unsafe
+  }
+
+  def initialize
+    puts "2. Class initialized !"
+  end
+
+  def watch()
+
+    puts "3. Watch function called"
+
+    @opts = DEFAULT_OPTIONS.clone
+
+    callback = Proc.new do |modified, added, removed|
+      puts "modified absolute path: #{modified}"
+      puts "added absolute path: #{added}"
+      puts "removed absolute path: #{removed}"
+
+      if !modified.nil? or !added.nil?
+
+        modified.each do |modify|
+          puts "File modified : #{modify}"
+
+          to_dir = File.dirname(modify)
+          @opts[:to_dir] = to_dir
+
+          file_to_process = Pathname.new(modify)
+          file_basename = file_to_process.basename
+          @ext_name = File.extname(file_basename)
+
+          puts "Extension of the file : #{@ext_name}"
+
+          if @ext_name != '.html'
+            to_file = file_to_process.to_s.gsub('adoc', 'html')
+            puts "Output Directory: #{to_dir}"
+            puts "To File : #{to_file}"
+            @opts[:to_file] = to_file
+            Asciidoctor.render_file(modify, @opts)
+          end
+        end
+      end
+
+
+    end
+
+    listener = Listen.to!('../../data/generated', &callback)
+
+  end
+end
+
+puts "1. Call & start Listen"
+WatchFiles.new.watch