all repos — h3rald @ a33f919e37e233053616219747af68daf9f7238f

The sources of https://h3rald.com 

Updated glyph project page, regenerated archives and tags.
h3rald h3rald@h3rald.com
Sun, 13 Jun 2010 18:42:53 +0200
commit

a33f919e37e233053616219747af68daf9f7238f

parent

18305d76502f0ab8bf17d59256d166a00000cb0f

49 files changed, 147 insertions(+), 84 deletions(-)

jump to
M content/archives/april-2006.textile → content/archives/april-2006.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: april-2006
 :title: "Archive: April 2006"
 -----
M content/archives/april-2008.textile → content/archives/april-2008.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: april-2008
 :title: "Archive: April 2008"
 -----
M content/archives/april-2009.textile → content/archives/april-2009.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: april-2009
 :title: "Archive: April 2009"
 -----
M content/archives/april-2010.textile → content/archives/april-2010.textile 
@@ -1,12 +1,12 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: april-2010
 :title: "Archive: April 2010"
 -----
 
-<p>1 item was written in <em>April 2010</em>:</p>
+<p>2 items were written in <em>April 2010</em>:</p>
 <ul>
 	<% articles_by_month.select{|i| i[0] == "April 2010"}[0][1].each do |a|%>
 		<%= render 'dated_article', :article => a %>
M content/archives/august-2006.textile → content/archives/august-2006.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: august-2006
 :title: "Archive: August 2006"
 -----
M content/archives/august-2007.textile → content/archives/august-2007.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: august-2007
 :title: "Archive: August 2007"
 -----
M content/archives/august-2008.textile → content/archives/august-2008.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: august-2008
 :title: "Archive: August 2008"
 -----
M content/archives/december-2005.textile → content/archives/december-2005.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: december-2005
 :title: "Archive: December 2005"
 -----
M content/archives/december-2007.textile → content/archives/december-2007.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: december-2007
 :title: "Archive: December 2007"
 -----
M content/archives/december-2008.textile → content/archives/december-2008.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: december-2008
 :title: "Archive: December 2008"
 -----
M content/archives/february-2006.textile → content/archives/february-2006.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: february-2006
 :title: "Archive: February 2006"
 -----
M content/archives/february-2009.textile → content/archives/february-2009.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: february-2009
 :title: "Archive: February 2009"
 -----
M content/archives/january-2006.textile → content/archives/january-2006.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: january-2006
 :title: "Archive: January 2006"
 -----
M content/archives/january-2007.textile → content/archives/january-2007.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: january-2007
 :title: "Archive: January 2007"
 -----
M content/archives/january-2008.textile → content/archives/january-2008.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: january-2008
 :title: "Archive: January 2008"
 -----
M content/archives/january-2009.textile → content/archives/january-2009.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: january-2009
 :title: "Archive: January 2009"
 -----
M content/archives/january-2010.textile → content/archives/january-2010.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: january-2010
 :title: "Archive: January 2010"
 -----
M content/archives/july-2006.textile → content/archives/july-2006.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: july-2006
 :title: "Archive: July 2006"
 -----
M content/archives/july-2007.textile → content/archives/july-2007.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: july-2007
 :title: "Archive: July 2007"
 -----
M content/archives/july-2008.textile → content/archives/july-2008.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: july-2008
 :title: "Archive: July 2008"
 -----
M content/archives/july-2009.textile → content/archives/july-2009.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: july-2009
 :title: "Archive: July 2009"
 -----
M content/archives/june-2005.textile → content/archives/june-2005.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: june-2005
 :title: "Archive: June 2005"
 -----
M content/archives/june-2006.textile → content/archives/june-2006.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: june-2006
 :title: "Archive: June 2006"
 -----
M content/archives/june-2007.textile → content/archives/june-2007.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: june-2007
 :title: "Archive: June 2007"
 -----
M content/archives/june-2008.textile → content/archives/june-2008.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: june-2008
 :title: "Archive: June 2008"
 -----
M content/archives/june-2009.textile → content/archives/june-2009.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: june-2009
 :title: "Archive: June 2009"
 -----
A content/archives/june-2010.textile 
@@ -0,0 +1,15 @@ 
+----- 
+:type: page
+:filters_pre: 
+- erb
+:permalink: june-2010
+:title: "Archive: June 2010"
+-----
+
+<p>1 item was written in <em>June 2010</em>:</p>
+<ul>
+	<% articles_by_month.select{|i| i[0] == "June 2010"}[0][1].each do |a|%>
+		<%= render 'dated_article', :article => a %>
+	<% end %>
+</ul>
+
M content/archives/march-2006.textile → content/archives/march-2006.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: march-2006
 :title: "Archive: March 2006"
 -----
M content/archives/march-2007.textile → content/archives/march-2007.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: march-2007
 :title: "Archive: March 2007"
 -----
M content/archives/march-2008.textile → content/archives/march-2008.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: march-2008
 :title: "Archive: March 2008"
 -----
M content/archives/march-2009.textile → content/archives/march-2009.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: march-2009
 :title: "Archive: March 2009"
 -----
M content/archives/may-2006.textile → content/archives/may-2006.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: may-2006
 :title: "Archive: May 2006"
 -----
M content/archives/may-2008.textile → content/archives/may-2008.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: may-2008
 :title: "Archive: May 2008"
 -----
M content/archives/may-2009.textile → content/archives/may-2009.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: may-2009
 :title: "Archive: May 2009"
 -----
A content/archives/may-2010.textile 
@@ -0,0 +1,15 @@ 
+----- 
+:type: page
+:filters_pre: 
+- erb
+:permalink: may-2010
+:title: "Archive: May 2010"
+-----
+
+<p>1 item was written in <em>May 2010</em>:</p>
+<ul>
+	<% articles_by_month.select{|i| i[0] == "May 2010"}[0][1].each do |a|%>
+		<%= render 'dated_article', :article => a %>
+	<% end %>
+</ul>
+
M content/archives/november-2005.textile → content/archives/november-2005.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: november-2005
 :title: "Archive: November 2005"
 -----
M content/archives/november-2006.textile → content/archives/november-2006.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: november-2006
 :title: "Archive: November 2006"
 -----
M content/archives/november-2007.textile → content/archives/november-2007.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: november-2007
 :title: "Archive: November 2007"
 -----
M content/archives/november-2008.textile → content/archives/november-2008.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: november-2008
 :title: "Archive: November 2008"
 -----
M content/archives/november-2009.textile → content/archives/november-2009.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: november-2009
 :title: "Archive: November 2009"
 -----
M content/archives/october-2007.textile → content/archives/october-2007.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: october-2007
 :title: "Archive: October 2007"
 -----
M content/archives/october-2008.textile → content/archives/october-2008.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: october-2008
 :title: "Archive: October 2008"
 -----
M content/archives/october-2009.textile → content/archives/october-2009.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: october-2009
 :title: "Archive: October 2009"
 -----
M content/archives/september-2006.textile → content/archives/september-2006.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: september-2006
 :title: "Archive: September 2006"
 -----
M content/archives/september-2007.textile → content/archives/september-2007.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: september-2007
 :title: "Archive: September 2007"
 -----
M content/archives/september-2008.textile → content/archives/september-2008.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: september-2008
 :title: "Archive: September 2008"
 -----
M content/archives/september-2009.textile → content/archives/september-2009.textile 
@@ -1,7 +1,7 @@ 
 ----- 
+:type: page
 :filters_pre: 
 - erb
-:type: page
 :permalink: september-2009
 :title: "Archive: September 2009"
 -----
M content/articles/succeeding-with-agile-review.glyph → content/articles/succeeding-with-agile-review.glyph 
@@ -1,7 +1,6 @@ 
 ----- 
 :type: article
 :tags: 
-- book
 - review
 - productivity
 - software
M content/glyph.textile → content/glyph.textile 
@@ -9,26 +9,26 @@ github: glyph
 links:
 - "Repository": http://www.github.com/h3rald/glyph/
 - "Bug Tracking": http://www.github.com/h3rald/glyph/issues
+- "Development Wiki": http://wiki.github.com/h3rald/glyph
+- "Download": http://www.rubygems.org/gems/glyph
 - "Book (PDF)": http://github.com/h3rald/glyph/blob/master/book/output/pdf/glyph.pdf
-- "Reference Documentation": http://yardoc.org/docs/h3rald-glyph/
+- "Docs": http://yardoc.org/docs/h3rald-glyph/
 - "User Group": http://groups.google.com/group/glyph-framework
 status: Active
-version: 0.2.0
+version: 0.3.0
 -----
 
 <%= render 'project_data', :tag => 'glyph' %>
 
 Glyph is a _Rapid Document Authoring Framework_. 
 
-Think of it like a sort of "Ruby On Rails":http://www.rubyonrails.org but for creating text documents instead of web sites. With Glyph, you can manage your documents tidily in _projects_ that can be used to generate deliverables in different formats such as HTML or PDF (through "Prince":http://www.princexml.com).
+With Glyph, you can manage your documents tidily in _projects_ and generate deliverables in different formats such as HTML or PDF (through <a href="http://www.princexml.com/">Prince</a>).
 
 <br style="clear:both" />
 
-h3. Main Features
-
-!>/img/pictures/glyph.png!
-
-Glyph uses a simple macro system to perform a wide variety of advanced tasks:
+<div class="section">
+<h3 id="h_1">Main Features</h3>
+Glyph comes with its very own macro system to perform a wide variety of advanced tasks:
 * Generate block-level HTML tags not commonly managed by lightweight markups, like @head@, @body@, @div@ and @table@.
 * Create and validate internal and external links.
 * Include and validate images and figures.

@@ -40,64 +40,98 @@ * Evaluate Ruby code within your document.
 * Include content only if certain conditions are satisfied.
 * Define macros, snippets and configuration settings directly within your document.
 * Highlight source code.
-* Call macros from other macros (including snippets), carefully avoiding mutual calls.
-* Include text files in other text files.
-* Include the contents of configuration settings (author, title) in the document.
-* Filter input explicitly or implicitly, based on file extensions when including files. 
-* Manage comments and todo items.
+* Call macros from other macros (including snippets), avoiding mutual calls.
+* Include text files within other text files.
+* Include the value of any configuration setting (like author, title) in the document.
+* Filter input explicitly or implicitly (based on file extensions). 
+* Manage draft comments and todo items.
+* Provide a simple, less-verbose syntax to write XML code.
 
-h3. Installation
+</div>
 
+<div class="section">
+<h3 id="h_2">Installation</h3>
 @gem install glyph@ -- simple, as always.
 
-h3. Essential Glyph Commands
+</div>
 
-Glyph is 100% command line. Its interface "Git's":http://git-scm.com/ for its simplicity and power (thanks to the "Gli":http://github.com/davetron5000/gli gem). Here are some example commands: 
+<div class="section">
+<h3 id="h_3">Essential Glyph commands</h3>
+Glyph is 100% command line. Its interface resambles <a href="http://git-scm.com/">Git's</a> for its simplicity and power (thanks to the <a href="http://github.com/davetron5000/gli">gli</a> gem). Here are some example commands: 
 
 * @glyph init@ -- to initialize a new Glyph project in the current (empty) directory.
 * @glyph add introduction.textile@ -- to create a new file called _introduction.textile_.
 * @glyph compile@ -- to compile the current document into a single HTML file.
-* @glyph compile --auto@ — to keep recompiling the current document every time a file is changed.
-* @glyph compile -f pdf@ -- to compile the current document into HTML and then transform it into PDF using "Prince":http://www.princexml.com.
-* @glyph compile readme.glyph@ — to compile _readme.glyph_ located in the current directory into a single HTML file
+* @glyph compile --auto@ -- to keep recompiling the current document every time a file is changed.
+* @glyph compile -f pdf@ -- to compile the current document into HTML and then transform it into PDF using <a href="http://www.princexml.com/">Prince</a>.
+* @glyph compile readme.glyph@ -- to compile a _readme.glyph_ located in the current directory into a single HTML file.
+* @glyph outline -l 2@ -- Display the document outline, up to second-level headers.
 
-h3. Glyph macros in a nutshell
+</div>
 
+<div class="section">
+<h3 id="macros_nutshell">Glyph macros in a nutshell</h3>
 Format your documents using Textile or Markdown, and use Glyph Macros to do everything else:
 
 **Glyph Source:**
 
-<pre><code>
-section[header[Something about Glyph]
-You can use Glyph macros in conjunction
- with _Textile_ or _Markdown_ to
+<div class="code">
+<pre>
+<code>
+section[
+  @title[Something about Glyph]
+  txt[
+You can use Glyph macros in conjunction 
+with _Textile_ or _Markdown_ to
 produce HTML files effortlessly.
-  section[header[What about PDFs?|pdf]
+  ]
+  p[
+Alternatively, you can just use em[Glyph itself]
+to generate HTML tags.
+  ]
+  section[
+    @title[What about PDFs?]
+    @id[pdf]
 Once you have a single, well-formatted HTML 
 file, converting it to PDF is
 extremely easy with a 3rd-party 
 renderer like =>[http://www.princexml.com|Prince].
   ]   
 ]
-</code></pre>
+</code>
+</pre>
+</div>
 
 **HTML Output:**
 
-<pre><code>
+<div class="code">
+<pre>
+<code>
 <div class="section">
-  <h2 id="h_1">Something about Glyph</h2>
-  <p>You can use Glyph macros in conjunction with 
-     <em>Textile</em> or <em>Markdown</em> to
-     produce HTML files effortlessly.</p>
+  <h2 id="h_10">Something about Glyph</h2>
+  <p>
+    You can use Glyph macros in conjunction with 
+    <em>Textile</em> or <em>Markdown</em> to
+    produce HTML files effortlessly.
+  </p>
   <div class="section">
    <h3 id="pdf">What about PDFs?</h3>
-   <p>Once you have a single, well-formatted HTML 
-      file, converting it to PDF is
-      extremely easy with a 3rd-party renderer 
-      like <a href="http://www.princexml.com">Prince</a>.</p>
+   <p>
+     Once you have a single, well-formatted HTML 
+     file, converting it to PDF is
+     extremely easy with a 3rd-party renderer 
+     like <a href="http://www.princexml.com">Prince</a>.
+   </p>
+   <p>
+     Alternatively, you can just use <em>Glyph itself</em>
+     to generate HTML tags.
+   </p>
   </div>
 </div>
-</code></pre>
+</code>
+</pre>
+</div>
+
+</div>
 
 <%= render 'project_updates', :tag => 'glyph' %>
-