add agenda

static.md

@@ -1,6 +1,35 @@
-% Talk Notes - Static is the New Dynamic
+title: Static is the New Dynamic - Jekyll, Octopress, GitHub Pages n Friends
 
 
+%css
+
+pre {
+  padding: 4px 4px 4px 4px;
+  border-top: #bbb 1px solid;
+  border-bottom: #bbb 1px solid;
+  background: #f3f3f3;
+}
+
+%end
+
+
+
+# Agenda
+
+- Dynamic Site Generators
+- Static Site Generators
+- Why Static?
+- Static Site Generator - Folder Structure Example
+- Static Site Generators - The Biggies
+- Build Your Own Static Site Generator in Ruby in 5 Minutes
+- Static is the New Dynamic - Jekyll is the New Ruby Killer App
+- Jekyll Getting Started
+- Jekyll - Beyond the Basics - Collections, Data
+- Dynamic Examples  -  Videos, Comments, n More
+- Jekyll Goodies -  HTML Proofer, Prose.io, GitHub.j, Jekyll Planet Gem, WordPress Jekyll Export Plugin
+- GitHub Pages
+- Octopress 3.0 Upcoming
+
 
 # Dynamic Site Generators
 
@@ -140,7 +169,7 @@ The numbers
 
 The web stack
 
-- Static HTML pages generated by Jekyll
+- Static HTML pages generated by Ruby w/ Jekyll
 - Served by Akamai CDN, origin hosted on Amazon S3
 - Version control with GitHub
 - Conversion optimization with Optimizely
@@ -156,14 +185,15 @@ The web stack
 
 ![](i/site-staticgen-com.png)
 
-(Source: [staticsitegenerators.net](http://staticsitegenerators.net))
+(Source: [staticgen.com](http://www.staticgen.com))
+
 
 
 # Static Site Generators Directories - `staticsitegenerators.net`
 
 ![](i/site-staticsitegenerators-net.png)
 
-(Source: [staticgen.com](http://www.staticgen.com))
+(Source: [staticsitegenerators.net](http://staticsitegenerators.net))
 
 
 
@@ -414,7 +444,7 @@ In your templates use `site.data.books`. Example:
 {{{% video urls [class names] [width height] [preload:auto|metadata|none] %}}}
 ~~~
 
-**Examples***
+**Examples**
 
 ~~~
 {{{% video {{{{ site.cdn }}/videos/clouds.mp4 %}}}
@@ -455,9 +485,9 @@ Re-generate and re-deploy your site every minute (or when pinged with web hook e
 
 What's HTML Proofer?
 
-HTML Proofer is gem (html-proofer) that  proofreads your HTML output 
-Tests include if your image references are legitimate, 
-if they have alt tags, if your internal links are working, and so on. 
+HTML Proofer is a gem (e.g. `html-proofer`) that proofreads your HTML output.
+Tests include if your image references are legitimate,
+if they have alt tags, if your internal links are working, and many many more.
 
 Usage:
 
@@ -485,34 +515,33 @@ script: jekyll build && htmlproof ./_site
 Write and save your posts in your browser with "distraction-free"
 simple online text editor like Prose.io - a content editor for GitHub, for example.
 
-How does it work?
-
-GitHub offers an HTTP JSON API; using the GitHub.js machinery lets you
+How does it work? -- GitHub offers an HTTP JSON API; using the GitHub.js machinery lets you
 build your own single-page web app in JavaScript only - no server required
 other than GitHub itself ;-).
 
-**`jekyll-planet`**
+**Jekyll Planet Gem**
 
-Subscribe to web feeds and (auto-)save the latest posts
+The Jekyll Planet gem (e.g. `jekyll-planet`) lets you
+subscribe to web feeds and (auto-)save the latest posts
 in your Jekyll `_posts` folder.
 
-Why?! Lets others use whatever blog (or content managment system) they like - you don't care -
+Why?! -- Lets others use whatever blog (or content managment system) they like - you don't care -
 to pull in the posts and get the stories added to your site
 all you need is a ye good ol' web feed.
 
 **WordPress Jekyll Export Plugin**
 
-One Click - gets you a zip w/ ready-to-use static Jekyll site
+One Click - gets you a zip w/ ready-to-use static Jekyll site.
 
-Why?! Best of both worlds - use all the WordPress tools
+Why?! -- Best of both worlds - use all the WordPress tools
 plus get a fast and simple static site for live production.
 
 
 Find out more:
 
 - [Prose.io](https://github.com/prose)
 - [GitHub.js](https://github.com/michael/github)
-- [jekyll-planet gem](https://github.com/feedreader/jekyll-planet)
+- [Jekyll Planet Gem](https://github.com/feedreader/jekyll-planet)
 - [WordPress Jekyll Exporter](https://wordpress.org/plugins/jekyll-exporter)
 
 
@@ -627,8 +656,10 @@ $ git remote show origin
 
 Basically a pre-configured Jekyll site w/ a theme, helpers, build scripts and more.
 "packaged" as ready-to-fork-and-use git repo. To get started use:
-
+
+~~~
 $ git clone octopress
+~~~
 
 and than start changing the configuration settings and so on.
 
@@ -638,14 +669,18 @@ What's wrong with that?!
 - Not-so-easy to extend and configure.
 
 
+# Octopress 3.0 Upcoming (Cont.)
+
 ### "Modern" Octopress (Released February 2015)
 
 Modul-mania. Now almost everything is a gem
 (more than 20+ gems e.g. `octopress-videotag`, `octopress-unpublish`, `octopress-deploy`, and so on)
 plus a new command line tool (that is, `octopress`). To get started, use:
 
+~~~
 $ gem install octopress
 $ octopress new
+~~~
 
 Why?!
 
@@ -656,6 +691,7 @@ instead many small gems that work with "plain vanilla" jekyll).
 **There will no longer be a division between Octopress and Jekyll.**
 
 
+
 # Octopress 3.0 in Action
 
 ~~~
@@ -683,7 +719,7 @@ Subcommands:
   deploy      Deploy your Octopress site.
 ~~~
 
-## `new post` Command
+## Command `new post`
 
 ~~~
 $ octopress new post --help
@@ -705,7 +741,7 @@ Options:
   -h,  --help         Show this message
 ~~~
 
-## `deploy` Command
+## Command `deploy`
 
 ~~~
 $ octopress deploy --help