Regenerated Glyph book.
h3rald h3rald@h3rald.com
Fri, 22 Oct 2010 22:54:21 +0200
60 files changed,
448 insertions(+),
210 deletions(-)
jump to
M
content/glyph.textile
→
content/glyph.textile
@@ -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.1 +version: 0.4.2 ----- <%= render 'project_data', :tag => 'glyph' %>
M
content/glyph/book/acknowledgements.html
→
content/glyph/book/acknowledgements.html
@@ -62,12 +62,13 @@ <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> <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 and/or proposing and implementing new features:</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> <li><a href="http://www.jabbslad.com">Jamie Atkinson</a> (Jabbslad)</li> <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> </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>@@ -106,7 +107,7 @@ <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.min.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">
M
content/glyph/book/changelog.html
→
content/glyph/book/changelog.html
@@ -67,9 +67,42 @@
<section class="section"> -<header><h1 id="h_231">v0.4.1 – September 23th 2010</h1></header> +<header><h1 id="h_241">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> + +</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> + +</section> + + <section class="section"> +<header><h1 id="h_244">v0.4.1 – September 23th 2010</h1></header> <section class="section"> -<header><h1 id="h_232">5 Bugs Fixed</h1></header> +<header><h1 id="h_245">5 Bugs Fixed</h1></header> <table><tr><th>ID</th> <th>Description</th></tr>@@ -94,9 +127,9 @@
</section> <section class="section"> -<header><h1 id="h_233">v0.4.0 – September 3th 2010</h1></header> +<header><h1 id="h_246">v0.4.0 – September 3th 2010</h1></header> <section class="section"> -<header><h1 id="h_234">13 Features Implemented</h1></header> +<header><h1 id="h_247">13 Features Implemented</h1></header> <table><tr><th>ID</th> <th>Description</th></tr>@@ -144,7 +177,7 @@ </section>
<section class="section"> -<header><h1 id="h_235">7 Bugs Fixed</h1></header> +<header><h1 id="h_248">7 Bugs Fixed</h1></header> <table><tr><th>ID</th> <th>Description</th></tr>@@ -175,9 +208,9 @@
</section> <section class="section"> -<header><h1 id="h_236">v0.3.0 – June 13th 2010</h1></header> +<header><h1 id="h_249">v0.3.0 – June 13th 2010</h1></header> <section class="section"> -<header><h1 id="h_237">13 Features Implemented</h1></header> +<header><h1 id="h_250">13 Features Implemented</h1></header> <table><tr><th>ID</th> <th>Description</th></tr>@@ -225,7 +258,7 @@ </section>
<section class="section"> -<header><h1 id="h_238">3 Bugs Fixed</h1></header> +<header><h1 id="h_251">3 Bugs Fixed</h1></header> <table><tr><th>ID</th> <th>Description</th></tr>@@ -244,9 +277,9 @@
</section> <section class="section"> -<header><h1 id="h_239">v0.2.0 – May 9th 2010</h1></header> +<header><h1 id="h_252">v0.2.0 – May 9th 2010</h1></header> <section class="section"> -<header><h1 id="h_240">11 Features Implemented</h1></header> +<header><h1 id="h_253">11 Features Implemented</h1></header> <table><tr><th>ID</th> <th>Description</th></tr>@@ -288,7 +321,7 @@ </section>
<section class="section"> -<header><h1 id="h_241">8 Bugs Fixed</h1></header> +<header><h1 id="h_254">8 Bugs Fixed</h1></header> <table><tr><th>ID</th> <th>Description</th></tr>@@ -322,7 +355,7 @@
</section> <section class="section"> -<header><h1 id="h_242">v0.1.0 – April 8th 2010</h1></header> +<header><h1 id="h_255">v0.1.0 – April 8th 2010</h1></header> Initial release. </section>@@ -362,7 +395,7 @@ <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.min.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">
M
content/glyph/book/compiling/compiling.html
→
content/glyph/book/compiling/compiling.html
@@ -69,7 +69,7 @@ <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_41">HTML/HTML5 output</h1></header> +<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>@@ -79,7 +79,7 @@ </p>
</section> <section class="section"> -<header><h1 id="h_42">PDF Output</h1></header> +<header><h1 id="h_43">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>@@ -157,7 +157,7 @@ <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.min.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">
M
content/glyph/book/compiling/lite_mode.html
→
content/glyph/book/compiling/lite_mode.html
@@ -116,7 +116,7 @@ <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.min.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">
M
content/glyph/book/compiling/programmatic_usage.html
→
content/glyph/book/compiling/programmatic_usage.html
@@ -172,7 +172,7 @@ <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.min.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">
M
content/glyph/book/config/document.html
→
content/glyph/book/config/document.html
@@ -159,7 +159,7 @@ <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.min.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">
M
content/glyph/book/config/filters.html
→
content/glyph/book/config/filters.html
@@ -139,7 +139,7 @@ <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.min.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">
M
content/glyph/book/config/options.html
→
content/glyph/book/config/options.html
@@ -137,7 +137,7 @@ <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.min.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">
M
content/glyph/book/config/output.html
→
content/glyph/book/config/output.html
@@ -73,7 +73,7 @@ These settings are used to configure output-specific options.
<section class="section"> -<header><h1 id="h_225">output.pdf.*</h1></header> +<header><h1 id="h_235">output.pdf.*</h1></header> <table><tr><th>Name</th> <th>Description</th> <th>Default</th></tr>@@ -105,7 +105,7 @@ <td><code>false</code></td></tr></table>
</section> <section class="section"> -<header><h1 id="h_226">output.html.*</h1></header> +<header><h1 id="h_236">output.html.*</h1></header> <table><tr><th>Name</th> <th>Description</th> <th>Default</th></tr>@@ -132,7 +132,7 @@ <td><code>false</code></td></tr></table>
</section> <section class="section"> -<header><h1 id="h_227">output.html5.*</h1></header> +<header><h1 id="h_237">output.html5.*</h1></header> <table><tr><th>Name</th> <th>Description</th> <th>Default</th></tr>@@ -159,7 +159,7 @@ <td><code>false</code></td></tr></table>
</section> <section class="section"> -<header><h1 id="h_228">output.web.*</h1></header> +<header><h1 id="h_238">output.web.*</h1></header> <table><tr><th>Name</th> <th>Description</th> <th>Default</th></tr>@@ -206,7 +206,7 @@ <td><code>true</code></td></tr></table>
</section> <section class="section"> -<header><h1 id="h_229">output.web5.*</h1></header> +<header><h1 id="h_239">output.web5.*</h1></header> <table><tr><th>Name</th> <th>Description</th> <th>Default</th></tr>@@ -288,7 +288,7 @@ <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.min.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">
M
content/glyph/book/extending/bookmarks_headers.html
→
content/glyph/book/extending/bookmarks_headers.html
@@ -110,7 +110,7 @@ <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.min.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">
M
content/glyph/book/extending/command.html
→
content/glyph/book/extending/command.html
@@ -63,7 +63,7 @@
<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> <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_96">Creating a 'glyph generate' command</h1></header> +<header><h1 id="h_97">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 +85,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.1 +<span class="no"> 3</span> Glyph v.0.4.2 <span class="no"> 4</span> ===================================== <span class="no"> 5</span> usage: glyph command [options] <span class="no"> 6</span>@@ -148,7 +148,7 @@ <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.min.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">
M
content/glyph/book/extending/commands_tasks.html
→
content/glyph/book/extending/commands_tasks.html
@@ -135,7 +135,7 @@ <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.min.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">
M
content/glyph/book/extending/further_reading.html
→
content/glyph/book/extending/further_reading.html
@@ -106,7 +106,7 @@ <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.min.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">
M
content/glyph/book/extending/internals.html
→
content/glyph/book/extending/internals.html
@@ -72,7 +72,7 @@ <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>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_73">Example: A short note</h1></header> +<header><h1 id="h_74">Example: A short note</h1></header> <p>As an example, consider the following Glyph code:</p> <div class="CodeRay"> <div class="code"><pre><span class="no">1</span> fmi[something|#test]@@ -178,7 +178,7 @@ <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.min.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">
M
content/glyph/book/extending/interpreting.html
→
content/glyph/book/extending/interpreting.html
@@ -147,7 +147,7 @@ <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.min.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">
M
content/glyph/book/extending/layouts.html
→
content/glyph/book/extending/layouts.html
@@ -68,7 +68,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_84">Topic Layout</h1></header> +<header><h1 id="h_85">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 +122,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_86">Creating a Custom Layout</h1></header> +<header><h1 id="h_87">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>@@ -172,7 +172,7 @@ <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.min.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">
M
content/glyph/book/extending/macro_def.html
→
content/glyph/book/extending/macro_def.html
@@ -145,7 +145,7 @@ <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.min.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">
M
content/glyph/book/extending/output_format.html
→
content/glyph/book/extending/output_format.html
@@ -65,7 +65,7 @@ <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_93">Output Configuration</h1></header> +<header><h1 id="h_94">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>:@@ -93,7 +93,7 @@ </ul>
</section> <section class="section"> -<header><h1 id="h_94">Creating a 'generate:h3rald' task</h1></header> +<header><h1 id="h_95">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>@@ -168,7 +168,7 @@ <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.min.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">
M
content/glyph/book/extending/params_attrs.html
→
content/glyph/book/extending/params_attrs.html
@@ -76,7 +76,7 @@ </ul>
</section> <section class="section"> -<header><h1 id="h_77">Accessing Raw Values</h1></header> +<header><h1 id="h_78">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>@@ -165,7 +165,7 @@ <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.min.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">
M
content/glyph/book/extending/placeholders.html
→
content/glyph/book/extending/placeholders.html
@@ -122,7 +122,7 @@ <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.min.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">
M
content/glyph/book/extending/task.html
→
content/glyph/book/extending/task.html
@@ -137,7 +137,7 @@ <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.min.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">
M
content/glyph/book/extending/validators.html
→
content/glyph/book/extending/validators.html
@@ -111,7 +111,7 @@ <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.min.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">
M
content/glyph/book/getting_started/configuration.html
→
content/glyph/book/getting_started/configuration.html
@@ -135,7 +135,7 @@ <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.min.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">
M
content/glyph/book/getting_started/create_project.html
→
content/glyph/book/getting_started/create_project.html
@@ -133,7 +133,7 @@ <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.min.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">
M
content/glyph/book/getting_started/structure.html
→
content/glyph/book/getting_started/structure.html
@@ -148,7 +148,7 @@ <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.min.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">
M
content/glyph/book/index.html
→
content/glyph/book/index.html
@@ -64,18 +64,18 @@ <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_24">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_30">Textile or Markdown</a></li><li class="bodymatter section"><a href="/glyph/book/text_editing/xml_fallback.html#h_31">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_36">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_47">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_50">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_72">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_75">Parameters and Attributes</a></li><li class="bodymatter section"><a href="/glyph/book/extending/bookmarks_headers.html#h_78">Bookmarks and Headers</a></li><li class="bodymatter section"><a href="/glyph/book/extending/placeholders.html#h_79">Using Placeholders</a></li><li class="bodymatter section"><a href="/glyph/book/extending/validators.html#h_80">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_87">Further Reading</a></li></ol></li> -<li class="bodymatter section"><a href="/glyph/book/extending/commands_tasks.html#h_88">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/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> </ol></li> -<li class="bodymatter chapter">Troubleshooting</li><li><ol><li class="bodymatter section"><a href="/glyph/book/troubleshooting/errors_generic.html#h_98">Generic Errors</a></li><li class="bodymatter section"><a href="/glyph/book/troubleshooting/errors_parser.html#h_99">Parsing Errors</a></li><li class="bodymatter section"><a href="/glyph/book/troubleshooting/errors_command.html#h_100">Command Errors</a></li><li class="bodymatter section"><a href="/glyph/book/troubleshooting/errors_macro.html#h_101">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_122">Core Macros</a></li><li class="appendix section"><a href="/glyph/book/macros/macros_block.html#h_166">Block Macros</a></li><li class="appendix section"><a href="/glyph/book/macros/macros_inline.html#h_186">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_202">Structure Macros</a></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="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_230">Changelog</a></li> +<li class="backmatter appendix"><a href="/glyph/book/changelog.html#h_240">Changelog</a></li> </ol> </nav> </section>@@ -113,7 +113,7 @@ <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.min.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">
M
content/glyph/book/introduction.html
→
content/glyph/book/introduction.html
@@ -239,7 +239,7 @@ <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.min.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">
M
content/glyph/book/license.html
→
content/glyph/book/license.html
@@ -62,30 +62,21 @@ <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> <p>Copyright © 2010 <strong>Fabio Cevasco</strong>, <a href="http://www.h3rald.com">http://www.h3rald.com</a></p> - -<div class="code"> -<pre> -<code> -Permission is hereby granted, free of charge, to any person obtaining a copy +<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 in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: - -The above copyright notice and this permission notice shall be included in -all copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +furnished to do so, subject to the following conditions:</p> +<p>The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software.</p> +<p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN -THE SOFTWARE. -</code> -</pre> -</div> +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>@@ -122,7 +113,7 @@ <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.min.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">
M
content/glyph/book/macros/macros_block.html
→
content/glyph/book/macros/macros_block.html
@@ -80,7 +80,7 @@
<section class="section"> -<header><h1 id="h_168">Parameters</h1></header> +<header><h1 id="h_171">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -124,7 +124,7 @@
<section class="section"> -<header><h1 id="h_170">Parameters</h1></header> +<header><h1 id="h_173">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -140,7 +140,7 @@ </section>
<section class="section"> -<header><h1 id="h_171">Remarks</h1></header> +<header><h1 id="h_174">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>@@ -168,7 +168,7 @@
<section class="section"> -<header><h1 id="h_173">Parameters</h1></header> +<header><h1 id="h_176">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -190,7 +190,7 @@ </section>
<section class="section"> -<header><h1 id="h_174">Attributes</h1></header> +<header><h1 id="h_177">Attributes</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Attribute</th>@@ -228,7 +228,7 @@
<section class="section"> -<header><h1 id="h_176">Parameters</h1></header> +<header><h1 id="h_179">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -244,7 +244,7 @@ </section>
<section class="section"> -<header><h1 id="h_177">Attributes</h1></header> +<header><h1 id="h_180">Attributes</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Attribute</th>@@ -271,7 +271,7 @@
<section class="section"> -<header><h1 id="h_179">Parameters</h1></header> +<header><h1 id="h_182">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -298,7 +298,7 @@
<section class="section"> -<header><h1 id="h_181">Parameters</h1></header> +<header><h1 id="h_184">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -390,7 +390,7 @@ <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.min.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">
M
content/glyph/book/macros/macros_core.html
→
content/glyph/book/macros/macros_core.html
@@ -72,7 +72,7 @@
<section class="section"> -<header><h1 id="h_124">Parameters</h1></header> +<header><h1 id="h_125">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -105,7 +105,7 @@
<section class="section"> -<header><h1 id="h_126">Parameters</h1></header> +<header><h1 id="h_127">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -137,7 +137,7 @@
<section class="section"> -<header><h1 id="h_128">Parameters</h1></header> +<header><h1 id="h_129">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -153,7 +153,7 @@ </section>
<section class="section"> -<header><h1 id="h_129">Remarks</h1></header> +<header><h1 id="h_130">Remarks</h1></header> <p>Macros are not expanded within comments.</p> </section>@@ -171,7 +171,7 @@
<section class="section"> -<header><h1 id="h_131">Parameters</h1></header> +<header><h1 id="h_132">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -193,7 +193,7 @@ </section>
<section class="section"> -<header><h1 id="h_132">Remarks</h1></header> +<header><h1 id="h_133">Remarks</h1></header> <p>For examples see any of the following:</p> <ul> <li><a href="#m_and"><code>and</code></a> macro</li>@@ -218,7 +218,7 @@
<section class="section"> -<header><h1 id="h_134">Parameters</h1></header> +<header><h1 id="h_135">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -245,7 +245,7 @@
<section class="section"> -<header><h1 id="h_136">Parameters</h1></header> +<header><h1 id="h_137">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -267,7 +267,7 @@ </section>
<section class="section"> -<header><h1 id="h_137">Remarks</h1></header> +<header><h1 id="h_138">Remarks</h1></header> <p>This macro cannot be used in <a href="/glyph/book/compiling/programmatic_usage.html#modes">safe mode</a>.</p> </section>@@ -285,7 +285,7 @@
<section class="section"> -<header><h1 id="h_139">Parameters</h1></header> +<header><h1 id="h_140">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -317,7 +317,7 @@
<section class="section"> -<header><h1 id="h_141">Parameters</h1></header> +<header><h1 id="h_142">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -344,7 +344,7 @@
<section class="section"> -<header><h1 id="h_143">Parameters</h1></header> +<header><h1 id="h_144">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -360,7 +360,7 @@ </section>
<section class="section"> -<header><h1 id="h_144">Remarks</h1></header> +<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>@@ -380,7 +380,7 @@
<section class="section"> -<header><h1 id="h_146">Parameters</h1></header> +<header><h1 id="h_147">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -408,7 +408,7 @@ </section>
<section class="section"> -<header><h1 id="h_147">Remarks</h1></header> +<header><h1 id="h_148">Remarks</h1></header> <p>This macro must be used with the <a href="#m_condition"><code>condition</code></a> macro.</p> </section>@@ -426,7 +426,7 @@
<section class="section"> -<header><h1 id="h_149">Parameters</h1></header> +<header><h1 id="h_150">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -448,7 +448,7 @@ </section>
<section class="section"> -<header><h1 id="h_150">Remarks</h1></header> +<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>@@ -467,7 +467,7 @@
<section class="section"> -<header><h1 id="h_152">Parameters</h1></header> +<header><h1 id="h_153">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -486,6 +486,33 @@
<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> + +<p><strong>Example:</strong> <code>?[output?[web|web5]|This text is printed only when generating web or web5 output.]</code></p> + + + + <section class="section"> +<header><h1 id="h_155">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +<tr> + <td>0, ...</td> + <td>a valid output target.</td> + </tr> + </table> + +</section> + +</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>@@ -494,7 +521,7 @@
<section class="section"> -<header><h1 id="h_154">Parameters</h1></header> +<header><h1 id="h_157">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -538,7 +565,7 @@
<section class="section"> -<header><h1 id="h_156">Parameters</h1></header> +<header><h1 id="h_159">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -560,7 +587,7 @@ </section>
<section class="section"> -<header><h1 id="h_157">Remarks</h1></header> +<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>@@ -584,7 +611,7 @@ </div>
<section class="section"> -<header><h1 id="h_159">Parameters</h1></header> +<header><h1 id="h_162">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -600,7 +627,7 @@ </section>
<section class="section"> -<header><h1 id="h_160">Remarks</h1></header> +<header><h1 id="h_163">Remarks</h1></header> <p>This macro cannot be used in <a href="/glyph/book/compiling/programmatic_usage.html#modes">safe mode</a>.</p> </section>@@ -618,7 +645,7 @@
<section class="section"> -<header><h1 id="h_162">Parameters</h1></header> +<header><h1 id="h_165">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -645,7 +672,7 @@
<section class="section"> -<header><h1 id="h_164">Parameters</h1></header> +<header><h1 id="h_167">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -667,7 +694,7 @@ </section>
<section class="section"> -<header><h1 id="h_165">Remarks</h1></header> +<header><h1 id="h_168">Remarks</h1></header> <p>The new snippet can only be used <em>after</em> its declaration.</p> </section>@@ -710,7 +737,7 @@ <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.min.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">
M
content/glyph/book/macros/macros_filters.html
→
content/glyph/book/macros/macros_filters.html
@@ -61,7 +61,8 @@ </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> - + + <section class="section"> <header><h1 id="m_markdown">markdown</h1></header> <p>Uses a Markdown converter (BlueCloth, RDiscount, Maruku or Kramdown) to transform the value into <span class="caps">HTML</span> if the <a href="/glyph/book/config/output.html#cfg_output"><code>output.*.filter_target</code></a> setting is set to <code>html</code>.</p>@@ -72,7 +73,7 @@
<section class="section"> -<header><h1 id="h_198">Parameters</h1></header> +<header><h1 id="h_201">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -89,6 +90,73 @@
</section> + + + <section class="section"> +<header><h1 id="m_markdown_section">markdown_section</h1></header> +<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> +<strong>Example</strong> +</p> + <div class="CodeRay"> + <div class="code"><pre><span class="no">1</span> markdown_section[ +<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> + + + + <section class="section"> +<header><h1 id="h_203">Parameters</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Parameter</th> + <th>Description</th> + </tr> +<tr> + <td>0</td> + <td>The text of the section</td> + </tr> + </table> + +</section> + + + <section class="section"> +<header><h1 id="h_204">Attributes</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Attribute</th> + <th>Description</th> + </tr> +<tr> + <td>title</td> + <td>The title of the section <em>(optional)</em></td> + </tr> + + + <tr> + <td>id</td> + <td>The ID of the section <em>(optional)</em></td> + </tr> + + + <tr> + <td>notoc</td> + <td>If not blank, the header will not appear in the Table of Contents. <em>(optional)</em></td> + </tr> + </table> + +</section> + +</section> + + <section class="section"> <header><h1 id="m_textile">textile</h1></header>@@ -100,7 +168,7 @@
<section class="section"> -<header><h1 id="h_200">Parameters</h1></header> +<header><h1 id="h_206">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -118,9 +186,76 @@ </section>
+ + <section class="section"> +<header><h1 id="m_textile_section">textile_section</h1></header> +<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> +<strong>Example</strong> +</p> + <div class="CodeRay"> + <div class="code"><pre><span class="no">1</span> textile_section[ +<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> + + + + <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> +<tr> + <td>0</td> + <td>The text of the section</td> + </tr> + </table> + +</section> + + + <section class="section"> +<header><h1 id="h_209">Attributes</h1></header> +<table style="width:100%;"> + <tr> + <th style="width:30%">Attribute</th> + <th>Description</th> + </tr> +<tr> + <td>title</td> + <td>The title of the section <em>(optional)</em></td> + </tr> + + + <tr> + <td>id</td> + <td>The ID of the section <em>(optional)</em></td> + </tr> + + + <tr> + <td>notoc</td> + <td>If not blank, the header will not appear in the Table of Contents. <em>(optional)</em></td> + </tr> + </table> + +</section> + +</section> + + + <section class="section"> <header><h1 id="m_highlight">highlight</h1></header> -<p>Highlights a piece of source code (second parameter) according to the specified language (first parameter). <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> +<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>@@ -134,6 +269,29 @@ <span class="no">3</span> puts "Hello World"
<span class="no">4</span> end <span class="no">5</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>A programming language supported by the underlying highlighter.</td> + </tr> + + + <tr> + <td>1</td> + <td>The code to highlight.</td> + </tr> + </table> + +</section> </section>@@ -173,7 +331,7 @@ <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.min.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">
M
content/glyph/book/macros/macros_inline.html
→
content/glyph/book/macros/macros_inline.html
@@ -71,7 +71,7 @@
<section class="section"> -<header><h1 id="h_188">Parameters</h1></header> +<header><h1 id="h_191">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -104,7 +104,7 @@
<section class="section"> -<header><h1 id="h_190">Parameters</h1></header> +<header><h1 id="h_193">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -131,7 +131,7 @@
<section class="section"> -<header><h1 id="h_192">Parameters</h1></header> +<header><h1 id="h_195">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -164,7 +164,7 @@
<section class="section"> -<header><h1 id="h_194">Parameters</h1></header> +<header><h1 id="h_197">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -232,7 +232,7 @@ <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.min.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">
M
content/glyph/book/macros/macros_structure.html
→
content/glyph/book/macros/macros_structure.html
@@ -90,7 +90,7 @@
<section class="section"> -<header><h1 id="h_204">Parameters</h1></header> +<header><h1 id="h_214">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -106,7 +106,7 @@ </section>
<section class="section"> -<header><h1 id="h_205">Attributes</h1></header> +<header><h1 id="h_215">Attributes</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Attribute</th>@@ -177,7 +177,7 @@
<section class="section"> -<header><h1 id="h_207">Parameters</h1></header> +<header><h1 id="h_217">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -193,7 +193,7 @@ </section>
<section class="section"> -<header><h1 id="h_208">Attributes</h1></header> +<header><h1 id="h_218">Attributes</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Attribute</th>@@ -262,7 +262,7 @@
<section class="section"> -<header><h1 id="h_210">Parameters</h1></header> +<header><h1 id="h_220">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -289,7 +289,7 @@
<section class="section"> -<header><h1 id="h_212">Parameters</h1></header> +<header><h1 id="h_222">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -309,7 +309,7 @@
<section class="section"> <header><h1 id="m_section">section</h1></header> -<p>Creates a section (<code><div></code> tag).</p> +<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>@@ -327,7 +327,7 @@
<section class="section"> -<header><h1 id="h_214">Parameters</h1></header> +<header><h1 id="h_224">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -343,7 +343,7 @@ </section>
<section class="section"> -<header><h1 id="h_215">Attributes</h1></header> +<header><h1 id="h_225">Attributes</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Attribute</th>@@ -382,7 +382,7 @@
<section class="section"> -<header><h1 id="h_217">Parameters</h1></header> +<header><h1 id="h_227">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -409,7 +409,7 @@
<section class="section"> -<header><h1 id="h_219">Parameters</h1></header> +<header><h1 id="h_229">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -461,7 +461,7 @@ <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.min.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">
M
content/glyph/book/ref_commands.html
→
content/glyph/book/ref_commands.html
@@ -69,7 +69,7 @@ <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_103">Global Options</h1></header> +<header><h1 id="h_104">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>@@ -83,7 +83,7 @@ <p>Creates a new text file in the <code>text/</code> folder.</p>
<p><strong>Example:</strong> <code>glyph add introduction.textile</code></p> <section class="section"> -<header><h1 id="h_106">Parameters</h1></header> +<header><h1 id="h_107">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -104,7 +104,7 @@ <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> <section class="section"> -<header><h1 id="h_108">Parameters</h1></header> +<header><h1 id="h_109">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -126,7 +126,7 @@ </section>
<section class="section"> -<header><h1 id="h_109">Options</h1></header> +<header><h1 id="h_110">Options</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Option</th>@@ -173,7 +173,7 @@ </div>
<section class="section"> -<header><h1 id="h_111">Options</h1></header> +<header><h1 id="h_112">Options</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Option</th>@@ -192,7 +192,7 @@ </section>
<section class="section"> -<header><h1 id="h_112">Parameters</h1></header> +<header><h1 id="h_113">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -224,7 +224,7 @@ </div>
<section class="section"> -<header><h1 id="h_114">Parameters</h1></header> +<header><h1 id="h_115">Parameters</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Parameter</th>@@ -250,7 +250,7 @@ <header><h1 id="c_outline">outline</h1></header>
Display an outline of the current document. <section class="section"> -<header><h1 id="h_117">Options</h1></header> +<header><h1 id="h_118">Options</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Option</th>@@ -308,7 +308,7 @@ </div>
<section class="section"> -<header><h1 id="h_119">Options</h1></header> +<header><h1 id="h_120">Options</h1></header> <table style="width:100%;"> <tr> <th style="width:30%">Option</th>@@ -431,7 +431,7 @@ <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.min.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">
M
content/glyph/book/stats/bookmarks.html
→
content/glyph/book/stats/bookmarks.html
@@ -63,7 +63,7 @@
<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 class="section"> -<header><h1 id="h_62">Displaying stats about all bookmarks</h1></header> +<header><h1 id="h_63">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="code"><pre><span class="no"> 1</span> ===== Bookmarks@@ -92,7 +92,7 @@ <span class="no">23</span> [...]</pre></div>
</div> <section class="section"> -<header><h1 id="h_63">Remarks</h1></header> +<header><h1 id="h_64">Remarks</h1></header> <ul> <li>All the automatically-generated bookmarks (like headers, starting with <code>h_</code>) are included as well.</li> </ul>@@ -102,7 +102,7 @@
</section> <section class="section"> -<header><h1 id="h_64">Displaying stats about a single bookmark</h1></header> +<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"> <div class="code"><pre><span class="no">1</span> ===== Bookmark 'c_config' (header)@@ -114,7 +114,7 @@ <span class="no">6</span> - text/troubleshooting/errors_command.glyph (3)</pre></div>
</div> <section class="section"> -<header><h1 id="h_65">Remarks</h1></header> +<header><h1 id="h_66">Remarks</h1></header> <ul> <li>Do not prepend the bookmark ID with <code>#</code>.</li> </ul>@@ -158,7 +158,7 @@ <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.min.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">
M
content/glyph/book/stats/links.html
→
content/glyph/book/stats/links.html
@@ -63,7 +63,7 @@
<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 class="section"> -<header><h1 id="h_67">Displaying stats about all links</h1></header> +<header><h1 id="h_68">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="code"><pre><span class="no"> 1</span> ===== Links@@ -101,7 +101,7 @@ <span class="no">32</span> [...]</pre></div>
</div> <section class="section"> -<header><h1 id="h_68">Remarks</h1></header> +<header><h1 id="h_69">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>@@ -111,7 +111,7 @@
</section> <section class="section"> -<header><h1 id="h_69">Displaying stats about links matching a regular expression</h1></header> +<header><h1 id="h_70">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="code"><pre><span class="no"> 1</span> ===== Links matching /c_/@@ -155,7 +155,7 @@ <span class="no">38</span> - text/text_editing/macro_intro.glyph (1)</pre></div>
</div> <section class="section"> -<header><h1 id="h_70">Remarks</h1></header> +<header><h1 id="h_71">Remarks</h1></header> <ul> <li>No distinction between external and internal targets is made.</li> </ul>@@ -199,7 +199,7 @@ <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.min.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">
M
content/glyph/book/stats/macros.html
→
content/glyph/book/stats/macros.html
@@ -63,7 +63,7 @@
<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 class="section"> -<header><h1 id="h_52">Displaying stats about all macros</h1></header> +<header><h1 id="h_53">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="code"><pre><span class="no"> 1</span> ===== Macros@@ -102,7 +102,7 @@ <span class="no">33</span> |xml|</pre></div>
</div> <section class="section"> -<header><h1 id="h_53">Remarks</h1></header> +<header><h1 id="h_54">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>@@ -114,7 +114,7 @@
</section> <section class="section"> -<header><h1 id="h_54">Displaying stats about a single macro</h1></header> +<header><h1 id="h_55">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="code"><pre><span class="no"> 1</span> ===== Macro 'note'@@ -136,7 +136,7 @@ <span class="no">16</span> - text/text_editing/xml_fallback.glyph (2)</pre></div>
</div> <section class="section"> -<header><h1 id="h_55">Remarks</h1></header> +<header><h1 id="h_56">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>@@ -182,7 +182,7 @@ <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.min.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">
M
content/glyph/book/stats/snippets.html
→
content/glyph/book/stats/snippets.html
@@ -63,7 +63,7 @@
<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 class="section"> -<header><h1 id="h_57">Displaying stats about all snippets</h1></header> +<header><h1 id="h_58">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="code"><pre><span class="no"> 1</span> ===== Snippets@@ -85,7 +85,7 @@ <span class="no">16</span> yardoc</pre></div>
</div> <section class="section"> -<header><h1 id="h_58">Remarks</h1></header> +<header><h1 id="h_59">Remarks</h1></header> <ul> <li>Information on snippet usage and definitions is available only when displaying statistics for a single snippet.</li> </ul>@@ -95,7 +95,7 @@
</section> <section class="section"> -<header><h1 id="h_59">Displaying stats about a single snippet</h1></header> +<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'@@ -115,7 +115,7 @@ <span class="no">14</span> - text/stats/macros.glyph (1)</pre></div>
</div> <section class="section"> -<header><h1 id="h_60">Remarks</h1></header> +<header><h1 id="h_61">Remarks</h1></header> <ul> <li>Nested snippets appear as within the file containing the top-level snippet.</li> </ul>@@ -159,7 +159,7 @@ <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.min.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">
M
content/glyph/book/stats/stats.html
→
content/glyph/book/stats/stats.html
@@ -66,7 +66,7 @@ <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.1 +<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@@ -162,7 +162,7 @@ <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.min.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">
M
content/glyph/book/text_editing/attribute_intro.html
→
content/glyph/book/text_editing/attribute_intro.html
@@ -123,7 +123,7 @@ <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.min.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">
M
content/glyph/book/text_editing/code.html
→
content/glyph/book/text_editing/code.html
@@ -145,7 +145,7 @@ <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.min.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">
M
content/glyph/book/text_editing/conditionals.html
→
content/glyph/book/text_editing/conditionals.html
@@ -73,18 +73,18 @@ </ul>
<p>Consider the following code:</p> <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> ?[not[$[document.draft]]| -<span class="no">4</span> This is the official version of the Glyph Book]</pre></div> +<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>The <a href="/glyph/book/macros/macros_core.html#m_condition"><code>condition</code></a> macro takes two parameters:</p> -<ul> - <li>the first one is the condition to evaluate</li> - <li>the second one is the text to include in the document only if the condition is satisfied.</li> -</ul> -<p>Note that <em>both</em> parameters can contain macros, of course, so you can write things like:</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> + <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="code"><pre><span class="no">1</span> ?[and[ <span class="no">2</span> eq[$[document.output]|pdf]@@ -97,7 +97,7 @@ </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> <section class="section"> -<header><h1 id="h_38">Results of conditional expressions</h1></header> +<header><h1 id="h_39">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>@@ -141,7 +141,7 @@ <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.min.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">
M
content/glyph/book/text_editing/esc_quot.html
→
content/glyph/book/text_editing/esc_quot.html
@@ -166,7 +166,7 @@ <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.min.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">
M
content/glyph/book/text_editing/evaluation.html
→
content/glyph/book/text_editing/evaluation.html
@@ -64,8 +64,8 @@ <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> <ul> <li><code>%[2 + 2]</code> → 4</li> - <li><code>%[Time.now]</code> → Thu Sep 23 13:33:57 +0200 2010</li> - <li><code>%[Glyph::VERSION]</code> → 0.4.1</li> + <li><code>%[Time.now]</code> → Fri Oct 22 22:51:14 +0200 2010</li> + <li><code>%[Glyph::VERSION]</code> → 0.4.2</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>@@ -105,7 +105,7 @@ <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.min.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">
M
content/glyph/book/text_editing/glyph_files.html
→
content/glyph/book/text_editing/glyph_files.html
@@ -61,8 +61,9 @@ </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> - <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.<br /> -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>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>@@ -99,7 +100,7 @@ <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.min.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">
M
content/glyph/book/text_editing/images.html
→
content/glyph/book/text_editing/images.html
@@ -128,7 +128,7 @@ <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.min.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">
M
content/glyph/book/text_editing/inclusions.html
→
content/glyph/book/text_editing/inclusions.html
@@ -137,7 +137,7 @@ <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.min.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">
M
content/glyph/book/text_editing/links.html
→
content/glyph/book/text_editing/links.html
@@ -153,7 +153,7 @@ <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.min.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">
M
content/glyph/book/text_editing/macro_intro.html
→
content/glyph/book/text_editing/macro_intro.html
@@ -111,7 +111,7 @@ <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.min.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">
M
content/glyph/book/text_editing/raw_html.html
→
content/glyph/book/text_editing/raw_html.html
@@ -128,7 +128,7 @@ <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.min.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">
M
content/glyph/book/text_editing/section_aliases.html
→
content/glyph/book/text_editing/section_aliases.html
@@ -61,7 +61,7 @@ </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>. Each one of them is a simple wrapper for a <code><div></code> tag with a <code>class</code> attribute set to its name.</p> + <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>@@ -84,7 +84,7 @@ <strong>‡</strong>: Any subsection of this section is not listed in the Table of Contents.
</p> <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 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. +<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>@@ -123,7 +123,7 @@ <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.min.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">
M
content/glyph/book/text_editing/sections.html
→
content/glyph/book/text_editing/sections.html
@@ -62,7 +62,7 @@ <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> - <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, 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="code"><pre><span class="no">1</span> section[@@ -92,6 +92,33 @@ </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> + <section class="section"> +<header><h1 id="h_24">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="code"><pre><span class="no">1</span> section[ +<span class="no">2</span> @title[My Textile section] +<span class="no">3</span> textile[ +<span class="no">4</span> Textile markup can be used _here_. +<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"> + <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"> +<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>@@ -128,7 +155,7 @@ <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.min.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">
M
content/glyph/book/text_editing/stylesheets.html
→
content/glyph/book/text_editing/stylesheets.html
@@ -130,7 +130,7 @@ <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.min.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">
M
content/glyph/book/text_editing/topics.html
→
content/glyph/book/text_editing/topics.html
@@ -129,7 +129,7 @@ <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.min.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">
M
content/glyph/book/text_editing/xml_fallback.html
→
content/glyph/book/text_editing/xml_fallback.html
@@ -189,7 +189,7 @@ <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.min.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">
M
content/glyph/book/troubleshooting/errors_command.html
→
content/glyph/book/troubleshooting/errors_command.html
@@ -165,7 +165,7 @@ <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.min.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">
M
content/glyph/book/troubleshooting/errors_generic.html
→
content/glyph/book/troubleshooting/errors_generic.html
@@ -187,7 +187,7 @@ <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.min.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">
M
content/glyph/book/troubleshooting/errors_macro.html
→
content/glyph/book/troubleshooting/errors_macro.html
@@ -283,7 +283,7 @@ <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.min.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">
M
content/glyph/book/troubleshooting/errors_parser.html
→
content/glyph/book/troubleshooting/errors_parser.html
@@ -151,7 +151,7 @@ <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.min.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">