Regenerated archives, tags, and Glyph book.
jump to
@@ -6,7 +6,7 @@ - erb
:title: "Archive: August 2011" ----- -<p>1 article was written in <em>August 2011</em>:</p> +<p>2 articles were written in <em>August 2011</em>:</p> <ul> <% articles_by_month.select{|i| i[0] == "August 2011"}[0][1].each do |a|%> <%= render 'dated_article', :article => a %>
@@ -13,7 +13,7 @@ - "Download": http://www.rubygems.org/gems/glyph
- "Documentation": /glyph/book/ - "User Group": http://groups.google.com/group/glyph-framework status: Active -version: 0.4.2 +version: 0.5.0 ----- <%= render 'project_data', :tag => 'glyph' %>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Acknowledgements – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Acknowledgements - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> + <meta content="44.388041;9.073248" name="ICBM" /> - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Acknowledgements</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Acknowledgements</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/license.html">License ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/getting_started/create_project.html">→ Creating your first Glyph Project</a></nav> + <nav class="navigation"><a href="/glyph/book/license.html">License</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/getting_started/create_project.html">Creating your first Glyph Project</a></nav> <p>Glyph was designed and developed by <a href="http://www.h3rald.com">Fabio Cevasco</a> (h3rald).</p> <p>Special thanks to the following individuals who contributed to Glyph by reporting and fixing issues, proposing and implementing new features or provided Glyph-related resources and plugins:</p> <ul>@@ -69,15 +73,28 @@ <li><a href="http://koraktor.github.com">Sebastian Staudt</a> (koraktor)</li>
<li><a href="http://balcone.eveel.ru">Dmitry A. Ustalov</a> (eveel)</li> <li><a href="http://www.stuartellis.eu">Stuart Ellis</a> (stuartellis)</li> <li>Eric Givens (darthzippy)</li> + <li><a href="http://www.taylored-software.com/">Tammy Cravit</a> (tammycravit)</li> </ul> - <nav><a href="/glyph/book/license.html">License ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/getting_started/create_project.html">→ Creating your first Glyph Project</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/license.html">License</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/getting_started/create_project.html">Creating your first Glyph Project</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -85,50 +102,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,371 +1,893 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Changelog – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Changelog - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Changelog</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> + <nav class="navigation"><a href="/glyph/book/config/output.html">output.*</a> | <a href="/glyph/book/index.html">Contents</a> | </nav> + - <section id="container"> - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Changelog</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <section class="section"> +<header><h1 id="h_286">v0.5.0 – August 28th 2011</h1></header> +<section class="section"> +<header><h1 id="h_287">16 Features Implemented</h1></header> +<table> + <tr> + <th>ID</th> + <th>Description</th> + </tr> + + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/152">#152</a></td> + <td> +<p>It is now possible to generate a <span class="caps">PDF</span> document through HTML5, not only <span class="caps">HTML</span>, by setting the <code>output.pdf.through</code> setting to <code>html5</code>.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/165">#165</a></td> + <td> +<p>The <a href="/glyph/book/macros/macros_core.html#m_fragment"><code>fragment</code></a> macro and the <a href="/glyph/book/macros/macros_core.html#m_embed"><code>embed</code></a> macro can be used to delimit and embed text fragments, in a way much similar to snippets.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/177">#177</a></td> + <td> +<p>Introduced the concept of “macro representations”, to make macro code output-independent.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/179">#179</a></td> + <td> +<p>Macro can be composed with other macros via backslashes, provided that containers only take exactly one parameter. The new <a href="/glyph/book/macros/macros_core.html#m_xml"><code>xml</code></a> macro dispatcher must be used composed with other macros to create raw <span class="caps">XML</span> tags, prepending = to macro names no longer works.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/180">#180</a></td> + <td> +<p>Glyph can now generate ebooks in <span class="caps">MOBI</span> and <span class="caps">EPUB</span> format – with Calibre’s help.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/181">#181</a></td> + <td> +<p>By using the new <a href="/glyph/book/macros/macros_core.html#m_let"><code>let</code></a> macro macro, it is possible to define lexically scoped “variables” via the <a href="/glyph/book/macros/macros_core.html#m_attribute_"><code>attribute:</code></a> macro, and retrieve them within the scope of the let macro using the <a href="/glyph/book/macros/macros_core.html#m_attribute"><code>attribute</code></a> macro.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/182">#182</a></td> + <td> +<p>A <a href="/glyph/book/macros/macros_core.html#m_while"><code>while</code></a> macro can be used to execute glyph code multiple times.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/183">#183</a></td> + <td> +<p>The <a href="/glyph/book/macros/macros_core.html#m_s"><code>s</code></a> macro dispatcher can be used to call almost any instance method of the Ruby String class. The <code>match</code> macro cannot be used anymore; use <code>s/match</code> instead.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/184">#184</a></td> + <td> +<p>The old <code>rewrite:</code> macro has been renamed to <code>define:</code>. The new <a href="/glyph/book/macros/macros_core.html#m_define_"><code>define:</code></a> macro fully supports recursion.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/189">#189</a></td> + <td> +<p>The <a href="/glyph/book/macros/macros_core.html#m_add"><code>add</code></a> macro, the <a href="/glyph/book/macros/macros_core.html#m_subtract"><code>subtract</code></a> macro and the <a href="/glyph/book/macros/macros_core.html#m_multiply"><code>multiply</code></a> macro macro can be used to perform operations on integers.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/190">#190</a></td> + <td> +<p>The lt, gt, lte, gte macros can be used to compare integer values.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/194">#194</a></td> + <td> +<p>The <a href="/glyph/book/macros/macros_core.html#m_load"><code>load</code></a> macro macro can be used to embed the contents of a file without performing any evaluation.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/195">#195</a></td> + <td> +<p><code>\/</code> must not be used as invisible space separator, instead of <code>\.</code>.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/197">#197</a></td> + <td> +<p>Snippets are no longer managed via a separate snippet.yml file and <em>must</em> be defined within Glyph source files, using the <a href="/glyph/book/macros/macros_core.html#m_snippet_"><code>snippet:</code></a> macro.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/200">#200</a></td> + <td> +<p>Typing <code>glyph -v</code> now prints the current version of Glyph on the screen.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/201">#201</a></td> + <td> +<p>Glyph no longer depends on Jeweler to create and manage its gem.</p> +</td> + </tr> + + </table> - <nav><a href="/glyph/book/config/output.html">output.* ←</a><a href="/glyph/book/index.html">Contents</a></nav> - +</section> + + + <section class="section"> +<header><h1 id="h_288">4 Bugs Fixed</h1></header> +<table> + <tr> + <th>ID</th> + <th>Description</th> + </tr> + + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/151">#151</a></td> + <td> +<p>Fixed a bug related to Jeweler’s gemspec validation. And for all it matters, Jeweler is no longer a development dependency for Glyph.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/166">#166</a></td> + <td> +<p>Temporary output files are now placed in a temporary folder.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/196">#196</a></td> + <td> +<p>Glyph now handles non-<span class="caps">ASCII</span> characters properly with Ruby 1.9 as well.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/199">#199</a></td> + <td> +<p>Fixed a bug that caused incorrect <span class="caps">TOC</span> nesting when using the <code>src</code> attribute of the <a href="/glyph/book/macros/macros_structure.html#m_section"><code>section</code></a> macro.</p> +</td> + </tr> + + </table> +</section> + + <p> +<em>→ View closed issues on <a href="https://github.com/h3rald/glyph/issues?direction=asc&labels=0.5.0&sort=created&state=closed">GitHub</a>.</em> +</p> +</section> - <section class="section"> -<header><h1 id="h_241">v0.4.2 – October 22th 2010</h1></header> + <section class="section"> +<header><h1 id="h_289">v0.4.2 – October 22th 2010</h1></header> <section class="section"> -<header><h1 id="h_242">3 Features Implemented</h1></header> -<table><tr><th>ID</th> - <th>Description</th></tr> - - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/172">#172</a></td> - <td><p>A new <a href="/glyph/book/macros/macros_core.html#m_output_"><code>output?</code></a> macro macro can be used to test whether Glyph is compiling to a particular output format.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/175">#175</a></td> - <td><p>The conditional macro now support a third parameter (else branch).</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/176">#176</a></td> - <td><p>A bunch of new aliases and shortcuts are available for the section macro.</p></td></tr></table> +<header><h1 id="h_290">3 Features Implemented</h1></header> +<table> + <tr> + <th>ID</th> + <th>Description</th> + </tr> + + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/172">#172</a></td> + <td> +<p>A new <a href="/glyph/book/macros/macros_core.html#m_output_"><code>output?</code></a> macro can be used to test whether Glyph is compiling to a particular output format.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/175">#175</a></td> + <td> +<p>The conditional macro now support a third parameter (else branch).</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/176">#176</a></td> + <td> +<p>A bunch of new aliases and shortcuts are available for the section macro.</p> +</td> + </tr> + + </table> </section> - - - <section class="section"> -<header><h1 id="h_243">1 Bug Fixed</h1></header> -<table><tr><th>ID</th> - <th>Description</th></tr> - - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/178">#178</a></td> - <td><p>No error is raised anymore if less than the required parameters/attributes are supplied to a rewritten macro.</p></td></tr></table> + + + <section class="section"> +<header><h1 id="h_291">1 Bug Fixed</h1></header> +<table> + <tr> + <th>ID</th> + <th>Description</th> + </tr> + + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/178">#178</a></td> + <td> +<p>No error is raised anymore if less than the required parameters/attributes are supplied to a rewritten macro.</p> +</td> + </tr> + + </table> </section> + + + <p> +<em>→ View closed issues on <a href="https://github.com/h3rald/glyph/issues?direction=asc&labels=0.4.2&sort=created&state=closed">GitHub</a>.</em> +</p> </section> - <section class="section"> -<header><h1 id="h_244">v0.4.1 – September 23th 2010</h1></header> + <section class="section"> +<header><h1 id="h_292">v0.4.1 – September 23th 2010</h1></header> <section class="section"> -<header><h1 id="h_245">5 Bugs Fixed</h1></header> -<table><tr><th>ID</th> - <th>Description</th></tr> - - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/169">#169</a></td> - <td><p>*.scss files are now supported by the <a href="/glyph/book/macros/macros_structure.html#m_style"><code>style</code></a> macro.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/170">#170</a></td> - <td><p>Improved default CodeRay stylesheet.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/171">#171</a></td> - <td><p><span class="caps">SCSS</span> now used internally by Glyph to generate default <span class="caps">CSS</span> files.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/173">#173</a></td> - <td><p>Consecutive escape sequences are now interpreted correctly in topics.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/174">#174</a></td> - <td><p>Fixed error causing broken images in web5/html5 output.</p></td></tr></table> +<header><h1 id="h_293">5 Bugs Fixed</h1></header> +<table> + <tr> + <th>ID</th> + <th>Description</th> + </tr> + + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/169">#169</a></td> + <td> +<p>*.scss files are now supported by the <a href="/glyph/book/macros/macros_structure.html#m_style"><code>style</code></a> macro.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/170">#170</a></td> + <td> +<p>Improved default CodeRay stylesheet.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/171">#171</a></td> + <td> +<p><span class="caps">SCSS</span> now used internally by Glyph to generate default <span class="caps">CSS</span> files.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/173">#173</a></td> + <td> +<p>Consecutive escape sequences are now interpreted correctly in topics.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/174">#174</a></td> + <td> +<p>Fixed error causing broken images in web5/html5 output.</p> +</td> + </tr> + + </table> </section> + + + <p> +<em>→ View closed issues on <a href="https://github.com/h3rald/glyph/issues?direction=asc&labels=0.4.1&sort=created&state=closed">GitHub</a>.</em> +</p> </section> - <section class="section"> -<header><h1 id="h_246">v0.4.0 – September 3th 2010</h1></header> + <section class="section"> +<header><h1 id="h_294">v0.4.0 – September 3th 2010</h1></header> <section class="section"> -<header><h1 id="h_247">13 Features Implemented</h1></header> -<table><tr><th>ID</th> - <th>Description</th></tr> - - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/40">#40</a></td> - <td><p>A new <a href="/glyph/book/ref_commands.html#c_stats"><code>stats</code></a> command can be used to display statistics about project files, snippets, macros, bookmarks and links.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/73">#73</a></td> - <td><p>It is now possible to validate online <span class="caps">HTTP</span> links.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/112">#112</a></td> - <td><p>It is now possible to use <em>wkhtmltopdf</em> instead of Prince to generate <span class="caps">PDF</span> files from <span class="caps">HTML</span> files.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/114">#114</a></td> - <td><p>It is now possible to generate documents comprised of multiple files (topics).</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/115">#115</a></td> - <td><p>It is now possible to define layouts (used when generating multi-file outputs) using Glyph macros.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/120">#120</a></td> - <td><p>It is now possible to compile your project to a single HTML5 file (<code>html5</code> output) or multiple files (<code>web5</code> output)</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/135">#135</a></td> - <td><p>Stylesheets can now be linked and imported as well as embedded.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/138">#138</a></td> - <td><p><code>web</code> and <code>web5</code> output formats inherit <code>html</code> macros.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/142">#142</a></td> - <td><p>A new <a href="/glyph/book/macros/macros_block.html#m_navigation"><code>navigation</code></a> macro can be used in <code>web</code> and <code>web5</code> outputs to navigate through topics.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/143">#143</a></td> - <td><p>A topic-based <span class="caps">TOC</span> is generated when compiling to <code>web</code> or <code>web5</code></p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/144">#144</a></td> - <td><p>Two new validators are now available to check whether a macro has (or doesn’t have) a certain ancestor: <code>within</code> and <code>not_within</code>.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/147">#147</a></td> - <td><p>The default stylesheets provided by Glyph are now compatible with HTML5 outputs (html5 and web5).</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/148">#148</a></td> - <td><p>It is now possible to create custom tasks and commands to extend Glyph functionality.</p></td></tr></table> +<header><h1 id="h_295">13 Features Implemented</h1></header> +<table> + <tr> + <th>ID</th> + <th>Description</th> + </tr> + + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/40">#40</a></td> + <td> +<p>A new <a href="/glyph/book/ref_commands.html#c_stats"><code>stats</code></a> command can be used to display statistics about project files, snippets, macros, bookmarks and links.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/73">#73</a></td> + <td> +<p>It is now possible to validate online <span class="caps">HTTP</span> links.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/112">#112</a></td> + <td> +<p>It is now possible to use <em>wkhtmltopdf</em> instead of Prince to generate <span class="caps">PDF</span> files from <span class="caps">HTML</span> files.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/114">#114</a></td> + <td> +<p>It is now possible to generate documents comprised of multiple files (topics).</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/115">#115</a></td> + <td> +<p>It is now possible to define layouts (used when generating multi-file outputs) using Glyph macros.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/120">#120</a></td> + <td> +<p>It is now possible to compile your project to a single HTML5 file (<code>html5</code> output) or multiple files (<code>web5</code> output)</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/135">#135</a></td> + <td> +<p>Stylesheets can now be linked and imported as well as embedded.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/138">#138</a></td> + <td> +<p><code>web</code> and <code>web5</code> output formats inherit <code>html</code> macros.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/142">#142</a></td> + <td> +<p>A new <a href="/glyph/book/macros/macros_block.html#m_navigation"><code>navigation</code></a> macro can be used in <code>web</code> and <code>web5</code> outputs to navigate through topics.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/143">#143</a></td> + <td> +<p>A topic-based <span class="caps">TOC</span> is generated when compiling to <code>web</code> or <code>web5</code></p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/144">#144</a></td> + <td> +<p>Two new validators are now available to check whether a macro has (or doesn’t have) a certain ancestor: <code>within</code> and <code>not_within</code>.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/147">#147</a></td> + <td> +<p>The default stylesheets provided by Glyph are now compatible with HTML5 outputs (html5 and web5).</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/148">#148</a></td> + <td> +<p>It is now possible to create custom tasks and commands to extend Glyph functionality.</p> +</td> + </tr> + + </table> </section> - - - <section class="section"> -<header><h1 id="h_248">7 Bugs Fixed</h1></header> -<table><tr><th>ID</th> - <th>Description</th></tr> - - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/133">#133</a></td> - <td><p>Added <span class="caps">HTML</span> charset to Glyph documents (utf-8).</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/136">#136</a></td> - <td><p>Moved utility functions to separate <code>Glyph::Utils</code> module.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/139">#139</a></td> - <td><p>Heavily restructured Glyph configuration.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/140">#140</a></td> - <td><p>Added <code>Glyph::Macro::Helpers</code> module to avoid code duplication in macros for different output formats.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/141">#141</a></td> - <td><p>Prevented non-rb files to be loaded as macros.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/145">#145</a></td> - <td><p>Dotfiles are now ignored by <a href="/glyph/book/ref_commands.html#c_init"><code>init</code></a> command.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/167">#167</a></td> - <td><p>Fixed <span class="caps">PDF</span> book download links.</p></td></tr></table> + + + <section class="section"> +<header><h1 id="h_296">7 Bugs Fixed</h1></header> +<table> + <tr> + <th>ID</th> + <th>Description</th> + </tr> + + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/133">#133</a></td> + <td> +<p>Added <span class="caps">HTML</span> charset to Glyph documents (utf-8).</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/136">#136</a></td> + <td> +<p>Moved utility functions to separate <code>Glyph::Utils</code> module.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/139">#139</a></td> + <td> +<p>Heavily restructured Glyph configuration.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/140">#140</a></td> + <td> +<p>Added <code>Glyph::Macro::Helpers</code> module to avoid code duplication in macros for different output formats.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/141">#141</a></td> + <td> +<p>Prevented non-rb files to be loaded as macros.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/145">#145</a></td> + <td> +<p>Dotfiles are now ignored by <a href="/glyph/book/ref_commands.html#c_init"><code>init</code></a> command.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/167">#167</a></td> + <td> +<p>Fixed <span class="caps">PDF</span> book download links.</p> +</td> + </tr> + + </table> </section> + + + <p> +<em>→ View closed issues on <a href="https://github.com/h3rald/glyph/issues?direction=asc&labels=0.4.0&sort=created&state=closed">GitHub</a>.</em> +</p> </section> - <section class="section"> -<header><h1 id="h_249">v0.3.0 – June 13th 2010</h1></header> + <section class="section"> +<header><h1 id="h_297">v0.3.0 – June 13th 2010</h1></header> <section class="section"> -<header><h1 id="h_250">13 Features Implemented</h1></header> -<table><tr><th>ID</th> - <th>Description</th></tr> - - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/39">#39</a></td> - <td><p>A new <a href="/glyph/book/ref_commands.html#c_outline"><code>outline</code></a> command is available to display the document outline.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/110">#110</a></td> - <td><p>It is now possible to use Glyph language to produce arbitrary <span class="caps">XML</span> code.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/111">#111</a></td> - <td><p>System settings are now stored within a <code>system.*</code> namespace and cannot be changed via the <a href="/glyph/book/macros/macros_core.html#m_config_"><code>config:</code></a> macro or the <a href="/glyph/book/ref_commands.html#c_config"><code>config</code></a> command.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/116">#116</a></td> - <td><p>It is now possible to use named attributes within Glyph macros.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/119">#119</a></td> - <td><p><a id="new_parser"></a>A new parser was implemented from scratch to improve performance. Treetop gem no longer required.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/121">#121</a></td> - <td><p>Some macros have been removed in favor of <span class="caps">XML</span> fallback, others have been updated.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/123">#123</a></td> - <td><p>The SyntaxNode class has been specialized to differentiate between macros, attributes, parameters, text and escapes.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/124">#124</a></td> - <td><p>Implemented new <a href="/glyph/book/macros/macros_structure.html#m_article"><code>article</code></a> macro and <a href="/glyph/book/macros/macros_structure.html#m_book"><code>book</code></a> macro.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/126">#126</a></td> - <td><p>A new <a href="/glyph/book/macros/macros_core.html#m_rewrite_"><code>rewrite:</code></a> macro has been implemented to create simple macros using just Glyph code.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/127">#127</a></td> - <td><p>A new <a href="/glyph/book/macros/macros_core.html#m_alias"><code>alias</code></a> macro has been implemented to create macro aliases.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/128">#128</a></td> - <td><p>A blacklist for <span class="caps">XML</span> tags has been exposed via the <code>language.options.xml_blacklist</code> setting.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/129">#129</a></td> - <td><p>The <a href="/glyph/book/macros/macros_core.html#m_include"><code>include</code></a> macro can now be used in lite mode, it can evaluate ruby files and requires relative paths.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/130">#130</a></td> - <td><p>A new “safe mode” has been implemented to explicitly forbid certain potentially unsafe macros.</p></td></tr></table> +<header><h1 id="h_298">13 Features Implemented</h1></header> +<table> + <tr> + <th>ID</th> + <th>Description</th> + </tr> + + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/39">#39</a></td> + <td> +<p>A new <a href="/glyph/book/ref_commands.html#c_outline"><code>outline</code></a> command is available to display the document outline.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/110">#110</a></td> + <td> +<p>It is now possible to use Glyph language to produce arbitrary <span class="caps">XML</span> code.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/111">#111</a></td> + <td> +<p>System settings are now stored within a <code>system.*</code> namespace and cannot be changed via the <a href="/glyph/book/macros/macros_core.html#m_config_"><code>config:</code></a> macro or the <a href="/glyph/book/ref_commands.html#c_config"><code>config</code></a> command.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/116">#116</a></td> + <td> +<p>It is now possible to use named attributes within Glyph macros.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/119">#119</a></td> + <td> +<p><a id="new_parser"></a>A new parser was implemented from scratch to improve performance. Treetop gem no longer required.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/121">#121</a></td> + <td> +<p>Some macros have been removed in favor of <span class="caps">XML</span> fallback, others have been updated.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/123">#123</a></td> + <td> +<p>The SyntaxNode class has been specialized to differentiate between macros, attributes, parameters, text and escapes.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/124">#124</a></td> + <td> +<p>Implemented new <a href="/glyph/book/macros/macros_structure.html#m_article"><code>article</code></a> macro and <a href="/glyph/book/macros/macros_structure.html#m_book"><code>book</code></a> macro.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/126">#126</a></td> + <td> +<p>A new <code>rewrite</code> macro has been implemented to create simple macros using just Glyph code.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/127">#127</a></td> + <td> +<p>A new <a href="/glyph/book/macros/macros_core.html#m_alias"><code>alias</code></a> macro has been implemented to create macro aliases.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/128">#128</a></td> + <td> +<p>A blacklist for <span class="caps">XML</span> tags has been exposed via the <code>language.options.xml_blacklist</code> setting.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/129">#129</a></td> + <td> +<p>The <a href="/glyph/book/macros/macros_core.html#m_include"><code>include</code></a> macro can now be used in lite mode, it can evaluate ruby files and requires relative paths.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/130">#130</a></td> + <td> +<p>A new “safe mode” has been implemented to explicitly forbid certain potentially unsafe macros.</p> +</td> + </tr> + + </table> </section> - - - <section class="section"> -<header><h1 id="h_251">3 Bugs Fixed</h1></header> -<table><tr><th>ID</th> - <th>Description</th></tr> - - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/109">#109</a></td> - <td><p>Performance has been dramatically improved by implementing a parser from scratch (see <a href="#new_parser">#119</a>)</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/122">#122</a></td> - <td><p>Macro encoding/decoding no longer necessary due to the new parser (see <a href="#new_parser">#119</a>)</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/125">#125</a></td> - <td><p>Warning messages have been streamlined.</p></td></tr></table> + + + <section class="section"> +<header><h1 id="h_299">3 Bugs Fixed</h1></header> +<table> + <tr> + <th>ID</th> + <th>Description</th> + </tr> + + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/109">#109</a></td> + <td> +<p>Performance has been dramatically improved by implementing a parser from scratch (see <a href="#new_parser">#119</a>)</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/122">#122</a></td> + <td> +<p>Macro encoding/decoding no longer necessary due to the new parser (see <a href="#new_parser">#119</a>)</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/125">#125</a></td> + <td> +<p>Warning messages have been streamlined.</p> +</td> + </tr> + + </table> </section> + + + <p> +<em>→ View closed issues on <a href="https://github.com/h3rald/glyph/issues?direction=asc&labels=0.3.0&sort=created&state=closed">GitHub</a>.</em> +</p> </section> - <section class="section"> -<header><h1 id="h_252">v0.2.0 – May 9th 2010</h1></header> + <section class="section"> +<header><h1 id="h_300">v0.2.0 – May 9th 2010</h1></header> <section class="section"> -<header><h1 id="h_253">11 Features Implemented</h1></header> -<table><tr><th>ID</th> - <th>Description</th></tr> - - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/62">#62</a></td> - <td><p>A new <a href="/glyph/book/macros/macros_filters.html#m_highlight"><code>highlight</code></a> macro is available to highlight source code (CodeRay or UltraViolet required).</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/76">#76</a></td> - <td><p>It is now possible to use Glyph programmatically via the new <code>Glyph#filter</code> and <code>Glyph#compile</code> methods.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/87">#87</a></td> - <td><p>It is now possible to define snippets inside a Glyph source file using the <a href="/glyph/book/macros/macros_core.html#m_snippet_"><code>snippet:</code></a> macro.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/88">#88</a></td> - <td><p>It is now possible to change configuration settings inside a Glyph source file using the <a href="/glyph/book/macros/macros_core.html#m_config_"><code>config:</code></a> macro (Jabbslad).</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/89">#89</a></td> - <td><p>It is now possible to compile a single Glyph source file without creating a Glyph project.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/92">#92</a></td> - <td><p>6 new macros have been defined to allow conditional processing (<a href="/glyph/book/macros/macros_core.html#m_condition"><code>condition</code></a> macro, <a href="/glyph/book/macros/macros_core.html#m_eq"><code>eq</code></a> macro, <a href="/glyph/book/macros/macros_core.html#m_not"><code>not</code></a> macro, <a href="/glyph/book/macros/macros_core.html#m_and"><code>and</code></a> macro, <a href="/glyph/book/macros/macros_core.html#m_or"><code>or</code></a> macro, <a href="/glyph/book/macros/macros_core.html#m_match"><code>match</code></a> macro)</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/94">#94</a></td> - <td><p>It is now possible to add <em>validators</em> to macros, for example to check the number of parameters they take.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/97">#97</a></td> - <td><p>The <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command command can now take an extra <code>--auto</code> switch to trigger document auto-regeneration whenever a source file is changed (koraktor).</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/99">#99</a></td> - <td><p>Added a <code>document.draft</code> setting. If set to <code>true</code>, comments and TODOs are rendered in output files.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/100">#100</a></td> - <td><p><a id="system_css"></a>Glyph <span class="caps">CSS</span> files are no longer copied to new projects, but they can be referenced as if they were (see also <a href="#css_not_copied">#93</a>).</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/108">#108</a></td> - <td><p>It is now possible to define Glyph macros within Glyph source files using the <a href="/glyph/book/macros/macros_core.html#m_macro_"><code>macro:</code></a> macro.</p></td></tr></table> +<header><h1 id="h_301">11 Features Implemented</h1></header> +<table> + <tr> + <th>ID</th> + <th>Description</th> + </tr> + + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/62">#62</a></td> + <td> +<p>A new <a href="/glyph/book/macros/macros_filters.html#m_highlight"><code>highlight</code></a> macro is available to highlight source code (CodeRay or UltraViolet required).</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/76">#76</a></td> + <td> +<p>It is now possible to use Glyph programmatically via the new <code>Glyph#filter</code> and <code>Glyph#compile</code> methods.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/87">#87</a></td> + <td> +<p>It is now possible to define snippets inside a Glyph source file using the <a href="/glyph/book/macros/macros_core.html#m_snippet_"><code>snippet:</code></a> macro.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/88">#88</a></td> + <td> +<p>It is now possible to change configuration settings inside a Glyph source file using the <a href="/glyph/book/macros/macros_core.html#m_config_"><code>config:</code></a> macro (Jabbslad).</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/89">#89</a></td> + <td> +<p>It is now possible to compile a single Glyph source file without creating a Glyph project.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/92">#92</a></td> + <td> +<p>6 new macros have been defined to allow conditional processing (<a href="/glyph/book/macros/macros_core.html#m_condition"><code>condition</code></a> macro, <a href="/glyph/book/macros/macros_core.html#m_eq"><code>eq</code></a> macro, <a href="/glyph/book/macros/macros_core.html#m_not"><code>not</code></a> macro, <a href="/glyph/book/macros/macros_core.html#m_and"><code>and</code></a> macro, <a href="/glyph/book/macros/macros_core.html#m_or"><code>or</code></a> macro, <a href="/glyph/book/macros/macros_core.html#m_match"><code>match</code></a> macro)</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/94">#94</a></td> + <td> +<p>It is now possible to add <em>validators</em> to macros, for example to check the number of parameters they take.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/97">#97</a></td> + <td> +<p>The <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command command can now take an extra <code>--auto</code> switch to trigger document auto-regeneration whenever a source file is changed (koraktor).</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/99">#99</a></td> + <td> +<p>Added a <code>document.draft</code> setting. If set to <code>true</code>, comments and TODOs are rendered in output files.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/100">#100</a></td> + <td> +<p><a id="system_css"></a>Glyph <span class="caps">CSS</span> files are no longer copied to new projects, but they can be referenced as if they were (see also <a href="#css_not_copied">#93</a>).</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/108">#108</a></td> + <td> +<p>It is now possible to define Glyph macros within Glyph source files using the <a href="/glyph/book/macros/macros_core.html#m_macro_"><code>macro:</code></a> macro.</p> +</td> + </tr> + + </table> </section> - - - <section class="section"> -<header><h1 id="h_254">8 Bugs Fixed</h1></header> -<table><tr><th>ID</th> - <th>Description</th></tr> - - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/86">#86</a></td> - <td><p>Warning and error messages have been updated, and it is now possible to show additional debug information. Additionally, syntax errors are now handled before the document is processed.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/93">#93</a></td> - <td><p><a id="css_not_copied"></a>Default css files were not copied when creating a new project. The issue has been resolved by allowing the <a href="/glyph/book/macros/macros_structure.html#m_style"><code>style</code></a> macro to reference Glyph’s system styles (see also <a href="#system_css">#100</a>).</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/95">#95</a></td> - <td><p>The <a href="/glyph/book/ref_commands.html#c_config"><code>config</code></a> command did not save data to <span class="caps">YAML</span> configuration files. This has been fixed ensuring that internal configuration overrides are not saved to the <span class="caps">YAML</span> file too.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/98">#98</a></td> - <td><p>Glyph is now fully compatible with Ruby 1.9.1 and JRuby 1.4.0.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/101">#101</a></td> - <td><p>Additional tests have been developed to improve Textile support. There should no longer be errors when using textile block elements inside Glyph macros.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/103">#103</a></td> - <td><p>Fixed a bug that caused test failures when deleting the test project directory.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/104">#104</a></td> - <td><p>Nested Glyph macros calling <code>Macro#interpret</code> no longer ignore escape delimiters.</p></td></tr> - - <tr><td><a href="http://github.com/h3rald/glyph/issues/closed#issue/107">#107</a></td> - <td><p>Added the possibility to encode (using the <code>encode</code> macro) and decode (using the <code>decode</code> macro) macros so that they can be interpreted later.</p></td></tr></table> + + + <section class="section"> +<header><h1 id="h_302">8 Bugs Fixed</h1></header> +<table> + <tr> + <th>ID</th> + <th>Description</th> + </tr> + + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/86">#86</a></td> + <td> +<p>Warning and error messages have been updated, and it is now possible to show additional debug information. Additionally, syntax errors are now handled before the document is processed.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/93">#93</a></td> + <td> +<p><a id="css_not_copied"></a>Default css files were not copied when creating a new project. The issue has been resolved by allowing the <a href="/glyph/book/macros/macros_structure.html#m_style"><code>style</code></a> macro to reference Glyph’s system styles (see also <a href="#system_css">#100</a>).</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/95">#95</a></td> + <td> +<p>The <a href="/glyph/book/ref_commands.html#c_config"><code>config</code></a> command did not save data to <span class="caps">YAML</span> configuration files. This has been fixed ensuring that internal configuration overrides are not saved to the <span class="caps">YAML</span> file too.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/98">#98</a></td> + <td> +<p>Glyph is now fully compatible with Ruby 1.9.1 and JRuby 1.4.0.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/101">#101</a></td> + <td> +<p>Additional tests have been developed to improve Textile support. There should no longer be errors when using textile block elements inside Glyph macros.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/103">#103</a></td> + <td> +<p>Fixed a bug that caused test failures when deleting the test project directory.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/104">#104</a></td> + <td> +<p>Nested Glyph macros calling <code>Macro#interpret</code> no longer ignore escape delimiters.</p> +</td> + </tr> + + <tr> + <td><a href="https://github.com/h3rald/glyph/issues/107">#107</a></td> + <td> +<p>Added the possibility to encode (using the <code>encode</code> macro) and decode (using the <code>decode</code> macro) macros so that they can be interpreted later.</p> +</td> + </tr> + + </table> </section> + + + <p> +<em>→ View closed issues on <a href="https://github.com/h3rald/glyph/issues?direction=asc&labels=0.2.0&sort=created&state=closed">GitHub</a>.</em> +</p> </section> - <section class="section"> -<header><h1 id="h_255">v0.1.0 – April 8th 2010</h1></header> + <section class="section"> +<header><h1 id="h_303">v0.1.0 – April 8th 2010</h1></header> Initial release. + <p> +<em>→ View closed issues on <a href="https://github.com/h3rald/glyph/issues?direction=asc&labels=0.1.0&sort=created&state=closed">GitHub</a>.</em> +</p> + </section> - <nav><a href="/glyph/book/config/output.html">output.* ←</a><a href="/glyph/book/index.html">Contents</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/config/output.html">output.*</a> | <a href="/glyph/book/index.html">Contents</a> | </nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -373,50 +895,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Compiling a project – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Compiling a project - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Compiling a project</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Compiling a project</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/text_editing/conditionals.html">Conditional Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/compiling/lite_mode.html">→ Compiling single Glyph files</a></nav> + <nav class="navigation"><a href="/glyph/book/text_editing/evaluation.html">Simple Programming and Code Evaluation</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/compiling/lite_mode.html">Compiling single Glyph files</a></nav> <p>By default, a Glyph project can be “compiled” into an <span class="caps">HTML</span> document. Additionally, Glyph can also be used to produce documents in the following formats:</p> <ul> <li>HTML5</li>@@ -69,38 +73,58 @@ <li>Web (i.e. multiple <span class="caps">HTML</span> files)</li>
<li>Web5 (i.e. multiple HTML5 files)</li> </ul> <section class="section"> -<header><h1 id="h_42">HTML/HTML5 output</h1></header> -<p>To compile a Glyph project to an HTML document, use the <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command within your Glyph project folder. Glyph parses the <code>document.glyph</code> file (and all included files and snippets); if no errors are found, Glyph creates an HTML document in the <code>/output/html</code> folder.</p> - <p>The name of the HTML file can be set in the configuration (<a href="/glyph/book/config/document.html#s_document_filename"><code>document.filename</code></a> setting).</p> - <p>To create an HTML5 file instead, you must specify it explicitly like this:</p> - <p> -<code>glyph compile -f html5</code> +<header><h1 id="h_51">HTML/HTML5 output</h1></header> +<p>To compile a Glyph project to an HTML document, use the <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command within your Glyph project folder. Glyph parses the <code>document.glyph</code> file (and all included files and snippets); if no errors are found, Glyph creates an HTML document in the <code>/output/html</code> folder.</p> + <p>The name of the HTML file can be set in the configuration (<a href="/glyph/book/config/document.html#s_document_filename"><code>document.filename</code></a> setting).</p> + <p>To create an HTML5 file instead, you must specify it explicitly like this:</p> + <p> +<code> glyph compile -f html5 </code> </p> </section> <section class="section"> -<header><h1 id="h_43">PDF Output</h1></header> +<header><h1 id="h_52">PDF Output</h1></header> <p>To generate a PDF document, you must specify <code>pdf</code> as format, like this:</p> - <p> -<code>glyph compile -f pdf</code> + <p> +<code> glyph compile -f pdf </code> </p> - <p>The command above will attempt to compile the project into an HTML document and then call a third-party PDF generator to convert it into a PDF file.</p> - <p>Currently, Glyph supports:</p> + <p>The command above will attempt to compile the project into an HTML document and then call a third-party PDF generator to convert it into a PDF file.</p> + <p>Currently, Glyph supports:</p> <ul> <li><a href="http://www.princexml.com/">Prince</a> (version 7.0 or higher) — a commercial generator that can be used freely for personal use. Prince produces high-quality <span class="caps">PDF</span> files and implement most of the new features introduced in CSS3, used heavily in Glyph’s <a href="/glyph/book/text_editing/stylesheets.html#default_stylesheets"><code>pagination.css</code></a> default stylesheet.</li> <li><a href="http://code.google.com/p/wkhtmltopdf/">wkhtmltopdf</a> (version 1.0 beta4 or higher) — an open source generator that uses the WebKit rendering engine to transform <span class="caps">HTML</span> files into <span class="caps">PDF</span>. Although not as advanced as Prince, it produces very satisfactory results.</li> </ul> <p>By default, Glyph attempts to use wkhtmltopdf. To change this, set the <a href="/glyph/book/config/output.html#s_output_pdf_generator"><code>output_pdf_generator</code></a> setting to <code>prince</code>.</p> - <aside class="note"> + <aside class="note"> <span class="note-title">Note</span>Glyph expects PDF generators to be installed on the local machine and callable via command line using the <code>wkhtmltopdf</code> or the <code>prince</code> commands. Just install them as you would with any other program, depending on your operating system (yes, they both offer Windows installers). </aside> - <aside class="tip"> + <aside class="tip"> <span class="note-title">Tip</span>Glyph's default CSS file use the free <em>Gentium</em> font for all text. You can download it from <a href="http://www.sil.org/~gaultney/gentium/">here</a>. </aside> </section> + +<section class="section"> +<header><h1 id="h_53">EPUB/MOBI output</h1></header> +<p>To generate .epub or .mobi e-books, you must specify <code>epub</code> or <code>mobi</code> as format, like this:</p> + <p> +<code> glyph compile -f mobi </code> +</p> + <p> +<code> glyph compile -f epub </code> +</p> + <p>This option requires that you have <a href="http://calibre-ebook.com/">Calibre</a> and its command-line tools installed. Glyph assumes the ebook-convert command is installed in /usr/bin. If this is not so, you can set the <code>options.ebook.converter</code> option to the path to the ebook-convert command.</p> + <p>If you have cover art for your e-book, put it in the <code>images</code> folder, and specify the name of the file in the <code>document.cover</code> configuration option.</p> + <p>You can also specify the output profile used by the <code>ebook-convert</code> command by setting the <code>output.epub.profile</code> and <code>output.mobi.profile</code> options. If these are not specified, the conversion will use the <code>kindle</code> output profile for mobi files, and the <code>nook</code> output profile for epub files. See the documentation for Calibre for a list of available output profiles.</p> + <aside class="tip"> +<span class="note-title">Tip</span>Giving the command <code> glyph compile -f ebooks </code> will generate both mobi and epub files. + +</aside> + +</section> + <section class="section"> <header><h1 id="web_output">Web/Web5 Output</h1></header> <p>To generate a Web or Web5 output, specify <code>web</code> or <code>web5</code> as format. These two output formats behave different way from the others, and require that your project uses <a href="/glyph/book/text_editing/topics.html#topics">topics</a> and <a href="/glyph/book/extending/layouts.html#layouts">layouts</a>.</p>@@ -115,19 +139,31 @@ </section>
<section class="section"> <header><h1 id="auto_regeneration">Auto Regeneration</h1></header> <p>You can also call the <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command with a <code>--auto</code> switch. If you do so, your project will be recompiled automatically every time any source file is changed.</p> - <aside class="note"> + <aside class="note"> <span class="note-title">Note</span>Auto regeneration requires the <a href="http://rubygems.org/gems/directory_watcher">directory_watcher</a> gem to be installed. </aside> </section> - <nav><a href="/glyph/book/text_editing/conditionals.html">Conditional Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/compiling/lite_mode.html">→ Compiling single Glyph files</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/text_editing/evaluation.html">Simple Programming and Code Evaluation</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/compiling/lite_mode.html">Compiling single Glyph files</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -135,50 +171,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,73 +1,77 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Compiling single Glyph files – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Compiling single Glyph files - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Compiling single Glyph files</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Compiling single Glyph files</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/compiling/compiling.html">Compiling a project ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/compiling/programmatic_usage.html">→ Using Glyph programmatically</a></nav> - <p>Glyph's primary goal is to author complex documents like books or manuals. In order to do so, a Glyph project is required to keep everything organized and automated via a set of predefined conventions, exactly like Ruby on Rails or other similar frameworks do.</p> - <p>If you want to write a one-page article or a short draft, however, creating and managing Glyph projects can be an unnecessary burden. Luckily, you don't have to: you can use Glyph to compile single files containing Glyph code, by adding one parameter (or two if you want to specify a custom destination file) to the <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command, like this:</p> - <p> + <nav class="navigation"><a href="/glyph/book/compiling/compiling.html">Compiling a project</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/compiling/programmatic_usage.html">Using Glyph programmatically</a></nav> + <p>Glyph's primary goal is to author complex documents like books or manuals. In order to do so, a Glyph project is required to keep everything organized and automated via a set of predefined conventions, exactly like Ruby on Rails or other similar frameworks do.</p> + <p>If you want to write a one-page article or a short draft, however, creating and managing Glyph projects can be an unnecessary burden. Luckily, you don't have to: you can use Glyph to compile single files containing Glyph code, by adding one parameter (or two if you want to specify a custom destination file) to the <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command, like this:</p> + <p> <code>glyph compile source.glyph destination.htm</code> </p> - <p>This command will process a file called <code>source.glyph</code> and produce an HTML file called <code>destination.htm</code>.</p> - <section class="section"> + <p>This command will process a file called <code>source.glyph</code> and produce an HTML file called <code>destination.htm</code>.</p> + <section class="section"> <header><h1 id="lite_limitations">Limitations</h1></header> <p>This sort of “lite” mode comes with a few minor limitations:</p> <ul>@@ -80,13 +84,25 @@ <li>The files included through the <a href="/glyph/book/macros/macros_core.html#m_include"><code>include</code></a> macro must be referenced with their absolute path, or a path relative to the current directory.</li>
</ul> </section> - <nav><a href="/glyph/book/compiling/compiling.html">Compiling a project ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/compiling/programmatic_usage.html">→ Using Glyph programmatically</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/compiling/compiling.html">Compiling a project</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/compiling/programmatic_usage.html">Using Glyph programmatically</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -94,50 +110,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,74 +1,78 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Using Glyph programmatically – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Using Glyph programmatically - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Using Glyph programmatically</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Using Glyph programmatically</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/compiling/lite_mode.html">Compiling single Glyph files ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/stats/stats.html">→ Using the stats command</a></nav> - <p>Besides using Glyph from the command line, you can also use it straight from your code. Glyph’s public <a href="http://yardoc.org/docs/glyph/Glyph"><span class="caps">API</span></a> is simple and can be used to:</p> + <nav class="navigation"><a href="/glyph/book/compiling/lite_mode.html">Compiling single Glyph files</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/stats/stats.html">Using the stats command</a></nav> + <p>Besides using Glyph from the command line, you can also use it straight from your code. Glyph’s public <a href="http://rubydoc.info/gems/glyph"><span class="caps">API</span></a> is simple and can be used to:</p> <ul> <li>Retrieve and update configuration settings (using <code>Glyph[]</code> and <code>Glyph[]=</code>)</li> <li>Filter text to <span class="caps">HTML</span> (using <code>Glyph#filter</code>)</li> <li>Compile Glyph source files into <span class="caps">HTML</span> or <span class="caps">PDF</span> files (using <code>Glyph#compile</code>)</li> </ul> <p>That’s pretty much it. Of course, both the <code>filter</code> and <code>compile</code> method cause Glyph to run in <a href="/glyph/book/compiling/lite_mode.html#lite_mode"><em>lite</em> mode</a>, so the same <a href="/glyph/book/compiling/lite_mode.html#lite_limitations">limitations</a> apply.</p> - <aside class="tip"> + <aside class="tip"> <span class="note-title">Tip</span><p>For an example on how to use Glyph programmatically (specifically in conjunction with the <a href="http://nanoc.stoneship.org/">nanoc</a> static site generator), see <a href="http://github.com/h3rald/h3rald">h3rald.com source code</a>, in particular:</p> <ul> <li><a href="http://github.com/h3rald/h3rald/blob/master/lib/glyph_filter.rb">lib/glyph_filter.rb</a> — using the <code>Glyph#filter</code> method.</li>@@ -76,73 +80,103 @@ <li><a href="http://github.com/h3rald/h3rald/blob/master/lib/glyph_context.rb">lib/glyph_context.rb</a> — using the <code>Glyph#compile</code> method to generate <span class="caps">PDF</span> files.</li>
</ul> </aside> - <section class="section"> + <section class="section"> <header><h1 id="modes">Modes</h1></header> <p>It is possible to specify some flags (or "modes") to make Glyph behave slightly different than normal, as shown in the following table (by default, none of these is used).</p> - <table><tr><th>Name</th> - <th>Writer Method</th> - <th>Reader Method</th> - <th>Description</th></tr> - <tr><td>Test Mode</td> - <td> + <table> + <tr> + <th>Name</th> + <th>Writer Method</th> + <th>Reader Method</th> + <th>Description</th> + </tr> + <tr> + <td>Test Mode</td> + <td> <code>Glyph.test_mode=</code> </td> - <td> + <td> <code>Glyph.test?</code> </td> - <td>Used internally by the <code>rake spec</code> task to run Glyph's specs.</td></tr> - <tr><td>Library Mode</td> - <td> + <td>Used internally by the <code>rake spec</code> task to run Glyph's specs.</td> + </tr> + <tr> + <td>Library Mode</td> + <td> <code>Glyph.library_mode=</code> </td> - <td> + <td> <code>Glyph.library?</code> </td> - <td>If enabled, the <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command command will raise exceptions instead of printing errors on the screen. Enabled by the <code>Glyph.compile</code> command.</td></tr> - <tr><td>Debug Mode</td> - <td> + <td>If enabled, the <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command command will raise exceptions instead of printing errors on the screen. Enabled by the <code>Glyph.compile</code> command.</td> + </tr> + <tr> + <td>Debug Mode</td> + <td> <code>Glyph.debug_mode=</code> </td> - <td> + <td> <code>Glyph.debug?</code> </td> - <td>If enabled, additional diagnostic information (such as backtraces or macro values) will be displayed. Enabled by specifying the <a href="/glyph/book/ref_commands.html#debug_switch">debug switch</a> when running a Glyph command.</td></tr> - <tr><td>Lite Mode</td> - <td> + <td>If enabled, additional diagnostic information (such as backtraces or macro values) will be displayed. Enabled by specifying the <a href="/glyph/book/ref_commands.html#debug_switch">debug switch</a> when running a Glyph command.</td> + </tr> + <tr> + <td>Lite Mode</td> + <td> <code>Glyph.lite_mode=</code> </td> - <td> + <td> <code>Glyph.lite?</code> </td> - <td><p>Used to compile <a href="/glyph/book/compiling/lite_mode.html#lite_mode">single files</a>. Enabled by:</p> + <td> + <p>Used to compile <a href="/glyph/book/compiling/lite_mode.html#lite_mode">single files</a>. Enabled by:</p> <ul> <li>The <code>Glyph.compile</code> and <code>Glyph.filter</code> methods.</li> <li>The <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command, if at least one parameter is supplied.</li> -</ul></td></tr> - <tr><td>Safe Mode</td> - <td> +</ul> + </td> + </tr> + <tr> + <td>Safe Mode</td> + <td> <code>Glyph.safe_mode=</code> </td> - <td> + <td> <code>Glyph.safe?</code> </td> - <td><p>If enabled, the following macros cannot be used and will return an error:</p> + <td> + <p>If enabled, the following macros cannot be used and will return an error:</p> <ul> <li><a href="/glyph/book/macros/macros_core.html#m_ruby"><code>ruby</code></a> macro</li> <li><a href="/glyph/book/macros/macros_core.html#m_macro_"><code>macro:</code></a> macro</li> <li><a href="/glyph/book/macros/macros_core.html#m_include"><code>include</code></a> macro</li> - <li><a href="/glyph/book/macros/macros_core.html#m_rewrite_"><code>rewrite:</code></a> macro</li> + <li><a href="/glyph/book/macros/macros_core.html#m_define_"><code>define:</code></a> macro</li> <li><a href="/glyph/book/macros/macros_core.html#m_config_"><code>config:</code></a> macro</li> -</ul></td></tr></table> +</ul> + </td> + </tr> + </table> </section> - <nav><a href="/glyph/book/compiling/lite_mode.html">Compiling single Glyph files ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/stats/stats.html">→ Using the stats command</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/compiling/lite_mode.html">Compiling single Glyph files</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/stats/stats.html">Using the stats command</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -150,50 +184,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,135 +1,255 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>document.* – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>document.* - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>document.*</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>document.*</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/macros/macros_structure.html">Structure Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/config/filters.html">→ filters.*</a></nav> + <nav class="navigation"><a href="/glyph/book/macros/macros_structure.html">Structure Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/config/filters.html">filters.*</a></nav> The following configuration settings are related to the current Glyph document. Therefore, you should update them right after creating a project. -<table><tr><th>Name</th> +<table> + <tr> + <th>Name</th> <th>Description</th> - <th>Default</th></tr> - <tr><td> + <th>Default</th> + </tr> + <tr> + <td> <code>document.author</code> <a id="s_document_author"></a> </td> - <td><p>The author of the document.</p></td> - <td><code>""</code></td></tr> - <tr><td> + <td> +<p>The author of the document.</p> +</td> + <td> + <code> +"" + </code> + </td> + </tr> + <tr> + <td> +<code>document.cover</code> <a id="s_document_cover"></a> +</td> + <td> +<p>The image used as the document cover (used only for e-book generation).</p> +</td> + <td> + <code> +false + </code> + </td> + </tr> + <tr> + <td> <code>document.draft</code> <a id="s_document_draft"></a> </td> - <td><p>If set to <code>true</code>, the document is considered a draft, so <a href="/glyph/book/macros/macros_inline.html#m_draftcomment">draft comments</a> and <a href="/glyph/book/macros/macros_inline.html#m_todo">todo items</a> will be displayed.</p></td> - <td><code>false</code></td></tr> - <tr><td> + <td> +<p>If set to <code>true</code>, the document is considered a draft, so <a href="/glyph/book/macros/macros_inline.html#m_draftcomment">draft comments</a> and <a href="/glyph/book/macros/macros_inline.html#m_todo">todo items</a> will be displayed.</p> +</td> + <td> + <code> +false + </code> + </td> + </tr> + <tr> + <td> <code>document.filename</code> <a id="s_document_filename"></a> </td> - <td><p>The name of the output file.</p></td> - <td><code>""</code></td></tr> - <tr><td> + <td> +<p>The name of the output file.</p> +</td> + <td> + <code> +"" + </code> + </td> + </tr> + <tr> + <td> <code>document.output</code> <a id="s_document_output"></a> </td> - <td><p>The format of the output file. It can be set to:</p> + <td> +<p>The format of the output file. It can be set to:</p> <ul> + <li><code>epub</code></li> <li><code>html5</code></li> <li><code>html</code></li> + <li><code>mobi</code></li> <li><code>pdf</code></li> <li><code>web5</code></li> <li><code>web</code></li> -</ul></td> - <td><code>"html"</code></td></tr> - <tr><td> +</ul> +</td> + <td> + <code> +"html" + </code> + </td> + </tr> + <tr> + <td> <code>document.revision</code> <a id="s_document_revision"></a> </td> - <td><p>The document’s revision.</p></td> - <td><code>""</code></td></tr> - <tr><td> + <td> +<p>The document’s revision.</p> +</td> + <td> + <code> +"" + </code> + </td> + </tr> + <tr> + <td> <code>document.source</code> <a id="s_document_source"></a> </td> - <td><p>The main source file to compile. It can be also be overridden by calling the <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command with the <code>-s</code> option.</p></td> - <td><code>"document.glyph"</code></td></tr> - <tr><td> + <td> +<p>The main source file to compile. It can be also be overridden by calling the <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command with the <code>-s</code> option.</p> +</td> + <td> + <code> +"document.glyph" + </code> + </td> + </tr> + <tr> + <td> <code>document.styles</code> <a id="s_document_styles"></a> </td> - <td><p>How to process stylesheets. It can be set to one of the following values:</p> + <td> +<p>How to process stylesheets. It can be set to one of the following values:</p> <ul> <li><code>embed</code> — Embed stylesheets within the document.</li> <li><code>link</code> — Link stylesheets.</li> <li><code>import</code> — Import stylesheets using the <code>@import</code> <span class="caps">CSS</span> directive.</li> -</ul></td> - <td><code>"embed"</code></td></tr> - <tr><td> +</ul> +</td> + <td> + <code> +"embed" + </code> + </td> + </tr> + <tr> + <td> <code>document.subtitle</code> <a id="s_document_subtitle"></a> </td> - <td><p>The subtitle of the document, displayed using the <a href="/glyph/book/macros/macros_block.html#m_subtitle"><code>subtitle</code></a> macro.</p></td> - <td><code>""</code></td></tr> - <tr><td> + <td> +<p>The subtitle of the document, displayed using the <a href="/glyph/book/macros/macros_block.html#m_subtitle"><code>subtitle</code></a> macro.</p> +</td> + <td> + <code> +"" + </code> + </td> + </tr> + <tr> + <td> <code>document.title</code> <a id="s_document_title"></a> </td> - <td><p>The title of the document, displayed using the <a href="/glyph/book/macros/macros_block.html#m_title"><code>title</code></a> macro.</p></td> - <td><code>""</code></td></tr></table> - <nav><a href="/glyph/book/macros/macros_structure.html">Structure Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/config/filters.html">→ filters.*</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <td> +<p>The title of the document, displayed using the <a href="/glyph/book/macros/macros_block.html#m_title"><code>title</code></a> macro.</p> +</td> + <td> + <code> +"" + </code> + </td> + </tr> + <tr> + <td> +<code>document.isbn</code> <a id="s_document_isbn"></a> +</td> + <td> +<p>The <span class="caps">ISBN</span> of the document, for e-book generation.</p> +</td> + <td> + <code> +false + </code> + </td> + </tr> + </table> + <nav class="navigation"><a href="/glyph/book/macros/macros_structure.html">Structure Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/config/filters.html">filters.*</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -137,50 +257,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,115 +1,183 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>filters.* – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>filters.* - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>filters.*</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>filters.*</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/config/document.html">document.* ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/config/options.html">→ options.*</a></nav> + <nav class="navigation"><a href="/glyph/book/config/document.html">document.*</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/config/options.html">options.*</a></nav> These settings are used to configure some special options related to output filters and highlighters. -<table><tr><th>Name</th> +<table> + <tr> + <th>Name</th> <th>Description</th> - <th>Default</th></tr> - <tr><td> + <th>Default</th> + </tr> + <tr> + <td> <code>filters.coderay.*</code> <a id="s_filters_coderay_"></a> </td> - <td><p>Some <a href="http://coderay.rubychan.de/">Coderay</a>-specific <a href="http://coderay.rubychan.de/doc/classes/CodeRay/Encoders/HTML.html">options</a>.</p></td> - <td><code>nil</code></td></tr> - <tr><td> + <td> +<p>Some <a href="http://coderay.rubychan.de/">Coderay</a>-specific <a href="http://coderay.rubychan.de/doc/classes/CodeRay/Encoders/HTML.html">options</a>.</p> +</td> + <td> + <code> +nil + </code> + </td> + </tr> + <tr> + <td> <code>filters.highlighter</code> <a id="s_filters_highlighter"></a> </td> - <td><p>The current highlighter to use. It can be set to <code>coderay</code> or <code>ultraviolet</code></p></td> - <td><code>"coderay"</code></td></tr> - <tr><td> + <td> +<p>The current highlighter to use. It can be set to <code>coderay</code> or <code>ultraviolet</code></p> +</td> + <td> + <code> +"coderay" + </code> + </td> + </tr> + <tr> + <td> <code>filters.markdown.converter</code> <a id="s_filters_markdown_converter"></a> </td> - <td><p>The name of the markdown converter to use with the <a href="/glyph/book/macros/macros_filters.html#m_markdown"><code>markdown</code></a> macro. It can be set to one of the following values:</p> + <td> +<p>The name of the markdown converter to use with the <a href="/glyph/book/macros/macros_filters.html#m_markdown"><code>markdown</code></a> macro. It can be set to one of the following values:</p> <ul> <li>BlueCloth</li> <li>RDiscount</li> <li>Maruku</li> <li>Kramdown</li> </ul> -<p>If not set, Glyph tests for the presence of each gem in the same order, until one is found.</p></td> - <td><code>"bluecloth"</code></td></tr> - <tr><td> +<p>If not set, Glyph tests for the presence of each gem in the same order, until one is found.</p> +</td> + <td> + <code> +"bluecloth" + </code> + </td> + </tr> + <tr> + <td> <code>filters.redcloth.restrictions</code> <a id="s_filters_redcloth_restrictions"></a> </td> - <td><p>An <code>Array</code> containing restrictions applied to RedCloth, used by the <a href="/glyph/book/macros/macros_filters.html#m_textile"><code>textile</code></a> macro (see <a href="http://redcloth.rubyforge.org/classes/RedCloth/TextileDoc.html">RedCloth Documentation</a> for more information).</p></td> - <td><code>[]</code></td></tr> - <tr><td> + <td> +<p>An <code>Array</code> containing restrictions applied to RedCloth, used by the <a href="/glyph/book/macros/macros_filters.html#m_textile"><code>textile</code></a> macro (see <a href="http://redcloth.rubyforge.org/classes/RedCloth/TextileDoc.html">RedCloth Documentation</a> for more information).</p> +</td> + <td> + <code> +[] + </code> + </td> + </tr> + <tr> + <td> <code>filters.ultraviolet.line_numbers</code> <a id="s_filters_ultraviolet_line_numbers"></a> </td> - <td><p>Whether the <a href="http://ultraviolet.rubyforge.org/">Ultraviolet</a> highlighter should display line numbers or not.</p></td> - <td><code>true</code></td></tr> - <tr><td> + <td> +<p>Whether the <a href="http://ultraviolet.rubyforge.org/">Ultraviolet</a> highlighter should display line numbers or not.</p> +</td> + <td> + <code> +true + </code> + </td> + </tr> + <tr> + <td> <code>filters.ultraviolet.theme</code> <a id="s_filters_ultraviolet_theme"></a> </td> - <td><p>The theme used by the <a href="http://ultraviolet.rubyforge.org/">Ultraviolet</a> highlighter.</p></td> - <td><code>"lazy"</code></td></tr></table> - <nav><a href="/glyph/book/config/document.html">document.* ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/config/options.html">→ options.*</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <td> +<p>The theme used by the <a href="http://ultraviolet.rubyforge.org/">Ultraviolet</a> highlighter.</p> +</td> + <td> + <code> +"lazy" + </code> + </td> + </tr> + </table> + <nav class="navigation"><a href="/glyph/book/config/document.html">document.*</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/config/options.html">options.*</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -117,50 +185,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,113 +1,194 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>options.* – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>options.* - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>options.*</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>options.*</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/config/filters.html">filters.* ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/config/output.html">→ output.*</a></nav> + <nav class="navigation"><a href="/glyph/book/config/filters.html">filters.*</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/config/output.html">output.*</a></nav> The following configuration settings are used to enable or disable specific Glyph functionalities and behaviors. -<table><tr><th>Name</th> +<table> + <tr> + <th>Name</th> <th>Description</th> - <th>Default</th></tr> - <tr><td> + <th>Default</th> + </tr> + <tr> + <td> <code>options.filters_by_file_extension</code> <a id="s_options_filters_by_file_extension"></a> </td> - <td><p>If set to <code>true</code>, a filter macro is applied to included files, based on their extensions (<span class="fmi">for more information on <mark>including files</mark>, see <a href="/glyph/book/text_editing/inclusions.html#incl">Including Files and Snippets</a></span>).</p></td> - <td><code>nil</code></td></tr> - <tr><td> + <td> +<p>If set to <code>true</code>, a filter macro is applied to included files, based on their extensions (<span class="fmi">for more information on <mark>including files</mark>, see <a href="/glyph/book/text_editing/inclusions.html#incl">Content Reuse</a></span>).</p> +</td> + <td> + <code> +nil + </code> + </td> + </tr> + <tr> + <td> <code>options.macro_set</code> <a id="s_options_macro_set"></a> </td> - <td><p>Determines which macro set will be loaded. It can be set to:</p> + <td> +<p>Determines which macro set will be loaded. It can be set to:</p> <ul> <li>glyph — Loads core, filter, xml macros plus all macros necessary for the <a href="/glyph/book/config/document.html#s_document_output"><code>document.output</code></a> setting.</li> <li>xml — Loads core and xml macros.</li> <li>core — Loads core macros only.</li> -</ul></td> - <td><code>"glyph"</code></td></tr> - <tr><td> +</ul> +</td> + <td> + <code> +"glyph" + </code> + </td> + </tr> + <tr> + <td> <code>options.safe_mode</code> <a id="s_options_safe_mode"></a> </td> - <td><p>Enables Safe Mode (<span class="fmi">for more information on <mark>Glyph modes</mark>, see <a href="/glyph/book/compiling/programmatic_usage.html#modes">Modes</a></span>).</p></td> - <td><code>false</code></td></tr> - <tr><td> + <td> +<p>Enables Safe Mode (<span class="fmi">for more information on <mark>Glyph modes</mark>, see <a href="/glyph/book/compiling/programmatic_usage.html#modes">Modes</a></span>).</p> +</td> + <td> + <code> +false + </code> + </td> + </tr> + <tr> + <td> <code>options.url_validation</code> <a id="s_options_url_validation"></a> </td> - <td><p>If set to <em>true_, every external link will be validated (see </em>editing/links.html#links">Links and Bookmarks</a>).</p></td> - <td><code>false</code></td></tr> - <tr><td> + <td> +<p>If set to <em>true_, every external link will be validated (see </em>editing/links.html#links">Links and Bookmarks</a>).</p> +</td> + <td> + <code> +false + </code> + </td> + </tr> + <tr> + <td> <code>options.xml_blacklist</code> <a id="s_options_xml_blacklist"></a> </td> - <td><p>The <span class="caps">XML</span> tags listed here cannot be generated using Glyph code.</p></td> - <td><code>["applet", "base", "basefont", "embed", "frame", "frameset", "iframe", "isindex", "meta", "noframes", "noscript", "object", "param", "title"]</code></td></tr> - <tr><td> + <td> +<p>The <span class="caps">XML</span> tags listed here cannot be generated using Glyph code.</p> +</td> + <td> + <code> +["applet", "base", "basefont", "embed", "frame", "frameset", "iframe", "isindex", "meta", "noframes", "noscript", "object", "param", "title"] + </code> + </td> + </tr> + <tr> + <td> <code>options.xml_fallback</code> <a id="s_options_xml_fallback"></a> </td> - <td><p>If set to true, any unknown macro name will considered an <span class="caps">XML</span> element (see <a href="/glyph/book/document.html#other_elements">Other <span class="caps">HTML</span> Elements</a>).</p></td> - <td><code>true</code></td></tr></table> - <nav><a href="/glyph/book/config/filters.html">filters.* ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/config/output.html">→ output.*</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <td> +<p>If set to true, any unknown macro name will considered an <span class="caps">XML</span> element (see <a href="/glyph/book/document.html#other_elements">Other <span class="caps">HTML</span> Elements</a>).</p> +</td> + <td> + <code> +true + </code> + </td> + </tr> + <tr> + <td> +<code>options.ebook.converter</code> <a id="s_options_ebook_converter"></a> +</td> + <td> +<p>The full path name of the ebook-convert command. Defaults to /usr/bin/ebook-convert.</p> +</td> + <td> + <code> +nil + </code> + </td> + </tr> + </table> + <nav class="navigation"><a href="/glyph/book/config/filters.html">filters.*</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/config/output.html">output.*</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -115,50 +196,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,264 +1,725 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>output.* – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>output.* - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>output.*</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> + <nav class="navigation"><a href="/glyph/book/config/options.html">options.*</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/changelog.html">Changelog</a></nav> + - <section id="container"> - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - </header> - <article class="page"> - <header> - <hgroup> - <h1>output.*</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/config/options.html">options.* ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/changelog.html">→ Changelog</a></nav> - + +These settings are used to configure output-specific options. +<section class="section"> +<header><h1 id="h_278">output.epub.*</h1></header> +<table> + <tr> + <th>Name</th> + <th>Description</th> + <th>Default</th> + </tr> + <tr> + <td> +<code>output.epub.extension</code> <a id="s_output_epub_extension"></a> +</td> + <td> +<p>The extension to use for the output file(s).</p> +</td> + <td> + <code> +".epub" + </code> + </td> + </tr> + <tr> + <td> +<code>output.epub.filter_target</code> <a id="s_output_epub_filter_target"></a> +</td> + <td> +<p>The output target for filters. It can be set to <code>html</code> (for RedCloth and MarkDown) or <code>latex</code> (RedCloth-only).</p> +</td> + <td> + <code> +"html" + </code> + </td> + </tr> + <tr> + <td> +<code>output.epub.generator</code> <a id="s_output_epub_generator"></a> +</td> + <td> +<p>The external program used to generate <span class="caps">EPUB</span> files. It must be set to <code>calibre</code>.</p> +</td> + <td> + <code> +"calibre" + </code> + </td> + </tr> + <tr> + <td> +<code>output.epub.calibre</code> <a id="s_output_epub_calibre"></a> +</td> + <td> +<p>An array of options to configure Calibre. See the <a href="http://calibre-ebook.com/user_manual/cli/ebook-convert-3.html">full list</a>.</p> +</td> + <td> + <code> +{"output-profile"=>"nook"} + </code> + </td> + </tr> + <tr> + <td> +<code>output.epub.macro_reps</code> <a id="s_output_epub_macro_reps"></a> +</td> + <td> +<p>The name of the representation file from which macro representation will be loaded.</p> +</td> + <td> + <code> +"html" + </code> + </td> + </tr> + <tr> + <td> +<code>output.epub.multifile</code> <a id="s_output_epub_multifile"></a> +</td> + <td> +<p>If set to <em>true_, the document will be rendered in multiple files, according to the specified </em>editing/topics.html#topics">topics</a>.</p> +</td> + <td> + <code> +false + </code> + </td> + </tr> + </table> -These settings are used to configure output-specific options. - +</section> +<section class="section"> +<header><h1 id="h_279">output.mobi.*</h1></header> +<table> + <tr> + <th>Name</th> + <th>Description</th> + <th>Default</th> + </tr> + <tr> + <td> +<code>output.mobi.extension</code> <a id="s_output_mobi_extension"></a> +</td> + <td> +<p>The extension to use for the output file(s).</p> +</td> + <td> + <code> +".mobi" + </code> + </td> + </tr> + <tr> + <td> +<code>output.mobi.filter_target</code> <a id="s_output_mobi_filter_target"></a> +</td> + <td> +<p>The output target for filters. It can be set to <code>html</code> (for RedCloth and MarkDown) or <code>latex</code> (RedCloth-only).</p> +</td> + <td> + <code> +"html" + </code> + </td> + </tr> + <tr> + <td> +<code>output.mobi.generator</code> <a id="s_output_mobi_generator"></a> +</td> + <td> +<p>The external program used to generate <span class="caps">MOBI</span> files. It must be set to <code>calibre</code>.</p> +</td> + <td> + <code> +"calibre" + </code> + </td> + </tr> + <tr> + <td> +<code>output.mobi.calibre</code> <a id="s_output_mobi_calibre"></a> +</td> + <td> +<p>An array of options to configure Calibre. See the <a href="http://calibre-ebook.com/user_manual/cli/ebook-convert-3.html">full list</a>.</p> +</td> + <td> + <code> +{"no-inline-toc"=>nil, "output-profile"=>"kindle"} + </code> + </td> + </tr> + <tr> + <td> +<code>output.mobi.macro_reps</code> <a id="s_output_mobi_macro_reps"></a> +</td> + <td> +<p>The name of the representation file from which macro representation will be loaded.</p> +</td> + <td> + <code> +"html" + </code> + </td> + </tr> + <tr> + <td> +<code>output.mobi.multifile</code> <a id="s_output_mobi_multifile"></a> +</td> + <td> +<p>If set to <em>true_, the document will be rendered in multiple files, according to the specified </em>editing/topics.html#topics">topics</a>.</p> +</td> + <td> + <code> +false + </code> + </td> + </tr> + </table> +</section> <section class="section"> -<header><h1 id="h_235">output.pdf.*</h1></header> -<table><tr><th>Name</th> +<header><h1 id="h_280">output.pdf.*</h1></header> +<table> + <tr> + <th>Name</th> <th>Description</th> - <th>Default</th></tr> - <tr><td> + <th>Default</th> + </tr> + <tr> + <td> <code>output.pdf.extension</code> <a id="s_output_pdf_extension"></a> </td> - <td><p>The extension to use for the output file(s).</p></td> - <td><code>".pdf"</code></td></tr> - <tr><td> + <td> +<p>The extension to use for the output file(s).</p> +</td> + <td> + <code> +".pdf" + </code> + </td> + </tr> + <tr> + <td> <code>output.pdf.filter_target</code> <a id="s_output_pdf_filter_target"></a> </td> - <td><p>The output target for filters. It can be set to <code>html</code> (for RedCloth and MarkDown) or <code>latex</code> (RedCloth-only).</p></td> - <td><code>"html"</code></td></tr> - <tr><td> + <td> +<p>The output target for filters. It can be set to <code>html</code> (for RedCloth and MarkDown) or <code>latex</code> (RedCloth-only).</p> +</td> + <td> + <code> +"html" + </code> + </td> + </tr> + <tr> + <td> +<code>output.pdf.through</code> <a id="s_output_pdf_through"></a> +</td> + <td> +<p>The intermediate format from which a <span class="caps">PDF</span> file is generated. It can be set to <code>html</code> or <code>html5</code>.</p> +</td> + <td> + <code> +"html" + </code> + </td> + </tr> + <tr> + <td> <code>output.pdf.generator</code> <a id="s_output_pdf_generator"></a> </td> - <td><p>The external program used to generate <span class="caps">PDF</span> files. It can be set to <code>prince</code> or <code>wkhtmltopdf</code>.</p></td> - <td><code>"wkhtmltopdf"</code></td></tr> - <tr><td> -<code>output.pdf.macro_dirs</code> <a id="s_output_pdf_macro_dirs"></a> + <td> +<p>The external program used to generate <span class="caps">PDF</span> files. It can be set to <code>prince</code> or <code>wkhtmltopdf</code>.</p> +</td> + <td> + <code> +"wkhtmltopdf" + </code> + </td> + </tr> + <tr> + <td> +<code>output.pdf.macro_reps</code> <a id="s_output_pdf_macro_reps"></a> +</td> + <td> +<p>The name of the representation file from which macro representation will be loaded.</p> </td> - <td><p>The directories from which macros will be loaded (both in Glyph’s home and the current project directory).</p></td> - <td><code>["html"]</code></td></tr> - <tr><td> + <td> + <code> +"html" + </code> + </td> + </tr> + <tr> + <td> <code>output.pdf.multifile</code> <a id="s_output_pdf_multifile"></a> </td> - <td><p>If set to <em>true_, the document will be rendered in multiple files, according to the specified </em>editing/topics.html#topics">topics</a>.</p></td> - <td><code>false</code></td></tr></table> + <td> +<p>If set to <em>true_, the document will be rendered in multiple files, according to the specified </em>editing/topics.html#topics">topics</a>.</p> +</td> + <td> + <code> +false + </code> + </td> + </tr> + </table> </section> <section class="section"> -<header><h1 id="h_236">output.html.*</h1></header> -<table><tr><th>Name</th> +<header><h1 id="h_281">output.html.*</h1></header> +<table> + <tr> + <th>Name</th> <th>Description</th> - <th>Default</th></tr> - <tr><td> + <th>Default</th> + </tr> + <tr> + <td> <code>output.html.extension</code> <a id="s_output_html_extension"></a> </td> - <td><p>The extension to use for the output file(s).</p></td> - <td><code>".html"</code></td></tr> - <tr><td> + <td> +<p>The extension to use for the output file(s).</p> +</td> + <td> + <code> +".html" + </code> + </td> + </tr> + <tr> + <td> <code>output.html.filter_target</code> <a id="s_output_html_filter_target"></a> </td> - <td><p>The output target for filters. It can be set to <code>html</code> (for RedCloth and MarkDown) or <code>latex</code> (RedCloth-only).</p></td> - <td><code>"html"</code></td></tr> - <tr><td> -<code>output.html.macro_dirs</code> <a id="s_output_html_macro_dirs"></a> + <td> +<p>The output target for filters. It can be set to <code>html</code> (for RedCloth and MarkDown) or <code>latex</code> (RedCloth-only).</p> +</td> + <td> + <code> +"html" + </code> + </td> + </tr> + <tr> + <td> +<code>output.html.macro_reps</code> <a id="s_output_html_macro_reps"></a> +</td> + <td> +<p>The name of the representation file from which macro representation will be loaded.</p> </td> - <td><p>The directories from which macros will be loaded (both in Glyph’s home and the current project directory).</p></td> - <td><code>["html"]</code></td></tr> - <tr><td> + <td> + <code> +"html" + </code> + </td> + </tr> + <tr> + <td> <code>output.html.multifile</code> <a id="s_output_html_multifile"></a> </td> - <td><p>If set to <em>true_, the document will be rendered in multiple files, according to the specified </em>editing/topics.html#topics">topics</a>.</p></td> - <td><code>false</code></td></tr></table> + <td> +<p>If set to <em>true_, the document will be rendered in multiple files, according to the specified </em>editing/topics.html#topics">topics</a>.</p> +</td> + <td> + <code> +false + </code> + </td> + </tr> + </table> </section> <section class="section"> -<header><h1 id="h_237">output.html5.*</h1></header> -<table><tr><th>Name</th> +<header><h1 id="h_282">output.html5.*</h1></header> +<table> + <tr> + <th>Name</th> <th>Description</th> - <th>Default</th></tr> - <tr><td> + <th>Default</th> + </tr> + <tr> + <td> <code>output.html5.extension</code> <a id="s_output_html5_extension"></a> </td> - <td><p>The extension to use for the output file(s).</p></td> - <td><code>".html"</code></td></tr> - <tr><td> + <td> +<p>The extension to use for the output file(s).</p> +</td> + <td> + <code> +".html" + </code> + </td> + </tr> + <tr> + <td> <code>output.html5.filter_target</code> <a id="s_output_html5_filter_target"></a> </td> - <td><p>The output target for filters. It can be set to <code>html</code> (for RedCloth and MarkDown) or <code>latex</code> (RedCloth-only).</p></td> - <td><code>"html"</code></td></tr> - <tr><td> -<code>output.html5.macro_dirs</code> <a id="s_output_html5_macro_dirs"></a> + <td> +<p>The output target for filters. It can be set to <code>html</code> (for RedCloth and MarkDown) or <code>latex</code> (RedCloth-only).</p> </td> - <td><p>The directories from which macros will be loaded (both in Glyph’s home and the current project directory).</p></td> - <td><code>["html", "html5"]</code></td></tr> - <tr><td> + <td> + <code> +"html" + </code> + </td> + </tr> + <tr> + <td> +<code>output.html5.macro_reps</code> <a id="s_output_html5_macro_reps"></a> +</td> + <td> +<p>The name of the representation file from which macro representation will be loaded.</p> +</td> + <td> + <code> +"html5" + </code> + </td> + </tr> + <tr> + <td> <code>output.html5.multifile</code> <a id="s_output_html5_multifile"></a> </td> - <td><p>If set to <em>true_, the document will be rendered in multiple files, according to the specified </em>editing/topics.html#topics">topics</a>.</p></td> - <td><code>false</code></td></tr></table> + <td> +<p>If set to <em>true_, the document will be rendered in multiple files, according to the specified </em>editing/topics.html#topics">topics</a>.</p> +</td> + <td> + <code> +false + </code> + </td> + </tr> + </table> </section> <section class="section"> -<header><h1 id="h_238">output.web.*</h1></header> -<table><tr><th>Name</th> +<header><h1 id="h_283">output.web.*</h1></header> +<table> + <tr> + <th>Name</th> <th>Description</th> - <th>Default</th></tr> - <tr><td> + <th>Default</th> + </tr> + <tr> + <td> <code>output.web.base</code> <a id="s_output_web_base"></a> </td> - <td><p>The directory to use as root for all link paths.</p></td> - <td><code>"/"</code></td></tr> - <tr><td> + <td> +<p>The directory to use as root for all link paths.</p> +</td> + <td> + <code> +"/" + </code> + </td> + </tr> + <tr> + <td> <code>output.web.extension</code> <a id="s_output_web_extension"></a> </td> - <td><p>The extension to use for the output file(s).</p></td> - <td><code>".html"</code></td></tr> - <tr><td> + <td> +<p>The extension to use for the output file(s).</p> +</td> + <td> + <code> +".html" + </code> + </td> + </tr> + <tr> + <td> <code>output.web.filter_target</code> <a id="s_output_web_filter_target"></a> </td> - <td><p>The output target for filters. It can be set to <code>html</code> (for RedCloth and MarkDown) or <code>latex</code> (RedCloth-only).</p></td> - <td><code>"html"</code></td></tr> - <tr><td> + <td> +<p>The output target for filters. It can be set to <code>html</code> (for RedCloth and MarkDown) or <code>latex</code> (RedCloth-only).</p> +</td> + <td> + <code> +"html" + </code> + </td> + </tr> + <tr> + <td> <code>output.web.layout_dirs</code> <a id="s_output_web_layout_dirs"></a> </td> - <td><p>The directories from which layout macros will be loaded (both in Glyph’s home and the current project directory).</p></td> - <td><code>["web"]</code></td></tr> - <tr><td> + <td> +<p>The directories from which layout macros will be loaded (both in Glyph’s home and the current project directory).</p> +</td> + <td> + <code> +nil + </code> + </td> + </tr> + <tr> + <td> <code>output.web.layouts.index</code> <a id="s_output_web_layouts_index"></a> </td> - <td><p>The name of the layout to use to render the document index file.</p></td> - <td><code>"index"</code></td></tr> - <tr><td> + <td> +<p>The name of the layout to use to render the document index file.</p> +</td> + <td> + <code> +"index" + </code> + </td> + </tr> + <tr> + <td> <code>output.web.layouts.topic</code> <a id="s_output_web_layouts_topic"></a> </td> - <td><p>The name of the layout to use to render topic files.</p></td> - <td><code>"topic"</code></td></tr> - <tr><td> -<code>output.web.macro_dirs</code> <a id="s_output_web_macro_dirs"></a> + <td> +<p>The name of the layout to use to render topic files.</p> +</td> + <td> + <code> +"topic" + </code> + </td> + </tr> + <tr> + <td> +<code>output.web.macro_reps</code> <a id="s_output_web_macro_reps"></a> +</td> + <td> +<p>The name of the representation file from which macro representation will be loaded.</p> </td> - <td><p>The directories from which macros will be loaded (both in Glyph’s home and the current project directory).</p></td> - <td><code>["html"]</code></td></tr> - <tr><td> + <td> + <code> +"html" + </code> + </td> + </tr> + <tr> + <td> <code>output.web.multifile</code> <a id="s_output_web_multifile"></a> </td> - <td><p>If set to <em>true_, the document will be rendered in multiple files, according to the specified </em>editing/topics.html#topics">topics</a>.</p></td> - <td><code>true</code></td></tr></table> + <td> +<p>If set to <em>true_, the document will be rendered in multiple files, according to the specified </em>editing/topics.html#topics">topics</a>.</p> +</td> + <td> + <code> +true + </code> + </td> + </tr> + </table> </section> <section class="section"> -<header><h1 id="h_239">output.web5.*</h1></header> -<table><tr><th>Name</th> +<header><h1 id="h_284">output.web5.*</h1></header> +<table> + <tr> + <th>Name</th> <th>Description</th> - <th>Default</th></tr> - <tr><td> + <th>Default</th> + </tr> + <tr> + <td> <code>output.web5.base</code> <a id="s_output_web5_base"></a> </td> - <td><p>The directory to use as root for all link paths.</p></td> - <td><code>"/"</code></td></tr> - <tr><td> + <td> +<p>The directory to use as root for all link paths.</p> +</td> + <td> + <code> +"/" + </code> + </td> + </tr> + <tr> + <td> <code>output.web5.extension</code> <a id="s_output_web5_extension"></a> </td> - <td><p>The extension to use for the output file(s).</p></td> - <td><code>".html"</code></td></tr> - <tr><td> + <td> +<p>The extension to use for the output file(s).</p> +</td> + <td> + <code> +".html" + </code> + </td> + </tr> + <tr> + <td> <code>output.web5.filter_target</code> <a id="s_output_web5_filter_target"></a> </td> - <td><p>The output target for filters. It can be set to <code>html</code> (for RedCloth and MarkDown) or <code>latex</code> (RedCloth-only).</p></td> - <td><code>"html"</code></td></tr> - <tr><td> + <td> +<p>The output target for filters. It can be set to <code>html</code> (for RedCloth and MarkDown) or <code>latex</code> (RedCloth-only).</p> +</td> + <td> + <code> +"html" + </code> + </td> + </tr> + <tr> + <td> <code>output.web5.layout_dirs</code> <a id="s_output_web5_layout_dirs"></a> </td> - <td><p>The directories from which layout macros will be loaded (both in Glyph’s home and the current project directory).</p></td> - <td><code>["web5"]</code></td></tr> - <tr><td> + <td> +<p>The directories from which layout macros will be loaded (both in Glyph’s home and the current project directory).</p> +</td> + <td> + <code> +nil + </code> + </td> + </tr> + <tr> + <td> <code>output.web5.layouts.index</code> <a id="s_output_web5_layouts_index"></a> </td> - <td><p>The name of the layout to use to render the document index file.</p></td> - <td><code>"index"</code></td></tr> - <tr><td> + <td> +<p>The name of the layout to use to render the document index file.</p> +</td> + <td> + <code> +"index" + </code> + </td> + </tr> + <tr> + <td> <code>output.web5.layouts.topic</code> <a id="s_output_web5_layouts_topic"></a> </td> - <td><p>The name of the layout to use to render topic files.</p></td> - <td><code>"topic"</code></td></tr> - <tr><td> -<code>output.web5.macro_dirs</code> <a id="s_output_web5_macro_dirs"></a> + <td> +<p>The name of the layout to use to render topic files.</p> +</td> + <td> + <code> +"topic" + </code> + </td> + </tr> + <tr> + <td> +<code>output.web5.macro_reps</code> <a id="s_output_web5_macro_reps"></a> +</td> + <td> +<p>The name of the representation file from which macro representation will be loaded.</p> </td> - <td><p>The directories from which macros will be loaded (both in Glyph’s home and the current project directory).</p></td> - <td><code>["html", "html5"]</code></td></tr> - <tr><td> + <td> + <code> +"html5" + </code> + </td> + </tr> + <tr> + <td> <code>output.web5.multifile</code> <a id="s_output_web5_multifile"></a> </td> - <td><p>If set to <em>true_, the document will be rendered in multiple files, according to the specified </em>editing/topics.html#topics">topics</a>.</p></td> - <td><code>true</code></td></tr></table> + <td> +<p>If set to <em>true_, the document will be rendered in multiple files, according to the specified </em>editing/topics.html#topics">topics</a>.</p> +</td> + <td> + <code> +true + </code> + </td> + </tr> + </table> </section> - <nav><a href="/glyph/book/config/options.html">options.* ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/changelog.html">→ Changelog</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/config/options.html">options.*</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/changelog.html">Changelog</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -266,50 +727,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,86 +1,104 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Bookmarks and Headers – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Bookmarks and Headers - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Bookmarks and Headers</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Bookmarks and Headers</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/extending/params_attrs.html">Parameters and Attributes ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/placeholders.html">→ Using Placeholders</a></nav> - <p>The <a href="http://yardoc.org/docs/h3rald-glyph/Macro"><code>Glyph::Macro</code></a> class also includes a few methods to check and store bookmarks and headers. Consider for example the following source code for the <a href="/glyph/book/macros/macros_inline.html#m_anchor"><code>anchor</code></a> macro:</p> + <nav class="navigation"><a href="/glyph/book/extending/params_attrs.html">Parameters and Attributes</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/placeholders.html">Using Placeholders</a></nav> + <p>The <a href="http://rubydoc.info/gems/glyph/Macro"><code>Glyph::Macro</code></a> class also includes a few methods to check and store bookmarks and headers. Consider for example the following source code for the <a href="/glyph/book/macros/macros_inline.html#m_anchor"><code>anchor</code></a> macro:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> macro <span class="sy">:anchor</span> <span class="r">do</span> -<span class="no">2</span> ident, title = <span class="iv">@params</span> -<span class="no">3</span> macro_error <span class="s"><span class="dl">"</span><span class="k">Bookmark '</span><span class="il"><span class="idl">#{</span>ident<span class="idl">}</span></span><span class="k">' already exists</span><span class="dl">"</span></span> <span class="r">if</span> bookmark? ident -<span class="no">4</span> bookmark <span class="sy">:id</span> => ident, <span class="sy">:title</span> => title -<span class="no">5</span> <span class="s"><span class="dl">%{</span><span class="k"><a id="</span><span class="il"><span class="idl">#{</span>ident<span class="idl">}</span></span><span class="k">"></span><span class="il"><span class="idl">#{</span>title<span class="idl">}</span></span><span class="k"></a></span><span class="dl">}</span></span> -<span class="no">6</span> <span class="r">end</span></pre></div> +<span class="no">2</span> min_parameters <span class="i">1</span> +<span class="no">3</span> max_parameters <span class="i">2</span> +<span class="no">4</span> bookmark <span class="sy">:id</span> => param(<span class="i">0</span>), <span class="sy">:title</span> => param(<span class="i">1</span>), <span class="sy">:file</span> => <span class="iv">@source_file</span> +<span class="no">5</span> <span class="iv">@data</span>[<span class="sy">:id</span>] = param <span class="i">0</span> +<span class="no">6</span> <span class="iv">@data</span>[<span class="sy">:title</span>] = param <span class="i">1</span> +<span class="no">7</span> render +<span class="no">8</span> <span class="r">end</span></pre></div> </div> - <p>The <code>bookmark?</code> method can be used to check the existance of a particular ID within the whole document, while the <code>bookmark</code> method is used to store bookmark IDs and titles. In a similar way, you can use <code>header?</code> and <code>header</code> methods to check the existance of headers within the documents or store new ones.</p> - <nav><a href="/glyph/book/extending/params_attrs.html">Parameters and Attributes ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/placeholders.html">→ Using Placeholders</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <p>The <code>bookmark?</code> method can be used to check the existance of a particular ID within the whole document, while the <code>bookmark</code> method is used to store bookmark IDs and titles. In a similar way, you can use <code>header?</code> and <code>header</code> methods to check the existance of headers within the documents or store new ones.</p> + <nav class="navigation"><a href="/glyph/book/extending/params_attrs.html">Parameters and Attributes</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/placeholders.html">Using Placeholders</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -88,50 +106,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,69 +1,73 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Defining Custom Commands – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Defining Custom Commands - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Defining Custom Commands</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Defining Custom Commands</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/extending/output_format.html">Custom Output Formats ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/troubleshooting/errors_generic.html">→ Generic Errors</a></nav> + <nav class="navigation"><a href="/glyph/book/extending/output_format.html">Custom Output Formats</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/troubleshooting/errors_generic.html">Generic Errors</a></nav> <p>Glyph relies on <a href="http://davetron5000.github.com/gli/"><span class="caps">GLI</span></a> for defining commands. This useful library provides a high-level framework for creating command-line interface similar to <a href="http://git-scm.com/">Git</a>, its <span class="caps">DSL</span> takes care of pretty much everything, from managing command line arguments and options to providing an interactive help system.</p> <section class="section"> -<header><h1 id="h_97">Creating a 'glyph generate' command</h1></header> +<header><h1 id="h_109">Creating a 'glyph generate' command</h1></header> <p>Consider the custom task defined in <a href="/glyph/book/extending/task.html#custom_generate_task">Creating a ‘custom:generate’ task</a>. Creating a custom command to call it is fairly straightforward.</p> <p>First of all, create a <code>lib/commands</code> folder in your project directory. Then, create a <code>.rb</code> file within it, e.g. <code>commands.rake</code>.</p> <p>Finally, here’s the source of the command:</p>@@ -85,7 +89,7 @@ <p>That’s it. If you try to run <code>glyph help</code> within your project directory, notice that there’s a new entry for the generate command:</p>
<div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> $ glyph help <span class="no"> 2</span> ===================================== -<span class="no"> 3</span> Glyph v.0.4.2 +<span class="no"> 3</span> Glyph v/0.5.0 <span class="no"> 4</span> ===================================== <span class="no"> 5</span> usage: glyph command [options] <span class="no"> 6</span>@@ -112,13 +116,25 @@ <span class="no">3</span> -- Done.</pre></div>
</div> </section> - <nav><a href="/glyph/book/extending/output_format.html">Custom Output Formats ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/troubleshooting/errors_generic.html">→ Generic Errors</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/extending/output_format.html">Custom Output Formats</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/troubleshooting/errors_generic.html">Generic Errors</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -126,50 +142,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,74 +1,77 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Defining Custom Commands and Tasks – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Defining Custom Commands and Tasks - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> + <meta content="44.388041;9.073248" name="ICBM" /> - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Defining Custom Commands and Tasks</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Defining Custom Commands and Tasks</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/extending/further_reading.html">Further Reading ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/task.html">→ Defining Custom Tasks</a></nav> + <nav class="navigation"><a href="/glyph/book/extending/further_reading.html">Further Reading</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/task.html">Defining Custom Tasks</a></nav> <p>In most cases, you can extend Glyph just by creating your own <a href="/glyph/book/extending/macro_def.html#macro_def">custom macros</a>. In some cases though, you may want to further customize Glyph to fit the needs of your project, in terms of creating <a href="/glyph/book/extending/command.html#custom_command">custom commands</a> and <a href="/glyph/book/extending/task.html#custom_task">custom tasks</a>.</p> <p>Glyph’s modular architecture (and the Ruby language itself) lets you to add <em>arbitrary</em> functionality to its core, simply by creating a few Ruby files and putting them in the right places.</p> <section class="section"> <header><h1 id="cmd_tasks_arch">How Commands and Tasks work</h1></header> <p>Before creating custom Glyph commands and tasks, you should have a basic understanding on how they work, and which commands — or better, which tasks — are already available.</p> -<p>The following diagram outlines the relationships between commands and tasks:</p> - <figure><img alt="-" src="/glyph/book/images/glyph/commands_tasks.png" /> - <figcaption>Glyph default commands and tasks</figcaption></figure> +<p>The following diagram outlines the relationships between the default commands and some tasks:</p> + <figure><img src="/glyph/book/images/glyph/commands_tasks.png" /><figcaption>Some of Glyph default commands and tasks</figcaption></figure> <p>As you can see:</p> <ul> <li>All commands call at at least one task.</li>@@ -99,13 +102,25 @@
</aside> </section> - <nav><a href="/glyph/book/extending/further_reading.html">Further Reading ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/task.html">→ Defining Custom Tasks</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/extending/further_reading.html">Further Reading</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/task.html">Defining Custom Tasks</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -113,50 +128,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,82 +1,98 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Further Reading – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Further Reading - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Further Reading</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Further Reading</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/extending/layouts.html">Layouts ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/commands_tasks.html">→ Defining Custom Commands and Tasks</a></nav> + <nav class="navigation"><a href="/glyph/book/extending/layouts.html">Layouts</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/commands_tasks.html">Defining Custom Commands and Tasks</a></nav> <p>For more examples on how to create more complex macros, have a look at the <a href="http://github.com/h3rald/glyph/tree/master/macros/">source code</a> of the existing ones.</p> <p>To gain a deeper understanding on how macros are executed, have a look at the following Glyph classes:</p> <ul> - <li><a href="http://yardoc.org/docs/h3rald-glyph/Glyph/Parser"><code>Glyph::Parser</code></a></li> - <li><a href="http://yardoc.org/docs/h3rald-glyph/Glyph/SyntaxNode"><code>Glyph::SyntaxNode</code></a></li> - <li><a href="http://yardoc.org/docs/h3rald-glyph/Glyph/Interpreter"><code>Glyph::Interpreter</code></a></li> - <li><a href="http://yardoc.org/docs/h3rald-glyph/Glyph/Document"><code>Glyph::Document</code></a></li> - <li><a href="http://yardoc.org/docs/h3rald-glyph/Glyph/Macro"><code>Glyph::Macro</code></a></li> + <li><a href="http://rubydoc.info/gems/glyph/Glyph/Parser"><code>Glyph::Parser</code></a></li> + <li><a href="http://rubydoc.info/gems/glyph/Glyph/SyntaxNode"><code>Glyph::SyntaxNode</code></a></li> + <li><a href="http://rubydoc.info/gems/glyph/Glyph/Interpreter"><code>Glyph::Interpreter</code></a></li> + <li><a href="http://rubydoc.info/gems/glyph/Glyph/Document"><code>Glyph::Document</code></a></li> + <li><a href="http://rubydoc.info/gems/glyph/Glyph/Macro"><code>Glyph::Macro</code></a></li> </ul> - <nav><a href="/glyph/book/extending/layouts.html">Layouts ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/commands_tasks.html">→ Defining Custom Commands and Tasks</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/extending/layouts.html">Layouts</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/commands_tasks.html">Defining Custom Commands and Tasks</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -84,50 +100,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,80 +1,83 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>A quick look at Glyph's internals – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>A quick look at Glyph's internals - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>A quick look at Glyph's internals</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>A quick look at Glyph's internals</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/stats/links.html">Link Statistics ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/macro_def.html">→ Defining Custom Macros</a></nav> - <p>If you plan on extending Glyph, knowing how it works inside helps. It is not mandatory by any means, but it definitely helps, especially when creating complex macros.</p> - <p>What happens behind the scenes when you call <code>glyph compile</code>? Glyph's code is parsed, analyzed and then translated into text, and here's how:</p> - <figure><img alt="-" src="/glyph/book/images/glyph/document_generation.png" /> - <figcaption>A sequence diagram for document generation</figcaption></figure> - <p>From the diagram, it is possible to divide the document generation process into three phases:</p> + <nav class="navigation"><a href="/glyph/book/stats/links.html">Link Statistics</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/macro_def.html">Defining Custom Macros</a></nav> + <p>If you plan on extending Glyph, knowing how it works inside helps. It is not mandatory by any means, but it definitely helps, especially when creating complex macros.</p> + <p>What happens behind the scenes when you call <code>glyph compile</code>? Glyph's code is parsed, analyzed and then translated into text, and here's how:</p> + <figure><img src="/glyph/book/images/glyph/document_generation.png" /><figcaption>A sequence diagram for document generation</figcaption></figure> + <p>From the diagram, it is possible to divide the document generation process into three phases:</p> <ul> - <li>The <em>Parsing Phase</em> starts when a chunk of Glyph code is passed (by the <code>generate:document</code> Rake task, for example) to a <a href="http://yardoc.org/docs/h3rald-glyph/Glyph/Interpreter"><code>Glyph::Interpreter</code></a>. The interpreter initializes a <a href="http://yardoc.org/docs/h3rald-glyph/Glyph/Parser"><code>Glyph::Parser</code></a> that parses the code and returns an <em>Abstract Syntax Tree</em> (<span class="caps">AST</span>) of <a href="http://yardoc.org/docs/h3rald-glyph/Glyph/SyntaxNode"><code>Glyph::SyntaxNode</code></a> objects.</li> - <li>The <em>Analysis Phase</em> (Processing) starts when the interpreter method calls the <code>analyze</code> method, instantiating a new <a href="http://yardoc.org/docs/h3rald-glyph/Glyph/Document"><code>Glyph::Document</code></a>. The <code>Glyph::Document</code> object evaluates the <span class="caps">AST</span> expanding all macro nodesth (that’s when macros are executed) and generates string.</li> + <li>The <em>Parsing Phase</em> starts when a chunk of Glyph code is passed (by the <code>generate:document</code> Rake task, for example) to a <a href="http://rubydoc.info/gems/glyph/Glyph/Interpreter"><code>Glyph::Interpreter</code></a>. The interpreter initializes a <a href="http://rubydoc.info/gems/glyph/Glyph/Parser"><code>Glyph::Parser</code></a> that parses the code and returns an <em>Abstract Syntax Tree</em> (<span class="caps">AST</span>) of <a href="http://rubydoc.info/gems/glyph/Glyph/SyntaxNode"><code>Glyph::SyntaxNode</code></a> objects.</li> + <li>The <em>Analysis Phase</em> (Processing) starts when the interpreter method calls the <code>analyze</code> method, instantiating a new <a href="http://rubydoc.info/gems/glyph/Glyph/Document"><code>Glyph::Document</code></a>. The <code>Glyph::Document</code> object evaluates the <span class="caps">AST</span> expanding all macro nodesth (that’s when macros are executed) and generates string.</li> <li>The <em>Finalization Phase</em> (Post-Processing) starts when the interpreter calls the <code>finalyze</code> method, causing the <code>Glyph::Document</code> object to perform a series of finalizations on the string obtained after analysis, i.e. it replaces escape sequences and placeholders.</li> </ul> - <section class="section"> -<header><h1 id="h_74">Example: A short note</h1></header> + <section class="section"> +<header><h1 id="h_84">Example: A short note</h1></header> <p>As an example, consider the following Glyph code:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> fmi[something|#test] <span class="no">2</span> ... <span class="no">3</span> section[@@ -84,8 +87,8 @@ <span class="no">6</span> ...
<span class="no">7</span> ]</pre></div> </div> - <p>This simple snippet uses the <a href="/glyph/book/macros/macros_inline.html#m_fmi"><code>fmi</code></a> macro to link to a section later on in the document. When parsed, the produced AST is the following:</p> - <div class="CodeRay"> + <p>This simple snippet uses the <a href="/glyph/book/macros/macros_inline.html#m_fmi"><code>fmi</code></a> macro to link to a section later on in the document. When parsed, the produced AST is the following:</p> + <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> {<span class="sy">:name</span>=><span class="sy"><span class="sy">:</span><span class="dl">"</span><span class="k">--</span><span class="dl">"</span></span>} <span class="no"> 2</span> {<span class="sy">:name</span>=><span class="sy">:fmi</span>, <span class="sy">:escape</span>=><span class="pc">false</span>} <span class="no"> 3</span> {<span class="sy">:name</span>=><span class="sy"><span class="sy">:</span><span class="dl">"</span><span class="k">0</span><span class="dl">"</span></span>}@@ -112,25 +115,27 @@ <span class="no">23</span> {<span class="sy">:name</span>=><span class="sy">:id</span>, <span class="sy">:escape</span>=><span class="pc">false</span>}
<span class="no">24</span> {<span class="sy">:value</span>=><span class="s"><span class="dl">"</span><span class="k">test</span><span class="dl">"</span></span>}</pre></div> </div> - <p>This output is produced by calling the <code>inspect</code> method on the AST. Each <a href="http://yardoc.org/docs/h3rald-glyph/Glyph/SyntaxNode"><code>Glyph::SyntaxNode</code></a> object in the tree is basically an ordinary Glyph Hash with a parent and 0 or more chidren, so the code snippets above shows how the syntax nodes are nested.</p> - <p>The AST contains information about macro, parameter and attribute names, and escaping, and raw text values (the nodes without a <code>:name</code> key), but nothing more.</p> - <p>When the AST is analyzed, the resulting textual output is the following:</p> - <div class="CodeRay"> + <p>This output is produced by calling the <code>inspect</code> method on the AST. Each <a href="http://rubydoc.info/gems/glyph/Glyph/SyntaxNode"><code>Glyph::SyntaxNode</code></a> object in the tree is basically an ordinary Glyph Hash with a parent and 0 or more chidren, so the code snippets above shows how the syntax nodes are nested.</p> + <p>The AST contains information about macro, parameter and attribute names, and escaping, and raw text values (the nodes without a <code>:name</code> key), but nothing more.</p> + <p>When the AST is analyzed, the resulting textual output is the following:</p> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> <span class="ta"><span</span> <span class="an">class</span>=<span class="s"><span class="dl">"</span><span class="k">fmi</span><span class="dl">"</span></span><span class="ta">></span>for more information on something, see ‡‡‡‡‡PLACEHOLDER ¤ 1‡‡‡‡‡ <span class="no">2</span> <span class="ta"></span></span> -<span class="no">3</span> \.[...\.] +<span class="no">3</span> \/[...\/] <span class="no">4</span> <span class="ta"><div</span> <span class="an">class</span>=<span class="s"><span class="dl">"</span><span class="k">section</span><span class="dl">"</span></span><span class="ta">></span> <span class="no">5</span> <span class="ta"><h2</span> <span class="an">id</span>=<span class="s"><span class="dl">"</span><span class="k">test</span><span class="dl">"</span></span><span class="ta">></span>Test Section<span class="ta"></h2></span> -<span class="no">6</span> \.[...\.] +<span class="no">6</span> \/[...\/] <span class="no">7</span> <span class="no">8</span> <span class="ta"></div></span></pre></div> </div> - <p>This looks almost perfect, except that:</p> - <ul><li>There's a nasty placeholder instead of a link: this is due to the fact that when the link is processed, there is no <code>#text</code> anchor in the document, but there may be one afterwards (and there will be).</li> - <li>There are some escaped brackets.</li></ul> - <p>Finally, when the document is finalized, placeholders and escape sequences are removed and the final result is the following:</p> - <div class="CodeRay"> + <p>This looks almost perfect, except that:</p> + <ul> + <li>There's a nasty placeholder instead of a link: this is due to the fact that when the link is processed, there is no <code>#text</code> anchor in the document, but there may be one afterwards (and there will be).</li> + <li>There are some escaped brackets.</li> + </ul> + <p>Finally, when the document is finalized, placeholders and escape sequences are removed and the final result is the following:</p> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> <span class="ta"><span</span> <span class="an">class</span>=<span class="s"><span class="dl">"</span><span class="k">fmi</span><span class="dl">"</span></span><span class="ta">></span>for more information on something, <span class="no">2</span> see <span class="ta"><a</span> <span class="an">href</span>=<span class="s"><span class="dl">"</span><span class="k">#test</span><span class="dl">"</span></span><span class="ta">></span>Test Section<span class="ta"></a></span><span class="ta"></span></span> <span class="no">3</span> [...]@@ -142,13 +147,25 @@ <span class="no">8</span> <span class="ta"></div></span></pre></div>
</div> </section> - <nav><a href="/glyph/book/stats/links.html">Link Statistics ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/macro_def.html">→ Defining Custom Macros</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/stats/links.html">Link Statistics</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/macro_def.html">Defining Custom Macros</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -156,50 +173,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Interpreting Glyph Code – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Interpreting Glyph Code - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Interpreting Glyph Code</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Interpreting Glyph Code</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/extending/validators.html">Using Validators ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/layouts.html">→ Layouts</a></nav> + <nav class="navigation"><a href="/glyph/book/extending/validators.html">Using Validators</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/layouts.html">Layouts</a></nav> <p>What if you need to evaluate some Glyph code <em>within</em> a macro? Say for example you want to transform a parameter in a link, and you want to make sure that link gets validated exactly like the others, in this case, you can use the <code>interpret</code> method, as follows:</p>@@ -78,46 +82,93 @@
<p>When the <code>interpret</code> method is called, the following happens:</p> <ol> <li>A new Glyph document is created from the <code>String</code> passed to the method.</li> - <li>The bookmarks, headers and placeholders are passed from the main document to the new one. Because they are stored in arrays and hashes, they are passed by reference, so for example any new bookmark stored in the new document will also become available in the main document.</li> + <li>Document-specific objects (bookmarks, headers, snippet, fragments, placeholders, etc.) are passed from the main document to the new one. Because they are stored in arrays and hashes, they are passed by reference, so for example any new bookmark stored in the new document will also become available in the main document.</li> <li>Any macro included in the <code>String</code> is evaluated, and the resulting text is returned by the method. Note that this new document does not get finalized: in other words, placeholders will be left as they are, and they’ll eventually be replaced when <em>the main document</em> is finalized.</li> </ol> + <section class="section"> +<header><h1 id="h_94">Dispatching</h1></header> +<p><a href="/glyph/book/text_editing/macro_composition.html#composition">Macro Composition</a> can be useful to remove nesting, but you can also use it to create your own macro <em>dispatchers</em>. What is a macro dispatcher? The easies way to understand this is by looking at the source code of one of them, the <a href="/glyph/book/macros/macros_core.html#m_s"><code>s</code></a> macro:</p> + <div class="CodeRay"> + <div class="code"><pre><span class="no"> 1</span> macro <span class="sy">:s</span> <span class="r">do</span> +<span class="no"> 2</span> dispatch <span class="r">do</span> |node| +<span class="no"> 3</span> forbidden = [<span class="sy">:each</span>, <span class="sy">:each_line</span>, <span class="sy">:each_byte</span>, <span class="sy">:upto</span>, <span class="sy">:intern</span>, <span class="sy">:to_sym</span>, <span class="sy">:to_f</span>] +<span class="no"> 4</span> meth = node[<span class="sy">:name</span>] +<span class="no"> 5</span> infer_type = lambda <span class="r">do</span> |str| +<span class="no"> 6</span> <span class="c"># Code omitted...</span> +<span class="no"> 7</span> <span class="r">end</span> +<span class="no"> 8</span> macro_error <span class="s"><span class="dl">"</span><span class="k">Macro 's/</span><span class="il"><span class="idl">#{</span>meth<span class="idl">}</span></span><span class="k">' takes at least one parameter</span><span class="dl">"</span></span> <span class="r">unless</span> node.params.length > <span class="i">0</span> +<span class="no"> 9</span> macro_error <span class="s"><span class="dl">"</span><span class="k">String method '</span><span class="il"><span class="idl">#{</span>meth<span class="idl">}</span></span><span class="k">' is not supported</span><span class="dl">"</span></span> <span class="r">if</span> meth.in?(forbidden) || meth.to_s.match(<span class="rx"><span class="dl">/</span><span class="k">!$</span><span class="dl">/</span></span>) +<span class="no"><strong>10</strong></span> str = node.param(<span class="i">0</span>).evaluate(node, <span class="sy">:params</span> => <span class="pc">true</span>) +<span class="no">11</span> <span class="r">begin</span> +<span class="no">12</span> <span class="r">if</span> node.param(<span class="i">1</span>) <span class="r">then</span> +<span class="no">13</span> meth_params = node.params[<span class="i">1</span>..node.params.length-<span class="i">1</span>].map <span class="r">do</span> |p| +<span class="no">14</span> infer_type.call(p.evaluate(node, <span class="sy">:params</span> => <span class="pc">true</span>)) +<span class="no">15</span> <span class="r">end</span> +<span class="no">16</span> str.send(meth, *meth_params).to_s +<span class="no">17</span> <span class="r">else</span> +<span class="no">18</span> str.send(meth).to_s +<span class="no">19</span> <span class="r">end</span> +<span class="no"><strong>20</strong></span> <span class="r">rescue</span> <span class="co">Exception</span> => e +<span class="no">21</span> <span class="c"># Code omittted</span> +<span class="no">22</span> <span class="r">end</span> +<span class="no">23</span> <span class="r">end</span> +<span class="no">24</span> <span class="r">end</span></pre></div> +</div> + + <p>See the <code>dispatch</code> method at the very beginning? This method takes a block with a <code>node</code> parameter, corresponding to the MacroNode of the macro which is being composed with <code>s</code>. So, for example, if you write <code>s/sub[my string|/my/|your]</code> the node of a macro called <code>sub</code> will be passed to the block. Of course there’s no <code>sub</code> macro defined in Glyph, but it doesn’t matter: its name will be interpreted as the name of a method of the Ruby String class in this case, so no worries.</p> +<p>Got it? Tricky, but damn useful to create your own “dynamic” macros.</p> + +</section> + <section class="section"> -<header><h1 id="rewriting">Rewriting</h1></header> -<p>While the <code>interpret</code> method is useful to evaluate Glyph code in a macro while performing other actions (storing a bookmark, checking for the presence of an anchor, etc.), in some cases it may not be necessary. If you simply want your macro to be converted into existing Glyph macro without performing any action excepting parameter substitution, you can just use the <a href="/glyph/book/macros/macros_core.html#m_rewrite_"><code>rewrite:</code></a> macro within youy Glyph document</p> +<header><h1 id="rewriting">Defining macros using Glyph</h1></header> +<p>While the <code>interpret</code> method is useful to evaluate Glyph code in a macro while performing other actions (storing a bookmark, checking for the presence of an anchor, etc.), in some cases it may not be necessary. If you simply want your macro to be converted into existing Glyph macro without performing any action excepting parameter substitution, you can just use the <a href="/glyph/book/macros/macros_core.html#m_define_"><code>define:</code></a> macro within your Glyph document</p> <p>Consider the following macro definition:</p> <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> macro <span class="sy">:issue</span> <span class="r">do</span> <span class="no">2</span> interpret <span class="s"><span class="dl">%{</span><span class="k"> <span class="no">3</span> tr[ -<span class="no">4</span> td[.=>[http://github.com/h3rald/glyph/issues/closed#issue/</span><span class="il"><span class="idl">#{</span>param[<span class="i">0</span>]<span class="idl">}</span></span><span class="k">|#</span><span class="il"><span class="idl">#{</span>param(<span class="i">0</span>)<span class="idl">}</span></span><span class="k">]] +<span class="no">4</span> td[/=>[http://github.com/h3rald/glyph/issues/closed#issue/</span><span class="il"><span class="idl">#{</span>param[<span class="i">0</span>]<span class="idl">}</span></span><span class="k">|#</span><span class="il"><span class="idl">#{</span>param(<span class="i">0</span>)<span class="idl">}</span></span><span class="k">]] <span class="no">5</span> td[txt[</span><span class="il"><span class="idl">#{</span>param(<span class="i">1</span>)<span class="idl">}</span></span><span class="k">]] <span class="no">6</span> ] <span class="no">7</span> </span><span class="dl">}</span></span> <span class="no">8</span> <span class="r">end</span></pre></div> </div> - <p>The <code>issue</code> macro is only rewriting existing Glyph code around the two parameters provided. In this case, it is possible to do exactly the same thing using the <a href="/glyph/book/macros/macros_core.html#m_rewrite_"><code>rewrite:</code></a> macro:</p> + <p>The <code>issue</code> macro is only rewriting existing Glyph code around the two parameters provided. In this case, it is possible to do exactly the same thing using the <a href="/glyph/book/macros/macros_core.html#m_define_"><code>define:</code></a> macro (aliased by @def:@):</p> <div class="CodeRay"> - <div class="code"><pre><span class="no">1</span> rewrite:[issue| + <div class="code"><pre><span class="no">1</span> define:[issue| <span class="no">2</span> tr[ -<span class="no">3</span> td[.=<span class="er">></span>[http://github.com/h3rald/glyph/issues/closed#issue/{{0}}|#{{0}}]] +<span class="no">3</span> td[/=<span class="er">></span>[http://github.com/h3rald/glyph/issues/closed#issue/{{0}}|#{{0}}]] <span class="no">4</span> td[txt[{{1}}]] <span class="no">5</span> ] <span class="no">6</span> ]</pre></div> </div> - <p>Within the <a href="/glyph/book/macros/macros_core.html#m_rewrite_"><code>rewrite:</code></a> macro, it is possible to use a special syntax to call the <code>raw_attr</code> or <code>raw_param</code> methods: <br /> + <p>Within the <a href="/glyph/book/macros/macros_core.html#m_define_"><code>define:</code></a> macro, it is possible to use a special syntax to call the <code>raw_attr</code> or <code>raw_param</code> methods: <br /> <code>{{</code><em>parameter_number</em> or <em>attribute_name</em><code>}}</code></p> </section> - <nav><a href="/glyph/book/extending/validators.html">Using Validators ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/layouts.html">→ Layouts</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/extending/validators.html">Using Validators</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/layouts.html">Layouts</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -125,50 +176,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Layouts – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Layouts - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Layouts</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Layouts</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/extending/interpreting.html">Interpreting Glyph Code ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/further_reading.html">→ Further Reading</a></nav> + <nav class="navigation"><a href="/glyph/book/extending/interpreting.html">Interpreting Glyph Code</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/further_reading.html">Further Reading</a></nav> <p>When generating <a href="/glyph/book/text_editing/topics.html#topics">topic</a>-based outputs, Glyph uses <em>layouts</em> to render topics as standalone documents. By default, the following two layout are used:</p> <ul> <li><code>topic</code> — used to render standard topics.</li>@@ -68,7 +72,7 @@ <li><code>index</code> — used to render the index page of your document.</li>
</ul> <p>Layouts are nothing more than “fancy” Glyph macros defined using the Glyph language (i.e. by using <a href="/glyph/book/extending/interpreting.html#rewriting">macro rewriting</a>) within a single <code>.glyph</code> file.</p> <section class="section"> -<header><h1 id="h_85">Topic Layout</h1></header> +<header><h1 id="h_97">Topic Layout</h1></header> <p>The default layout used to render all web topics (the layout used for web5 topics is very similar) is defined as follows:</p> <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> document[@@ -122,7 +126,7 @@ <p>Index layouts do not take any attribute or parameter (basically because they are used to produce only one page).</p>
</section> <section class="section"> -<header><h1 id="h_87">Creating a Custom Layout</h1></header> +<header><h1 id="h_99">Creating a Custom Layout</h1></header> <p>To create a custom layout, proceed as follows:</p> <ul> <li>Create a <code>.glyph</code> file in the <code>lib/layouts</code> directory, within your project, e.g. <code>mytopic.glyph</code></li>@@ -136,13 +140,25 @@ </aside>
</section> - <nav><a href="/glyph/book/extending/interpreting.html">Interpreting Glyph Code ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/further_reading.html">→ Further Reading</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/extending/interpreting.html">Interpreting Glyph Code</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/further_reading.html">Further Reading</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -150,50 +166,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,67 +1,71 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Defining Custom Macros – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Defining Custom Macros - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Defining Custom Macros</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Defining Custom Macros</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/extending/internals.html">A quick look at Glyph's internals ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/params_attrs.html">→ Parameters and Attributes</a></nav> - <p>Glyph was created wih extensibility in mind. You can freely extend Glyph Language by creating or overriding macros, to do whatever you like. Macro definitions are written in pure Ruby code and placed in <code>.rb</code> files within the <code>lib/macros/</code> folder of your project.</p> + <nav class="navigation"><a href="/glyph/book/extending/internals.html">A quick look at Glyph's internals</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/params_attrs.html">Parameters and Attributes</a></nav> + <p>Glyph was created wih extensibility in mind. You can freely extend Glyph Language by creating or overriding macros, to do whatever you like. Macro definitions are written in pure Ruby code and placed in <code>.rb</code> files within the <code>lib/macros/</code> folder of your project.</p> <aside class="box"> <div class="box-title">Alternative Ways to Define Macros</div> <p>You can also define macros:</p>@@ -71,7 +75,7 @@ <li>Using the <a href="/glyph/book/macros/macros_core.html#m_include"><code>include</code></a> macro specifying the path to an <code>.rb</code> file containing macro definitions stored in the <code>lib/</code> directory (useful especially when <a href="/glyph/book/compiling/lite_mode.html#lite_mode">compiling single Glyph files</a>).</li>
</ul> </aside> <p>This is the source code of a fairly simple macro used to format a note:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> macro <span class="sy">:note</span> <span class="r">do</span> <span class="no">2</span> <span class="s"><span class="dl">%{</span><span class="k"><div class="</span><span class="il"><span class="idl">#{</span><span class="iv">@name</span><span class="idl">}</span></span><span class="k">"><span class="note-title"></span><span class="il"><span class="idl">#{</span><span class="iv">@name</span>.to_s.capitalize<span class="idl">}</span></span><span class="k"></span> <span class="no">3</span> </span><span class="il"><span class="idl">#{</span><span class="iv">@value</span><span class="idl">}</span></span><span class="k">@@ -80,19 +84,24 @@ <span class="no">5</span> </div></span><span class="dl">}</span></span>
<span class="no">6</span> <span class="r">end</span></pre></div> </div> - <p>The <code>macro</code> method takes a single <code>Symbol</code> or <code>String</code> parameter, corresponding to the name of the macro. In this case, the entire block (or <em>body</em> of the macro) is a <code>String</code> corresponding to what we want the macro to evaluate to: a <code><div></code> tag containing a note.</p> -<p>The body of the macro is evaluated in the context of the <a href="http://yardoc.org/docs/h3rald-glyph/Glyph/Macro"><code>Glyph::Macro</code></a> class, therefore its instance variables (like <code>@name</code> or <code>@value</code>) can be used directly.</p> + <p>The <code>macro</code> method takes a single <code>Symbol</code> or <code>String</code> parameter, corresponding to the name of the macro. In this case, the entire block (or <em>body</em> of the macro) is a <code>String</code> corresponding to what we want the macro to evaluate to: a <code><div></code> tag containing a note.</p> +<p>The body of the macro is evaluated in the context of the <a href="http://rubydoc.info/gems/glyph/Glyph/Macro"><code>Glyph::Macro</code></a> class, therefore its instance variables (like <code>@name</code> or <code>@value</code>) can be used directly.</p> <aside class="box"> <div class="box-title">Why using <code>@name</code> instead of just “note”?</div> <p>For the <code>note</code> macro, it absolutely makes no difference. However, by using <code>@name</code> it is possible to re-use the same code for the <code>tip</code>, <code>important</code> and <code>caution</code> macros as well, which are in fact only aliases of the <code>note</code> macro.</p> </aside> <p>The following table lists all the instance variables that can be used inside macros:</p> - <table><tr><th>Variable</th> - <th>Description</th></tr> - <tr><td> + <table> + <tr> + <th>Variable</th> + <th>Description</th> + </tr> + <tr> + <td> <code>@node</code> </td> - <td><p>A <a href="http://yardoc.org/docs/h3rald-glyph/Glyph/MacroNode"><code>Glyph::MacroNode</code></a> containing information about the macro. Useful for accessing parent and child macros, and the current <a href="http://yardoc.org/docs/h3rald-glyph/Glyph/Document"><code>Glyph::Document</code></a>. Normally, instances of the <code>MacroNode</code> class contain the following keys:</p> + <td> + <p>A <a href="http://rubydoc.info/gems/glyph/Glyph/MacroNode"><code>Glyph::MacroNode</code></a> containing information about the macro. Useful for accessing parent and child macros, and the current <a href="http://rubydoc.info/gems/glyph/Glyph/Document"><code>Glyph::Document</code></a>. Normally, instances of the <code>MacroNode</code> class contain the following keys:</p> <ul> <li><code>:name</code>, the name of the macro.</li> <li><code>:source</code>, a <code>String</code> identifying the source of the macro (a file, a snippet, etc.)</li>@@ -100,22 +109,90 @@ <li><code>:value</code>, the value of the macro (populated after the document has been parsed and analyzed).</li>
<li><code>:escape</code>, whether the macro is a <a href="/glyph/book/text_editing/esc_quot.html#esc_quot">quoting macro</a> or not.</li> <li><code>:document</code>, the instance of <code>Document</code> the macro is contained in (populated after the document has been parsed and analyzed).</li> </ul> -<p>Note that the first two keys can also be accessed via instance variables.</p></td></tr> - <tr><td> +<p>Note that the first two keys can also be accessed via instance variables.</p> + </td> + </tr> + <tr> + <td> <code>@name</code> </td> - <td>The name of the macro.</td></tr> - <tr><td> -<code>@source</code> + <td>The name of the macro.</td> + </tr> + <tr> + <td> +<code>@source_name</code> +</td> + <td>A <code>String</code> identifying the source of the macro (a file, a snippet, etc.).</td> + </tr> + <tr> + <td> +<code>@source_topic</code> +</td> + <td>A <code>String</code> identifying the source topic of the macro.</td> + </tr> + <tr> + <td> +<code>@source_file</code> </td> - <td>A <code>String</code> identifying the source of the macro (a file, a snippet, etc.).</td></tr></table> - <nav><a href="/glyph/book/extending/internals.html">A quick look at Glyph's internals ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/params_attrs.html">→ Parameters and Attributes</a></nav> - </section> - </article> + <td>A <code>String</code> identifying the source file of the macro.</td> + </tr> + </table> + <section class="section"> +<header><h1 id="h_86">Representations</h1></header> +<p>There’s a small problem with the code used to define the <code>note</code> macro in the previous section: what if I want to format notes using HTML5 instead of <span class="caps">HTML</span>, or another output format?</p> +<p>Glyph supports different output formats, therefore macros must be format-independent! In fact, this is the actual source of the <code>note</code> macro:</p> + <div class="CodeRay"> + <div class="code"><pre><span class="no">1</span> macro <span class="sy">:note</span> <span class="r">do</span> +<span class="no">2</span> <span class="iv">@data</span>[<span class="sy">:name</span>] = <span class="iv">@name</span> +<span class="no">3</span> <span class="iv">@data</span>[<span class="sy">:text</span>] = value +<span class="no">4</span> render +<span class="no">5</span> <span class="r">end</span></pre></div> +</div> + + <p>The <span class="caps">HTML</span> representation of the note macro is defined in the <code>macros/reps/html.rb</code> file as follows:</p> + <div class="CodeRay"> + <div class="code"><pre><span class="no">1</span> rep <span class="sy">:note</span> <span class="r">do</span> |data| +<span class="no">2</span> css_class = data[<span class="sy">:name</span>].to_s.match(<span class="rx"><span class="dl">/</span><span class="k">[a-z0-9_-]</span><span class="dl">/</span><span class="mod">i</span></span>) ? data[<span class="sy">:name</span>] : <span class="s"><span class="dl">"</span><span class="k">note</span><span class="dl">"</span></span> +<span class="no">3</span> <span class="s"><span class="dl">%{</span><span class="k"><div class="</span><span class="il"><span class="idl">#{</span>css_class<span class="idl">}</span></span><span class="k">"> +<span class="no">4</span> <span class="note-title"></span><span class="il"><span class="idl">#{</span>data[<span class="sy">:name</span>].to_s.capitalize<span class="idl">}</span></span><span class="k"></span></span><span class="il"><span class="idl">#{</span>data[<span class="sy">:text</span>]<span class="idl">}</span></span><span class="k"> +<span class="no">5</span> +<span class="no">6</span> </div></span><span class="dl">}</span></span> +<span class="no">7</span> <span class="r">end</span></pre></div> +</div> + + <p>The HTML5 representation of the note macro, on the other hand, is defined in the <code>macros/reps/html5.rb</code> file as follows:</p> + <div class="CodeRay"> + <div class="code"><pre><span class="no">1</span> rep <span class="sy">:note</span> <span class="r">do</span> |data| +<span class="no">2</span> css_class = data[<span class="sy">:name</span>].to_s.match(<span class="rx"><span class="dl">/</span><span class="k">[a-z0-9_-]</span><span class="dl">/</span><span class="mod">i</span></span>) ? data[<span class="sy">:name</span>] : <span class="s"><span class="dl">"</span><span class="k">note</span><span class="dl">"</span></span> +<span class="no">3</span> <span class="s"><span class="dl">%{</span><span class="k"><aside class="</span><span class="il"><span class="idl">#{</span>css_class<span class="idl">}</span></span><span class="k">"> +<span class="no">4</span> <span class="note-title"></span><span class="il"><span class="idl">#{</span>data[<span class="sy">:name</span>].to_s.capitalize<span class="idl">}</span></span><span class="k"></span></span><span class="il"><span class="idl">#{</span>data[<span class="sy">:text</span>]<span class="idl">}</span></span><span class="k"> +<span class="no">5</span> +<span class="no">6</span> </aside></span><span class="dl">}</span></span> +<span class="no">7</span> <span class="r">end</span></pre></div> +</div> +Note the different tags used to render the note. - <footer> - <section class="ads"> +</section> + <nav class="navigation"><a href="/glyph/book/extending/internals.html">A quick look at Glyph's internals</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/params_attrs.html">Parameters and Attributes</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -123,50 +200,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,71 +1,75 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Custom Output Formats – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Custom Output Formats - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Custom Output Formats</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Custom Output Formats</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/extending/task.html">Defining Custom Tasks ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/command.html">→ Defining Custom Commands</a></nav> + <nav class="navigation"><a href="/glyph/book/extending/task.html">Defining Custom Tasks</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/command.html">Defining Custom Commands</a></nav> <p>As shown in <a href="/glyph/book/extending/commands_tasks.html#cmd_tasks_arch">How Commands and Tasks work</a>, the <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command command calls specific tasks defined in the <code>generate:</code> Rake namespace to generate output files in a particular format.</p> <p>More specifically, when a <code>--format</code> option is specified, the command looks for a task with the same name within the <code>generate:</code> namespace. This makes adding new output formats to Glyph a fairly easy task, without the need to specify custom commands or similar.</p> <p>The following sections explain how the <code>h3rald</code> output format was created to integrate this book into the <a href="http://www.h3rald.com">H3RALD.com</a> website.</p> <section class="section"> -<header><h1 id="h_94">Output Configuration</h1></header> +<header><h1 id="h_106">Output Configuration</h1></header> <p>The first step required to add a new output format to Glyph is extending Glyph’s configuration by adding the appropriate output hash, as follows:</p> <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> <span class="sy">:output</span>:@@ -74,7 +78,7 @@ <span class="no"> 3</span> <span class="sy">:multifile</span>: <span class="er">true</span>
<span class="no"> 4</span> <span class="sy">:extension</span>: <span class="er">'.html'</span> <span class="no"> 5</span> <span class="sy">:filter_target</span>: <span class="er">'html'</span> <span class="no"> 6</span> <span class="sy">:base</span>: <span class="er">'/glyph/book/'</span> -<span class="no"> 7</span> <span class="sy">:macro_dirs</span>: [<span class="er">'html', 'html5']</span> +<span class="no"> 7</span> <span class="sy">:macro_rep</span>: <span class="er">html5</span> <span class="no"> 8</span> <span class="sy">:layout_dirs</span>: [<span class="er">'web5']</span> <span class="no"> 9</span> <span class="sy">:layouts</span>: <span class="no"><strong>10</strong></span> <span class="sy">:topic</span>: <span class="er">bookpage</span>@@ -93,7 +97,7 @@ </ul>
</section> <section class="section"> -<header><h1 id="h_95">Creating a 'generate:h3rald' task</h1></header> +<header><h1 id="h_107">Creating a 'generate:h3rald' task</h1></header> <p>The next (and final) step involves creating a custom <code>h3rald</code> task within the <code>generate:</code> namespace. This task can be placed in any <code>.rake</code> file within the <code>lib/tasks</code> directory:</p> <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> namespace <span class="sy">:generate</span> <span class="r">do</span>@@ -120,7 +124,7 @@ <span class="no">21</span> <span class="r">end</span>
<span class="no">22</span> (dir/<span class="s"><span class="dl">'</span><span class="k">glyph/book/images/glyph/glyph.eps</span><span class="dl">'</span></span>).unlink <span class="no">23</span> (dir/<span class="s"><span class="dl">'</span><span class="k">glyph/book/images/glyph/glyph.svg</span><span class="dl">'</span></span>).unlink <span class="no">24</span> <span class="c"># Create project page</span> -<span class="no">25</span> project = <span class="co">Glyph</span>.filter <span class="s"><span class="dl">%{</span><span class="k">layout:project[ +<span class="no">25</span> project = <span class="co">Glyph</span>.filter <span class="s"><span class="dl">%{</span><span class="k">layout/project[ <span class="no">26</span> @contents[</span><span class="il"><span class="idl">#{</span>file_load(<span class="co">Glyph</span>::<span class="co">PROJECT</span>/<span class="s"><span class="dl">'</span><span class="k">text/introduction.glyph</span><span class="dl">'</span></span>)<span class="idl">}</span></span><span class="k">] <span class="no">27</span> ]</span><span class="dl">}</span></span> <span class="no">28</span> file_write dir/<span class="s"><span class="dl">"</span><span class="k">glyph.textile</span><span class="dl">"</span></span>, project@@ -132,13 +136,25 @@ <p>In this case, this task does not actually renders files in a different format, it just moves the files generated by the @generate:web5@ task in different subdirectories.</p>
<p>Additionally, it also generates the <a href="http://www.h3rald.com/glyph/">Glyph project page</a> from the book's introduction (note the usage of a raw custom layout macro).</p> </section> - <nav><a href="/glyph/book/extending/task.html">Defining Custom Tasks ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/command.html">→ Defining Custom Commands</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/extending/task.html">Defining Custom Tasks</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/command.html">Defining Custom Commands</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -146,50 +162,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Parameters and Attributes – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Parameters and Attributes - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Parameters and Attributes</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Parameters and Attributes</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/extending/macro_def.html">Defining Custom Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/bookmarks_headers.html">→ Bookmarks and Headers</a></nav> + <nav class="navigation"><a href="/glyph/book/extending/macro_def.html">Defining Custom Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/bookmarks_headers.html">Bookmarks and Headers</a></nav> <p>Perhaps the most common things to do in a macro definition is accessing parameters and attributes. When doing so, it is important to consider whether we want to retrieve the <em>raw value</em> of and attribute or parameter or its <em>expanded value</em>. The difference between the two will become clearer in the following sections and also in the <a href="/glyph/book/extending/interpreting.html#interpreting">Interpreting Glyph Code</a> section.</p> <section class="section"> <header><h1 id="expanded_values">Accessing Expanded Values</h1></header>@@ -76,7 +80,7 @@ </ul>
</section> <section class="section"> -<header><h1 id="h_78">Accessing Raw Values</h1></header> +<header><h1 id="h_89">Accessing Raw Values</h1></header> <p>While accessing expanded values is simple and immediate, in some cases it may not produce the desired results. Consider the following macro definition:</p> <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> macro <span class="sy">:nest_section</span> <span class="r">do</span>@@ -129,13 +133,25 @@ <li><code>raw_attribute</code> (or <code>raw_attr</code>): Returns the attribute value of the attribute specified by name.</li>
</ul> </section> - <nav><a href="/glyph/book/extending/macro_def.html">Defining Custom Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/bookmarks_headers.html">→ Bookmarks and Headers</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/extending/macro_def.html">Defining Custom Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/bookmarks_headers.html">Bookmarks and Headers</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -143,50 +159,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,98 +1,126 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Using Placeholders – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Using Placeholders - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Using Placeholders</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Using Placeholders</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/extending/bookmarks_headers.html">Bookmarks and Headers ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/validators.html">→ Using Validators</a></nav> + <nav class="navigation"><a href="/glyph/book/extending/bookmarks_headers.html">Bookmarks and Headers</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/validators.html">Using Validators</a></nav> <p>Sometimes you may need to access some data that will not be available until the entire document has been fully parsed and analyzed. For example, in order to be able to validate internal links, it is necessary to know in advance if the bookmark ID referenced in the link exists or not, either before (that’s easy) or even <em>after</em> the link.</p> <p>Here’s the source code of the <a href="/glyph/book/macros/macros_inline.html#m_link"><code>link</code></a> macro:</p> <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> macro <span class="sy">:link</span> <span class="r">do</span> -<span class="no"> 2</span> href, title = <span class="iv">@params</span> -<span class="no"> 3</span> <span class="r">if</span> href.match <span class="rx"><span class="dl">/</span><span class="k">^#</span><span class="dl">/</span></span> <span class="r">then</span> -<span class="no"> 4</span> anc = href.gsub(<span class="rx"><span class="dl">/</span><span class="k">^#</span><span class="dl">/</span></span>, <span class="s"><span class="dl">'</span><span class="dl">'</span></span>).to_sym -<span class="no"> 5</span> bmk = bookmark? anc -<span class="no"> 6</span> <span class="r">if</span> bmk <span class="r">then</span> -<span class="no"> 7</span> title ||= bmk[<span class="sy">:title</span>] -<span class="no"> 8</span> <span class="r">else</span> -<span class="no"> 9</span> plac = placeholder <span class="r">do</span> |document| -<span class="no"><strong>10</strong></span> macro_error <span class="s"><span class="dl">"</span><span class="k">Bookmark '</span><span class="il"><span class="idl">#{</span>anc<span class="idl">}</span></span><span class="k">' does not exist</span><span class="dl">"</span></span> <span class="r">unless</span> document.bookmarks[anc] -<span class="no">11</span> document.bookmarks[anc][<span class="sy">:title</span>] -<span class="no">12</span> <span class="r">end</span> -<span class="no">13</span> title ||= plac -<span class="no">14</span> <span class="r">end</span> -<span class="no">15</span> <span class="r">end</span> -<span class="no">16</span> title ||= href -<span class="no">17</span> <span class="s"><span class="dl">%{</span><span class="k"><a href="</span><span class="il"><span class="idl">#{</span>href<span class="idl">}</span></span><span class="k">"></span><span class="il"><span class="idl">#{</span>title<span class="idl">}</span></span><span class="k"></a></span><span class="dl">}</span></span> -<span class="no">18</span> <span class="r">end</span></pre></div> +<span class="no"> 2</span> min_parameters <span class="i">1</span> +<span class="no"> 3</span> max_parameters <span class="i">2</span> +<span class="no"> 4</span> target = param <span class="i">0</span> +<span class="no"> 5</span> title = param <span class="i">1</span> +<span class="no"> 6</span> <span class="r">if</span> target.match <span class="rx"><span class="dl">/</span><span class="k">^#</span><span class="dl">/</span></span> <span class="r">then</span> +<span class="no"> 7</span> <span class="iv">@node</span>[<span class="sy">:document</span>].links << target +<span class="no"> 8</span> anchor = target.gsub <span class="rx"><span class="dl">/</span><span class="k">^#</span><span class="dl">/</span></span>, <span class="s"><span class="dl">'</span><span class="dl">'</span></span> +<span class="no"> 9</span> bmk = bookmark? anchor +<span class="no"><strong>10</strong></span> <span class="r">if</span> !bmk <span class="r">then</span> +<span class="no">11</span> placeholder <span class="r">do</span> |document| +<span class="no">12</span> bmk = document.bookmark?(anchor) +<span class="no">13</span> macro_error <span class="s"><span class="dl">"</span><span class="k">Bookmark '</span><span class="il"><span class="idl">#{</span>anchor<span class="idl">}</span></span><span class="k">' does not exist</span><span class="dl">"</span></span> <span class="r">unless</span> bmk +<span class="no">14</span> bmk_title = title +<span class="no">15</span> bmk_title = bmk.title <span class="r">if</span> bmk_title.blank? +<span class="no">16</span> <span class="iv">@data</span>[<span class="sy">:target</span>] = bmk.link(<span class="iv">@source_file</span>) +<span class="no">17</span> <span class="iv">@data</span>[<span class="sy">:title</span>] = bmk_title +<span class="no">18</span> render +<span class="no">19</span> <span class="r">end</span> +<span class="no"><strong>20</strong></span> <span class="r">else</span> +<span class="no">21</span> bmk_title = title +<span class="no">22</span> bmk_title = bmk.title <span class="r">if</span> bmk_title.blank? +<span class="no">23</span> <span class="iv">@data</span>[<span class="sy">:target</span>] = bmk.link(<span class="iv">@source_file</span>) +<span class="no">24</span> <span class="iv">@data</span>[<span class="sy">:title</span>] = bmk_title +<span class="no">25</span> render +<span class="no">26</span> <span class="r">end</span> +<span class="no">27</span> <span class="r">else</span> +<span class="no">28</span> <span class="c"># Code omitted...</span> +<span class="no">29</span> <span class="r">end</span> +<span class="no"><strong>30</strong></span> <span class="r">end</span></pre></div> </div> <p>If there’s already a bookmark stored in the current document, then it is possible to retrieve its title and use it as link text. Otherwise, it is necessary to wait until the entire document has been fully processed and then check if the bookmark exists. To do so, use the <code>placeholder</code> method. When called, this method returns an unique placeholder, which is then substituted with the value of the block, right before the document is finalized.</p> <p>Within the <code>placeholder</code> block, the <code>document</code> parameter is, by all means, the fully analyzed document.</p> - <nav><a href="/glyph/book/extending/bookmarks_headers.html">Bookmarks and Headers ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/validators.html">→ Using Validators</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/extending/bookmarks_headers.html">Bookmarks and Headers</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/validators.html">Using Validators</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -100,50 +128,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Defining Custom Tasks – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Defining Custom Tasks - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Defining Custom Tasks</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Defining Custom Tasks</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/extending/commands_tasks.html">Defining Custom Commands and Tasks ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/output_format.html">→ Custom Output Formats</a></nav> + <nav class="navigation"><a href="/glyph/book/extending/commands_tasks.html">Defining Custom Commands and Tasks</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/output_format.html">Custom Output Formats</a></nav> <p>Glyph relies on <a href="http://rake.rubyforge.org/">Rake</a> to perform most of its core operations. Typically, Rake tasks are used do define the high level logic that is used by Glyph commands to, for example, compile a project or load configuration files.</p> <p>Furthermore, Rake provides an easy mechanism to create dependencies among tasks: for example, to make sure that Glyph’s configuration files are loaded before everything else happens.</p> <section class="section">@@ -101,13 +105,25 @@ <p>That’s it. Note that this task is pretty useless without a command that calls it, and it won’t even show up if you run <code>rake -T</code> within your project directory. <span class="fmi">for more information on <mark>creating custom commands</mark>, see <a href="/glyph/book/extending/command.html#custom_command">Defining Custom Commands</a></span>.</p>
</section> - <nav><a href="/glyph/book/extending/commands_tasks.html">Defining Custom Commands and Tasks ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/output_format.html">→ Custom Output Formats</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/extending/commands_tasks.html">Defining Custom Commands and Tasks</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/output_format.html">Custom Output Formats</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -115,50 +131,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,67 +1,71 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Using Validators – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Using Validators - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Using Validators</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Using Validators</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/extending/placeholders.html">Using Placeholders ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/interpreting.html">→ Interpreting Glyph Code</a></nav> - <p>If you need to make sure that a macro is used properly, consider using <a href="http://yardoc.org/docs/h3rald-glyph/Glyph/Macro/Validators">validators</a>. These methods can be used anywhere within the macro code to check whether certain conditions are met or not. Some default validators are provided to check the number of parameters of a macro, and they are actually used in some system macros.</p> + <nav class="navigation"><a href="/glyph/book/extending/placeholders.html">Using Placeholders</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/interpreting.html">Interpreting Glyph Code</a></nav> + <p>If you need to make sure that a macro is used properly, consider using <a href="http://rubydoc.info/gems/glyph/Glyph/Macro/Validators">validators</a>. These methods can be used anywhere within the macro code to check whether certain conditions are met or not. Some default validators are provided to check the number of parameters of a macro, and they are actually used in some system macros.</p> <p>If you want to create your own validators, you can call the generic <code>validate</code> method which takes the message to display in case of error, a Hash of options and a block containing the validation to perform.</p> <aside class="box"> <div class="box-title">Validating macro placement</div>@@ -75,13 +79,25 @@ <p>Even if you consider all the possibilities within the scope of the default macros provided with Glyph, this could still make the <code>box</code> macro unusable within custom macros.</p>
<p>For the specific cases where a macro does not make sense unless is within another (e.g. the <a href="/glyph/book/macros/macros_core.html#m_eq"><code>eq</code></a> macro), a <code>within</code> validator is used. Note though, that this validator only checks that the macro is used within another, but it is not necessarily its child.</p> </aside> - <nav><a href="/glyph/book/extending/placeholders.html">Using Placeholders ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/interpreting.html">→ Interpreting Glyph Code</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/extending/placeholders.html">Using Placeholders</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/interpreting.html">Interpreting Glyph Code</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -89,50 +105,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Project Configuration – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Project Configuration - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Project Configuration</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Project Configuration</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/getting_started/structure.html">Document Structure ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/glyph_files.html">→ .glyph files</a></nav> + <nav class="navigation"><a href="/glyph/book/getting_started/structure.html">Document Structure</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/glyph_files.html">.glyph files</a></nav> <p>Glyph stores configuration settings in the following <span class="caps">YAML</span> files:</p> <ol>@@ -99,13 +103,25 @@ <p>Note that this guessing is far from being foolproof: If you type something like <em>{:test, 2}</em>, for example, you’ll get an error.</p>
</aside> <p>There are plenty of configuration settings that can be modified, but most of them are best if left alone (and in the System Configuration file).</p> <p>For a complete reference, see <a href="/glyph/book/document.html#cfg_ref">Configuration Reference</a>. For everyday use, you may just want to change the settings defined in the <a href="/glyph/book/config/document.html#cfg_document">document.*</a> namespace.</p> - <nav><a href="/glyph/book/getting_started/structure.html">Document Structure ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/glyph_files.html">→ .glyph files</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/getting_started/structure.html">Document Structure</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/glyph_files.html">.glyph files</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -113,50 +129,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Creating your first Glyph Project – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Creating your first Glyph Project - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Creating your first Glyph Project</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Creating your first Glyph Project</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/acknowledgements.html">Acknowledgements ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/getting_started/structure.html">→ Document Structure</a></nav> + <nav class="navigation"><a href="/glyph/book/acknowledgements.html">Acknowledgements</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/getting_started/structure.html">Document Structure</a></nav> <p>To install Glyph, simply run <code>gem install glyph</code>, like with any other Ruby gem. Then, create a new directory and initialize a new Glyph project, like so:</p> <p><code>mkdir</code> <em>test_document</em></p> <p><code>cd</code> <em>test_document</em></p>@@ -78,7 +82,7 @@ <p>Additionally, some Glyph macros may require additional gems, such as:</p>
<ul> <li>RedCloth (<a href="/glyph/book/macros/macros_filters.html#m_textile"><code>textile</code></a> macro)</li> <li>BlueCloth <em>or</em> RDiscount <em>or</em> Maruku <em>or</em> Kramdown (<a href="/glyph/book/macros/macros_filters.html#m_markdown"><code>markdown</code></a> macro)</li> - <li>Haml (if you want to load .sass files with the <a href="/glyph/book/macros/macros_structure.html#m_style"><code>style</code></a> macro)</li> + <li>Sass (if you want to load .sass files with the <a href="/glyph/book/macros/macros_structure.html#m_style"><code>style</code></a> macro)</li> <li>CodeRay <em>or</em> UltraViolet (<a href="/glyph/book/macros/macros_filters.html#m_highlight"><code>highlight</code></a> macro)</li> <li>directory_watcher (to use auto-regeneration with the <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command)</li> </ul>@@ -95,15 +99,26 @@ <p>Additionally, the following files are also created at top level:</p>
<ul> <li><code>config.yml</code> — containing your <a href="/glyph/book/getting_started/configuration.html#cfg">Project Configuration</a>.</li> <li><code>document.glyph</code> — containing the <a href="/glyph/book/getting_started/structure.html#struct">structure</a> of your document.</li> - <li><code>snippets.yml</code> — containing your text <a href="/glyph/book/text_editing/inclusions.html#incl">snippets</a>.</li> </ul> - <nav><a href="/glyph/book/acknowledgements.html">Acknowledgements ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/getting_started/structure.html">→ Document Structure</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/acknowledgements.html">Acknowledgements</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/getting_started/structure.html">Document Structure</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -111,50 +126,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Document Structure – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Document Structure - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Document Structure</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Document Structure</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/getting_started/create_project.html">Creating your first Glyph Project ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/getting_started/configuration.html">→ Project Configuration</a></nav> + <nav class="navigation"><a href="/glyph/book/getting_started/create_project.html">Creating your first Glyph Project</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/getting_started/configuration.html">Project Configuration</a></nav> <p>Every Glyph project contains a <code>document.glyph</code> file that is typically used to define the document structure. The default <code>document.glyph</code> generated automatically when creating a new project is the following:</p>@@ -110,15 +114,27 @@ <p>More specifically, in this <code>document.glyph</code> file:</p>
<ul> <li>The <a href="/glyph/book/macros/macros_structure.html#m_book"><code>book</code></a> macro wraps every other macro and is used to create the document header and default title page.</li> <li>Then, the <code>@frontmatter</code>, <code>@bodymatter</code>, and <code>@backmatter</code> attributes are used to divide the portions of your document according to the rules of <a href="http://en.wikipedia.org/wiki/Book_design">book design</a>. They are not mandatory, but they can be used, for example, to number your appendixes with letters instead of numbers and similar.</li> - <li><code>preface</code>, <code>chapter</code>, <code>appendix</code> are just a way to wrap content in <code><div></code> tags, from an <span class="caps">HTML</span> point of view, but they are also necessary to nest the content of your document and generate the Table of Contents automatically, together through <code>@title</code> attributes.</li> + <li><code>preface</code>, <code>chapter</code>, <code>appendix</code> are just a way to wrap content in <code><div></code> tags, from an <span class="caps">HTML</span> point of view (or <code><section></code> tags, in HTML5), but they are also necessary to nest the content of your document and generate the Table of Contents automatically, together through <code>@title</code> attributes.</li> </ul> - <nav><a href="/glyph/book/getting_started/create_project.html">Creating your first Glyph Project ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/getting_started/configuration.html">→ Project Configuration</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/getting_started/create_project.html">Creating your first Glyph Project</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/getting_started/configuration.html">Project Configuration</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -126,50 +142,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,89 +1,106 @@
-<!DOCTYPE html> -<html lang="en"> - <head> - <title>Glyph - Document Authoring Framework</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> +<!DOCTYPE html> +<html lang="en"> + <head> + <title>Glyph - Document Authoring Framework</title> + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Glyph - Document Authoring Framework</h1> - <h2>Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="glyph-index"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page"> + <header> + <hgroup> + <h1>Glyph - Document Authoring Framework</h1> + <h2>Documentation</h2> + + </hgroup> + +</header> + <section id="body-text" class="hyphenate glyph-index"> <nav class="contents"> <h1 class="toc-header" id="toc">Table of Contents</h1> <ol class="toc"> <li class="frontmatter introduction"><a href="/glyph/book/introduction.html#h_1">Introduction</a></li><li><ol><li class="frontmatter section"><a href="/glyph/book/license.html#h_12">License</a></li></ol></li> <li class="frontmatter acknowledgement"><a href="/glyph/book/acknowledgements.html#h_13">Acknowledgements</a></li><li class="bodymatter chapter">Getting Started</li><li><ol><li class="bodymatter section"><a href="/glyph/book/getting_started/create_project.html#h_15">Creating your first Glyph Project</a></li><li class="bodymatter section"><a href="/glyph/book/getting_started/structure.html#struct">Document Structure</a></li><li class="bodymatter section"><a href="/glyph/book/getting_started/configuration.html#cfg">Project Configuration</a></li></ol></li> -<li class="bodymatter chapter">Authoring Documents</li><li><ol><li class="bodymatter section"><a href="/glyph/book/text_editing/glyph_files.html#h_19">.glyph files</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/macro_intro.html#macro_intro">Introducing Glyph Macros</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/attribute_intro.html#attribute_intro">Macro attributes</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/esc_quot.html#esc_quot">Escaping and Quoting</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/sections.html#sec_head">Sections and Headers</a></li><li><ol><li class="bodymatter section"><a href="/glyph/book/text_editing/section_aliases.html#h_25">Section Aliases</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/topics.html#topics">Topics</a></li></ol></li> -<li class="bodymatter section"><a href="/glyph/book/text_editing/links.html#links">Links and Bookmarks</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/images.html#img_fig">Images and Figures</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/code.html#source_code">Source Code</a></li><li class="bodymatter section">Other HTML Elements</li><li><ol><li class="bodymatter section"><a href="/glyph/book/text_editing/raw_html.html#h_31">Textile or Markdown</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/xml_fallback.html#h_32">XML Fallback</a></li></ol></li> -<li class="bodymatter section"><a href="/glyph/book/text_editing/stylesheets.html#stylesheets">Adding Stylesheets</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/inclusions.html#incl">Including Files and Snippets</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/evaluation.html#h_37">Evaluating Ruby code and Configuration Settings</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/conditionals.html#cond_macros">Conditional Macros</a></li></ol></li> -<li class="bodymatter chapter">Generating Output Files</li><li><ol><li class="bodymatter section"><a href="/glyph/book/compiling/compiling.html#compile">Compiling a project</a></li><li class="bodymatter section"><a href="/glyph/book/compiling/lite_mode.html#lite_mode">Compiling single Glyph files</a></li><li class="bodymatter section"><a href="/glyph/book/compiling/programmatic_usage.html#h_48">Using Glyph programmatically</a></li></ol></li> -<li class="bodymatter chapter">Document Statistics</li><li><ol><li class="bodymatter section"><a href="/glyph/book/stats/stats.html#h_51">Using the stats command</a></li><li class="bodymatter section"><a href="/glyph/book/stats/macros.html#stats_macros">Macro Statistics</a></li><li class="bodymatter section"><a href="/glyph/book/stats/snippets.html#stats_snippets">Snippet Statistics</a></li><li class="bodymatter section"><a href="/glyph/book/stats/bookmarks.html#stats_bookmarks">Bookmark Statistics</a></li><li class="bodymatter section"><a href="/glyph/book/stats/links.html#stats_links">Link Statistics</a></li></ol></li> -<li class="bodymatter chapter">Extending Glyph</li><li><ol><li class="bodymatter section"><a href="/glyph/book/extending/internals.html#h_73">A quick look at Glyph's internals</a></li><li class="bodymatter section"><a href="/glyph/book/extending/macro_def.html#macro_def">Defining Custom Macros</a></li><li><ol><li class="bodymatter section"><a href="/glyph/book/extending/params_attrs.html#h_76">Parameters and Attributes</a></li><li class="bodymatter section"><a href="/glyph/book/extending/bookmarks_headers.html#h_79">Bookmarks and Headers</a></li><li class="bodymatter section"><a href="/glyph/book/extending/placeholders.html#h_80">Using Placeholders</a></li><li class="bodymatter section"><a href="/glyph/book/extending/validators.html#h_81">Using Validators</a></li><li class="bodymatter section"><a href="/glyph/book/extending/interpreting.html#interpreting">Interpreting Glyph Code</a></li><li class="bodymatter section"><a href="/glyph/book/extending/layouts.html#layouts">Layouts</a></li><li class="bodymatter section"><a href="/glyph/book/extending/further_reading.html#h_88">Further Reading</a></li></ol></li> -<li class="bodymatter section"><a href="/glyph/book/extending/commands_tasks.html#h_89">Defining Custom Commands and Tasks</a></li><li><ol><li class="bodymatter section"><a href="/glyph/book/extending/task.html#custom_task">Defining Custom Tasks</a></li><li class="bodymatter section"><a href="/glyph/book/extending/command.html#custom_command">Defining Custom Commands</a></li></ol></li> +<li class="bodymatter chapter">Authoring Documents</li><li><ol><li class="bodymatter section"><a href="/glyph/book/text_editing/glyph_files.html#h_19">.glyph files</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/macro_intro.html#macro_intro">Introducing Glyph Macros</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/attribute_intro.html#attribute_intro">Macro attributes</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/macro_composition.html#composition">Macro Composition</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/esc_quot.html#esc_quot">Escaping and Quoting</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/sections.html#sec_head">Sections and Headers</a></li><li><ol><li class="bodymatter section"><a href="/glyph/book/text_editing/section_aliases.html#h_26">Section Aliases</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/topics.html#topics">Topics</a></li></ol></li> +<li class="bodymatter section"><a href="/glyph/book/text_editing/links.html#links">Links and Bookmarks</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/images.html#img_fig">Images and Figures</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/code.html#source_code">Source Code</a></li><li class="bodymatter section">Other HTML Elements</li><li><ol><li class="bodymatter section"><a href="/glyph/book/text_editing/raw_html.html#h_32">Textile or Markdown</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/xml_fallback.html#h_33">XML Fallback</a></li></ol></li> +<li class="bodymatter section"><a href="/glyph/book/text_editing/stylesheets.html#stylesheets">Adding Stylesheets</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/inclusions.html#incl">Content Reuse</a></li><li><ol><li class="bodymatter section">Remarks</li></ol></li> +<li class="bodymatter section"><a href="/glyph/book/text_editing/conditionals.html#cond_macros">Conditional Macros</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/evaluation.html#h_44">Simple Programming and Code Evaluation</a></li><li><ol><li class="bodymatter section">Turing-completeness</li><li class="bodymatter section">Operations on integer values</li><li class="bodymatter section">Lexically-scoped attribute assignment</li><li class="bodymatter section">Evaluating Ruby code</li></ol></li> </ol></li> -<li class="bodymatter chapter">Troubleshooting</li><li><ol><li class="bodymatter section"><a href="/glyph/book/troubleshooting/errors_generic.html#h_99">Generic Errors</a></li><li class="bodymatter section"><a href="/glyph/book/troubleshooting/errors_parser.html#h_100">Parsing Errors</a></li><li class="bodymatter section"><a href="/glyph/book/troubleshooting/errors_command.html#h_101">Command Errors</a></li><li class="bodymatter section"><a href="/glyph/book/troubleshooting/errors_macro.html#h_102">Macro Errors</a></li></ol></li> -<li class="backmatter appendix"><a href="/glyph/book/ref_commands.html#cmd_ref">Command Reference</a></li><li class="backmatter appendix">Macro Reference</li><li><ol><li class="appendix section"><a href="/glyph/book/macros/macros_core.html#h_123">Core Macros</a></li><li class="appendix section"><a href="/glyph/book/macros/macros_block.html#h_169">Block Macros</a></li><li class="appendix section"><a href="/glyph/book/macros/macros_inline.html#h_189">Inline Macros</a></li><li class="appendix section"><a href="/glyph/book/macros/macros_filters.html#f_macros">Filter Macros</a></li><li class="appendix section"><a href="/glyph/book/macros/macros_structure.html#h_212">Structure Macros</a></li></ol></li> +<li class="bodymatter chapter">Generating Output Files</li><li><ol><li class="bodymatter section"><a href="/glyph/book/compiling/compiling.html#compile">Compiling a project</a></li><li class="bodymatter section"><a href="/glyph/book/compiling/lite_mode.html#lite_mode">Compiling single Glyph files</a></li><li class="bodymatter section"><a href="/glyph/book/compiling/programmatic_usage.html#h_58">Using Glyph programmatically</a></li></ol></li> +<li class="bodymatter chapter">Document Statistics</li><li><ol><li class="bodymatter section"><a href="/glyph/book/stats/stats.html#h_61">Using the stats command</a></li><li class="bodymatter section"><a href="/glyph/book/stats/macros.html#stats_macros">Macro Statistics</a></li><li class="bodymatter section"><a href="/glyph/book/stats/snippets.html#stats_snippets">Snippet Statistics</a></li><li class="bodymatter section"><a href="/glyph/book/stats/bookmarks.html#stats_bookmarks">Bookmark Statistics</a></li><li class="bodymatter section"><a href="/glyph/book/stats/links.html#stats_links">Link Statistics</a></li></ol></li> +<li class="bodymatter chapter">Extending Glyph</li><li><ol><li class="bodymatter section"><a href="/glyph/book/extending/internals.html#h_83">A quick look at Glyph's internals</a></li><li class="bodymatter section"><a href="/glyph/book/extending/macro_def.html#macro_def">Defining Custom Macros</a></li><li><ol><li class="bodymatter section"><a href="/glyph/book/extending/params_attrs.html#h_87">Parameters and Attributes</a></li><li class="bodymatter section"><a href="/glyph/book/extending/bookmarks_headers.html#h_90">Bookmarks and Headers</a></li><li class="bodymatter section"><a href="/glyph/book/extending/placeholders.html#h_91">Using Placeholders</a></li><li class="bodymatter section"><a href="/glyph/book/extending/validators.html#h_92">Using Validators</a></li><li class="bodymatter section"><a href="/glyph/book/extending/interpreting.html#interpreting">Interpreting Glyph Code</a></li><li class="bodymatter section"><a href="/glyph/book/extending/layouts.html#layouts">Layouts</a></li><li class="bodymatter section"><a href="/glyph/book/extending/further_reading.html#h_100">Further Reading</a></li></ol></li> +<li class="bodymatter section"><a href="/glyph/book/extending/commands_tasks.html#h_101">Defining Custom Commands and Tasks</a></li><li><ol><li class="bodymatter section"><a href="/glyph/book/extending/task.html#custom_task">Defining Custom Tasks</a></li><li class="bodymatter section"><a href="/glyph/book/extending/command.html#custom_command">Defining Custom Commands</a></li></ol></li> +</ol></li> +<li class="bodymatter chapter">Troubleshooting</li><li><ol><li class="bodymatter section"><a href="/glyph/book/troubleshooting/errors_generic.html#h_111">Generic Errors</a></li><li class="bodymatter section"><a href="/glyph/book/troubleshooting/errors_parser.html#h_112">Parsing Errors</a></li><li class="bodymatter section"><a href="/glyph/book/troubleshooting/errors_command.html#h_113">Command Errors</a></li><li class="bodymatter section"><a href="/glyph/book/troubleshooting/errors_macro.html#h_114">Macro Errors</a></li></ol></li> +<li class="backmatter appendix"><a href="/glyph/book/ref_commands.html#cmd_ref">Command Reference</a></li><li class="backmatter appendix">Macro Reference</li><li><ol><li class="appendix section"><a href="/glyph/book/macros/macros_core.html#h_136">Core Macros</a></li><li class="appendix section"><a href="/glyph/book/macros/macros_block.html#h_212">Block Macros</a></li><li class="appendix section"><a href="/glyph/book/macros/macros_inline.html#h_232">Inline Macros</a></li><li class="appendix section"><a href="/glyph/book/macros/macros_filters.html#f_macros">Filter Macros</a></li><li class="appendix section"><a href="/glyph/book/macros/macros_structure.html#h_255">Structure Macros</a></li></ol></li> <li class="backmatter appendix">Configuration Reference</li><li><ol><li class="appendix section"><a href="/glyph/book/config/document.html#cfg_document">document.*</a></li><li class="appendix section"><a href="/glyph/book/config/filters.html#cfg_filters">filters.*</a></li><li class="appendix section"><a href="/glyph/book/config/options.html#cfg_options">options.*</a></li><li class="appendix section"><a href="/glyph/book/config/output.html#cfg_output">output.*</a></li></ol></li> -<li class="backmatter appendix"><a href="/glyph/book/changelog.html#h_240">Changelog</a></li> +<li class="backmatter appendix"><a href="/glyph/book/changelog.html#h_285">Changelog</a></li> </ol> </nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -91,50 +108,39 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Introduction – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Introduction - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Introduction</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Introduction</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/license.html">→ License</a></nav> + <nav class="navigation"> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/license.html">License</a></nav> <p>Glyph is a <em>Rapid Document Authoring Framework</em>.</p> <p>With Glyph, creating and maintaining any kind of document becomes as easy as… <em>programming</em>. Glyph enables you to minimize text duplication, focus on content rather than presentation, manage references seamlessly and automate tedious tasks through a simple but effective macro language, specifically geared towards customization and extensibility.</p> <section class="section">@@ -203,13 +207,25 @@ <li>Reference Documentation: <a href="http://rubydoc.info/gems/glyph/">http://rubydoc.info/gems/glyph/</a></li>
<li>User Group: <a href="http://groups.google.com/group/glyph-framework">http://groups.google.com/group/glyph-framework</a></li> </ul> </section> - <nav><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/license.html">→ License</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/license.html">License</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -217,50 +233,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>License – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>License - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>License</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - </header> - <article class="page"> - <header> - <hgroup> - <h1>License</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/introduction.html">Introduction ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/acknowledgements.html">→ Acknowledgements</a></nav> + <nav class="navigation"><a href="/glyph/book/introduction.html">Introduction</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/acknowledgements.html">Acknowledgements</a></nav> <p>Copyright © 2010 <strong>Fabio Cevasco</strong>, <a href="http://www.h3rald.com">http://www.h3rald.com</a></p> <p>Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal@@ -76,14 +80,27 @@ 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.</p> - <nav><a href="/glyph/book/introduction.html">Introduction ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/acknowledgements.html">→ Acknowledgements</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> +THE SOFTWARE. +</p> + <nav class="navigation"><a href="/glyph/book/introduction.html">Introduction</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/acknowledgements.html">Acknowledgements</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -91,50 +108,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Block Macros – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Block Macros - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Block Macros</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Block Macros</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/macros/macros_core.html">Core Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/macros/macros_inline.html">→ Inline Macros</a></nav> + <nav class="navigation"><a href="/glyph/book/macros/macros_core.html">Core Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/macros/macros_inline.html">Inline Macros</a></nav> <section class="section"> <header><h1 id="m_box">box</h1></header>@@ -68,19 +72,22 @@ <p>Creates a titled box (<code><div></code> tag).</p>
- <div class="example"><p> + <div class="example"> + <p> <strong>Example</strong> </p> <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> box[Why boxes?| <span class="no">2</span> Boxes can be used to make a section of text stand out from the rest of the document. <span class="no">3</span> ]</pre></div> -</div></div> +</div> + + </div> <section class="section"> -<header><h1 id="h_171">Parameters</h1></header> +<header><h1 id="h_214">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -110,7 +117,8 @@ <p>Used to render a block of code within <code><pre></code> and <code><code></code> tags.</p>
- <div class="example"><p> + <div class="example"> + <p> <strong>Example</strong> </p> <div class="CodeRay">@@ -119,12 +127,14 @@ <span class="no">2</span> def hello
<span class="no">3</span> puts "Hello World" <span class="no">4</span> end <span class="no">5</span> ]</pre></div> -</div></div> +</div> + + </div> <section class="section"> -<header><h1 id="h_173">Parameters</h1></header> +<header><h1 id="h_216">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -140,7 +150,7 @@ </section>
<section class="section"> -<header><h1 id="h_174">Remarks</h1></header> +<header><h1 id="h_217">Remarks</h1></header> <p>For code highlighting, see the <a href="/glyph/book/macros/macros_filters.html#m_highlight"><code>highlight</code></a> macro.</p> </section>@@ -155,7 +165,8 @@ <p>Includes an image in the document, with an optional caption (see <a href="/glyph/book/text_editing/images.html#img_fig">Images and Figures</a>).</p>
- <div class="example"><p> + <div class="example"> + <p> <strong>Example</strong> </p> <div class="CodeRay">@@ -163,12 +174,14 @@ <div class="code"><pre><span class="no">1</span> figure[
<span class="no">2</span> graph.png|Monthly Pageviews <span class="no">3</span> @width[90%] <span class="no">4</span> ]</pre></div> -</div></div> +</div> + + </div> <section class="section"> -<header><h1 id="h_176">Parameters</h1></header> +<header><h1 id="h_219">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -190,7 +203,7 @@ </section>
<section class="section"> -<header><h1 id="h_177">Attributes</h1></header> +<header><h1 id="h_220">Attributes</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Attribute</th>@@ -214,7 +227,8 @@ <p>Includes an image in the document</p>
- <div class="example"><p> + <div class="example"> + <p> <strong>Example</strong> </p> <div class="CodeRay">@@ -223,12 +237,14 @@ <span class="no">2</span> holidays/landscape.jpg
<span class="no">3</span> @class[photo] <span class="no">4</span> @style[border: 1px solid black;] <span class="no">5</span> ]</pre></div> -</div></div> +</div> + + </div> <section class="section"> -<header><h1 id="h_179">Parameters</h1></header> +<header><h1 id="h_222">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -244,7 +260,7 @@ </section>
<section class="section"> -<header><h1 id="h_180">Attributes</h1></header> +<header><h1 id="h_223">Attributes</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Attribute</th>@@ -271,7 +287,7 @@
<section class="section"> -<header><h1 id="h_182">Parameters</h1></header> +<header><h1 id="h_225">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -298,7 +314,7 @@
<section class="section"> -<header><h1 id="h_184">Parameters</h1></header> +<header><h1 id="h_227">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -354,13 +370,25 @@ <p><strong>Example:</strong> <code>title[]</code></p>
</section> - <nav><a href="/glyph/book/macros/macros_core.html">Core Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/macros/macros_inline.html">→ Inline Macros</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/macros/macros_core.html">Core Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/macros/macros_inline.html">Inline Macros</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -368,50 +396,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,68 +1,96 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Core Macros – Glyph Documentation</title> + <title>Core Macros - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <link rel="shortcut icon" href="/favicon.png" type="image/png" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Core Macros</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + <nav class="navigation"><a href="/glyph/book/ref_commands.html">Command Reference</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/macros/macros_block.html">Block Macros</a></nav> + + + <section class="section"> +<header><h1 id="m_add">add</h1></header> +<p>Adds two or more integers together.</p> - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> - <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> +<p><strong>Example:</strong> <code>add[2|5|7]</code></p> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> + <section class="section"> +<header><h1 id="h_138">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +Two or more integer values. + </table> - <section id="container"> +</section> - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> +</section> + - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Core Macros</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/ref_commands.html">Command Reference ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/macros/macros_block.html">→ Block Macros</a></nav> - - + <section class="section"> <header><h1 id="m_alias">alias</h1></header> <p>Creates a macro alias.</p>@@ -72,7 +100,7 @@
<section class="section"> -<header><h1 id="h_125">Parameters</h1></header> +<header><h1 id="h_140">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -83,7 +111,7 @@ <td>0</td>
<td>The name of the alias.</td> </tr> - + <tr> <td>1</td> <td>The name of an existing macro.</td>@@ -95,7 +123,7 @@
</section> - + <section class="section"> <header><h1 id="m_and">and</h1></header> <p>Conditional <code>and</code> operator, to be used with the <a href="#m_condition"><code>condition</code></a> macro.</p>@@ -105,7 +133,7 @@
<section class="section"> -<header><h1 id="h_127">Parameters</h1></header> +<header><h1 id="h_142">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -127,7 +155,67 @@
</section> + + <section class="section"> +<header><h1 id="m_attribute">attribute</h1></header> +<p>Returns the value of the specified attribute. For a more complete example, see the <a href="#m_let"><code>let</code></a> macro.</p> +<strong>Aliases:</strong> <code>@</code> +<p><strong>Example:</strong> <code>@[title]</code></p> + + + + <section class="section"> +<header><h1 id="h_144">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +<tr> + <td>0</td> + <td>The name of the attribute to retrieve.</td> + </tr> + </table> + +</section> + +</section> + + + <section class="section"> +<header><h1 id="m_attribute_">attribute:</h1></header> +<p>Sets the value of the specified attribute. For a more complete example, see the ‡‡‡‡‡PLACEHOLDER¤279‡‡‡‡‡ macro.</p> +<strong>Aliases:</strong> <code>@:</code> +<p><strong>Example:</strong> <code>@:[title|Test Title]</code></p> + + + + <section class="section"> +<header><h1 id="h_146">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +<tr> + <td>0</td> + <td>The name of the attribute to set.</td> + </tr> + + + <tr> + <td>1</td> + <td>The value of the attribute.</td> + </tr> + </table> + +</section> + +</section> + + + <section class="section"> <header><h1 id="m_comment">comment</h1></header> <p>Evaluates to nothing. Used to add comments in a Glyph document that will not be displayed in output files.</p>@@ -137,7 +225,7 @@
<section class="section"> -<header><h1 id="h_129">Parameters</h1></header> +<header><h1 id="h_148">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -153,7 +241,7 @@ </section>
<section class="section"> -<header><h1 id="h_130">Remarks</h1></header> +<header><h1 id="h_149">Remarks</h1></header> <p>Macros are not expanded within comments.</p> </section>@@ -161,7 +249,7 @@
</section> - + <section class="section"> <header><h1 id="m_condition">condition</h1></header> <p>Tests a conditional expression. For more information, see <a href="/glyph/book/text_editing/conditionals.html#cond_macros">Conditional Macros</a>.</p>@@ -171,7 +259,7 @@
<section class="section"> -<header><h1 id="h_132">Parameters</h1></header> +<header><h1 id="h_151">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -182,7 +270,7 @@ <td>0</td>
<td>The condition to test</td> </tr> - + <tr> <td>1</td> <td>The contents to expand if the condition is satisfied.</td>@@ -193,7 +281,7 @@ </section>
<section class="section"> -<header><h1 id="h_133">Remarks</h1></header> +<header><h1 id="h_152">Remarks</h1></header> <p>For examples see any of the following:</p> <ul> <li><a href="#m_and"><code>and</code></a> macro</li>@@ -208,7 +296,7 @@
</section> - + <section class="section"> <header><h1 id="m_config">config</h1></header> <p>Returns the value of a configuration setting.</p>@@ -218,7 +306,7 @@
<section class="section"> -<header><h1 id="h_135">Parameters</h1></header> +<header><h1 id="h_154">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -235,7 +323,7 @@
</section> - + <section class="section"> <header><h1 id="m_config_">config:</h1></header> <p>Sets the value of a configuration setting.</p>@@ -245,7 +333,7 @@
<section class="section"> -<header><h1 id="h_137">Parameters</h1></header> +<header><h1 id="h_156">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -255,8 +343,8 @@ <tr>
<td>0</td> <td>The full name of a configuration setting.</td> </tr> - - + + <tr> <td>1</td> <td>The new value of the configuration setting</td>@@ -267,15 +355,15 @@ </section>
<section class="section"> -<header><h1 id="h_138">Remarks</h1></header> +<header><h1 id="h_157">Remarks</h1></header> <p>This macro cannot be used in <a href="/glyph/book/compiling/programmatic_usage.html#modes">safe mode</a>.</p> </section> </section> - - + + <section class="section"> <header><h1 id="m_eq">eq</h1></header> <p>Conditional equality operator, to be used with the <a href="#m_condition"><code>condition</code></a> macro.</p>@@ -285,7 +373,7 @@
<section class="section"> -<header><h1 id="h_140">Parameters</h1></header> +<header><h1 id="h_159">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -307,7 +395,7 @@
</section> - + <section class="section"> <header><h1 id="m_escape">escape</h1></header> <p>Evaluates to its value. Commonly used with the escaping delimiters <code>[=</code> and <code>=]</code>.</p>@@ -317,7 +405,7 @@
<section class="section"> -<header><h1 id="h_142">Parameters</h1></header> +<header><h1 id="h_161">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -334,7 +422,139 @@
</section> + + <section class="section"> +<header><h1 id="m_fragment">fragment</h1></header> +<p>Delimits a fragment of text that can be embedded using the <a href="#m_embed"><code>embed</code></a> macro.</p> +<strong>Aliases:</strong> <code>##</code> +<p><strong>Example:</strong> <code>##[test_fragment|This is an embeddable fragment]</code></p> + + + + <section class="section"> +<header><h1 id="h_163">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +<tr> + <td>0</td> + <td>The ID of the fragment.</td> + </tr> + + <tr> + <td>1</td> + <td>The contents of the fragment.</td> + </tr> + </table> + +</section> + +</section> + + + + <section class="section"> +<header><h1 id="m_embed">embed</h1></header> +<p>Embeds text previously-delimited using the <a href="#m_fragment"><code>fragment</code></a> macro.</p> +<strong>Aliases:</strong> <code>&=</code> +<p><strong>Example:</strong> <code>&=[test_fragment]</code></p> + + + + <section class="section"> +<header><h1 id="h_165">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +<tr> + <td>0</td> + <td>The ID of the fragment.</td> + </tr> + </table> + +</section> + +</section> + + + + + + + <section class="section"> +<header><h1 id="m_gt">gt</h1></header> +<p>Returns <em>true</em> if the first parameter is gt the second one.</p> + +<p><strong>Example:</strong> <code>greater than[5|2]</code></p> + + + + <section class="section"> +<header><h1 id="h_167">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +<tr> + <td>0</td> + <td>The first integer to compare.</td> + </tr> + + + <tr> + <td>1</td> + <td>The second integer to compare.</td> + </tr> + </table> + +</section> + +</section> + + + + + + <section class="section"> +<header><h1 id="m_gte">gte</h1></header> +<p>Returns <em>true</em> if the first parameter is gte the second one.</p> + +<p><strong>Example:</strong> <code>greater than or equal to[5|2]</code></p> + + + + <section class="section"> +<header><h1 id="h_169">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +<tr> + <td>0</td> + <td>The first integer to compare.</td> + </tr> + + + <tr> + <td>1</td> + <td>The second integer to compare.</td> + </tr> + </table> + +</section> + +</section> + + + + <section class="section"> <header><h1 id="m_include">include</h1></header> <p>Evaluates to the contents of a text file stored in the <code>text/</code> directory referenced by its relative path. If the <a href="/glyph/book/config/options.html#s_options_filters_by_file_extension"><code>options.filters_by_file_extension</code></a> setting is <code>true</code>, filters the contents of the file using the <a href="/glyph/book/macros/macros_filters.html#f_macros">filter macro</a> corresponding to the file extension.</p>@@ -344,7 +564,7 @@
<section class="section"> -<header><h1 id="h_144">Parameters</h1></header> +<header><h1 id="h_171">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -360,17 +580,164 @@ </section>
<section class="section"> -<header><h1 id="h_145">Remarks</h1></header> -<ul><li>This macro cannot be used in <a href="/glyph/book/compiling/programmatic_usage.html#modes">safe mode</a>.</li> - <li><code>.glyph</code> is assumed if no file extension is specified.</li> - <li>This macro can also be used to include <code>.rb</code> ruby files within the <code>lib</code> directory. File contents are evaluated in the context of the <a href="http://yardoc.org/docs/h3rald-glyph/Glyph">Glyph</a> module.</li></ul> +<header><h1 id="h_172">Remarks</h1></header> +<ul> +<li> +<p>This macro cannot be used in <a href="/glyph/book/compiling/programmatic_usage.html#modes">safe mode</a>.</p> +</li> + <li><code>.glyph</code> is assumed if no file extension is specified.</li> +<li> +<p>This macro can also be used to include <code>.rb</code> ruby files within the <code>lib</code> directory. File contents are evaluated in the context of the <a href="http://rubydoc.info/gems/glyph/Glyph">Glyph</a> module.</p> +</li> +</ul> </section> </section> + + <section class="section"> +<header><h1 id="m_let">let</h1></header> +<p>Used to bind one or more attributes via the <a href="#m_attribute"><code>attribute</code></a> macro. Actually, you can use <a href="#m_attribute"><code>attribute</code></a> macro inside any other macro, but it looks tidier in this way.</p> + + + + <div class="example"> + <p> +<strong>Example</strong> +</p> + <div class="CodeRay"> + <div class="code"><pre><span class="no">1</span> let[ +<span class="no">2</span> @:[a|2] +<span class="no">3</span> @:[b|3] +<span class="no">4</span> section[ +<span class="no">5</span> @title[Testing] +<span class="no">6</span> @[title]: @[a] * @[b] = multiply[@[a]|@[b]] --[Outputs: Testing: 2 * 3 = 6] +<span class="no">7</span> ] +<span class="no">8</span> ]</pre></div> +</div> + + </div> + + + <section class="section"> +<header><h1 id="h_174">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +<tr> + <td>0</td> + <td>Any content.</td> + </tr> + </table> + +</section> + +</section> + + + + <section class="section"> +<header><h1 id="m_load">load</h1></header> +<p>Embeds the contents of a file.</p> + +<p><strong>Example:</strong> <code>load[my_samples.rb]</code></p> + + + + <section class="section"> +<header><h1 id="h_176">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +<tr> + <td>0</td> + <td>The file to embed, relative to the Glyph project folder.</td> + </tr> + </table> + +</section> + +</section> + + + + + <section class="section"> +<header><h1 id="m_lt">lt</h1></header> +<p>Returns <em>true</em> if the first parameter is lt the second one.</p> + +<p><strong>Example:</strong> <code>less than[5|2]</code></p> + + + + <section class="section"> +<header><h1 id="h_178">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +<tr> + <td>0</td> + <td>The first integer to compare.</td> + </tr> + + + <tr> + <td>1</td> + <td>The second integer to compare.</td> + </tr> + </table> + +</section> + +</section> + + + + + + <section class="section"> +<header><h1 id="m_lte">lte</h1></header> +<p>Returns <em>true</em> if the first parameter is lte the second one.</p> + +<p><strong>Example:</strong> <code>less than or equal to[5|2]</code></p> + + + + <section class="section"> +<header><h1 id="h_180">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +<tr> + <td>0</td> + <td>The first integer to compare.</td> + </tr> + + + <tr> + <td>1</td> + <td>The second integer to compare.</td> + </tr> + </table> + +</section> + +</section> + + + + <section class="section"> <header><h1 id="m_match">match</h1></header> <p>Checks a string against a regular expression.</p>@@ -380,7 +747,7 @@
<section class="section"> -<header><h1 id="h_147">Parameters</h1></header> +<header><h1 id="h_182">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -391,13 +758,13 @@ <td>0</td>
<td>The string to check.</td> </tr> - + <tr> <td>1</td> <td>The regular expression to match against the string.</td> </tr> - + <tr> <td>2</td> <td>The contents to expand if the string matches.</td>@@ -408,7 +775,7 @@ </section>
<section class="section"> -<header><h1 id="h_148">Remarks</h1></header> +<header><h1 id="h_183">Remarks</h1></header> <p>This macro must be used with the <a href="#m_condition"><code>condition</code></a> macro.</p> </section>@@ -416,7 +783,7 @@
</section> - + <section class="section"> <header><h1 id="m_macro_">macro:</h1></header> <p>Defines a macro.</p>@@ -426,7 +793,7 @@
<section class="section"> -<header><h1 id="h_150">Parameters</h1></header> +<header><h1 id="h_185">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -437,7 +804,7 @@ <td>0</td>
<td>The name of the new macro.</td> </tr> - + <tr> <td>1</td> <td>The macro definition (Ruby code).</td>@@ -448,16 +815,44 @@ </section>
<section class="section"> -<header><h1 id="h_151">Remarks</h1></header> -<ul><li>This macro cannot be used in <a href="/glyph/book/compiling/programmatic_usage.html#modes">safe mode</a>.</li> - <li>The new macro can only be used <em>after</em> its declaration.</li></ul> +<header><h1 id="h_186">Remarks</h1></header> +<ul> +<li> +<p>This macro cannot be used in <a href="/glyph/book/compiling/programmatic_usage.html#modes">safe mode</a>.</p> +</li> + <li>The new macro can only be used <em>after</em> its declaration.</li> +</ul> </section> </section> - + + + <section class="section"> +<header><h1 id="m_multiply">multiply</h1></header> +<p>Multiplies two or more integers together.</p> + +<p><strong>Example:</strong> <code>add[3|5|9]</code></p> + + + + <section class="section"> +<header><h1 id="h_188">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +Two or more integer values. + </table> + +</section> + +</section> + + <section class="section"> <header><h1 id="m_not">not</h1></header> <p>Conditional <code>not</code> operator, to be used with the <a href="#m_condition"><code>condition</code></a> macro.</p>@@ -467,7 +862,7 @@
<section class="section"> -<header><h1 id="h_153">Parameters</h1></header> +<header><h1 id="h_190">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -484,7 +879,7 @@
</section> - + <section class="section"> <header><h1 id="m_output_">output?</h1></header> <p>Evaluates to true if Glyph is generating output in the specified format(s).</p>@@ -494,7 +889,7 @@
<section class="section"> -<header><h1 id="h_155">Parameters</h1></header> +<header><h1 id="h_192">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -511,7 +906,7 @@
</section> - + <section class="section"> <header><h1 id="m_or">or</h1></header> <p>Conditional <code>or</code> operator, to be used with the <a href="#m_condition"><code>condition</code></a> macro.</p>@@ -521,7 +916,7 @@
<section class="section"> -<header><h1 id="h_157">Parameters</h1></header> +<header><h1 id="h_194">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -543,29 +938,35 @@
</section> - + <section class="section"> -<header><h1 id="m_rewrite_">rewrite:</h1></header> -<p>Defines a new macro by rewriting (for more information, see <a href="/glyph/book/extending/interpreting.html#rewriting">Rewriting</a>)</p> -<strong>Aliases:</strong> <code>rw:</code> +<header><h1 id="m_define_">define:</h1></header> +<p>Defines a new macro in Glyph code (for more information, see <a href="/glyph/book/extending/interpreting.html#rewriting">Defining macros using Glyph</a>)</p> +<strong>Aliases:</strong> <code>def:</code> - <div class="example"><p> + <div class="example"> + <p> <strong>Example</strong> </p> <div class="CodeRay"> - <div class="code"><pre><span class="no">1</span> rw:[release| -<span class="no">2</span> section[ -<span class="no">3</span> @title[Release {{0}}] -<span class="no">4</span> {{1}} -<span class="no">5</span> ] -<span class="no">6</span> ]</pre></div> -</div></div> + <div class="code"><pre><span class="no"> 1</span> def:[factorial| +<span class="no"> 2</span> ?[ +<span class="no"> 3</span> eq[{{0}}|0]|1| +<span class="no"> 4</span> multiply[ +<span class="no"> 5</span> {{0}} | factorial[subtract[{{0}}|1]] +<span class="no"> 6</span> ] +<span class="no"> 7</span> ] +<span class="no"> 8</span> ] +<span class="no"> 9</span> factorial[5]</pre></div> +</div> + + </div> <section class="section"> -<header><h1 id="h_159">Parameters</h1></header> +<header><h1 id="h_196">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -576,7 +977,7 @@ <td>0</td>
<td>The name of the new macro.</td> </tr> - + <tr> <td>0</td> <td>The macro definition (Glyph code).</td>@@ -587,19 +988,23 @@ </section>
<section class="section"> -<header><h1 id="h_160">Remarks</h1></header> -<ul><li>The new macro can only be used <em>after</em> its declaration.</li> - <li>This macro cannot be used in <a href="/glyph/book/compiling/programmatic_usage.html#modes">safe mode</a>.</li></ul> +<header><h1 id="h_197">Remarks</h1></header> +<ul> + <li>The new macro can only be used <em>after</em> its declaration.</li> +<li> +<p>This macro cannot be used in <a href="/glyph/book/compiling/programmatic_usage.html#modes">safe mode</a>.</p> +</li> +</ul> </section> </section> - + <section class="section"> <header><h1 id="m_ruby">ruby</h1></header> -<p>Evaluates its value as Ruby code within the context of the <a href="http://yardoc.org/docs/h3rald-glyph/Glyph">Glyph</a> module.</p> +<p>Evaluates its value as Ruby code within the context of the <a href="http://rubydoc.info/gems/glyph/Glyph">Glyph</a> module.</p> <strong>Aliases:</strong> <code>%</code>@@ -611,7 +1016,7 @@ </div>
<section class="section"> -<header><h1 id="h_162">Parameters</h1></header> +<header><h1 id="h_199">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -627,7 +1032,7 @@ </section>
<section class="section"> -<header><h1 id="h_163">Remarks</h1></header> +<header><h1 id="h_200">Remarks</h1></header> <p>This macro cannot be used in <a href="/glyph/book/compiling/programmatic_usage.html#modes">safe mode</a>.</p> </section>@@ -635,7 +1040,23 @@
</section> + + <section class="section"> +<header><h1 id="m_s">s</h1></header> +<p>Can be used to dispatch almost any instance method of the ruby <a href="http://rubydoc.info/stdlib/core/1.9.2/String">String</a> class.</p> + + + + +<div class="examples"> +<p><strong>Examples:</strong></p> +<code>s/match[This is a test string|/test/]</code><br /><code>s/sub[This is a test string|/a test/|another test]</code><br /> +</div> + +</section> + + <section class="section"> <header><h1 id="m_snippet">snippet</h1></header> <p>Returns the value of a snippet.</p>@@ -645,7 +1066,7 @@
<section class="section"> -<header><h1 id="h_165">Parameters</h1></header> +<header><h1 id="h_203">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -662,7 +1083,7 @@
</section> - + <section class="section"> <header><h1 id="m_snippet_">snippet:</h1></header> <p>Defines a snippet.</p>@@ -672,7 +1093,7 @@
<section class="section"> -<header><h1 id="h_167">Parameters</h1></header> +<header><h1 id="h_205">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -683,7 +1104,7 @@ <td>0</td>
<td>The ID of the new snippet.</td> </tr> - + <tr> <td>1</td> <td>The contents of the new snippet.</td>@@ -694,20 +1115,117 @@ </section>
<section class="section"> -<header><h1 id="h_168">Remarks</h1></header> +<header><h1 id="h_206">Remarks</h1></header> <p>The new snippet can only be used <em>after</em> its declaration.</p> </section> </section> - <nav><a href="/glyph/book/ref_commands.html">Command Reference ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/macros/macros_block.html">→ Block Macros</a></nav> - </section> - </article> + + + <section class="section"> +<header><h1 id="m_subtract">subtract</h1></header> +<p>Subtracts two or more integers together.</p> + +<p><strong>Example:</strong> <code>add[10|5|2]</code></p> + - <footer> - <section class="ads"> + <section class="section"> +<header><h1 id="h_208">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +Two or more integer values. + </table> + +</section> + +</section> + + + + <section class="section"> +<header><h1 id="m_xml">xml</h1></header> +<p>When used composed with another macro, it can be used to render arbitrary raw <span class="caps">XML</span> tags.</p> + +<p><strong>Example:</strong> <code>xml/img[@src[test.png]@alt[A Test image]]</code></p> + +</section> + + + + <section class="section"> +<header><h1 id="m_while">while</h1></header> +<p>Keeps evaluating the second parameter while a condition is satisfied.</p> + + + + <div class="example"> + <p> +<strong>Example</strong> +</p> + <div class="CodeRay"> + <div class="code"><pre><span class="no"> 1</span> let[ +<span class="no"> 2</span> @count[5] +<span class="no"> 3</span> @text[-] +<span class="no"> 4</span> while[gt[@[count]|0]| +<span class="no"> 5</span> @:[text|s/concat[@[text]|@[count]-]] +<span class="no"> 6</span> @:[count|subtract[@[count]|1]] +<span class="no"> 7</span> ] +<span class="no"> 8</span> @[text] --[Outputs: -5-4-3-2-1-] +<span class="no"> 9</span> ]</pre></div> +</div> + + </div> + + + + <section class="section"> +<header><h1 id="h_211">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +<tr> + <td>0</td> + <td>The condition to check.</td> + </tr> + + + <tr> + <td>1</td> + <td>The code to evaluate while the condition is satisfied.</td> + </tr> + </table> + +</section> + +</section> + + <nav class="navigation"><a href="/glyph/book/ref_commands.html">Command Reference</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/macros/macros_block.html">Block Macros</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -715,50 +1233,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Filter Macros – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Filter Macros - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Filter Macros</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Filter Macros</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/macros/macros_inline.html">Inline Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/macros/macros_structure.html">→ Structure Macros</a></nav> + <nav class="navigation"><a href="/glyph/book/macros/macros_inline.html">Inline Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/macros/macros_structure.html">Structure Macros</a></nav> <section class="section">@@ -73,7 +77,7 @@
<section class="section"> -<header><h1 id="h_201">Parameters</h1></header> +<header><h1 id="h_244">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -98,7 +102,8 @@ <p>Creates a section (see <a href="/glyph/book/macros/macros_structure.html#m_section"><code>section</code></a> macro) whose content can be formatted with markdown markup.</p>
<strong>Aliases:</strong> <code>§md, md_section</code> - <div class="example"><p> + <div class="example"> + <p> <strong>Example</strong> </p> <div class="CodeRay">@@ -107,12 +112,14 @@ <span class="no">2</span> @title[Test Section]
<span class="no">3</span> @id[test] <span class="no">4</span> Some *markdown* text. <span class="no">5</span> ]</pre></div> -</div></div> +</div> + + </div> <section class="section"> -<header><h1 id="h_203">Parameters</h1></header> +<header><h1 id="h_246">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -128,7 +135,7 @@ </section>
<section class="section"> -<header><h1 id="h_204">Attributes</h1></header> +<header><h1 id="h_247">Attributes</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Attribute</th>@@ -168,7 +175,7 @@
<section class="section"> -<header><h1 id="h_206">Parameters</h1></header> +<header><h1 id="h_249">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -193,7 +200,8 @@ <p>Creates a section (see <a href="/glyph/book/macros/macros_structure.html#m_section"><code>section</code></a> macro) whose content can be formatted with textile markup.</p>
<strong>Aliases:</strong> <code>§txt, txt_section</code> - <div class="example"><p> + <div class="example"> + <p> <strong>Example</strong> </p> <div class="CodeRay">@@ -202,12 +210,14 @@ <span class="no">2</span> @title[Test Section]
<span class="no">3</span> @id[test] <span class="no">4</span> Some *textile* text. <span class="no">5</span> ]</pre></div> -</div></div> +</div> + + </div> <section class="section"> -<header><h1 id="h_208">Parameters</h1></header> +<header><h1 id="h_251">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -223,7 +233,7 @@ </section>
<section class="section"> -<header><h1 id="h_209">Attributes</h1></header> +<header><h1 id="h_252">Attributes</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Attribute</th>@@ -259,7 +269,8 @@ <p>Highlights a piece of source code according to the specified language. <span class="fmi">for more information on <mark>code highligting</mark>, see <a href="/glyph/book/text_editing/code.html#source_code">Source Code</a></span>.</p>
- <div class="example"><p> + <div class="example"> + <p> <strong>Example</strong> </p> <div class="CodeRay">@@ -268,12 +279,14 @@ <span class="no">2</span> def hello
<span class="no">3</span> puts "Hello World" <span class="no">4</span> end <span class="no">5</span> ]</pre></div> -</div></div> +</div> + + </div> <section class="section"> -<header><h1 id="h_211">Parameters</h1></header> +<header><h1 id="h_254">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -295,13 +308,25 @@ </section>
</section> - <nav><a href="/glyph/book/macros/macros_inline.html">Inline Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/macros/macros_structure.html">→ Structure Macros</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/macros/macros_inline.html">Inline Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/macros/macros_structure.html">Structure Macros</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -309,50 +334,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Inline Macros – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Inline Macros - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Inline Macros</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Inline Macros</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/macros/macros_block.html">Block Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/macros/macros_filters.html">→ Filter Macros</a></nav> + <nav class="navigation"><a href="/glyph/book/macros/macros_block.html">Block Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/macros/macros_filters.html">Filter Macros</a></nav> <section class="section"> <header><h1 id="m_anchor">anchor</h1></header>@@ -71,7 +75,7 @@
<section class="section"> -<header><h1 id="h_191">Parameters</h1></header> +<header><h1 id="h_234">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -104,7 +108,7 @@
<section class="section"> -<header><h1 id="h_193">Parameters</h1></header> +<header><h1 id="h_236">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -131,7 +135,7 @@
<section class="section"> -<header><h1 id="h_195">Parameters</h1></header> +<header><h1 id="h_238">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -164,7 +168,7 @@
<section class="section"> -<header><h1 id="h_197">Parameters</h1></header> +<header><h1 id="h_240">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -196,13 +200,25 @@ <p><strong>Example:</strong> <code>todo[Remember to do this.]</code></p>
</section> - <nav><a href="/glyph/book/macros/macros_block.html">Block Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/macros/macros_filters.html">→ Filter Macros</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/macros/macros_block.html">Block Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/macros/macros_filters.html">Filter Macros</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -210,50 +226,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Structure Macros – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Structure Macros - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Structure Macros</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Structure Macros</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/macros/macros_filters.html">Filter Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/config/document.html">→ document.*</a></nav> + <nav class="navigation"><a href="/glyph/book/macros/macros_filters.html">Filter Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/config/document.html">document.*</a></nav> <section class="section"> <header><h1 id="m_article">article</h1></header>@@ -90,7 +94,7 @@
<section class="section"> -<header><h1 id="h_214">Parameters</h1></header> +<header><h1 id="h_257">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -106,7 +110,7 @@ </section>
<section class="section"> -<header><h1 id="h_215">Attributes</h1></header> +<header><h1 id="h_258">Attributes</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Attribute</th>@@ -177,7 +181,7 @@
<section class="section"> -<header><h1 id="h_217">Parameters</h1></header> +<header><h1 id="h_260">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -193,7 +197,7 @@ </section>
<section class="section"> -<header><h1 id="h_218">Attributes</h1></header> +<header><h1 id="h_261">Attributes</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Attribute</th>@@ -262,7 +266,7 @@
<section class="section"> -<header><h1 id="h_220">Parameters</h1></header> +<header><h1 id="h_263">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -289,7 +293,7 @@
<section class="section"> -<header><h1 id="h_222">Parameters</h1></header> +<header><h1 id="h_265">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -313,7 +317,8 @@ <p>Creates a section (<code><div></code> or <code><section></code> tag).</p>
<strong>Aliases:</strong> <code>acknowledgement, addendum, afterword, appendix, bibliography, chapter, colophon, dedication, epilogue, foreword, glossary, imprint, index, inspiration, introduction, lof, lot, part, postscript, preface, prologue, promotion, references, section, section, volume</code> - <div class="example"><p> + <div class="example"> + <p> <strong>Example</strong> </p> <div class="CodeRay">@@ -322,12 +327,14 @@ <span class="no">2</span> @title[Test Section]
<span class="no">3</span> @id[test] <span class="no">4</span> ... <span class="no">5</span> ]</pre></div> -</div></div> +</div> + + </div> <section class="section"> -<header><h1 id="h_224">Parameters</h1></header> +<header><h1 id="h_267">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -343,7 +350,7 @@ </section>
<section class="section"> -<header><h1 id="h_225">Attributes</h1></header> +<header><h1 id="h_268">Attributes</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Attribute</th>@@ -382,7 +389,7 @@
<section class="section"> -<header><h1 id="h_227">Parameters</h1></header> +<header><h1 id="h_270">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -409,7 +416,7 @@
<section class="section"> -<header><h1 id="h_229">Parameters</h1></header> +<header><h1 id="h_272">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -425,13 +432,25 @@ </section>
</section> - <nav><a href="/glyph/book/macros/macros_filters.html">Filter Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/config/document.html">→ document.*</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/macros/macros_filters.html">Filter Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/config/document.html">document.*</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -439,50 +458,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Command Reference – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Command Reference - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Command Reference</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Command Reference</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/troubleshooting/errors_macro.html">Macro Errors ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/macros/macros_core.html">→ Core Macros</a></nav> + <nav class="navigation"><a href="/glyph/book/troubleshooting/errors_macro.html">Macro Errors</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/macros/macros_core.html">Core Macros</a></nav> <p>Glyph’s command-line interface has been built using the <a href="http://github.com/davetron5000/gli">gli</a> (Git-like interface) gem. Therefore, Glyph commands are all written like this:</p> <p><strong>glyph</strong> <em>global_options</em> <strong>command</strong> <em>options</em> <em>parameters</em></p> <p>Where:</p>@@ -69,21 +73,26 @@ <li><em>global_options</em> and <em>options</em> are in the form: <code>-n</code> <em>value</em> or <code>--name=</code><em>value</em>, e.g. <code>-f pdf</code> or <code>--format=pdf</code></li>
<li><em>parameters</em> are separated by whitespaces, and can be wrapped in quotes.</li> </ul> <section class="section"> -<header><h1 id="h_104">Global Options</h1></header> +<header><h1 id="h_116">Global Options</h1></header> <section class="section"> <header><h1 id="debug_switch"><code>-d</code>, <code>--debug</code></h1></header> <p>If specified, the command is executed in debug mode and additional diagnostic information is printed on the screen.</p> </section> + <section class="section"> +<header><h1 id="version_switch"><code>-v</code>, <code>--version</code></h1></header> +<p>Prints the current version of Glyph, ignoring any other command or switches.</p> + +</section> </section> <section class="section"> <header><h1 id="c_add">add</h1></header> <p>Creates a new text file in the <code>text/</code> folder.</p> - <p><strong>Example:</strong> <code>glyph add introduction.textile</code></p> - + <p><strong>Example:</strong> <code>glyph add introduction.textile</code></p> + <section class="section"> -<header><h1 id="h_107">Parameters</h1></header> +<header><h1 id="h_120">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -101,10 +110,10 @@ </section>
<section class="section"> <header><h1 id="c_compile">compile</h1></header> <p>Compiles a Glyph document into an output file. If no options are specified, the <code>document.glyph</code> file is used as source to produce a standalone HTML file.</p> - <p><strong>Example:</strong> <code>glyph compile -f pdf</code></p> - + <p><strong>Example:</strong> <code>glyph compile -f pdf</code></p> + <section class="section"> -<header><h1 id="h_109">Parameters</h1></header> +<header><h1 id="h_122">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -115,7 +124,7 @@ <td><em>source</em></td>
<td>The source glyph file to compile <em>(Optional)</em>.</td> </tr> - + <tr> <td><em>destination</em></td> <td>The destination file <em>(Optional)</em>.</td>@@ -124,9 +133,9 @@ </table>
</section> - + <section class="section"> -<header><h1 id="h_110">Options</h1></header> +<header><h1 id="h_123">Options</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Option</th>@@ -136,21 +145,21 @@ <tr>
<td><code>-s</code> (<code>--source</code>)</td> <td> The source file to compile. - <strong>Default Value:</strong> <code>document.glyph</code> + <strong>Default Value:</strong> <code>document.glyph</code> </td> </tr> - + <tr> <td><code>-f</code> (<code>--format</code>)</td> <td> The format of the output file. - <strong>Default Value:</strong> <code>html</code> - *Possible Values:* @html, pdf@ + <strong>Default Value:</strong> <code>html</code> + *Possible Values:* @html, pdf@ </td> </tr> - + <tr> <td><code>-a</code> (<code>--auto</code>)</td> <td>@@ -165,15 +174,15 @@ </section>
<section class="section"> <header><h1 id="c_config">config</h1></header> Gets or sets a configuration setting in the project or global configuration file (<span class="fmi">for more information on <mark>configuration files</mark>, see <a href="/glyph/book/getting_started/configuration.html#cfg">Project Configuration</a></span>). - + <div class="examples"> <p><strong>Examples:</strong></p> <code>glyph config document.filename</code><br /><code>glyph config -g document.author "Fabio Cevasco"</code><br /> </div> - + <section class="section"> -<header><h1 id="h_112">Options</h1></header> +<header><h1 id="h_125">Options</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Option</th>@@ -183,16 +192,16 @@ <tr>
<td><code>-g</code> (<code>--global</code>)</td> <td> If specified, the global configuration file is processed instead of the project file. - <strong>Default Value:</strong> <code>false</code> + <strong>Default Value:</strong> <code>false</code> </td> </tr> </table> </section> - + <section class="section"> -<header><h1 id="h_113">Parameters</h1></header> +<header><h1 id="h_126">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -203,7 +212,7 @@ <td><em>setting</em></td>
<td>The name of a valid <a href="/glyph/book/document.html#cfg_ref">configuration setting</a>.</td> </tr> - + <tr> <td><em>value</em></td> <td>The new value of the configuration setting.</td>@@ -216,15 +225,15 @@ </section>
<section class="section"> <header><h1 id="c_help">help</h1></header> Prints information about all Glyph commands or about one specific command. - + <div class="examples"> <p><strong>Examples:</strong></p> <code>glyph help</code><br /><code>glyph help compile</code><br /> </div> - + <section class="section"> -<header><h1 id="h_115">Parameters</h1></header> +<header><h1 id="h_128">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -242,15 +251,15 @@ </section>
<section class="section"> <header><h1 id="c_init">init</h1></header> Creates a new Glyph project in the current directory (if empty). - <p><strong>Example:</strong> <code>glyph init</code></p> + <p><strong>Example:</strong> <code>glyph init</code></p> </section> <section class="section"> <header><h1 id="c_outline">outline</h1></header> Display an outline of the current document. - + <section class="section"> -<header><h1 id="h_118">Options</h1></header> +<header><h1 id="h_131">Options</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Option</th>@@ -263,7 +272,7 @@ Only display headers until the specified level.
</td> </tr> - + <tr> <td><code>-i</code> (<code>--ids</code>)</td> <td>@@ -271,7 +280,7 @@ Display section IDs.
</td> </tr> - + <tr> <td><code>-f</code> (<code>--files</code>)</td> <td>@@ -279,7 +288,7 @@ Display file names.
</td> </tr> - + <tr> <td><code>-t</code> (<code>--titles</code>)</td> <td>@@ -290,7 +299,7 @@ </table>
</section> - + <div class="examples"> <p><strong>Examples:</strong></p> <code>glyph outline -it -l 1</code><br /><code>glyph outline -l 2</code><br /><code>glyph outline -f</code><br />@@ -300,15 +309,15 @@ </section>
<section class="section"> <header><h1 id="c_stats">stats</h1></header> <p>Displays project statistics (<span class="fmi">for more information on <mark>this command</mark>, see <a href="/glyph/book/document.html#stats">Document Statistics</a></span>).</p> - + <div class="examples"> <p><strong>Examples:</strong></p> -<code>glyph stats -m </code><br /><code>glyph stats --link=h3rald.com</code><br /> +<code>glyph stats -m </code><br /><code>glyph stats --link=h3rald.com</code><br /> </div> - + <section class="section"> -<header><h1 id="h_120">Options</h1></header> +<header><h1 id="h_133">Options</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Option</th>@@ -321,7 +330,7 @@ If specified, general statistics about bookmarks are displayed (see <a href="/glyph/book/stats/bookmarks.html#stats_bookmarks">Bookmark Statistics</a>).
</td> </tr> - + <tr> <td><code>--bookmark</code></td> <td>@@ -329,7 +338,7 @@ Display detailed statistics about the specified bookmark.
</td> </tr> - + <tr> <td><code>-f</code> (<code>--files</code>)</td> <td>@@ -337,7 +346,7 @@ If specified, general statistics about project files are displayed.
</td> </tr> - + <tr> <td><code>-l</code> (<code>--links</code>)</td> <td>@@ -345,7 +354,7 @@ If specified, general statistics about links are displayed (see <a href="/glyph/book/stats/links.html#stats_links">Link Statistics</a>).
</td> </tr> - + <tr> <td><code>--link</code></td> <td>@@ -353,7 +362,7 @@ Display detailed statistics about all links whose target matches the specified regular expression.
</td> </tr> - + <tr> <td><code>-m</code> (<code>--macros</code>)</td> <td>@@ -361,7 +370,7 @@ If specified, general statistics about macros are displayed (see <a href="/glyph/book/stats/macros.html#stats_macros">Macro Statistics</a>).
</td> </tr> - + <tr> <td><code>--macro</code></td> <td>@@ -369,7 +378,7 @@ Display detailed statistics about the specified macro.
</td> </tr> - + <tr> <td><code>-s</code> (<code>--snippets</code>)</td> <td>@@ -377,7 +386,7 @@ If specified, general statistics about snippets are displayed (see <a href="/glyph/book/stats/snippets.html#stats_snippets">Snippet Statistics</a>).
</td> </tr> - + <tr> <td><code>--snippet</code></td> <td>@@ -392,16 +401,28 @@ </section>
<section class="section"> <header><h1 id="c_todo">todo</h1></header> Prints all the todo items saved using the <a href="/glyph/book/macros/macros_inline.html#m_todo"><code>todo</code></a> macro. - <p><strong>Example:</strong> <code>glyph todo</code></p> + <p><strong>Example:</strong> <code>glyph todo</code></p> </section> - <nav><a href="/glyph/book/troubleshooting/errors_macro.html">Macro Errors ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/macros/macros_core.html">→ Core Macros</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/troubleshooting/errors_macro.html">Macro Errors</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/macros/macros_core.html">Core Macros</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -409,50 +430,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,79 +1,83 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Bookmark Statistics – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Bookmark Statistics - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Bookmark Statistics</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Bookmark Statistics</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/stats/snippets.html">Snippet Statistics ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/stats/links.html">→ Link Statistics</a></nav> + <nav class="navigation"><a href="/glyph/book/stats/snippets.html">Snippet Statistics</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/stats/links.html">Link Statistics</a></nav> - <section class="section"> -<header><h1 id="h_63">Displaying stats about all bookmarks</h1></header> + <section class="section"> +<header><h1 id="h_73">Displaying stats about all bookmarks</h1></header> <p>To display statistics about all bookmarks, execute <code>glyph stats --bookmarks</code>. Glyph displays something like this:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> ===== Bookmarks <span class="no"> 2</span> -- Total Bookmarks: 241 <span class="no"> 3</span> -- Total Referenced Bookmarks: 89 <span class="no"> 4</span> -- Total Unreferenced Bookmarks: 155 <span class="no"> 5</span> -- Bookmarks: -<span class="no"> 6</span> attribute_intro auto_regeneration c_add c_compile c_config -<span class="no"> 7</span> c_help c_init c_outline c_todo cfg -<span class="no"> 8</span> cfg_document cfg_filters cfg_ref cmd_ref compile +<span class="no"> 6</span> attribute_intro auto_regeneration c_add c_compile c_config +<span class="no"> 7</span> c_help c_init c_outline c_todo cfg +<span class="no"> 8</span> cfg_document cfg_filters cfg_ref cmd_ref compile <span class="no"> 9</span> [...] <span class="no"><strong>10</strong></span> -- Referenced Bookmarks: <span class="no">11</span> - attribute_intro (1)@@ -91,8 +95,8 @@ <span class="no">22</span> h_111 h_112 h_114 h_115 h_117
<span class="no">23</span> [...]</pre></div> </div> - <section class="section"> -<header><h1 id="h_64">Remarks</h1></header> + <section class="section"> +<header><h1 id="h_74">Remarks</h1></header> <ul> <li>All the automatically-generated bookmarks (like headers, starting with <code>h_</code>) are included as well.</li> </ul>@@ -101,10 +105,10 @@ </section>
</section> - <section class="section"> -<header><h1 id="h_65">Displaying stats about a single bookmark</h1></header> -<p>To display statistics about a single bookmark (e.g. <code>yardoc</code>), execute <code>glyph stats --bookmark=c_config</code>. Glyph displays something like this:</p> - <div class="CodeRay"> + <section class="section"> +<header><h1 id="h_75">Displaying stats about a single bookmark</h1></header> +<p>To display statistics about a single bookmark (e.g. <code>rubydoc</code>), execute <code>glyph stats --bookmark=c_config</code>. Glyph displays something like this:</p> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> ===== Bookmark 'c_config' (header) <span class="no">2</span> -- Defined in: text/ref_commands.glyph <span class="no">3</span> -- Referenced in:@@ -113,8 +117,8 @@ <span class="no">5</span> - text/getting_started/configuration.glyph (1)
<span class="no">6</span> - text/troubleshooting/errors_command.glyph (3)</pre></div> </div> - <section class="section"> -<header><h1 id="h_66">Remarks</h1></header> + <section class="section"> +<header><h1 id="h_76">Remarks</h1></header> <ul> <li>Do not prepend the bookmark ID with <code>#</code>.</li> </ul>@@ -122,13 +126,25 @@
</section> </section> - <nav><a href="/glyph/book/stats/snippets.html">Snippet Statistics ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/stats/links.html">→ Link Statistics</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/stats/snippets.html">Snippet Statistics</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/stats/links.html">Link Statistics</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -136,50 +152,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,71 +1,75 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Link Statistics – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Link Statistics - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Link Statistics</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Link Statistics</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/stats/bookmarks.html">Bookmark Statistics ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/internals.html">→ A quick look at Glyph's internals</a></nav> + <nav class="navigation"><a href="/glyph/book/stats/bookmarks.html">Bookmark Statistics</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/internals.html">A quick look at Glyph's internals</a></nav> - <section class="section"> -<header><h1 id="h_68">Displaying stats about all links</h1></header> + <section class="section"> +<header><h1 id="h_78">Displaying stats about all links</h1></header> <p>To display statistics about all links, execute <code>glyph stats --links</code>. Glyph displays something like this:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> ===== Links <span class="no"> 2</span> -- Total Internal Links: 89 <span class="no"> 3</span> -- Internal Links@@ -84,24 +88,24 @@ <span class="no">15</span> - #cfg_filters
<span class="no">16</span> [...] <span class="no">17</span> -- Total External Links: 95 <span class="no">18</span> -- External Links -<span class="no">19</span> - <span class="er">&</span>[yardoc]/Glyph -<span class="no"><strong>20</strong></span> - <span class="er">&</span>[yardoc]/Glyph/Document -<span class="no">21</span> - <span class="er">&</span>[yardoc]/Glyph/Interpreter -<span class="no">22</span> - <span class="er">&</span>[yardoc]/Glyph/Macro -<span class="no">23</span> - <span class="er">&</span>[yardoc]/Glyph/Macro/Validators -<span class="no">24</span> - <span class="er">&</span>[yardoc]/Glyph/Macro:update_source -<span class="no">25</span> - <span class="er">&</span>[yardoc]/Glyph/MacroNode -<span class="no">26</span> - <span class="er">&</span>[yardoc]/Glyph/Parser -<span class="no">27</span> - <span class="er">&</span>[yardoc]/Glyph/SyntaxNode -<span class="no">28</span> - <span class="er">&</span>[yardoc]/Macro +<span class="no">19</span> - <span class="er">&</span>[rubydoc]/Glyph +<span class="no"><strong>20</strong></span> - <span class="er">&</span>[rubydoc]/Glyph/Document +<span class="no">21</span> - <span class="er">&</span>[rubydoc]/Glyph/Interpreter +<span class="no">22</span> - <span class="er">&</span>[rubydoc]/Glyph/Macro +<span class="no">23</span> - <span class="er">&</span>[rubydoc]/Glyph/Macro/Validators +<span class="no">24</span> - <span class="er">&</span>[rubydoc]/Glyph/Macro:update_source +<span class="no">25</span> - <span class="er">&</span>[rubydoc]/Glyph/MacroNode +<span class="no">26</span> - <span class="er">&</span>[rubydoc]/Glyph/Parser +<span class="no">27</span> - <span class="er">&</span>[rubydoc]/Glyph/SyntaxNode +<span class="no">28</span> - <span class="er">&</span>[rubydoc]/Macro <span class="no">29</span> - http://code.google.com/p/wkhtmltopdf/ <span class="no"><strong>30</strong></span> - http://coderay.rubychan.de/ <span class="no">31</span> - http://coderay.rubychan.de/doc/classes/CodeRay/Encoders/HTML.html <span class="no">32</span> [...]</pre></div> </div> - <section class="section"> -<header><h1 id="h_69">Remarks</h1></header> + <section class="section"> +<header><h1 id="h_79">Remarks</h1></header> <ul> <li>The only criteria used to determine if a link is internal is whether it starts with a <code>#</code> or not.</li> </ul>@@ -110,10 +114,10 @@ </section>
</section> - <section class="section"> -<header><h1 id="h_70">Displaying stats about links matching a regular expression</h1></header> + <section class="section"> +<header><h1 id="h_80">Displaying stats about links matching a regular expression</h1></header> <p>To display statistics about links matching a regular expression (e.g. <code>/c_/</code>), execute <code>glyph stats --link=c_</code>. Glyph displays something like this:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> ===== Links matching /c_/ <span class="no"> 2</span> -- Total Links: 8 <span class="no"> 3</span> -- Link Targets:@@ -154,8 +158,8 @@ <span class="no">37</span> - text/extending/macro_def.glyph (1)
<span class="no">38</span> - text/text_editing/macro_intro.glyph (1)</pre></div> </div> - <section class="section"> -<header><h1 id="h_71">Remarks</h1></header> + <section class="section"> +<header><h1 id="h_81">Remarks</h1></header> <ul> <li>No distinction between external and internal targets is made.</li> </ul>@@ -163,13 +167,25 @@
</section> </section> - <nav><a href="/glyph/book/stats/bookmarks.html">Bookmark Statistics ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/extending/internals.html">→ A quick look at Glyph's internals</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/stats/bookmarks.html">Bookmark Statistics</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/extending/internals.html">A quick look at Glyph's internals</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -177,50 +193,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,71 +1,75 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Macro Statistics – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Macro Statistics - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Macro Statistics</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Macro Statistics</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/stats/stats.html">Using the stats command ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/stats/snippets.html">→ Snippet Statistics</a></nav> + <nav class="navigation"><a href="/glyph/book/stats/stats.html">Using the stats command</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/stats/snippets.html">Snippet Statistics</a></nav> - <section class="section"> -<header><h1 id="h_53">Displaying stats about all macros</h1></header> + <section class="section"> +<header><h1 id="h_63">Displaying stats about all macros</h1></header> <p>To display statistics about all macros, execute <code>glyph stats --macros</code>. Glyph displays something like this:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> ===== Macros <span class="no"> 2</span> -- Total Macro Instances: 2497 <span class="no"> 3</span> -- Total Macro Definitions: 65@@ -101,8 +105,8 @@ <span class="no">32</span> textile title toc todo values
<span class="no">33</span> |xml|</pre></div> </div> - <section class="section"> -<header><h1 id="h_54">Remarks</h1></header> + <section class="section"> +<header><h1 id="h_64">Remarks</h1></header> <ul> <li>Only macro <em>definitions</em> (not their <em>aliases</em>) are displayed, both default and user-defined.</li> <li>The <code>|xml|</code> macro is a special macro used if the <a href="/glyph/book/config/options.html#s_options_xml_fallback"><code>options.xml_fallback</code></a> setting is enabled.</li>@@ -113,10 +117,10 @@ </section>
</section> - <section class="section"> -<header><h1 id="h_55">Displaying stats about a single macro</h1></header> + <section class="section"> +<header><h1 id="h_65">Displaying stats about a single macro</h1></header> <p>To display statistics about a single macro (e.g. <code>note</code>), execute <code>glyph stats --macro=note</code>. Glyph displays something like this:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> ===== Macro 'note' <span class="no"> 2</span> -- Total Instances: 18 <span class="no"> 3</span> -- Occurrences:@@ -135,24 +139,36 @@ <span class="no">15</span> - text/text_editing/section_aliases.glyph (1)
<span class="no">16</span> - text/text_editing/xml_fallback.glyph (2)</pre></div> </div> - <section class="section"> -<header><h1 id="h_56">Remarks</h1></header> + <section class="section"> +<header><h1 id="h_66">Remarks</h1></header> <ul> <li>All the instances of the specified macro definition <em>and all its aliases</em> are collected, regardless whether a definition or an alias is specified.</li> - <li>If you use custom macros, make sure they call the <a href="http://yardoc.org/docs/h3rald-glyph/Glyph/Macro:update_source">Macro#update_source</a> appropriately method if necessary.</li> + <li>If you use custom macros, make sure they call the <a href="http://rubydoc.info/gems/glyph/Glyph/Macro:update_source">Macro#update_source</a> appropriately method if necessary.</li> <li>If macros are used within <a href="/glyph/book/extending/interpreting.html#rewriting">rewritten</a> macros, they’ll be also listed in each file where the rewritten macro is used.</li> </ul> </section> </section> - <nav><a href="/glyph/book/stats/stats.html">Using the stats command ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/stats/snippets.html">→ Snippet Statistics</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/stats/stats.html">Using the stats command</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/stats/snippets.html">Snippet Statistics</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -160,50 +176,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,91 +1,95 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Snippet Statistics – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Snippet Statistics - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Snippet Statistics</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Snippet Statistics</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/stats/macros.html">Macro Statistics ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/stats/bookmarks.html">→ Bookmark Statistics</a></nav> + <nav class="navigation"><a href="/glyph/book/stats/macros.html">Macro Statistics</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/stats/bookmarks.html">Bookmark Statistics</a></nav> - <section class="section"> -<header><h1 id="h_58">Displaying stats about all snippets</h1></header> + <section class="section"> +<header><h1 id="h_68">Displaying stats about all snippets</h1></header> <p>To display statistics about all snippets, execute <code>glyph stats --snippets</code>. Glyph displays something like this:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> ===== Snippets <span class="no"> 2</span> -- Total Snippets: 21 <span class="no"> 3</span> -- Total Used Snippets: 21 <span class="no"> 4</span> -- Total Unused Snippets: 0 <span class="no"> 5</span> -- Snippets: -<span class="no"> 6</span> bin_params called_on_files coderay filter_by_ext gcode -<span class="no"> 7</span> glang htmlcode img_attrs img_file macros -<span class="no"> 8</span> markups only_after_declaration only_defined_through opt prince -<span class="no"> 9</span> referenced_with_path sq_esc unsafe uv wkhtml -<span class="no"><strong>10</strong></span> yardoc +<span class="no"> 6</span> bin_params called_on_files coderay filter_by_ext +<span class="no"> 7</span> glang htmlcode img_attrs img_file +<span class="no"> 8</span> markups only_after_declaration only_defined_through opt +<span class="no"> 9</span> referenced_with_path sq_esc unsafe uv +<span class="no"><strong>10</strong></span> rubydoc <span class="no">11</span> -- Used Snippets: -<span class="no">12</span> bin_params called_on_files coderay filter_by_ext gcode -<span class="no">13</span> glang htmlcode img_attrs img_file macros -<span class="no">14</span> markups only_after_declaration only_defined_through opt prince -<span class="no">15</span> referenced_with_path sq_esc unsafe uv wkhtml -<span class="no">16</span> yardoc</pre></div> +<span class="no">12</span> bin_params called_on_files coderay filter_by_ext +<span class="no">13</span> glang htmlcode img_attrs img_file +<span class="no">14</span> markups only_after_declaration only_defined_through opt +<span class="no">15</span> referenced_with_path sq_esc unsafe uv +<span class="no">16</span> rubydoc</pre></div> </div> - <section class="section"> -<header><h1 id="h_59">Remarks</h1></header> + <section class="section"> +<header><h1 id="h_69">Remarks</h1></header> <ul> <li>Information on snippet usage and definitions is available only when displaying statistics for a single snippet.</li> </ul>@@ -94,14 +98,14 @@ </section>
</section> - <section class="section"> -<header><h1 id="h_60">Displaying stats about a single snippet</h1></header> -<p>To display statistics about a single snippet (e.g. <code>yardoc</code>), execute <code>glyph stats --snippet=yardoc</code>. Glyph displays something like this:</p> - <div class="CodeRay"> - <div class="code"><pre><span class="no"> 1</span> ===== Snippet 'yardoc' + <section class="section"> +<header><h1 id="h_70">Displaying stats about a single snippet</h1></header> +<p>To display statistics about a single snippet (e.g. <code>rubydoc</code>), execute <code>glyph stats --snippet=rubydoc</code>. Glyph displays something like this:</p> + <div class="CodeRay"> + <div class="code"><pre><span class="no"> 1</span> ===== Snippet 'rubydoc' <span class="no"> 2</span> -- Definition: <span class="no"> 3</span> ------------------- -<span class="no"> 4</span> http://yardoc.org/docs/h3rald-glyph +<span class="no"> 4</span> http://rubydoc.info/gems/glyph <span class="no"> 5</span> ------------------- <span class="no"> 6</span> -- Total Used Instances: 18 <span class="no"> 7</span> -- Usage Details:@@ -114,8 +118,8 @@ <span class="no">13</span> - text/macros/macros_core.glyph (2)
<span class="no">14</span> - text/stats/macros.glyph (1)</pre></div> </div> - <section class="section"> -<header><h1 id="h_61">Remarks</h1></header> + <section class="section"> +<header><h1 id="h_71">Remarks</h1></header> <ul> <li>Nested snippets appear as within the file containing the top-level snippet.</li> </ul>@@ -123,13 +127,25 @@
</section> </section> - <nav><a href="/glyph/book/stats/macros.html">Macro Statistics ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/stats/bookmarks.html">→ Bookmark Statistics</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/stats/macros.html">Macro Statistics</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/stats/bookmarks.html">Bookmark Statistics</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -137,50 +153,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,86 +1,90 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Using the stats command – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Using the stats command - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Using the stats command</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Using the stats command</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/compiling/programmatic_usage.html">Using Glyph programmatically ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/stats/macros.html">→ Macro Statistics</a></nav> + <nav class="navigation"><a href="/glyph/book/compiling/programmatic_usage.html">Using Glyph programmatically</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/stats/macros.html">Macro Statistics</a></nav> -<p>Glyph includes a <a href="/glyph/book/ref_commands.html#c_stats"><code>stats</code></a> command that can be used to display useful statistics about your Glyph project. If you try running Glyph's command help, you'll see that this command can take quite a few options:</p> +<p>Glyph includes a <a href="/glyph/book/ref_commands.html#c_stats"><code>stats</code></a> command that can be used to display useful statistics about your Glyph project. If you try running Glyph's command help, you'll see that this command can take quite a few options: +</p> <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> $ glyph help stats -<span class="no"> 2</span> ===================================== -<span class="no"> 3</span> Glyph v.0.4.2 -<span class="no"> 4</span> ===================================== -<span class="no"> 5</span> stats [options] -<span class="no"> 6</span> Display statistics -<span class="no"> 7</span> -<span class="no"> 8</span> Options: -<span class="no"> 9</span> -b, --bookmarks - Display stats about bookmarks -<span class="no"><strong>10</strong></span> --bookmark=arg - Display stats about a single bookmark -<span class="no">11</span> -f, --files - Display stats about project files -<span class="no">12</span> -l, --links - Display stats about links -<span class="no">13</span> --link=arg - Display stats about links matching a regular expression -<span class="no">14</span> -m, --macros - Display stats about macros -<span class="no">15</span> --macro=arg - Display stats about a single macro -<span class="no">16</span> -s, --snippets - Display stats about snippets -<span class="no">17</span> --snippet=arg - Display stats about a single snippet</pre></div> +<span class="no"> 2</span> Glyph v0.5.0 +<span class="no"> 3</span> +<span class="no"> 4</span> stats [options] +<span class="no"> 5</span> Display statistics +<span class="no"> 6</span> +<span class="no"> 7</span> Options: +<span class="no"> 8</span> -b, --bookmarks - Display stats about bookmarks +<span class="no"> 9</span> --bookmark=arg - Display stats about a single bookmark +<span class="no"><strong>10</strong></span> -f, --files - Display stats about project files +<span class="no">11</span> -l, --links - Display stats about links +<span class="no">12</span> --link=arg - Display stats about links matching a regular expression +<span class="no">13</span> -m, --macros - Display stats about macros +<span class="no">14</span> --macro=arg - Display stats about a single macro +<span class="no">15</span> -s, --snippets - Display stats about snippets +<span class="no">16</span> --snippet=arg - Display stats about a single snippet</pre></div> </div> <p>If no options are specified, the command returns a summary containing different element totals, i.e.:</p>@@ -126,13 +130,25 @@ <span class="no"><strong>30</strong></span> -- Total Internal Links: 87
<span class="no">31</span> -- Total External Links: 97</pre></div> </div> - <nav><a href="/glyph/book/compiling/programmatic_usage.html">Using Glyph programmatically ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/stats/macros.html">→ Macro Statistics</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/compiling/programmatic_usage.html">Using Glyph programmatically</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/stats/macros.html">Macro Statistics</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -140,50 +156,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,80 +1,84 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Macro attributes – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Macro attributes - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Macro attributes</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Macro attributes</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/text_editing/macro_intro.html">Introducing Glyph Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/esc_quot.html">→ Escaping and Quoting</a></nav> - <p>Although a macro can take any number of parameters, they are often no more than two or three, for readibility reasons: parameters have no name, but their position within a macro is significant.</p> + <nav class="navigation"><a href="/glyph/book/text_editing/macro_intro.html">Introducing Glyph Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/macro_composition.html">Macro Composition</a></nav> + <p>Although a macro can take any number of parameters, they are often no more than two or three, for readibility reasons: parameters have no name, but their position within a macro is significant.</p> <p>If you have something like this:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> custom_image[test.png|50%|50%|Test Image]</pre></div> </div> - <p>it may still be easy enough to understand what each parameter is used for, but:</p> + <p>it may still be easy enough to understand what each parameter is used for, but:</p> <ul> <li>you can easily forget that the third parameter is the image width</li> <li>if you don’t want to resize the image, you still have to pass <em>empty parameters</em> to the macro, like this: <code>custom_image[test2.png|||Test Image]</code></li> </ul> <p>To avoid these situations, some macros which would normally take three or four parameters take optional attributes instead, so you can write:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> image[test.png <span class="no">2</span> @width[50%] <span class="no">3</span> @alt[Test Image]@@ -82,18 +86,30 @@ <span class="no">4</span> @height[50%]
<span class="no">5</span> ]</pre></div> </div> - <p>More verbose, of course, but definitely more readable. In this way, if you won't want to scale an image, you can safely omit the <code>@width</code> and <code>@height</code> attributes.</p> - <aside class="note"> + <p>More verbose, of course, but definitely more readable. In this way, if you won't want to scale an image, you can safely omit the <code>@width</code> and <code>@height</code> attributes.</p> + <aside class="note"> <span class="note-title">Note</span>Like parameters, attributes can contain other macros, too. </aside> - <nav><a href="/glyph/book/text_editing/macro_intro.html">Introducing Glyph Macros ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/esc_quot.html">→ Escaping and Quoting</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/text_editing/macro_intro.html">Introducing Glyph Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/macro_composition.html">Macro Composition</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -101,50 +117,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,69 +1,73 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Source Code – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Source Code - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Source Code</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Source Code</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/text_editing/images.html">Images and Figures ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/raw_html.html">→ Textile or Markdown</a></nav> - <p>If you’re a programmer, chances are that you’re going to include some source code in your articles and books. Glyph offers two ways to format code blocks effortlessly: the <a href="/glyph/book/macros/macros_block.html#m_codeblock"><code>codeblock</code></a> macro, which simply wraps text into <code><pre></code> and <code><code></code> tags, or the <a href="/glyph/book/macros/macros_filters.html#m_highlight"><code>highlight</code></a> macro. The last one requires either <a href="http://coderay.rubychan.de/">Coderay</a> or <a href="http://ultraviolet.rubyforge.org/">Ultraviolet</a>, but it provides syntax highlighting for the most common programming languages.</p> + <nav class="navigation"><a href="/glyph/book/text_editing/images.html">Images and Figures</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/raw_html.html">Textile or Markdown</a></nav> + <p>If you’re a programmer, chances are that you’re going to include some source code in your articles and books. Glyph offers two ways to format code blocks effortlessly: the <a href="/glyph/book/macros/macros_block.html#m_codeblock"><code>codeblock</code></a> macro, which simply wraps text into <code><pre></code> and <code><code></code> tags, or the <a href="/glyph/book/macros/macros_filters.html#m_highlight"><code>highlight</code></a> macro. The last one requires either <a href="http://coderay.rubychan.de/">Coderay</a> or <a href="http://ultraviolet.rubyforge.org/">Ultraviolet</a>, but it provides syntax highlighting for the most common programming languages.</p> <p>Cosider the following piece of ruby code:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> def find_child(&block) <span class="no">2</span> children.each do |c| <span class="no">3</span> c.descend do |node, level|@@ -74,8 +78,8 @@ <span class="no">7</span> nil
<span class="no">8</span> end</pre></div> </div> - <p>It can be wrapped in a highlight macro, like so:</p> - <div class="CodeRay"> + <p>It can be wrapped in a highlight macro, like so:</p> + <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> highlight[=ruby| <span class="no"> 2</span> def find_child(&block) <span class="no"> 3</span> children.each do |c|@@ -88,8 +92,8 @@ <span class="no"> 9</span> end
<span class="no"><strong>10</strong></span> =]</pre></div> </div> - <p>...to produce the following, using the coderay highlighter:</p> - <div class="CodeRay"> + <p>...to produce the following, using the coderay highlighter:</p> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> <span class="r">def</span> <span class="fu">find_child</span>(&block) <span class="no">2</span> children.each <span class="r">do</span> |c| <span class="no">3</span> c.descend <span class="r">do</span> |node, level|@@ -100,7 +104,7 @@ <span class="no">7</span> <span class="pc">nil</span>
<span class="no">8</span> <span class="r">end</span></pre></div> </div> - <aside class="box"> + <aside class="box"> <div class="box-title">Some Remarks</div> <ul> <li>Highlighters require some configuration. For more information on relevant configuration settings, see the <a href="/glyph/book/config/filters.html#cfg_filters">filters.*</a> configuration settings.</li>@@ -109,13 +113,25 @@ <li>You must always escape pipes (<code>|</code>) with the code or the highlight macro.</li>
</ul> </aside> - <nav><a href="/glyph/book/text_editing/images.html">Images and Figures ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/raw_html.html">→ Textile or Markdown</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/text_editing/images.html">Images and Figures</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/raw_html.html">Textile or Markdown</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -123,50 +139,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,83 +1,86 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Conditional Macros – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Conditional Macros - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Conditional Macros</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Conditional Macros</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/text_editing/evaluation.html">Evaluating Ruby code and Configuration Settings ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/compiling/compiling.html">→ Compiling a project</a></nav> - <p>Sometimes you may want text to be included in a document only if certain conditions are satisfied. For example, you may want to display a disclaimer section only if the document is a draft (see the <a href="/glyph/book/config/document.html#s_document_draft"><code>document.draft</code></a> setting), or use a particular stylesheet only if when you generate a <span class="caps">PDF</span> document.</p> + <nav class="navigation"><a href="/glyph/book/text_editing/inclusions.html">Content Reuse</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/evaluation.html">Simple Programming and Code Evaluation</a></nav> + <p>Sometimes you may want text to be included in a document only if certain conditions are satisfied. For example, you may want to display a disclaimer section only if the document is a draft (see the <a href="/glyph/book/config/document.html#s_document_draft"><code>document.draft</code></a> setting), or use a particular stylesheet only if when you generate a <span class="caps">PDF</span> document.</p> <p>To do so, you can use the <a href="/glyph/book/macros/macros_core.html#m_condition"><code>condition</code></a> macro (aliased by <code>?</code>), and a set of additional macros that can be used as conditional operators i.e.:</p> <ul> <li><a href="/glyph/book/macros/macros_core.html#m_eq"><code>eq</code></a> macro</li> <li><a href="/glyph/book/macros/macros_core.html#m_not"><code>not</code></a> macro</li> <li><a href="/glyph/book/macros/macros_core.html#m_and"><code>and</code></a> macro</li> <li><a href="/glyph/book/macros/macros_core.html#m_or"><code>or</code></a> macro</li> - <li><a href="/glyph/book/macros/macros_core.html#m_match"><code>match</code></a> macro</li> </ul> <p>Consider the following code:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> ?[$[document.draft]| <span class="no">2</span> This is a first draft of the Glyph Book| <span class="no">3</span> This is the official version of the Glyph Book]</pre></div> </div> - <p>In this case, if <code>document.draft</code> is set to <code>true</code>, “This is a first draft of the Glyph Book” will be displayed; if not, “This is the official version of the Glyph Book” will be displayed instead.</p> + <p>In this case, if <code>document.draft</code> is set to <code>true</code>, “This is a first draft of the Glyph Book” will be displayed; if not, “This is the official version of the Glyph Book” will be displayed instead.</p> <p>The <a href="/glyph/book/macros/macros_core.html#m_condition"><code>condition</code></a> macro takes up to three parameters:</p> <ol> <li>the condition to evaluate</li>@@ -85,7 +88,7 @@ <li>the text to include in the document only if the condition is satisfied.</li>
<li><em>(Optional)</em> the text to include in the document if the condition is <em>not</em> satisfied.</li> </ol> <p>Note that <em>all</em> parameters can contain macros, of course, so you can write things like:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> ?[and[ <span class="no">2</span> eq[$[document.output]|pdf] <span class="no">3</span> |@@ -95,9 +98,9 @@ <span class="no">6</span> |
<span class="no">7</span> style[pagination.css]]</pre></div> </div> - <p>In this case, the <code>pagination.css</code> stylesheet is included only when you're generating a PDF document using Prince XML.</p> + <p>In this case, the <code>pagination.css</code> stylesheet is included only when you're generating a PDF document using Prince XML.</p> <section class="section"> -<header><h1 id="h_39">Results of conditional expressions</h1></header> +<header><h1 id="h_43">Results of conditional expressions</h1></header> <p>The <a href="/glyph/book/macros/macros_core.html#m_condition"><code>condition</code></a> macro in Glyph works in a similar way as conditionals in programming languages: if the conditional expression (supplied as first parameter) is satisfied then the second parameter is executed or displayed. But when is a conditional expression satisfied? Glyph is a simple mini-language to perform text manipulation, and has no types, it can only understand text, therefore:</p> <ul> <li>A conditional expression is satisfied if it evaluates to a non-empty string except “false”.</li>@@ -105,13 +108,25 @@ <li>A conditional expression is not satisfied if it evaluates to an empty string or the string “false”.</li>
</ul> </section> - <nav><a href="/glyph/book/text_editing/evaluation.html">Evaluating Ruby code and Configuration Settings ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/compiling/compiling.html">→ Compiling a project</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/text_editing/inclusions.html">Content Reuse</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/evaluation.html">Simple Programming and Code Evaluation</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -119,50 +134,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Escaping and Quoting – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Escaping and Quoting - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Escaping and Quoting</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Escaping and Quoting</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/text_editing/attribute_intro.html">Macro attributes ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/sections.html">→ Sections and Headers</a></nav> + <nav class="navigation"><a href="/glyph/book/text_editing/macro_composition.html">Macro Composition</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/sections.html">Sections and Headers</a></nav> <p>Glyph doesn’t require any special control characters like LaTeX, and its macro syntax is very straightforward and liberal. This however comes with a price: because square brackets are used as delimiters, you must escape any square bracket in your text with a backslash. That’s not <em>too</em> bad if you think about it, unless you’re writing programming code, in which case escaping every single square bracket can be painful.</p> <p>If a portion of your text contains an excessive amount of square brackets, you may consider using the <a href="/glyph/book/macros/macros_core.html#m_escape"><code>escape</code></a> macro (or its alias <code>.</code>) with the <code>[=</code> and <code>=]</code> delimiters. By itself, the escape macro doesn’t do anything: it just evaluates to its contents, but the special delimiters act as an escape for any square bracket within them. As a consequence, any macro within <code>[=</code> and <code>=]</code> will <em>not</em> be evaluated.</p> <p>You can use the quoting delimiters with <em>any</em> macro identifier. Obviously, using them as delimiters for things like <a href="/glyph/book/macros/macros_structure.html#m_section"><code>section</code></a> macros may not be a good idea, but they should be more or less mandatory with the <a href="/glyph/book/macros/macros_block.html#m_codeblock"><code>codeblock</code></a> macro or the <a href="/glyph/book/macros/macros_filters.html#m_highlight"><code>highlight</code></a> macro, especially when it contains square brackets or even Glyph code, like this:</p>@@ -87,56 +91,89 @@ </aside>
<p>Besides square brackets, there are other characters that must or can be escaped with backslashes, as shown in the following table:</p> - <table><tr><th>Escape Sequence</th> + <table> + <tr> + <th>Escape Sequence</th> <th>Evaluates to...</th> - <th>Notes</th></tr> - <tr><td> + <th>Notes</th> + </tr> + <tr> + <td> <code>\[</code> </td> <td> <code>[</code> </td> - <td>Square brackets must be escaped unless used as macro delimiters or within a quoting macro.</td></tr> - <tr><td> + <td> +Square brackets must be escaped unless used as macro delimiters or within a quoting macro. +</td> + </tr> + <tr> + <td> <code>\]</code> </td> <td> <code>]</code> </td> - <td>Square brackets must be escaped unless used as macro delimiters or within a quoting macro.</td></tr> - <tr><td> + <td> +Square brackets must be escaped unless used as macro delimiters or within a quoting macro. +</td> + </tr> + <tr> + <td> <code>\\</code> </td> <td> <code>\</code> </td> - <td>Backslashes do not have to be escaped by default, but an escaped backslash will evaluate to itself.</td></tr> - <tr><td> + <td>Backslashes do not have to be escaped by default, but an escaped backslash will evaluate to itself.</td> + </tr> + <tr> + <td> <code>\=</code> </td> <td> <code>=</code> </td> - <td>Equal signs do not have to be escaped by default, but an escaped equal sign will evaluate to iself.</td></tr> - <tr><td> + <td>Equal signs do not have to be escaped by default, but an escaped equal sign will evaluate to iself.</td> + </tr> + <tr> + <td> <code>\|</code> </td> <td> <code>|</code> </td> - <td>Pipes must be escaped (even within quoting macros) unless they are used to separate macro parameters.</td></tr> - <tr><td> -<code>\.</code> + <td>Pipes must be escaped (even within quoting macros) unless they are used to separate macro parameters.</td> + </tr> + <tr> + <td> +<code>\/</code> </td> <td /> - <td>An escaped dot evaluates to nothing. Useful to separate macro identifiers from other characters: <br /><code>_\.=>[#link|This link is emphasized using Textile]_</code></td></tr></table> - <nav><a href="/glyph/book/text_editing/attribute_intro.html">Macro attributes ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/sections.html">→ Sections and Headers</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <td>An escaped dot evaluates to nothing. Useful to separate macro identifiers from other characters: <br /><code>_\/=>[#link|This link is emphasized using Textile]_ </code> + </td> + </tr> + </table> + <nav class="navigation"><a href="/glyph/book/text_editing/macro_composition.html">Macro Composition</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/sections.html">Sections and Headers</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -144,50 +181,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,81 +1,149 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Evaluating Ruby code and Configuration Settings – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Simple Programming and Code Evaluation - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Simple Programming and Code Evaluation</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> + <nav class="navigation"><a href="/glyph/book/text_editing/conditionals.html">Conditional Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/compiling/compiling.html">Compiling a project</a></nav> + <section class="section"> +<header><h1 id="h_45">Turing-completeness</h1></header> +<p>As of version 0.5.0, Glyph can be considered <em>Turing-complete</em>, as it satisfies the following <a href="http://c2.com/cgi/wiki?LanguageRequirementsForTuringCompleteness">requirements for Turing-completeness</a>:</p> +<ul> + <li>A conditional construct, implemented via the <a href="/glyph/book/macros/macros_core.html#m_condition"><code>condition</code></a> macro.</li> + <li>Variable assignment, by setting the value of snippets using the <a href="/glyph/book/macros/macros_core.html#m_snippet_"><code>snippet:</code></a> macro and of attributes using the <a href="/glyph/book/macros/macros_core.html#m_attribute_"><code>attribute:</code></a> macro.</li> + <li>(infinite) iteration implemented through the <a href="/glyph/book/macros/macros_core.html#m_while"><code>while</code></a> macro or recursion, which is possible thanks to the <a href="/glyph/book/macros/macros_core.html#m_define_"><code>define:</code></a> macro.</li> + <li>A memory model which emulates an infinite store: there are no enforced limits on attribute/snippets allocations and number of algorithms or parameters.</li> +</ul> - <section id="container"> +</section> - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <section class="section"> +<header><h1 id="h_46">Operations on integer values</h1></header> +<p>Glyph can be used to perform operation on integer values (additions, subtractions and multiplications). For example, <code>add[2|3|7]</code> will evaluate to <code>12</code>, and <code>multiply[add[3|7]|subtract[5|1|2]]</code> will return 20.</p> +<p>As a more complex example, consider the following <code>factorial</code> macro, which is able to calculate the factorial of a number recursively:</p> +<div class="CodeRay"> + <div class="code"><pre><span class="no">1</span> def:[factorial|<br /> +<span class="no">2</span> ?[<br /> +<span class="no">3</span> eq[|0]|1|<br /> +<span class="no">4</span> multiply[<br /> +<span class="no">5</span> | factorial[subtract[|1]]<br /> +<span class="no">6</span> ]<br /> +<span class="no">7</span> ]<br /> +<span class="no">8</span> ]</pre></div> +</div> +<p>If you try executing <code>factorial[5]</code>, it will evaluate to <code>120</code>.</p> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> +</section> + <section class="section"> +<header><h1 id="h_47">Lexically-scoped attribute assignment</h1></header> +<p><a href="/glyph/book/text_editing/inclusions.html#snippets">Snippets</a> can be used in a similar way as <em>variables</em> are used in programming languages. Or better, they can be used as <em>global variables</em>, as they are visible from anywhere in the Glyph document. If you need something more restricted to, say, a section and all its subsections, you can define your own attributes and use them in a very similar way.</p> +<p>Consider the following Glyph code:</p> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Evaluating Ruby code and Configuration Settings</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> +</section> + <div class="CodeRay"> + <div class="code"><pre><span class="no">1</span> let[ +<span class="no">2</span> @:[a|bits] +<span class="no">3</span> @:[b|bobs] +<span class="no">4</span> section[ +<span class="no">5</span> @title[Something more about attributes] +<span class="no">6</span> Attributes are like lexically scoped variables. You can use them to store @[a] and @[b]. +<span class="no">7</span> ] +<span class="no">8</span> ]</pre></div> +</div> - <nav><a href="/glyph/book/text_editing/inclusions.html">Including Files and Snippets ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/conditionals.html">→ Conditional Macros</a></nav> - <p>Glyph Language is not a full-blown programming language and it is currently not Turing-complete (it does not provide loops). However, it is possible to evaluate simple ruby code snippets using the <code>ruby</code> macro (aliased to <code>%</code>), like this:</p> + <p>The <a href="/glyph/book/macros/macros_core.html#m_let"><code>let</code></a> macro here only acts as a dummy macro (it does nothing really) to bind attributes using the <a href="/glyph/book/macros/macros_core.html#m_attribute_"><code>attribute:</code></a> macro (aliased by <code>@:</code>). Attributes can then be used anywhere within the <code>let</code> macro, so the content of the section reads: “Attributes are like lexically-scoped variables. You can use them to store bits and bobs”.</p> +<p>Note that attributes defined through the <a href="/glyph/book/macros/macros_core.html#m_attribute_"><code>attribute:</code></a> macro are… well, attributes! Feel free to use the <a href="/glyph/book/macros/macros_core.html#m_attribute"><code>attribute</code></a> macro to access standard attributes like <code>title</code>, etc.</p> + <section class="section"> +<header><h1 id="h_48">Evaluating Ruby code</h1></header> +<p>For anything more complex than what described in the previous sections you can also evaluate simple ruby code snippets using the <code>ruby</code> macro (aliased to <code>%</code>), like this:</p> <ul> <li><code>%[2 + 2]</code> → 4</li> - <li><code>%[Time.now]</code> → Fri Oct 22 22:51:14 +0200 2010</li> - <li><code>%[Glyph::VERSION]</code> → 0.4.2</li> + <li><code>%[Time.now]</code> → Sun Aug 28 20:18:00 +0200 2011</li> + <li><code>%[Glyph::VERSION]</code> → 0.5.0</li> </ul> <p>The scope for the code evaluation is the Kernel module, (with all inclusions required by Glyph itself).</p> <p>Although it is possible to retrieve Glyph configuration settings in this way (e.g. <code>%[cfg('document.author')]</code>), the <a href="/glyph/book/macros/macros_core.html#m_config"><code>config</code></a> macro (aliased to <code>$</code>) makes things slightly simpler (e.g. <code>$[document.author]</code>).</p> - <nav><a href="/glyph/book/text_editing/inclusions.html">Including Files and Snippets ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/conditionals.html">→ Conditional Macros</a></nav> - </section> - </article> - - <footer> - <section class="ads"> +</section> + <nav class="navigation"><a href="/glyph/book/text_editing/conditionals.html">Conditional Macros</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/compiling/compiling.html">Compiling a project</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -83,50 +151,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,76 +1,92 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>.glyph files – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>.glyph files - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>.glyph files</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>.glyph files</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/getting_started/configuration.html">Project Configuration ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/macro_intro.html">→ Introducing Glyph Macros</a></nav> + <nav class="navigation"><a href="/glyph/book/getting_started/configuration.html">Project Configuration</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/macro_intro.html">Introducing Glyph Macros</a></nav> <p>The <code>text</code> folder of any Glyph folder contains all the text source files used to produce a document. Although there are no restrictions on the extension of the files in this folder, you may want to use <code>.glyph</code>, especially if <a href="http://www.vim.org">Vim</a> is your favorite text editor.</p> <p>The reason is simple: a Glyph syntax file is <a href="http://www.vim.org/scripts/script.php?script_id=3086">available on vim.org</a>. Although not essential, syntax highlighting does help when editing Glyph files.</p> <p>If you use TextMate, you may want to check out Eric Givens’ <a href="http://github.com/darthzippy/glyph.tmbundle">Glyph TextMate Bundle</a>.</p> - <nav><a href="/glyph/book/getting_started/configuration.html">Project Configuration ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/macro_intro.html">→ Introducing Glyph Macros</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/getting_started/configuration.html">Project Configuration</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/macro_intro.html">Introducing Glyph Macros</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -78,50 +94,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,71 +1,77 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Images and Figures – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Images and Figures - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Images and Figures</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Images and Figures</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/text_editing/links.html">Links and Bookmarks ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/code.html">→ Source Code</a></nav> + <nav class="navigation"><a href="/glyph/book/text_editing/links.html">Links and Bookmarks</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/code.html">Source Code</a></nav> <p>Same as for <a href="/glyph/book/text_editing/links.html#links">links</a>, you can also include images and figures using Textile or Markdown. If you want additional features, you can use the <a href="/glyph/book/macros/macros_block.html#m_image"><code>image</code></a> macro and the <a href="/glyph/book/macros/macros_block.html#m_figure"><code>figure</code></a> macro, as shown in the following example:</p> <aside class="box"> <div class="box-title">Example</div> -<p>The following Glyph code:</p> +<p> +The following Glyph code: +</p> <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> image[glyph.svg <span class="no">2</span> @with[20%]@@ -76,7 +82,9 @@ <span class="no">6</span> @alt[Example Figure]
<span class="no">7</span> ]</pre></div> </div> - <p>Is translated into the following HTML code:</p> + <p> +Is translated into the following HTML code: +</p> <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> <span class="ta"><img</span> <span class="an">src</span>=<span class="s"><span class="dl">"</span><span class="k">images/glyph.svg</span><span class="dl">"</span></span> <span class="an">width</span>=<span class="s"><span class="dl">"</span><span class="k">20%</span><span class="dl">"</span></span> <span class="an">height</span>=<span class="s"><span class="dl">"</span><span class="k">20%</span><span class="dl">"</span></span> <span class="ta">/></span> <span class="no">2</span> <span class="ta"><div</span> <span class="an">class</span>=<span class="s"><span class="dl">"</span><span class="k">figure</span><span class="dl">"</span></span><span class="ta">></span>@@ -92,13 +100,25 @@ <aside class="note">
<span class="note-title">Note</span>In future releases, figures will be numbered automatically and included in a <em>List of Figures</em> section. </aside> - <nav><a href="/glyph/book/text_editing/links.html">Links and Bookmarks ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/code.html">→ Source Code</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/text_editing/links.html">Links and Bookmarks</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/code.html">Source Code</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -106,50 +126,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,67 +1,73 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Including Files and Snippets – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Content Reuse - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Content Reuse</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Including Files and Snippets</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/text_editing/stylesheets.html">Adding Stylesheets ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/evaluation.html">→ Evaluating Ruby code and Configuration Settings</a></nav> - <p>If you’re authoring a user manual, a long article, or a book, writing everything inside a single <code>document.glyph</code> file may not be optimal. For this reason, Glyph provides an <a href="/glyph/book/macros/macros_core.html#m_include"><code>include</code></a> macro that can be used to include the contents of any file within the <code>text/</code> directory:</p> + <nav class="navigation"><a href="/glyph/book/text_editing/stylesheets.html">Adding Stylesheets</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/conditionals.html">Conditional Macros</a></nav> + <section class="section"> +<header><h1 id="file-inclusions">File inclusions</h1></header> +<p>If you’re authoring a user manual, a long article, or a book, writing everything inside a single <code>document.glyph</code> file may not be optimal. For this reason, Glyph provides an <a href="/glyph/book/macros/macros_core.html#m_include"><code>include</code></a> macro that can be used to include the contents of any file within the <code>text/</code> directory:</p> <p><code>include[general/introduction.textile]</code></p> <p>The macro call above loads the contents of the <code>introduction.textile</code> file, within the <code>text/general</code> directory.</p> <p>When including a text file, an input filter macro is applied to its contents by default, based on the file extension used:</p>@@ -70,44 +76,61 @@ <li><code>.textile</code> or <code>.txt</code> → <a href="/glyph/book/macros/macros_filters.html#m_textile"><code>textile</code></a> macro</li>
<li><code>.markdown</code> or <code>.md</code> → <a href="/glyph/book/macros/macros_filters.html#m_markdown"><code>markdown</code></a> macro</li> </ul> <p>You can override this behavior by setting the <code>filters.by_file_extensions</code> configuration setting to <code>false</code>. If no extension is specified, <code>.glyph</code> is assumed.</p> -<aside class="tip"> -<p><span class="note-title">Tip</span>The <a href="/glyph/book/macros/macros_core.html#m_include"><code>include</code></a> macro can also be used to include (and evaluate) ruby files (with a <code>.rb</code> extension). In this case, the ruby file must be placed within the <code>lib/</code> directory of the current project.</p> -</aside> + <section class="section"> +<header><h1 id="h_39">Remarks</h1></header> +<ul> + <li>The <a href="/glyph/book/macros/macros_core.html#m_include"><code>include</code></a> macro can also be used to include (and evaluate) ruby files (with a <code>.rb</code> extension). In this case, the ruby file must be placed within the <code>lib/</code> directory of the current project.</li> + <li>The <a href="/glyph/book/macros/macros_core.html#m_load"><code>load</code></a> macro macro can be used to include the content of any file <em>without</em> performing any evaluation.</li> +</ul> + +</section> + +</section> + <section class="section"> +<header><h1 id="snippets">Snippets</h1></header> <p>While including the context of an entire file is definitely a useful feature for content reuse, sometimes it can be an overkill. What if, for example, you just want to reuse a short procedure or even a sentence or a single word? In this case, you may want to consider using a <em>snippet</em> instead.</p> -<p>Snippets are text strings saved in <span class="caps">YAML</span> format in the <code>snippets.yml</code> file. They can be included anywhere in your document using the <a href="/glyph/book/macros/macros_core.html#m_snippet"><code>snippet</code></a> macro (or its alias <code>&</code>).</p> -<aside class="tip"> -<p><span class="note-title">Tip</span>Besides storing snippets in the <code>snippets.yml</code> file, you can also define them right in your document, using the <a href="/glyph/book/macros/macros_core.html#m_snippet_"><code>snippet:</code></a> macro.</p> -</aside> - <aside class="box"> -<div class="box-title">Example</div> -<p>Consider the following <code>snippets.yml</code> file:</p> - <div class="CodeRay"> - <div class="code"><pre><span class="no"> 1</span> <span class="head"><span class="head">---</span></span> -<span class="no"> 2</span> <span class="sy">:glang</span>: <span class="er">Glyph Language</span> -<span class="no"> 3</span> <span class="sy">:macros</span>: <span class="er">Glyph Macros</span> -<span class="no"> 4</span> <span class="sy">:sq_esc</span>: <span class="er">|-</span> -<span class="no"> 5</span> <span class="er">Square brackets must be escaped </span> -<span class="no"> 6</span> <span class="er">unless used as macro delimiters or within a quoting macro.</span> -<span class="no"> 7</span> <span class="sy">:markups</span>: <span class="er">Textile or Markdown</span> -<span class="no"> 8</span> <span class="sy">:test</span>: <span class="er">|-</span> -<span class="no"> 9</span> <span class="er">This is a </span> -<span class="no"><strong>10</strong></span> <span class="er">Test snippet</span></pre></div> +<p>Snippets can be defined using the <a href="/glyph/book/macros/macros_core.html#m_snippet_"><code>snippet:</code></a> macro (aliased by <code>&:</code>) and called by using the <a href="/glyph/book/macros/macros_core.html#m_snippet"><code>snippet</code></a> macro (aliased by <code>&</code>). Consider the following simple example:</p> + <div class="CodeRay"> + <div class="code"><pre><span class="no">1</span> <span class="er">&</span>:[markups|Textile or Markdown] +<span class="no">2</span> +<span class="no">3</span> Glyph supports <span class="er">&</span>[markups].</pre></div> </div> - <p>You can use <code>&[markups]</code> anywhere in your document instead of having to type "Textile or Markdown" every time. Additionally, later on you can change the value of the <code>markups</code> snippet only in the <code>snippets.yml</code> file to change it everywhere else in the document.</p> - -</aside> - <aside class="tip"> + <p>You can use <code>&[markups]</code> anywhere in your document instead of having to type "Textile or Markdown" every time. Additionally, later on you can change the value of the <code>markups</code> to change it everywhere else in the document.</p> + <aside class="tip"> <span class="note-title">Tip</span>Snippets (or any other macro) can be nested within other snippets. Glyph takes care of checking if you nested snippets or macros mutually and warns you as necessary. </aside> - <nav><a href="/glyph/book/text_editing/stylesheets.html">Adding Stylesheets ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/evaluation.html">→ Evaluating Ruby code and Configuration Settings</a></nav> - </section> - </article> +</section> + <section class="section"> +<header><h1 id="fragments">Fragments</h1></header> +<p>As an even simpler alternative to snippets, consider using <em>fragments</em>. The <a href="/glyph/book/macros/macros_core.html#m_fragment"><code>fragment</code></a> macro (aliased by <code>##</code>) can be used to mark a section of Glyph code as a fragment that can then be <em>embedded</em> using the <a href="/glyph/book/macros/macros_core.html#m_embed"><code>embed</code></a> macro (aliased by <code><=</code>), like this:</p> + + <div class="CodeRay"> + <div class="code"><pre><span class="no">1</span> Snippets and fragments ##[good_way|are a good way to reuse] small chunks of content, while the include and load macros <span class="er"><</span>=[good_way] entire files.</pre></div> +</div> - <footer> - <section class="ads"> +</section> + <nav class="navigation"><a href="/glyph/book/text_editing/stylesheets.html">Adding Stylesheets</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/conditionals.html">Conditional Macros</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -115,50 +138,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Links and Bookmarks – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Links and Bookmarks - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Links and Bookmarks</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Links and Bookmarks</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/text_editing/topics.html">Topics ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/images.html">→ Images and Figures</a></nav> + <nav class="navigation"><a href="/glyph/book/text_editing/topics.html">Topics</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/images.html">Images and Figures</a></nav> <p>Lightweight markups let you create internal and external links in a very easy way, and you can still do so in Glyph. However, if you do so:</p> <ul> <li>you can’t check if they are valid</li>@@ -73,7 +77,9 @@ <li>the <a href="/glyph/book/macros/macros_inline.html#m_anchor"><code>anchor</code></a> macro (aliased to <code>#</code>) — to create named anchors (bookmarks) within your document.</li>
</ul> <aside class="box"> <div class="box-title">Example</div> -<p>The following Glyph code:</p> +<p> +The following Glyph code: +</p> <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> This is a link to link[#test]. <span class="no">2</span> ...@@ -81,7 +87,9 @@ <span class="no">3</span> This is link[#wrong].
<span class="no">4</span> This is a #[test|test anchor].</pre></div> </div> - <p>Is translated into the following HTML code:</p> + <p> +Is translated into the following HTML code: +</p> <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> <span class="ta"><p></span>This is a link to <span class="ta"><a</span> <span class="an">href</span>=<span class="s"><span class="dl">"</span><span class="k">#test</span><span class="dl">"</span></span><span class="ta">></span>test anchor<span class="ta"></a></span>.<span class="ta"></p></span> <span class="no">2</span> <span class="ta"><p></span>...<span class="ta"></p></span>@@ -117,13 +125,25 @@ <aside class="important">
<span class="note-title">Important</span>Enabling URL validation may significantly slow down compilation if a lot of external links are present. </aside> - <nav><a href="/glyph/book/text_editing/topics.html">Topics ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/images.html">→ Images and Figures</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/text_editing/topics.html">Topics</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/images.html">Images and Figures</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -131,50 +151,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Introducing Glyph Macros – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Introducing Glyph Macros - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Introducing Glyph Macros</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Introducing Glyph Macros</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/text_editing/glyph_files.html">.glyph files ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/attribute_intro.html">→ Macro attributes</a></nav> + <nav class="navigation"><a href="/glyph/book/text_editing/glyph_files.html">.glyph files</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/attribute_intro.html">Macro attributes</a></nav> <p>The most important concept to grasp about Glyph is the concept of <em>macro</em>.</p> <p>A Glyph macro is, in a nutshell, an identifier of some kind that wraps a value or parameters within square brackets. More specifically:</p>@@ -75,13 +79,25 @@ <ul>
<li><code>=>[#test|Test Section]</code></li> <li><code>link[#test|Test Section]</code></li> </ul> - <nav><a href="/glyph/book/text_editing/glyph_files.html">.glyph files ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/attribute_intro.html">→ Macro attributes</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/text_editing/glyph_files.html">.glyph files</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/attribute_intro.html">Macro attributes</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -89,50 +105,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,67 +1,73 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Textile or Markdown – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Textile or Markdown - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Textile or Markdown</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Textile or Markdown</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/text_editing/code.html">Source Code ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/xml_fallback.html">→ XML Fallback</a></nav> - <p>Textile or Markdown are very easy and intuitive to use, and they can produce HTML markup with almost no effort. Using them with Glyph is as simple as using the <a href="/glyph/book/macros/macros_filters.html#m_textile"><code>textile</code></a> macro (aliased to <code>txt</code>) and the <a href="/glyph/book/macros/macros_filters.html#m_markdown"><code>markdown</code></a> macro (aliased to <code>md</code>).</p> + <nav class="navigation"><a href="/glyph/book/text_editing/code.html">Source Code</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/xml_fallback.html">XML Fallback</a></nav> + <p> +Textile or Markdown are very easy and intuitive to use, and they can produce HTML markup with almost no effort. Using them with Glyph is as simple as using the <a href="/glyph/book/macros/macros_filters.html#m_textile"><code>textile</code></a> macro (aliased to <code>txt</code>) and the <a href="/glyph/book/macros/macros_filters.html#m_markdown"><code>markdown</code></a> macro (aliased to <code>md</code>). +</p> <aside class="box"> <div class="box-title">Example</div> <p>The following Glyph code:</p>@@ -92,13 +98,25 @@ <aside class="important">
<span class="note-title">Important</span>Be careful when using block-level HTML with Textile and Markdown: sometimes it may be necessary to add extra empty lines or escape tags. </aside> - <nav><a href="/glyph/book/text_editing/code.html">Source Code ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/xml_fallback.html">→ XML Fallback</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/text_editing/code.html">Source Code</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/xml_fallback.html">XML Fallback</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -106,50 +124,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,99 +1,129 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Section Aliases – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Section Aliases - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> + <meta content="44.388041;9.073248" name="ICBM" /> - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Section Aliases</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Section Aliases</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/text_editing/sections.html">Sections and Headers ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/topics.html">→ Topics</a></nav> - <p>There are <em>a lot</em> of macros that can be used in the same way as <code>section</code>, one for each element commonly used in <a href="http://en.wikipedia.org/wiki/Book_design">book design</a>.</p> + <nav class="navigation"><a href="/glyph/book/text_editing/sections.html">Sections and Headers</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/topics.html">Topics</a></nav> + <p>There are <em>a lot</em> of macros that can be used in the same way as <code>section</code>, one for each element commonly used in <a href="http://en.wikipedia.org/wiki/Book_design">book design</a>.</p> <p>The following table lists the identifiers of all section-like macros, divided according to the part of the book they should be placed in:</p> - <table><tr><th>Frontmatter</th> - <td><p><code>imprint</code> <sup>†</sup>, <code>dedication</code> <sup>†</sup>, <code>inspiration</code> <sup>†</sup>, <code>foreword</code> <sup>‡</sup>, <code>introduction</code> <sup>‡</sup>, <code>acknowledgement</code> <sup>‡</sup>, <code>prologue</code> <sup>‡</sup>, <code>toc</code> <sup>*</sup></p></td></tr> - <tr><th>Bodymatter</th> - <td><p><code>volume</code>, <code>book</code>, <code>part</code>, <code>chapter</code></p></td></tr> - <tr><th>Backmatter</th> - <td><p><code>epilogue</code> <sup>‡</sup>, <code>afterword</code> <sup>‡</sup>, <code>postscript</code> <sup>†</sup>, <code>appendix</code>, <code>addendum</code> <sup>‡</sup>, <code>glossary</code> <sup>**‡</sup>, <code>colophon</code> <sup>†</sup>, <code>bibliography</code> <sup>**‡</sup>, <code>promotion</code> <sup>†</sup>, <code>references</code> <sup>**‡</sup>, <code>index</code> <sup>**‡</sup>, <code>lot</code> <sup>**‡</sup>, <code>lof</code> <sup>**‡</sup></p></td></tr></table> + <table> + <tr> + <th>Frontmatter</th> + <td> +<p><code>imprint</code> <sup>†</sup>, <code>dedication</code> <sup>†</sup>, <code>inspiration</code> <sup>†</sup>, <code>foreword</code> <sup>‡</sup>, <code>introduction</code> <sup>‡</sup>, <code>acknowledgement</code> <sup>‡</sup>, <code>prologue</code> <sup>‡</sup>, <code>toc</code> <sup>*</sup></p> +</td> + </tr> + <tr> + <th>Bodymatter</th> + <td> +<p><code>volume</code>, <code>book</code>, <code>part</code>, <code>chapter</code></p> +</td> + </tr> + <tr> + <th>Backmatter</th> + <td> +<p><code>epilogue</code> <sup>‡</sup>, <code>afterword</code> <sup>‡</sup>, <code>postscript</code> <sup>†</sup>, <code>appendix</code>, <code>addendum</code> <sup>‡</sup>, <code>glossary</code> <sup>**‡</sup>, <code>colophon</code> <sup>†</sup>, <code>bibliography</code> <sup>**‡</sup>, <code>promotion</code> <sup>†</sup>, <code>references</code> <sup>**‡</sup>, <code>index</code> <sup>**‡</sup>, <code>lot</code> <sup>**‡</sup>, <code>lof</code> <sup>**‡</sup></p> +</td> + </tr> + </table> - <p> + <p> <strong>*</strong>: The <a href="/glyph/book/macros/macros_structure.html#m_toc"><code>toc</code></a> macro is used to generate the Table of Contents automatically, and it takes no parameters. </p> - <p> + <p> <strong>**</strong>: This macro is likely to be extended in future versions to generate/aggregate content automatically. </p> - <p> + <p> <strong>†</strong>: This section is not listed in the Table of Contents. </p> - <p> + <p> <strong>‡</strong>: Any subsection of this section is not listed in the Table of Contents. </p> - <aside class="note"> + <aside class="note"> <span class="note-title">Note</span><code>frontmatter</code>, <code>bodymatter</code> and <code>backmatter</code> are also macro identifiers, but they are also exposed as attributes for the <a href="/glyph/book/macros/macros_structure.html#m_book"><code>book</code></a> macro and the <a href="/glyph/book/macros/macros_structure.html#m_article"><code>article</code></a> macro, so if you're using either of these two macros as your root macro for your document, there's no need to use them explicitly. </aside> - <nav><a href="/glyph/book/text_editing/sections.html">Sections and Headers ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/topics.html">→ Topics</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/text_editing/sections.html">Sections and Headers</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/topics.html">Topics</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -101,50 +131,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,70 +1,74 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Sections and Headers – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Sections and Headers - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Sections and Headers</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Sections and Headers</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/text_editing/esc_quot.html">Escaping and Quoting ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/section_aliases.html">→ Section Aliases</a></nav> + <nav class="navigation"><a href="/glyph/book/text_editing/esc_quot.html">Escaping and Quoting</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/section_aliases.html">Section Aliases</a></nav> - <p>Glyph documents are normally organized as a hierarchical tree of nested chapters, appendixes, sections, etc. To define a section, use the <a href="/glyph/book/macros/macros_structure.html#m_section"><code>section</code></a> macro (aliased by <code>§</code>), like so:</p> + <p>Glyph documents are normally organized as a hierarchical tree of nested chapters, appendixes, sections, etc. To define a section, use the <a href="/glyph/book/macros/macros_structure.html#m_section"><code>section</code></a> macro (aliased by <code>§</code>), like so:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> section[ <span class="no">2</span> @title[Section #1] <span class="no">3</span> Write the section contents here...@@ -76,10 +80,10 @@ <span class="no">8</span> ] --[End of Section #1]</pre></div>
</div> - <p>This example defines two nested sections. If the <code>@title</code> attribute is specified like in this case, it will be converted to a proper <span class="caps">HTML</span> header and it will appear in the Table of Contents (see the <a href="/glyph/book/macros/macros_structure.html#m_toc"><code>toc</code></a> macro).</p> + <p>This example defines two nested sections. If the <code>@title</code> attribute is specified like in this case, it will be converted to a proper <span class="caps">HTML</span> header and it will appear in the Table of Contents (see the <a href="/glyph/book/macros/macros_structure.html#m_toc"><code>toc</code></a> macro).</p> <p>Note an important difference from <span class="caps">HTML</span>: there is no need for an explicit level for the headers, as it will be determined at runtime when the document is compiled, based on how sections are nested. The previous code snippet (taken as it is), for example, will be transformed into the following <span class="caps">HTML</span> code:</p> - <div class="CodeRay"> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> <span class="ta"><div</span> <span class="an">class</span>=<span class="s"><span class="dl">"</span><span class="k">section</span><span class="dl">"</span></span><span class="ta">></span> <span class="no">2</span> <span class="ta"><h2></span>Section #1<span class="ta"></h2></span> <span class="no">3</span> <span class="ta"><p></span>Write the section contents here...<span class="ta"></p></span>@@ -91,12 +95,12 @@ <span class="no">8</span> <span class="ta"></div></span></pre></div>
</div> - <p>By default, in Glyph the first header level is <em>2</em>, so the two headers are rendered as <code>h2</code> and <code>h3</code>, respectively (<code>--[...]</code> macros are <em>comments</em>, therefore they are not included in the final output).</p> + <p>By default, in Glyph the first header level is <em>2</em>, so the two headers are rendered as <code>h2</code> and <code>h3</code>, respectively (<code>--[...]</code> macros are <em>comments</em>, therefore they are not included in the final output).</p> <section class="section"> -<header><h1 id="h_24">Markup-aware sections</h1></header> +<header><h1 id="h_25">Markup-aware sections</h1></header> <p>Although Glyph can be used on its own to produce valid <span class="caps">HTML</span> or <span class="caps">XML</span> code, you may often want to use Textile or Markdown to save some typing. Typically, you’ll end up writing a lot of code like this:</p> - - <div class="CodeRay"> + + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> section[ <span class="no">2</span> @title[My Textile section] <span class="no">3</span> textile[@@ -105,27 +109,39 @@ <span class="no">5</span> ]
<span class="no">6</span> ]</pre></div> </div> - <p>To save you even more typing, you can use the <a href="/glyph/book/macros/macros_filters.html#m_textile_section"><code>textile_section</code></a> macro (aliased by <code>txt_section</code> and <code>§txt</code>) and the <a href="/glyph/book/macros/macros_filters.html#m_markdown_section"><code>markdown_section</code></a> macro (aliased by <code>md_section</code> and <code>§md</code>). By doing so, the previous code snippet can be written like this:</p> - <div class="CodeRay"> + <p>To save you even more typing, you can use the <a href="/glyph/book/macros/macros_filters.html#m_textile_section"><code>textile_section</code></a> macro (aliased by <code>txt_section</code> and <code>§txt</code>) and the <a href="/glyph/book/macros/macros_filters.html#m_markdown_section"><code>markdown_section</code></a> macro (aliased by <code>md_section</code> and <code>§md</code>). By doing so, the previous code snippet can be written like this:</p> + <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> §txt[ <span class="no">2</span> @title[My Textile section] <span class="no">3</span> Textile markup can be used _here_. <span class="no">4</span> ]</pre></div> </div> - <aside class="tip"> + <aside class="tip"> <span class="note-title">Tip</span><p>On an Italian keyboard, you can type a <code>§</code> character by pressing <strong><span class="caps">SHIFT</span> + ù</strong>. Unfortunately, that’s about the only useful thing an Italian keyboard does. If you use Vim, you can map it to some key sequence like <code>''s</code>, like this: <code>map! ''s <C-V>u00A7</code>.</p> </aside> </section> - <nav><a href="/glyph/book/text_editing/esc_quot.html">Escaping and Quoting ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/section_aliases.html">→ Section Aliases</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/text_editing/esc_quot.html">Escaping and Quoting</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/section_aliases.html">Section Aliases</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -133,50 +149,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,106 +1,136 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Adding Stylesheets – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Adding Stylesheets - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Adding Stylesheets</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Adding Stylesheets</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> - - <nav><a href="/glyph/book/text_editing/xml_fallback.html">XML Fallback ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/inclusions.html">→ Including Files and Snippets</a></nav> - <p>Currently, Glyph does not provide any native way to format text and pages. The reason is that there's absolutely no need for that: CSS does the job just fine. In particular, CSS3 offers specific attributes and elements that can be used specifically for paginated documents. That's no replacement for LaTeX by any means, but it is enough if you're not looking for advanced typographical features.</p> - <p>You can embed CSS files using the <a href="/glyph/book/macros/macros_structure.html#m_style"><code>style</code></a> macro, like this:</p> - <p> -<code>style[default.css]</code> + <nav class="navigation"><a href="/glyph/book/text_editing/xml_fallback.html">XML Fallback</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/inclusions.html">Content Reuse</a></nav> + <p>Currently, Glyph does not provide any native way to format text and pages. The reason is that there's absolutely no need for that: CSS does the job just fine. In particular, CSS3 offers specific attributes and elements that can be used specifically for paginated documents. That's no replacement for LaTeX by any means, but it is enough if you're not looking for advanced typographical features.</p> + <p>You can embed CSS files using the <a href="/glyph/book/macros/macros_structure.html#m_style"><code>style</code></a> macro, like this:</p> + <p> +<code> style[default.css] </code> </p> - <p>In this case, the <a href="/glyph/book/macros/macros_structure.html#m_style"><code>style</code></a> macro looks for a <code>default.css</code> file in the <code>/styles</code> folder of your Glyph project <em>and</em> among the default Glyph stylesheets, and embeds it within a <code><style></code> tag. If you supply a file with a <code>.sass</code> or <code>.scss</code> extension, it will interpret it as a Sass file and convert it to <span class="caps">CSS</span> automatically (if the <em>Haml</em> gem is installed).</p> - <aside class="tip"> + <p>In this case, the <a href="/glyph/book/macros/macros_structure.html#m_style"><code>style</code></a> macro looks for a <code>default.css</code> file in the <code>/styles</code> folder of your Glyph project <em>and</em> among the default Glyph stylesheets, and embeds it within a <code><style></code> tag. If you supply a file with a <code>.sass</code> or <code>.scss</code> extension, it will interpret it as a Sass file and convert it to <span class="caps">CSS</span> automatically (if the <em>Haml</em> gem is installed).</p> + <aside class="tip"> <span class="note-title">Tip</span>By default, stylesheets are embedded within text files. If necessary, you can choose to link them or import them by changing the values of the <a href="/glyph/book/config/document.html#s_document_styles"><code>document.styles</code></a> setting. </aside> - <section class="section"> + <section class="section"> <header><h1 id="default_stylesheets">Default Stylesheets</h1></header> <p>Glyph provides the following default stylesheets, that can be referenced directly using the <a href="/glyph/book/macros/macros_structure.html#m_style"><code>style</code></a> macro:</p> - <table><tr><th>File name</th> - <th>Notes</th></tr> - <tr><td> + <table> + <tr> + <th>File name</th> + <th>Notes</th> + </tr> + <tr> + <td> <code>default.css</code> </td> - <td>The stylesheet used for this book.</td></tr> - <tr><td> + <td>The stylesheet used for this book.</td> + </tr> + <tr> + <td> <code>pagination.css</code> </td> - <td>A CSS3-compliant stylesheet used for pagination, suitable for PDF generation using <a href="http://www.princexml.com/">Prince</a>.</td></tr> - <tr><td> + <td>A CSS3-compliant stylesheet used for pagination, suitable for PDF generation using <a href="http://www.princexml.com/">Prince</a>.</td> + </tr> + <tr> + <td> <code>coderay.css</code> </td> - <td>The default <a href="http://coderay.rubychan.de/">Coderay</a> stylesheet, used for syntax highlighting.</td></tr> - <tr><td> + <td>The default <a href="http://coderay.rubychan.de/">Coderay</a> stylesheet, used for syntax highlighting.</td> + </tr> + <tr> + <td> <code>ultraviolet/*</code> </td> - <td>This folder contains the following <a href="http://ultraviolet.rubyforge.org/">Ultraviolet</a> stylesheets, used for syntax highlighting: <code>active4d.css, all_hallows_eve.css, amy.css, blackboard.css, brilliance_black.css, brilliance_dull.css, cobalt.css, dawn.css, eiffel.css, espresso_libre.css, idle.css, iplastic.css, lazy.css, mac_classic.css, magicwb_amiga.css, pastels_on_dark.css, slush_poppies.css, spacecadet.css, sunburst.css, twilight.css, zenburnesque.css</code></td></tr></table> + <td>This folder contains the following <a href="http://ultraviolet.rubyforge.org/">Ultraviolet</a> stylesheets, used for syntax highlighting: <code> +active4d.css, all_hallows_eve.css, amy.css, blackboard.css, brilliance_black.css, brilliance_dull.css, cobalt.css, dawn.css, eiffel.css, espresso_libre.css, idle.css, iplastic.css, lazy.css, mac_classic.css, magicwb_amiga.css, pastels_on_dark.css, slush_poppies.css, spacecadet.css, sunburst.css, twilight.css, zenburnesque.css +</code></td> + </tr> + </table> </section> - <nav><a href="/glyph/book/text_editing/xml_fallback.html">XML Fallback ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/inclusions.html">→ Including Files and Snippets</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/text_editing/xml_fallback.html">XML Fallback</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/inclusions.html">Content Reuse</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -108,50 +138,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Topics – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Topics - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Topics</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Topics</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/text_editing/section_aliases.html">Section Aliases ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/links.html">→ Links and Bookmarks</a></nav> + <nav class="navigation"><a href="/glyph/book/text_editing/section_aliases.html">Section Aliases</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/links.html">Links and Bookmarks</a></nav> <p>Sections can also be used to create <em>topics</em>. In a technical writing context, the term topic identifies a single page of an online help (e.g. a Compiled <span class="caps">HTML</span> file, or <span class="caps">CHM</span>). Topics should generally be:</p> <ul> <li>self-contained, in the sense that they should make sense on their own, ideally without the need to be read in sequence</li>@@ -93,13 +97,25 @@ <li>The topic file is rendered according to a specific <a href="/glyph/book/extending/layouts.html#layouts">layout</a>.</li>
<li>The location of the topic is the same as the location of the included file, mirrored in the output folder.</li> <li>Glyph takes care of changing the file extensions and resolving links automatically, regardless of the output target.</li> </ul> - <nav><a href="/glyph/book/text_editing/section_aliases.html">Section Aliases ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/links.html">→ Links and Bookmarks</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/text_editing/section_aliases.html">Section Aliases</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/links.html">Links and Bookmarks</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -107,50 +123,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,72 +1,78 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>XML Fallback – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>XML Fallback - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>XML Fallback</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>XML Fallback</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/text_editing/raw_html.html">Textile or Markdown ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/stylesheets.html">→ Adding Stylesheets</a></nav> + <nav class="navigation"><a href="/glyph/book/text_editing/raw_html.html">Textile or Markdown</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/stylesheets.html">Adding Stylesheets</a></nav> <p>Sure Textile and Markdown are great, but sometimes you may want to just use HTML, without the extra verbosity, of course. Take tables for example: Textile offers an easy way to create them, but things may get dirty when you need to have multiple paragraphs or lists within cells.</p> <p>Very early versions of Glyph used to offered some simple <code>table</code>, <code>tr</code>, <code>tr</code>, <code>td</code> macros just for that. Of course the problem was that thy didn't offer any way to customize the markup by adding, for example, CSS classes.</p> <p>Instead, by default, Glyph can convert any unrecognized macro to the corresponding XML element and macro attributes to XML attributes.</p> <aside class="box"> <div class="box-title">Example</div> -<p>The following Glyph code:</p> +<p> +The following Glyph code: +</p> <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> table[@class[features] <span class="no"> 2</span> tr[@@ -94,7 +100,9 @@ <span class="no">23</span> ]
<span class="no">24</span> ]</pre></div> </div> - <p>Is translated into the following HTML code:</p> + <p> +Is translated into the following HTML code: +</p> <div class="CodeRay"> <div class="code"><pre><span class="no"> 1</span> <span class="ta"><table</span> <span class="an">class</span>=<span class="s"><span class="dl">"</span><span class="k">features</span><span class="dl">"</span></span><span class="ta">></span> <span class="no"> 2</span> <span class="ta"><tr></span>@@ -128,7 +136,7 @@ <aside class="important">
<span class="note-title">Important</span>While macro names and attributes are validated so that an error is returned if they contain illegal character, no check is performed against any particular XML schema. </aside> - <p>Additionally, it is possible to force macro-to-<span class="caps">XML</span> conversion by prepending an equal sign to any macro, so for example <code>=snippet[test]</code> will be converted into <code><snippet>test</snippet></code>.</p> + <p>Additionally, it is possible to force macro-to-<span class="caps">XML</span> conversion by composing the name of a tag with the <a href="/glyph/book/macros/macros_core.html#m_xml"><code>xml</code></a> macro, so for example <code>xml/snippet[test]</code> will be converted into <code><snippet>test</snippet></code>.</p> <section class="section"> <header><h1 id="xml_blacklist">Blacklisted XML tags</h1></header> <p>By default, the following tags are blacklisted and will be ignored:</p>@@ -153,13 +161,25 @@ <p><span class="note-title">Tip</span>You can change this list by modifying the <a href="/glyph/book/config/options.html#s_options_xml_blacklist"><code>options.xml_blacklist</code></a> setting.</p>
</aside> </section> - <nav><a href="/glyph/book/text_editing/raw_html.html">Textile or Markdown ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/text_editing/stylesheets.html">→ Adding Stylesheets</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/text_editing/raw_html.html">Textile or Markdown</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/stylesheets.html">Adding Stylesheets</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -167,50 +187,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Command Errors – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Command Errors - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Command Errors</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Command Errors</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/troubleshooting/errors_parser.html">Parsing Errors ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/troubleshooting/errors_macro.html">→ Macro Errors</a></nav> + <nav class="navigation"><a href="/glyph/book/troubleshooting/errors_parser.html">Parsing Errors</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/troubleshooting/errors_macro.html">Macro Errors</a></nav> <table style="width:100%;"> <tr>@@ -106,8 +110,10 @@
<tr> <td>Unknown output target '<em>target_name</em>'</td> <td>An unsupported output target was specified for the <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command. Only the following output targets are supported: - <ul><li>html</li> - <li>pdf</li></ul></td> + <ul> + <li>html</li> + <li>pdf</li> + </ul></td> </tr>@@ -129,13 +135,25 @@ <td>Returned by the <a href="/glyph/book/ref_commands.html#c_config"><code>config</code></a> command when attempting to override a setting in the <code>system.*</code> namespace.</td>
</tr> </table> - <nav><a href="/glyph/book/troubleshooting/errors_parser.html">Parsing Errors ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/troubleshooting/errors_macro.html">→ Macro Errors</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/troubleshooting/errors_parser.html">Parsing Errors</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/troubleshooting/errors_macro.html">Macro Errors</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -143,50 +161,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Generic Errors – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Generic Errors - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Generic Errors</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Generic Errors</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/extending/command.html">Defining Custom Commands ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/troubleshooting/errors_parser.html">→ Parsing Errors</a></nav> + <nav class="navigation"><a href="/glyph/book/extending/command.html">Defining Custom Commands</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/troubleshooting/errors_parser.html">Parsing Errors</a></nav> <table style="width:100%;"> <tr>@@ -80,6 +84,12 @@ </tr>
<tr> + <td>No macro representation for '<em>macro_name</em>'</td> + <td>There is no valid macro representation for the specified macro.</td> + </tr> + + + <tr> <td>An error occurred when generating _file-name_.pdf</td> <td>Returned if Prince could not generate the PDF file or if Prince is not installed. Normally, Prince provides additional details on the specific error(s).</td> </tr>@@ -88,6 +98,12 @@
<tr> <td>Glyph cannot generate PDF. Please specify a valid output.pdf.generator setting</td> <td>Returned if the <a href="/glyph/book/config/output.html#s_output_pdf_generator"><code>output.pdf.generator</code></a> setting has not be set to a valid PDF renderer. Currently, the only supported values for this setting are <code>prince</code> and <code>wkhtmltopdf</code>.</td> + </tr> + + + <tr> + <td>Glyph cannot generate e-book. At present, output.<em>ebook_format</em>.generator can only be set to 'calibre'.</td> + <td>Returned if the output.<em>ebook_format</em>.generator setting has not be set to @calibre@.</td> </tr>@@ -151,13 +167,25 @@ <td>Returned by the <a href="/glyph/book/ref_commands.html#c_stats"><code>stats</code></a> command if the specified snippet is defined but unused.</td>
</tr> </table> - <nav><a href="/glyph/book/extending/command.html">Defining Custom Commands ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/troubleshooting/errors_parser.html">→ Parsing Errors</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/extending/command.html">Defining Custom Commands</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/troubleshooting/errors_parser.html">Parsing Errors</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -165,50 +193,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Macro Errors – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Macro Errors - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> - - - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> + <meta content="44.388041;9.073248" name="ICBM" /> - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - </header> - <article class="page"> - <header> - <hgroup> - <h1>Macro Errors</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Macro Errors</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/troubleshooting/errors_command.html">Command Errors ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/ref_commands.html">→ Command Reference</a></nav> + <nav class="navigation"><a href="/glyph/book/troubleshooting/errors_command.html">Command Errors</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/ref_commands.html">Command Reference</a></nav> <p>The following errors are displayed in the form:</p> <p><em>message</em><br /> source: <em>macro_source</em><br />@@ -230,12 +234,6 @@ </tr>
<tr> - <td>Macro '<em>macro_name</em>' cannot be defined by itself</td> - <td>Returned by the <a href="/glyph/book/macros/macros_core.html#m_rewrite_">rewrite:</a> if it contains a macro with the same name.</td> - </tr> - - - <tr> <td>Macro '<em>macro_a</em>' must be within a '<em>macro_b</em>' macro</td> <td>Returned if a macro was used in the wrong place.</td> </tr>@@ -247,13 +245,25 @@ <td>Returned if a macro was used in the wrong place.</td>
</tr> </table> - <nav><a href="/glyph/book/troubleshooting/errors_command.html">Command Errors ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/ref_commands.html">→ Command Reference</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/troubleshooting/errors_command.html">Command Errors</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/ref_commands.html">Command Reference</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -261,50 +271,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,66 +1,70 @@
<!DOCTYPE html> <html lang="en"> <head> - <title>Parsing Errors – Glyph Documentation</title> - - - - <meta charset="utf-8" /> - <meta name="author" content="Fabio Cevasco" /> - <meta name="copyright" content="Fabio Cevasco" /> - <meta name="robots" content="all, follow" /> - <meta name="Revisit-After" content="2 Days" /> - <meta name="language" content="en" /> - <meta name="target_country" content="en-us" /> - <meta name="country" content="United States" /> - <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> - - <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> + <title>Parsing Errors - Glyph</title> + <link href='http://fonts.googleapis.com/css?family=Crimson+Text:400,400italic,600,600italic,700,700italic' rel='stylesheet' type='text/css'> + + + + <meta charset="utf-8" /> + <meta name="author" content="Fabio Cevasco" /> + <meta name="copyright" content="Fabio Cevasco" /> + <meta name="robots" content="all, follow" /> + <meta name="Revisit-After" content="2 Days" /> + <meta name="language" content="en" /> + <meta name="target_country" content="en-us" /> + <meta name="country" content="United States" /> + <meta name="readability-verification" content="XmaVzRjmcFL5Bb2Fu9TZVdDKzhA3apQdxexTB2rK"/> + <meta name="description" content="H3RALD - Fabio Cevasco's Web Site" /> + + <meta name="keywords" content="h3rald, fabio cevasco, glyph" /> <link rel="shortcut icon" href="/favicon.png" type="image/png" /> - <meta content="44.388041;9.073248" name="ICBM" /> + <meta content="44.388041;9.073248" name="ICBM" /> + <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> + <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - <link rel="stylesheet" type="text/css" href="/styles/html5reset.css" /> - <link rel="stylesheet" type="text/css" href="/styles/style.css" /> - - <!--[if lte IE 8]> - <script src="/js/html5.js" type="text/javascript"></script> - <![endif]--> - </head> - <body> - <!--[if lte IE 6]> - <div id="ie-warning"> - This site is not compatible with Internet Explorer 6 or lower. You should consider using a more modern browser for a better – and <em>safer</em> – web experience. [<a href="http://browsehappy.com/browsers/">Read More »</a>] - </div> - <![endif]--> - - <section id="container"> - - <header class="page"> - <nav class="home-link"> - <a href="/"> - <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> - <![if !IE]> - <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> - <![endif]> - </a> - </nav> - - <nav class="section"> - /<a href="/glyph/" rel="archives">GLYPH</a> - </nav> - - </header> - <article class="page"> - <header> - <hgroup> - <h1>Parsing Errors</h1> - <h2>Glyph Documentation</h2> - </hgroup> - </header> - <section id="body-text" class="hyphenate glyph-book"> + <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> + <script src="/js/sevenup.js" type="text/javascript"></script> + <script src="/js/sevenup_black.js" type="text/javascript"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script> + <script src="/js/jquery-timeago.js" type="text/javascript"></script> + <script src="/js/jquery-easing.js" type="text/javascript"></script> + <script src="/js/jquery-fancybox.js" type="text/javascript"></script> + <script src="/js/date.js" type="text/javascript"></script> + <script src="/js/feeds.js" type="text/javascript"></script> + <script src="/js/hyphenator.js" type="text/javascript"></script> + <script src="/js/init.js" type="text/javascript"></script> + <script src="/js/search.js" type="text/javascript"></script> + </head> + <body> + <section id="container"> + + <header class="page"> + <nav class="home-link"> + <a href="/"> + <img src="/images/h3rald_small.png" alt="H3RALD" class="default"/> + <![if !IE]> + <img src="/images/h3rald_hover_small.png" alt="H3RALD" class="hover"/> + <![endif]> + </a> + </nav> + + <nav class="section"> + /<a href="/glyph/" rel="glyph">GLYPH</a> + </nav> + +</header> + <article class="page glyph-book"> + <header> + <hgroup> + <h1>Parsing Errors</h1> + <h2>Glyph</h2> + </hgroup> + </header> + <section id="body-text" class="hyphenate glyph-book"> - <nav><a href="/glyph/book/troubleshooting/errors_generic.html">Generic Errors ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/troubleshooting/errors_command.html">→ Command Errors</a></nav> + <nav class="navigation"><a href="/glyph/book/troubleshooting/errors_generic.html">Generic Errors</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/troubleshooting/errors_command.html">Command Errors</a></nav> <table style="width:100%;"> <tr>@@ -115,13 +119,25 @@ <td>Returned if a parameter delimiter is outside a macro or inside an attribute.</td>
</tr> </table> - <nav><a href="/glyph/book/troubleshooting/errors_generic.html">Generic Errors ←</a><a href="/glyph/book/index.html">Contents</a><a href="/glyph/book/troubleshooting/errors_command.html">→ Command Errors</a></nav> - </section> - </article> - - - <footer> - <section class="ads"> + <nav class="navigation"><a href="/glyph/book/troubleshooting/errors_generic.html">Generic Errors</a> | <a href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/troubleshooting/errors_command.html">Command Errors</a></nav> + <nav id="sharing-buttons"> +<a href="http://twitter.com/share" class="twitter-share-button" data-count="horizontal" data-via="h3rald">Tweet</a> +<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> +<g:plusone size="medium"></g:plusone> +<script type="text/javascript"> + (function() { + var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; + po.src = 'https://apis.google.com/js/plusone.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); + })(); +</script> +</nav> + </section> + </article> + + + <footer> + <section class="ads"> <script type="text/javascript"><!-- google_ad_client = "pub-2871497824158668"; /* 728x90, created 9/10/10 */@@ -129,50 +145,40 @@ google_ad_slot = "3963343166";
google_ad_width = 728; google_ad_height = 90; //--> - </script> - <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> - </script> - </section> - <section> - <nav> - <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> - </nav> - <p>H3RALD Web Site v8.1 — © 2010 — <em>Fabio Cevasco</em></p> - </section> - </footer> - </section><!-- #container end --> - <script src="http://www.google.com/jsapi?key=ABQIAAAAr6RY1Z6dchG_sX9WDLSy3xRlq2n1sm52B5HDRR5tm6o8XM18FhR56xHNNH6CsX86uN5VoTrglpyOyQ" type="text/javascript"></script> - <!-- <script src="/js/jquery.js" type="text/javascript"></script> --> - <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script> - <script src="/js/jquery-timeago.js" type="text/javascript"></script> - <script src="/js/jquery-easing.js" type="text/javascript"></script> - <script src="/js/jquery-fancybox.js" type="text/javascript"></script> - <script src="/js/jquery-toc.js" type="text/javascript"></script> - <script src="/js/date.js" type="text/javascript"></script> - <script src="/js/feeds.js" type="text/javascript"></script> - <script src="/js/search.js" type="text/javascript"></script> - <script src="/js/hyphenator.js" type="text/javascript"></script> - <script src="/js/init.js" type="text/javascript"></script> - <!-- Start Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-18587377-1']); - _gaq.push(['_trackPageview']); + </script> + <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> + </script> + </section> + <section> + <nav> + <a href="/about/">ABOUT</a>|<a href="/contact/">CONTACT</a> + </nav> + <p>H3RALD Web Site v8.1.2 © 2004 — 2011 <em>Fabio Cevasco</em></p> + </section> + </footer> + </section><!-- #container end --> + + + <!-- Start Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-18587377-1']); + _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - <!-- End Google Analytics --> - <!-- Start of StatCounter Code --> - <script type="text/javascript"> - var sc_project=6193656; - var sc_invisible=1; - var sc_security="57f7ee2a"; - </script> - <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> - <!-- End of StatCounter Code --> - </body> + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + <!-- End Google Analytics --> + <!-- Start of StatCounter Code --> + <script type="text/javascript"> + var sc_project=6193656; + var sc_invisible=1; + var sc_security="57f7ee2a"; + </script> + <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script> + <!-- End of StatCounter Code --> + </body> </html>
@@ -1,3 +1,4 @@
+@import "_fonts.scss"; @import "_definitions.scss"; @import "_layout.scss"; @import "_content.scss";