TwP-webby 0.9.0

data/examples/webby/content/css/coderay.css

@@ -0,0 +1,96 @@
+
+div.CodeRay { }
+
+span.CodeRay { white-space: pre; border: 0px; padding: 2px }
+
+table.CodeRay { border-collapse: collapse; width: 100%; padding: 2px }
+table.CodeRay td { padding: 2px 4px; vertical-align: top }
+
+.CodeRay .line_numbers, .CodeRay .no {
+  background-color: #def;
+  color: gray;
+  text-align: right;
+}
+.CodeRay .line_numbers tt { font-weight: bold }
+.CodeRay .no { padding: 0px 4px }
+
+ol.CodeRay { font-size: 10pt }
+ol.CodeRay li { white-space: pre }
+
+.CodeRay .debug { color:white ! important; background:blue ! important; }
+
+.CodeRay .af { color:#00C }
+.CodeRay .an { color:#007 }
+.CodeRay .av { color:#700 }
+.CodeRay .aw { color:#C00 }
+.CodeRay .bi { color:#509; font-weight:bold }
+.CodeRay .c  { color:#666; }
+
+.CodeRay .ch { color:#04D }
+.CodeRay .ch .k { color:#04D }
+.CodeRay .ch .dl { color:#039 }
+
+.CodeRay .cl { color:#B06; font-weight:bold }
+.CodeRay .co { color:#036; font-weight:bold }
+.CodeRay .cr { color:#0A0 }
+.CodeRay .cv { color:#369 }
+.CodeRay .df { color:#099; font-weight:bold }
+.CodeRay .di { color:#088; font-weight:bold }
+.CodeRay .dl { color:black }
+.CodeRay .do { color:#970 }
+.CodeRay .ds { color:#D42; font-weight:bold }
+.CodeRay .e  { color:#666; font-weight:bold }
+.CodeRay .en { color:#800; font-weight:bold }
+.CodeRay .er { color:#F00; background-color:#FAA }
+.CodeRay .ex { color:#F00; font-weight:bold }
+.CodeRay .fl { color:#60E; font-weight:bold }
+.CodeRay .fu { color:#06B; font-weight:bold }
+.CodeRay .gv { color:#d70; font-weight:bold }
+.CodeRay .hx { color:#058; font-weight:bold }
+.CodeRay .i  { color:#00D; font-weight:bold }
+.CodeRay .ic { color:#B44; font-weight:bold }
+
+.CodeRay .il { background: #eee }
+.CodeRay .il .il { background: #ddd }
+.CodeRay .il .il .il { background: #ccc }
+.CodeRay .il .idl { font-weight: bold; color: #888 }
+
+.CodeRay .in { color:#B2B; font-weight:bold }
+.CodeRay .iv { color:#33B }
+.CodeRay .la { color:#970; font-weight:bold }
+.CodeRay .lv { color:#963 }
+.CodeRay .oc { color:#40E; font-weight:bold }
+.CodeRay .of { color:#000; font-weight:bold }
+.CodeRay .op { }
+.CodeRay .pc { color:#038; font-weight:bold }
+.CodeRay .pd { color:#369; font-weight:bold }
+.CodeRay .pp { color:#579 }
+.CodeRay .pt { color:#339; font-weight:bold }
+.CodeRay .r  { color:#080; font-weight:bold }
+
+.CodeRay .rx { background-color:#fff0ff }
+.CodeRay .rx .k { color:#808 }
+.CodeRay .rx .dl { color:#404 }
+.CodeRay .rx .mod { color:#C2C }
+.CodeRay .rx .fu  { color:#404; font-weight: bold }
+
+.CodeRay .s  { background-color:#fff0f0 }
+.CodeRay .s  .s { background-color:#ffe0e0 }
+.CodeRay .s  .s  .s { background-color:#ffd0d0 }
+.CodeRay .s  .k { color:#D20 }
+.CodeRay .s  .dl { color:#710 }
+
+.CodeRay .sh { background-color:#f0fff0 }
+.CodeRay .sh .k { color:#2B2 }
+.CodeRay .sh .dl { color:#161 }
+
+.CodeRay .sy { color:#A60 }
+.CodeRay .sy .k { color:#A60 }
+.CodeRay .sy .dl { color:#630 }
+
+.CodeRay .ta { color:#070 }
+.CodeRay .tf { color:#070; font-weight:bold }
+.CodeRay .ts { color:#D70; font-weight:bold }
+.CodeRay .ty { color:#339; font-weight:bold }
+.CodeRay .v  { color:#036 }
+.CodeRay .xt { color:#444 }

data/examples/webby/content/css/site.css

@@ -0,0 +1,196 @@
+---
+extension: css
+filter:    sass
+layout:    nil   # no layout
+sass_options:
+  :style: :expanded
+---
+!text        = #000
+!border      = #CCC
+!header      = #111
+!link        = #125AA7
+!link_hover  = #000
+!blockquote  = #666
+!code        = #000
+!box_bg      = #EEE
+!highlight   = #B2CCFF
+!quiet       = #666
+!alt         = #666
+
+@import blueprint/screen.css
+
+body
+  :margin       0
+  :color =      !text
+  :font-family  Verdana, sans-serif
+  :background   white url('background.gif') repeat-x left top
+
+// Headings
+// ------------------------------------------------------------------------
+h1,h2,h3,h4,h5,h6
+  :color =      !header
+  :font-weight  bold
+
+h2,h3,h4,h5,h6
+  :border-bottom = 2px solid !highlight
+
+// Text Elements
+// ------------------------------------------------------------------------
+a
+  :color =   !link
+  &:hover
+    :color = !link_hover
+
+blockquote
+  :color =   !blockquote
+
+pre
+  :margin-left   18px
+  :padding       8px 8px 8px 18px
+  :color =       !code
+  :font-family   monospace, courier
+  :overflow      auto
+//  :background =  !box_bg
+//  :border =      1px solid !border
+  :border-left = 3px solid !border
+
+hr
+  :background = !highlight
+  :color =      !highlight
+
+code
+  :background-color = !box_bg
+
+// Tables
+// ------------------------------------------------------------------------
+table
+  :border-top =    1px solid !border
+  :border-left =   1px solid !border
+th,td
+  :border-bottom = 1px solid !border
+  :border-right =  1px solid !border
+
+// Default Classes
+// ------------------------------------------------------------------------
+p.quiet
+  :color = !quiet
+.alt
+  :color = !alt
+
+// My Site Stylings
+// ------------------------------------------------------------------------
+#header
+  :margin              0 0 25px 0
+  :padding-top         20px
+  a
+    :color =           !header
+    :text-decoration   none
+  h1
+    :margin            0
+    :font-size         2.0em
+    :letter-spacing    0.25em
+  p
+    :font-style        italic
+    :font-weight       normal
+    :color =           !quiet
+  ul
+    :float             right
+    :margin            0
+    :padding           0
+    :text-align        right
+    :font-size         1.0em
+    :list-style-type   circle
+    li
+      :display         inline
+      :margin          0 0 0 2.5em
+      a
+        :color =       !quiet
+        :font-weight   bold
+        &:hover
+          :color =     !header
+
+#footer
+  :margin-top        18px
+  :font-size         0.8em
+  hr
+    :margin-bottom   18px
+  p
+    :text-align      center
+
+.CodeRay
+  pre
+    :font             12px monospace, courier
+
+div.toc
+  :float              right
+  :padding            8px
+  :margin-left        16px
+  :margin-bottom      16px
+  :background-color = !highlight
+  :border =           1px solid !border
+  ol
+    :margin-bottom    0.5em
+    ol
+      :margin-bottom  0
+  p.title
+    :margin-bottom    0.25em
+    :font-weight      bold
+    :font-size        1.2em
+    :text-align       center
+
+ul
+  ul
+    :margin-bottom    0
+
+span.heading-num
+  :margin-right  10px
+
+p.fn
+  :color =       !blockquote
+  :margin-left   1.5em
+
+p.span-2
+  :clear         left
+
+pre.option
+  :float         left
+  :margin-left   80px
+  :width         500px
+  :clear         both
+
+div.label
+  :float         left
+  :clear         left
+  :margin-right  10px
+  :width         110px
+  :font-weight   bold
+
+div.desc
+  :float         left
+  :margin
+    :right       0
+    :bottom      1.5em
+  :width         510px
+  ul
+    :margin-bottom 0
+
+p.TODO
+  :color            white
+  :background-color red
+  :font-weight      bold
+  :padding          5px 0.5em
+
+p.pull
+  :float         left
+  :clear         left
+  :margin        0 10px 0 -120px
+  :width         110px
+  :text-align    right
+
+p.pulltext
+  :float         left
+  :clear         right
+  :margin-right  10px
+  :width         670px
+
+// EOF

data/examples/webby/content/css/uv/twilight.css

@@ -0,0 +1,137 @@
+pre.twilight .DiffInserted {
+   background-color: #253B22;
+   color: #F8F8F8;
+}
+pre.twilight .DiffHeader {
+   background-color: #0E2231;
+   color: #F8F8F8;
+   font-style: italic;
+}
+pre.twilight .CssPropertyValue {
+   color: #F9EE98;
+}
+pre.twilight .CCCPreprocessorDirective {
+   color: #AFC4DB;
+}
+pre.twilight .Constant {
+   color: #CF6A4C;
+}
+pre.twilight .DiffChanged {
+   background-color: #4A410D;
+   color: #F8F8F8;
+}
+pre.twilight .EmbeddedSource {
+   background-color: #A3A6AD;
+}
+pre.twilight .Support {
+   color: #9B859D;
+}
+pre.twilight .MarkupList {
+   color: #F9EE98;
+}
+pre.twilight .CssConstructorArgument {
+   color: #8F9D6A;
+}
+pre.twilight .Storage {
+   color: #F9EE98;
+}
+pre.twilight .line-numbers {
+   background-color: inherit;
+   color: #999999;
+}
+pre.twilight .CssClass {
+   color: #9B703F;
+}
+pre.twilight .StringConstant {
+   color: #DDF2A4;
+}
+pre.twilight .CssAtRule {
+   color: #8693A5;
+}
+pre.twilight .MetaTagInline {
+   color: #E0C589;
+}
+pre.twilight .MarkupHeading {
+   color: #CF6A4C;
+}
+pre.twilight .CssTagName {
+   color: #CDA869;
+}
+pre.twilight .SupportConstant {
+   color: #CF6A4C;
+}
+pre.twilight .DiffDeleted {
+   background-color: #420E09;
+   color: #F8F8F8;
+}
+pre.twilight .CCCPreprocessorLine {
+   color: #8996A8;
+}
+pre.twilight .StringRegexpSpecial {
+   color: #CF7D34;
+}
+pre.twilight .EmbeddedSourceBright {
+   background-color: #9C9EA4;
+}
+pre.twilight .InvalidIllegal {
+   background-color: #241A24;
+   color: #F8F8F8;
+}
+pre.twilight .SupportFunction {
+   color: #DAD085;
+}
+pre.twilight .CssAdditionalConstants {
+   color: #CA7840;
+}
+pre.twilight .MetaTagAll {
+   color: #AC885B;
+}
+pre.twilight .StringRegexp {
+   color: #E9C062;
+}
+pre.twilight .StringEmbeddedSource {
+   color: #DAEFA3;
+}
+pre.twilight .EntityInheritedClass {
+   color: #9B5C2E;
+   font-style: italic;
+}
+pre.twilight .CssId {
+   color: #8B98AB;
+}
+pre.twilight .CssPseudoClass {
+   color: #8F9D6A;
+}
+pre.twilight .StringVariable {
+   color: #8A9A95;
+}
+pre.twilight .String {
+   color: #8F9D6A;
+}
+pre.twilight .Keyword {
+   color: #CDA869;
+}
+pre.twilight {
+   background-color: #141414;
+   color: #F8F8F8;
+}
+pre.twilight .CssPropertyName {
+   color: #C5AF75;
+}
+pre.twilight .DoctypeXmlProcessing {
+   color: #494949;
+}
+pre.twilight .InvalidDeprecated {
+   color: #D2A8A1;
+   font-style: italic;
+}
+pre.twilight .Variable {
+   color: #7587A6;
+}
+pre.twilight .Entity {
+   color: #9B703F;
+}
+pre.twilight .Comment {
+   color: #5F5A60;
+   font-style: italic;
+}

data/examples/webby/content/index.txt

@@ -0,0 +1,37 @@
+--- 
+title:      Webby
+created_at: 2007-08-21 11:25:06.000000 -06:00
+filter:     textile
+--- 
+*Webby* is a fantastic little website management system. It would be called a _content management system_ if it were a bigger kid. But, it's just a runt with a special knack for transforming text. And that's really all it does - manages the legwork of turning text into something else, an *ASCII Alchemist* if you will.
+
+Webby works by combining the contents of a *page* with a *layout* to produce HTML. The layout contains everything common to all the pages - HTML headers, navigation menu, footer, etc. - and the page contains just the information for that page. You can use your favorite markup language to write your pages; Webby supports quite a few.
+
+Install Webby and try it out!
+
+pre. sudo gem install webby
+
+h2. Features
+
+* choose your templating language: *ERB*, *Textile*, *Markdown*, *HAML*, *SASS*
+* support for "UltraViolet":http://ultraviolet.rubyforge.org/ and "CodeRay":http://coderay.rubychan.de/ syntax highlighting
+* embeddable DOT scripts for "Graphviz":http://www.graphviz.org/ graphs
+* "LaTeX":http://www.latex-project.org/ snippets for mathematical formulas
+* automatically clean up generated content using "Tidy":http://tidy.sourceforge.net/
+* quick and speedy - only builds pages that have changed
+* deploy anywhere - it's just HTML, no special server stuff required
+* happy "rake":http://docs.rubyrake.org/ tasks for deploying your website to a server
+* build new pages from templates for quicker blog posts and news items
+
+h2. But Wait! There's More!
+
+Webby has a great _autobuild_ feature that continuously generates HTML whenever the *pages* or *layouts* change. The HTML is served up via "heel":http://copiousfreetime.rubyforge.org/heel/, a static file webserver based on mongrel. Whenever you change a page, you can immediately see those changes without having to run any commands.
+
+pre. $ webby autobuild
+[10:21:26]  INFO: starting autobuild (Ctrl-C to stop)
+[10:21:26]  INFO: creating output/index.html
+[10:22:57]  INFO: creating output/index.html
+
+Webby is not limited to producing HTML. By no means! Do you ever get tired of repeating the same color code *#D3C4A2* in your CSS files? Webby can help. Need some customized JavaScript for your website. Webby can help. Anytime you find yourself repeating the same bit of text over and over, then you should be using Webby.
+
+Read the "tutorial":/tutorial section for a quick introduction to Webby, and enjoy the wonders of *ASCII Alchemy*.

data/examples/webby/content/learn/index.txt

@@ -0,0 +1,28 @@
+---
+title:      Learn
+created_at: 2008-08-24 15:36:06.596051 -06:00
+filter:
+  - erb
+  - textile
+---
+h1. <%= h(@page.title) %>
+
+This section is devoted to learning more about Webby. Located below are the various "official" documents to assist you on your way to becoming prolific with Webby.
+
+If you cannot find your answer here, head on over to the <%= link_to_page('Communicate') %> section where the mailing list might help you.
+
+p(pull). *<%= link_to_page('Tutorial') %>*
+
+p(pulltext). The tutorial is a great introduction to Webby if you want to hit the ground running and figure things out as you go. Following along with the tutorial on your own computer will get you comfortable with the basic concepts of Webby.
+
+p(pull). *<%= link_to_page('User Manual') %>*
+
+p(pulltext). The user manual provides a more in-depth look into Webby. It assumes no prior experience with Webby, and it goes into more detail about the various aspects of creating a webby site and working with Webby itself. The user manual is the place to go if you want to go beyond the basics.
+
+p(pull). *<%= link_to_page('Reference') %>*
+
+p(pulltext). The reference does not provide an introduction to Webby. Instead, it is an indexed collection of the various Webby features with a brief explanation of each. It is useful when you vaguely remember reading something about filters and only need a quick refresher of the details without instructional text.
+
+p(pull). *<%= link_to_page('Release Notes', :title => 'Release 0.9.0') %>*
+
+p(pulltext). These are the release notes for past and present versions of Webby. Actually, it's only for the current version of Webby since formal release notes were only recently thought of by the developer. %(quiet)Bad developer! No latte!!%

data/examples/webby/content/reference/index.txt

@@ -0,0 +1,204 @@
+---
+title:      Reference
+created_at: 2008-03-04 22:00:08.439182 -07:00
+filter:
+  - erb
+  - textile
+  - outline
+content_for_head: |
+ <link rel="stylesheet" href="/css/coderay.css" type="text/css" media="screen, projection" />
+ <link rel="stylesheet" href="/css/uv/twilight.css" type="text/css" media="screen, projection" />
+---
+<div class="toc push-1">
+
+p(title). Table of Contents
+
+<toc toc_range="h2-h6" />
+</div>
+
+h1. <%= h(@page.title) %>
+
+h3. Resources
+
+Resources are the files that are found in the _content_ and _layouts_ folders of a webby site. They come in the following four flavors:
+
+* *Pages*  --  contain meta-data at the top of the file, are found in the content folder, and are processed by the Webby filter engine
+* *Files*  --  are found in the content folder and copied "as is" to the output folder
+* *Partials*  --  contain snippets of text that can be used in multiple locations; partial filenames begin with an underscore are are _not_ copied to the output folder
+* *Layouts*  --  are found in the layout folder and provide the basic framework of the webpage - the header, the footer, the navigation
+
+h3. Attributes
+
+Attributes are defined in the meta-data section of pages and layouts.
+
+<div class="label">destination</div>
+<div class="desc">
+Defines the path in the output directory where the rendered page should be stored.
+</div>
+
+<div class="label">dirty</div>
+<div class="desc">
+The dirty flag is used to determine whether the page should rendered or not. Normally this is automatically determined by the filter engine, but it can be overridden by setting this attribute. If the dirty flag is set to _true_ then the page will always be rendered. If the dirty flag is set to _false_ then the page will never be rendered.
+</div> 
+
+<div class="label">extension</div>
+<div class="desc">
+Defines the extension that will be appended to the filename of the rendered page in the output folder. The extension is determined by looking at the following:
+
+* the meta-data of the current page for an @extension@ attribute
+* the meta-data of layout file of the current page for an @extension@ attribute
+* the extension of this page file in the _content_ folder
+
+</div>
+
+<div class="label">filter</div>
+<div class="desc">
+Defines the list of filters that will be applied to the contents of this page. If left blank, then the default filter will be applied to the page contents.
+</div>
+
+<div class="label">layout</div>
+<div class="desc">
+Defines the layout that the page contents will be rendered into. The default layout will be used if this attribute is not defined. The value of @nil@ should be specified if the page should not be rendered into any layout.
+</div>
+
+The following attributes are defined for each page in the content folder. These attributes cannot be changed in the page's meta-data section. However, they are available to the ERB filter when rendering the contents of a page.
+
+<div class="label">path</div>
+<div class="desc">
+The full path to the file in the _content_ folder
+</div>
+
+<div class="label">dir</div>
+<div class="desc">
+The relative directory in the output folder where the page will be rendered
+</div>
+
+<div class="label">filename </div>
+<div class="desc">
+The name of the file in the _content_ folder excluding any path information and extension
+</div>
+
+<div class="label">ext</div>
+<div class="desc">
+The extension of the file in the _content_ folder
+</div>
+
+<div class="label">mtime</div>
+<div class="desc">
+The modification time of the file in the _content_ folder
+</div>
+
+<div class="label">number</div>
+<div class="desc">
+Reserved variable used for multi-page content
+</div>
+
+<div class="label">url</div>
+<div class="desc">
+A URL suitable for creating a link to the page
+</div>
+
+<div class="label">render</div>
+<div class="desc">
+Returns the contents of the page as rendered by the Webby filter engine
+</div>
+
+h3. Filters
+
+h3. ERB Variables & Methods
+
+h4. coderay
+
+The coderay method is used to generate syntax highlighting on a block of code. You will need to have the coderay gem installed on your system, and you will need to include the coderay CSS stylesheet in your pages for the syntax highlighting markup to take effect.
+
+The full list of "coderay options":/rdoc/classes/Webby/Helpers/CodeRayHelper.html can be found in the source documentation.
+
+<pre>
+<%% coderay :lang => 'ruby', :line_numbers => 'inline' do -%>
+class Object
+  def returning( r )
+    yield r if block_given?
+    r
+  end
+end
+<%% end -%>
+</pre>
+
+<% coderay :lang => "ruby", :line_numbers => "inline" do -%>
+class Object
+  def returning( r )
+    yield r if block_given?
+    r
+  end
+end
+<% end -%>
+
+
+h4. graphviz
+
+The graphviz method is used to convert a DOT script into an image and insert the image into the page. If the DOT script contains URL references, then an image map will also be generated. The resulting image will then have "clickable" regions that link to the URLs specified.
+
+"Graphviz":http://www.graphviz.org/ needs to be installed on your system in order to use the graphviz method. The full list of "graphviz options":/rdoc/classes/Webby/Helpers/GraphvizHelper.html can be found in the source documentation.
+
+<pre>
+<%% graphviz :path => 'images', :alt => 'hello world graph' do -%>
+digraph hello_world {
+  rankdir = LR;
+  Hello -> World;
+}
+<%% end -%>
+</pre>
+
+<% graphviz :path => "images", :alt => "hello world graph" do -%>
+digraph hello_world {
+  rankdir = LR;
+  Hello -> World;
+}
+<% end -%>
+
+
+h4. tex2img
+
+The tex2img method is used to convert a LaTeX script into an image and insert the image into the page. "LaTeX":http://www.latex-project.org/ and "ImageMagick":http://www.imagemagick.org/script/index.php need to be instaled on your system in order to use the tex2img maethod.
+
+The full list of "tex2img options":/rdoc/classes/Webby/Helpers/TexImgHelper.html can be found in the source documentation.
+
+<pre>
+<%% tex2img 'wave_eq', :path => 'images', :alt => 'wave equation' do -%>
+$\psi_{tot}(x,-t_0,r) = \frac{1}{(2\pi)^2} \int\!\!\!\int
+\tilde\Psi_{tot}\left(k_x,\frac{c}{2}\sqrt{k_x^2 + k_r^2},r=0\right)$
+<%% end -%>
+</pre>
+
+<% tex2img 'wave_eq', :path => 'images', :alt => 'wave equation' do -%>
+$\psi_{tot}(x,-t_0,r) = \frac{1}{(2\pi)^2} \int\!\!\!\int
+\tilde\Psi_{tot}\left(k_x,\frac{c}{2}\sqrt{k_x^2 + k_r^2},r=0\right)$
+<% end -%>
+
+
+h4. uv
+
+The uv method is used to generate syntax highlighting on a block of code. You will need to have the "Ultraviolet":http://ultraviolet.rubyforge.org/ gem installed on your system, and you will need to include the desired CSS stylesheet in your pages for the syntax highlighting markup to take effect.
+
+The full list of "ultraviolet options":/rdoc/classes/Webby/Helpers/UltraVioletHelper.html can be found in the source documentation.
+
+<pre>
+<%% uv :lang => "ruby", :line_numbers => true do -%>
+# Initializer for the class.
+def initialize( string )
+  @str = string
+end
+<%% end -%>
+</pre>
+
+<% uv :lang => "ruby", :line_numbers => true, :theme => 'twilight' do -%>
+# Initializer for the class.
+def initialize( string )
+  @str = string
+end
+<% end -%>
+
+
+h3. Rake Tasks
+
+h3. Site Defaults