all repos — h3rald @ 619e485a4c28d63ad5d77f33841d4fa349dfa7c2

The sources of https://h3rald.com

Fixed glyph book.
h3rald h3rald@h3rald.com
Sat, 02 Mar 2024 15:10:35 +0100
commit

619e485a4c28d63ad5d77f33841d4fa349dfa7c2

parent

e1e2d49d6c1a7da166ceffb445f06b128c3a8db0

34 files changed, 263 insertions(+), 258 deletions(-)

jump to
M assets/styles/style.cssassets/styles/style.css

@@ -234,6 +234,11 @@ code {

font-family: 'JetBrains Mono', monospace; } +.break-code { + word-break: break-all; + overflow-wrap: break-word; +} + small, sub, sup,
M contents/glyph.htmlcontents/glyph.html

@@ -41,7 +41,7 @@

<h4>Minimalist Syntax</h4> <p>Glyph syntax rules can be explained using Glyph itself:</p> -<pre><code> +<pre class="break-code"><code> section[ @title[Something about Glyph] txt[

@@ -67,7 +67,7 @@

<p>The Glyph code above corresponds to the following HTML code:</p> -<pre><code> +<pre class="break-code"><code class="html"> &lt;div class="section"&gt; &lt;h2 id="h_10"&gt;Something about Glyph&lt;/h2&gt; &lt;p&gt;

@@ -107,7 +107,7 @@ </code></pre>

<p>...which results in:</p> -<pre><code> +<pre class="break-code"><code> &lt;p&gt;Glyph allows you to define your own snippets and macros.&lt;/p&gt; </code></pre>
M contents/glyph/book/changelog.htmlcontents/glyph/book/changelog.html

@@ -12,11 +12,11 @@

<section class="section"> <header> - <h1 id="h_298" class="toc">v0.5.3 &ndash; October 4 2014</h1> + <h3 id="h_298" class="toc">v0.5.3 &ndash; October 4 2014</h1> </header> <section class="section"> <header> - <h1 id="h_299" class="toc">1 Bug Fixed</h1> + <h3 id="h_299" class="toc">1 Bug Fixed</h1> </header> <table> <tr>

@@ -40,11 +40,11 @@ </section>

<section class="section"> <header> - <h1 id="h_300" class="toc">v0.5.2 &ndash; November 11th 2012</h1> + <h3 id="h_300" class="toc">v0.5.2 &ndash; November 11th 2012</h1> </header> <section class="section"> <header> - <h1 id="h_301" class="toc">2 Features Implemented</h1> + <h3 id="h_301" class="toc">2 Features Implemented</h1> </header> <table> <tr>

@@ -74,7 +74,7 @@

<section class="section"> <header> - <h1 id="h_302" class="toc">2 Bugs Fixed</h1> + <h3 id="h_302" class="toc">2 Bugs Fixed</h1> </header> <table> <tr>

@@ -105,11 +105,11 @@ </section>

<section class="section"> <header> - <h1 id="h_303" class="toc">v0.5.1 &ndash; December 4th 2011</h1> + <h3 id="h_303" class="toc">v0.5.1 &ndash; December 4th 2011</h1> </header> <section class="section"> <header> - <h1 id="h_304" class="toc">2 Bugs Fixed</h1> + <h3 id="h_304" class="toc">2 Bugs Fixed</h1> </header> <table> <tr>

@@ -140,11 +140,11 @@ </section>

<section class="section"> <header> - <h1 id="h_305" class="toc">v0.5.0 &ndash; August 28th 2011</h1> + <h3 id="h_305" class="toc">v0.5.0 &ndash; August 28th 2011</h1> </header> <section class="section"> <header> - <h1 id="h_306" class="toc">16 Features Implemented</h1> + <h3 id="h_306" class="toc">16 Features Implemented</h1> </header> <table> <tr>

@@ -295,7 +295,7 @@

<section class="section"> <header> - <h1 id="h_307" class="toc">4 Bugs Fixed</h1> + <h3 id="h_307" class="toc">4 Bugs Fixed</h1> </header> <table> <tr>

@@ -343,11 +343,11 @@ </section>

<section class="section"> <header> - <h1 id="h_308" class="toc">v0.4.2 &ndash; October 22th 2010</h1> + <h3 id="h_308" class="toc">v0.4.2 &ndash; October 22th 2010</h1> </header> <section class="section"> <header> - <h1 id="h_309" class="toc">3 Features Implemented</h1> + <h3 id="h_309" class="toc">3 Features Implemented</h1> </header> <table> <tr>

@@ -385,7 +385,7 @@

<section class="section"> <header> - <h1 id="h_310" class="toc">1 Bug Fixed</h1> + <h3 id="h_310" class="toc">1 Bug Fixed</h1> </header> <table> <tr>

@@ -410,11 +410,11 @@ </section>

<section class="section"> <header> - <h1 id="h_311" class="toc">v0.4.1 &ndash; September 23th 2010</h1> + <h3 id="h_311" class="toc">v0.4.1 &ndash; September 23th 2010</h1> </header> <section class="section"> <header> - <h1 id="h_312" class="toc">5 Bugs Fixed</h1> + <h3 id="h_312" class="toc">5 Bugs Fixed</h1> </header> <table> <tr>

@@ -468,11 +468,11 @@ </section>

<section class="section"> <header> - <h1 id="h_313" class="toc">v0.4.0 &ndash; September 3th 2010</h1> + <h3 id="h_313" class="toc">v0.4.0 &ndash; September 3th 2010</h1> </header> <section class="section"> <header> - <h1 id="h_314" class="toc">13 Features Implemented</h1> + <h3 id="h_314" class="toc">13 Features Implemented</h1> </header> <table> <tr>

@@ -585,7 +585,7 @@

<section class="section"> <header> - <h1 id="h_315" class="toc">7 Bugs Fixed</h1> + <h3 id="h_315" class="toc">7 Bugs Fixed</h1> </header> <table> <tr>

@@ -653,11 +653,11 @@ </section>

<section class="section"> <header> - <h1 id="h_316" class="toc">v0.3.0 &ndash; June 13th 2010</h1> + <h3 id="h_316" class="toc">v0.3.0 &ndash; June 13th 2010</h1> </header> <section class="section"> <header> - <h1 id="h_317" class="toc">13 Features Implemented</h1> + <h3 id="h_317" class="toc">13 Features Implemented</h1> </header> <table> <tr>

@@ -775,7 +775,7 @@

<section class="section"> <header> - <h1 id="h_318" class="toc">3 Bugs Fixed</h1> + <h3 id="h_318" class="toc">3 Bugs Fixed</h1> </header> <table> <tr>

@@ -814,11 +814,11 @@ </section>

<section class="section"> <header> - <h1 id="h_319" class="toc">v0.2.0 &ndash; May 9th 2010</h1> + <h3 id="h_319" class="toc">v0.2.0 &ndash; May 9th 2010</h1> </header> <section class="section"> <header> - <h1 id="h_320" class="toc">11 Features Implemented</h1> + <h3 id="h_320" class="toc">11 Features Implemented</h1> </header> <table> <tr>

@@ -927,7 +927,7 @@

<section class="section"> <header> - <h1 id="h_321" class="toc">8 Bugs Fixed</h1> + <h3 id="h_321" class="toc">8 Bugs Fixed</h1> </header> <table> <tr>

@@ -1008,7 +1008,7 @@ </section>

<section class="section"> <header> - <h1 id="h_322" class="toc">v0.1.0 &ndash; April 8th 2010</h1> + <h3 id="h_322" class="toc">v0.1.0 &ndash; April 8th 2010</h1> </header> Initial release.
M contents/glyph/book/compiling/compiling.htmlcontents/glyph/book/compiling/compiling.html

@@ -17,7 +17,7 @@ <li>Web5 (i.e. multiple HTML5 files)</li>

</ul> <section class="section"> <header> - <h1 id="h_50" class="toc">HTML/HTML5 output</h1> + <h3 id="h_50" class="toc">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.

@@ -33,7 +33,7 @@

</section> <section class="section"> <header> - <h1 id="h_51" class="toc">PDF Output</h1> + <h3 id="h_51" class="toc">PDF Output</h1> </header> <p>To generate a PDF document, you must specify <code>pdf</code> as format, like this:</p> <p>

@@ -66,7 +66,7 @@ </section>

<section class="section"> <header> - <h1 id="h_52" class="toc">EPUB/MOBI output</h1> + <h3 id="h_52" class="toc">EPUB/MOBI output</h1> </header> <p>To generate .epub or .mobi e-books, you must specify <code>epub</code> or <code>mobi</code> as format, like this: </p>

@@ -95,7 +95,7 @@ </section>

<section class="section"> <header> - <h1 id="web_output" class="toc">Web/Web5 Output</h1> + <h3 id="web_output" class="toc">Web/Web5 Output</h1> </header> <p>To generate a Web or Web5 output, specify <code>web</code> or <code>web5</code> as format. These two output formats behave different way from the others, and require that your project uses <a

@@ -113,7 +113,7 @@

</section> <section class="section"> <header> - <h1 id="auto_regeneration" class="toc">Auto Regeneration</h1> + <h3 id="auto_regeneration" class="toc">Auto Regeneration</h1> </header> <p>You can also call the <a href="/glyph/book/ref_commands.html#c_compile"><code>compile</code></a> command with a <code>--auto</code> switch. If you do so, your project will be recompiled automatically every time any source file
M contents/glyph/book/compiling/lite_mode.htmlcontents/glyph/book/compiling/lite_mode.html

@@ -19,7 +19,7 @@ <p>This command will process a file called <code>source.glyph</code> and produce an HTML file called

<code>destination.htm</code>.</p> <section class="section"> <header> - <h1 id="lite_limitations" class="toc">Limitations</h1> + <h3 id="lite_limitations" class="toc">Limitations</h1> </header> <p>This sort of &#8220;lite&#8221; mode comes with a few minor limitations:</p> <ul>
M contents/glyph/book/compiling/programmatic_usage.htmlcontents/glyph/book/compiling/programmatic_usage.html

@@ -31,7 +31,7 @@

</aside> <section class="section"> <header> - <h1 id="modes" class="toc">Modes</h1> + <h3 id="modes" class="toc">Modes</h1> </header> <p>It is possible to specify some flags (or "modes") to make Glyph behave slightly different than normal, as shown in the following table (by default, none of these is used).</p>
M contents/glyph/book/config/output.htmlcontents/glyph/book/config/output.html

@@ -19,7 +19,7 @@

<section class="section"> <header> - <h1 id="h_290" class="toc">output.epub.*</h1> + <h3 id="h_290" class="toc">output.epub.*</h1> </header> <table> <tr>

@@ -114,7 +114,7 @@

</section> <section class="section"> <header> - <h1 id="h_291" class="toc">output.mobi.*</h1> + <h3 id="h_291" class="toc">output.mobi.*</h1> </header> <table> <tr>

@@ -209,7 +209,7 @@

</section> <section class="section"> <header> - <h1 id="h_292" class="toc">output.pdf.*</h1> + <h3 id="h_292" class="toc">output.pdf.*</h1> </header> <table> <tr>

@@ -304,7 +304,7 @@

</section> <section class="section"> <header> - <h1 id="h_293" class="toc">output.html.*</h1> + <h3 id="h_293" class="toc">output.html.*</h1> </header> <table> <tr>

@@ -371,7 +371,7 @@

</section> <section class="section"> <header> - <h1 id="h_294" class="toc">output.html5.*</h1> + <h3 id="h_294" class="toc">output.html5.*</h1> </header> <table> <tr>

@@ -438,7 +438,7 @@

</section> <section class="section"> <header> - <h1 id="h_295" class="toc">output.web.*</h1> + <h3 id="h_295" class="toc">output.web.*</h1> </header> <table> <tr>

@@ -558,7 +558,7 @@

</section> <section class="section"> <header> - <h1 id="h_296" class="toc">output.web5.*</h1> + <h3 id="h_296" class="toc">output.web5.*</h1> </header> <table> <tr>
M contents/glyph/book/extending/command.htmlcontents/glyph/book/extending/command.html

@@ -11,7 +11,7 @@ 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_108" class="toc">Creating a 'glyph generate' command</h1> + <h3 id="h_108" class="toc">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 &#8216;custom:generate&#8217; task</a>. Creating a custom command to call it is fairly straightforward.</p>
M contents/glyph/book/extending/commands_tasks.htmlcontents/glyph/book/extending/commands_tasks.html

@@ -14,7 +14,7 @@ <p>Glyph&#8217;s modular architecture (and the Ruby language itself) lets you to add <em>arbitrary</em> functionality to

its core, simply by creating a few Ruby files and putting them in the right places.</p> <section class="section"> <header> - <h1 id="cmd_tasks_arch" class="toc">How Commands and Tasks work</h1> + <h3 id="cmd_tasks_arch" class="toc">How Commands and Tasks work</h1> </header> <p>Before creating custom Glyph commands and tasks, you should have a basic understanding on how they work, and which commands &#8212; or better, which tasks &#8212; are already available.</p>
M contents/glyph/book/extending/internals.htmlcontents/glyph/book/extending/internals.html

@@ -30,7 +30,7 @@ after analysis, i.e. it replaces escape sequences and placeholders.</li>

</ul> <section class="section"> <header> - <h1 id="h_83" class="toc">Example: A short note</h1> + <h3 id="h_83" class="toc">Example: A short note</h1> </header> <p>As an example, consider the following Glyph code:</p> <div class="CodeRay">
M contents/glyph/book/extending/interpreting.htmlcontents/glyph/book/extending/interpreting.html

@@ -35,7 +35,7 @@ </ol>

<section class="section"> <header> - <h1 id="h_93" class="toc">Dispatching</h1> + <h3 id="h_93" class="toc">Dispatching</h1> </header> <p><a href="/glyph/book/text_editing/macro_composition.html#composition">Macro Composition</a> can be useful to remove nesting, but you can also use it to create your own macro <em>dispatchers</em>. What is a macro

@@ -82,7 +82,7 @@ </section>

<section class="section"> <header> - <h1 id="rewriting" class="toc">Defining macros using Glyph</h1> + <h3 id="rewriting" class="toc">Defining macros using Glyph</h1> </header> <p>While the <code>interpret</code> method is useful to evaluate Glyph code in a macro while performing other actions (storing a bookmark, checking for the presence of an anchor, etc.), in some cases it may not be
M contents/glyph/book/extending/layouts.htmlcontents/glyph/book/extending/layouts.html

@@ -16,7 +16,7 @@ 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_96" class="toc">Topic Layout</h1> + <h3 id="h_96" class="toc">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>

@@ -50,7 +50,7 @@

</section> <section class="section"> <header> - <h1 id="index_layout" class="toc">Index Layout</h1> + <h3 id="index_layout" class="toc">Index Layout</h1> </header> <p>The default layout used to render the web index page (the layout used for the web5 index is very similar) is defined as follows:</p>

@@ -81,7 +81,7 @@

</section> <section class="section"> <header> - <h1 id="h_98" class="toc">Creating a Custom Layout</h1> + <h3 id="h_98" class="toc">Creating a Custom Layout</h1> </header> <p>To create a custom layout, proceed as follows:</p> <ul>
M contents/glyph/book/extending/macro_def.htmlcontents/glyph/book/extending/macro_def.html

@@ -99,7 +99,7 @@ </tr>

</table> <section class="section"> <header> - <h1 id="h_85" class="toc">Representations</h1> + <h3 id="h_85" class="toc">Representations</h1> </header> <p>There&#8217;s a small problem with the code used to define the <code>note</code> macro in the previous section: what if I want to format notes using HTML5 instead of <span class="caps">HTML</span>, or another output format?</p>
M contents/glyph/book/extending/output_format.htmlcontents/glyph/book/extending/output_format.html

@@ -17,7 +17,7 @@ <a href="http://www.h3rald.com">H3RALD.com</a> website.

</p> <section class="section"> <header> - <h1 id="h_105" class="toc">Output Configuration</h1> + <h3 id="h_105" class="toc">Output Configuration</h1> </header> <p>The first step required to add a new output format to Glyph is extending Glyph&#8217;s configuration by adding the appropriate output hash, as follows:</p>

@@ -50,7 +50,7 @@

</section> <section class="section"> <header> - <h1 id="h_106" class="toc">Creating a 'generate:h3rald' task</h1> + <h3 id="h_106" class="toc">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:
M contents/glyph/book/extending/params_attrs.htmlcontents/glyph/book/extending/params_attrs.html

@@ -11,7 +11,7 @@ <em>expanded value</em>. The difference between the two will become clearer in the following sections and also in

the <a href="/glyph/book/extending/interpreting.html#interpreting">Interpreting Glyph Code</a> section.</p> <section class="section"> <header> - <h1 id="expanded_values" class="toc">Accessing Expanded Values</h1> + <h3 id="expanded_values" class="toc">Accessing Expanded Values</h1> </header> <p>Normally, you just want to get the value of an attribute or parameter and use it in the macro. This means, in other words, its <em>expanded</em> value, i.e. the value resulting from the expansion of the macros (if any)

@@ -31,7 +31,7 @@

</section> <section class="section"> <header> - <h1 id="h_88" class="toc">Accessing Raw Values</h1> + <h3 id="h_88" class="toc">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>
M contents/glyph/book/extending/task.htmlcontents/glyph/book/extending/task.html

@@ -12,7 +12,7 @@ <p>Furthermore, Rake provides an easy mechanism to create dependencies among tasks: for example, to make sure that

Glyph&#8217;s configuration files are loaded before everything else happens.</p> <section class="section"> <header> - <h1 id="custom_generate_task" class="toc">Creating a 'custom:generate' task</h1> + <h3 id="custom_generate_task" class="toc">Creating a 'custom:generate' task</h1> </header> <p>A custom task has been defined for the Glyph project used to produce this document. This custom task is used to compile a few of the documents files into standalone files, deployed in Glyph&#8217;s root folder:</p>
M contents/glyph/book/index.htmlcontents/glyph/book/index.html

@@ -3,7 +3,7 @@ title: "Glyph Documentation"

content-type: page ----- <nav class="contents"> -<h1 class="toc-header" id="toc">Table of Contents</h1> +<h3 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><li class="frontmatter section">Resources</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>
M contents/glyph/book/introduction.htmlcontents/glyph/book/introduction.html

@@ -13,11 +13,11 @@ customization and extensibility.</p>

<section class="section"> <header> - <h1 id="h_2" class="toc">Main Features</h1> + <h3 id="h_2" class="toc">Main Features</h1> </header> <section class="section"> <header> - <h1 id="h_3" class="toc">Command Line Interface</h1> + <h3 id="h_3" class="toc">Command Line Interface</h1> </header> <p>Glyph is 100% command line. Its interface resambles <a href="http://git-scm.com/">Git&#8217;s</a> for its simplicity and power (thanks to the <a href="http://github.com/davetron5000/gli">gli</a> gem). Here are

@@ -45,7 +45,7 @@ </section>

<section class="section"> <header> - <h1 id="h_4" class="toc">Minimalist Syntax</h1> + <h3 id="h_4" class="toc">Minimalist Syntax</h1> </header> <p>Glyph syntax rules can be explained using Glyph itself:</p>

@@ -106,7 +106,7 @@ </section>

<section class="section"> <header> - <h1 id="h_5" class="toc">Content Reuse</h1> + <h3 id="h_5" class="toc">Content Reuse</h1> </header> <p>Finding yourself repeating the same sentence over an over? Glyph allows you to create snippets. Within snippets. Within other snippets (and so on, for a long long time&#8230;) as long as you don&#8217;t

@@ -135,7 +135,7 @@

</section> <section class="section"> <header> - <h1 id="h_6" class="toc">Automation of Common Tasks</h1> + <h3 id="h_6" class="toc">Automation of Common Tasks</h1> </header> <p>If you&#8217;re writing a book, you shouldn&#8217;t have to worry about pagination, headers, footers, table of contents, section numbering or similar. Glyph understands you, and will take care of everything

@@ -144,7 +144,7 @@

</section> <section class="section"> <header> - <h1 id="h_7" class="toc">Reference Validation</h1> + <h3 id="h_7" class="toc">Reference Validation</h1> </header> <p>Feel free to add plenty of links, snippets, bookmarks, &#8230; if Glyph doesn&#8217;t find something, it will definitely complain. Broken references are a thing on the past, and you don&#8217;t need to worry

@@ -153,7 +153,7 @@

</section> <section class="section"> <header> - <h1 id="h_8" class="toc">Extreme Extensibility</h1> + <h3 id="h_8" class="toc">Extreme Extensibility</h1> </header> <ul> <li>You miss a <code>!!!</code> macro to format really, <em>really</em> important things? Create it. In

@@ -169,7 +169,7 @@

</section> <section class="section"> <header> - <h1 id="h_9" class="toc">Convention over Configuration</h1> + <h3 id="h_9" class="toc">Convention over Configuration</h1> </header> <p>Put your text files in <code>/text</code>, your images in <code>/images</code>, add custom macros in a <code>macro</code> folder within your <code>/lib</code> folder&#8230; you get the picture: Glyph has its

@@ -181,7 +181,7 @@

</section> <section class="section"> <header> - <h1 id="h_10" class="toc">Free and Open Source</h1> + <h3 id="h_10" class="toc">Free and Open Source</h1> </header> <p>Glyph is 100% Open Source Software, developed using the Ruby Programming Language and licensed under the very permissive terms of the <a href="http://www.opensource.org/licenses/mit-license.php"><span

@@ -193,7 +193,7 @@

</section> <section class="section"> <header> - <h1 id="h_11" class="toc">Resources</h1> + <h3 id="h_11" class="toc">Resources</h1> </header> <ul> <li>Home Page: <a href="/glyph/">/glyph/</a></li>
M contents/glyph/book/macros/macros_block.htmlcontents/glyph/book/macros/macros_block.html

@@ -8,7 +8,7 @@ </nav>

<section class="section"> <header> - <h1 id="m_box" class="toc"><code>box</code></h1> + <h3 id="m_box" class="toc"><code>box</code></h1> </header> <p>Creates a titled box (<code>&lt;div&gt;</code> tag).</p>

@@ -16,7 +16,7 @@

<section class="section"> <header> - <h1 id="h_217" class="notoc">Example</h1> + <h3 id="h_217" class="notoc">Example</h1> </header> <div class="CodeRay"> <div class="code">

@@ -32,7 +32,7 @@

<section class="section"> <header> - <h1 id="h_218" class="notoc">Parameters</h1> + <h3 id="h_218" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -59,7 +59,7 @@

<section class="section"> <header> - <h1 id="m_codeblock" class="toc"><code>codeblock</code></h1> + <h3 id="m_codeblock" class="toc"><code>codeblock</code></h1> </header> <p>Used to render a block of code within <code>&lt;pre&gt;</code> and <code>&lt;code&gt;</code> tags.</p>

@@ -67,7 +67,7 @@

<section class="section"> <header> - <h1 id="h_220" class="notoc">Example</h1> + <h3 id="h_220" class="notoc">Example</h1> </header> <div class="CodeRay"> <div class="code">

@@ -85,7 +85,7 @@

<section class="section"> <header> - <h1 id="h_221" class="notoc">Parameters</h1> + <h3 id="h_221" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -103,7 +103,7 @@

<section class="section"> <header> - <h1 id="h_222" class="notoc">Remarks</h1> + <h3 id="h_222" class="notoc">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>

@@ -116,7 +116,7 @@

<section class="section"> <header> - <h1 id="m_figure" class="toc"><code>figure</code></h1> + <h3 id="m_figure" class="toc"><code>figure</code></h1> </header> <p>Includes an image in the document, with an optional caption (see <a href="/glyph/book/text_editing/images.html#img_fig">Images and Figures</a>).</p>

@@ -125,7 +125,7 @@

<section class="section"> <header> - <h1 id="h_224" class="notoc">Example</h1> + <h3 id="h_224" class="notoc">Example</h1> </header> <div class="CodeRay"> <div class="code">

@@ -142,7 +142,7 @@

<section class="section"> <header> - <h1 id="h_225" class="notoc">Parameters</h1> + <h3 id="h_225" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -166,7 +166,7 @@

<section class="section"> <header> - <h1 id="h_226" class="notoc">Attributes</h1> + <h3 id="h_226" class="notoc">Attributes</h1> </header> <table style="width:100%;"> <tr>

@@ -187,7 +187,7 @@

<section class="section"> <header> - <h1 id="m_image" class="toc"><code>image</code></h1> + <h3 id="m_image" class="toc"><code>image</code></h1> </header> <p>Includes an image in the document</p>

@@ -195,7 +195,7 @@

<section class="section"> <header> - <h1 id="h_228" class="notoc">Example</h1> + <h3 id="h_228" class="notoc">Example</h1> </header> <div class="CodeRay"> <div class="code">

@@ -213,7 +213,7 @@

<section class="section"> <header> - <h1 id="h_229" class="notoc">Parameters</h1> + <h3 id="h_229" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -231,7 +231,7 @@

<section class="section"> <header> - <h1 id="h_230" class="notoc">Attributes</h1> + <h3 id="h_230" class="notoc">Attributes</h1> </header> <table style="width:100%;"> <tr>

@@ -252,7 +252,7 @@

<section class="section"> <header> - <h1 id="m_navigation" class="toc"><code>navigation</code></h1> + <h3 id="m_navigation" class="toc"><code>navigation</code></h1> </header> <p>Displays links to the document&#8217;s <span class="caps">TOC</span> and the previous/next topic (used only in <a href="/glyph/book/extending/layouts.html#layouts">layouts</a>).</p>

@@ -263,7 +263,7 @@

<section class="section"> <header> - <h1 id="h_232" class="notoc">Parameters</h1> + <h3 id="h_232" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -284,7 +284,7 @@

<section class="section"> <header> - <h1 id="m_note" class="toc"><code>note</code></h1> + <h3 id="m_note" class="toc"><code>note</code></h1> </header> <p>Creates a note <code>div</code> containing the value.</p> <strong>Aliases:</strong> <code>important, caution, tip</code>

@@ -294,7 +294,7 @@

<section class="section"> <header> - <h1 id="h_234" class="notoc">Parameters</h1> + <h3 id="h_234" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -315,7 +315,7 @@

<section class="section"> <header> - <h1 id="m_pubdate" class="toc"><code>pubdate</code></h1> + <h3 id="m_pubdate" class="toc"><code>pubdate</code></h1> </header> <p>Evaluates to a date string (in the format: <em>current_month</em> <em>current_year</em>; i.e. <em>%B</em> <em>%Y</em>), within a <code>&lt;div&gt;</code> tag. If a parameter is supplied, its value is used instead of

@@ -327,7 +327,7 @@

<section class="section"> <header> - <h1 id="h_236" class="notoc">Parameters</h1> + <h3 id="h_236" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -348,7 +348,7 @@

<section class="section"> <header> - <h1 id="m_revision" class="toc"><code>revision</code></h1> + <h3 id="m_revision" class="toc"><code>revision</code></h1> </header> <p>Renders the revision of the document (based on the <a href="/glyph/book/config/document.html#s_document_revision"><code>document.revision</code></a> setting)

@@ -362,7 +362,7 @@

<section class="section"> <header> - <h1 id="m_subtitle" class="toc"><code>subtitle</code></h1> + <h3 id="m_subtitle" class="toc"><code>subtitle</code></h1> </header> <p>Renders the subtitle of the document (based on the <a href="/glyph/book/config/document.html#s_document_subtitle"><code>document.subtitle</code></a> setting)

@@ -376,7 +376,7 @@

<section class="section"> <header> - <h1 id="m_title" class="toc"><code>title</code></h1> + <h3 id="m_title" class="toc"><code>title</code></h1> </header> <p>Renders the title of the document (based on the <a href="/glyph/book/config/document.html#s_document_title"><code>document.title</code></a> setting) within a
M contents/glyph/book/macros/macros_core.htmlcontents/glyph/book/macros/macros_core.html

@@ -9,7 +9,7 @@

<section class="section"> <header> - <h1 id="m_add" class="toc"><code>add</code></h1> + <h3 id="m_add" class="toc"><code>add</code></h1> </header> <p>Adds two or more integers together.</p>

@@ -21,7 +21,7 @@

<section class="section"> <header> - <h1 id="m_alias" class="toc"><code>alias</code></h1> + <h3 id="m_alias" class="toc"><code>alias</code></h1> </header> <p>Creates a macro alias.</p>

@@ -31,7 +31,7 @@

<section class="section"> <header> - <h1 id="h_142" class="notoc">Parameters</h1> + <h3 id="h_142" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -58,7 +58,7 @@

<section class="section"> <header> - <h1 id="m_and" class="toc"><code>and</code></h1> + <h3 id="m_and" class="toc"><code>and</code></h1> </header> <p>Conditional <code>and</code> operator, to be used with the <a href="#m_condition"><code>condition</code></a> macro.</p>

@@ -69,7 +69,7 @@

<section class="section"> <header> - <h1 id="h_144" class="notoc">Parameters</h1> + <h3 id="h_144" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -95,7 +95,7 @@

<section class="section"> <header> - <h1 id="m_attribute" class="toc"><code>attribute</code></h1> + <h3 id="m_attribute" class="toc"><code>attribute</code></h1> </header> <p>Returns the value of the specified attribute. For a more complete example, see the <a href="#m_let"><code>let</code></a> macro.</p>

@@ -106,7 +106,7 @@

<section class="section"> <header> - <h1 id="h_146" class="notoc">Parameters</h1> + <h3 id="h_146" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -127,7 +127,7 @@

<section class="section"> <header> - <h1 id="m_attribute_" class="toc"><code>attribute:</code></h1> + <h3 id="m_attribute_" class="toc"><code>attribute:</code></h1> </header> <p>Sets the value of the specified attribute. For a more complete example, see the ‡‡‡‡‡PLACEHOLDER¤277‡‡‡‡‡ macro. </p>

@@ -138,7 +138,7 @@

<section class="section"> <header> - <h1 id="h_148" class="notoc">Parameters</h1> + <h3 id="h_148" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -165,7 +165,7 @@

<section class="section"> <header> - <h1 id="m_comment" class="toc"><code>comment</code></h1> + <h3 id="m_comment" class="toc"><code>comment</code></h1> </header> <p>Evaluates to nothing. Used to add comments in a Glyph document that will not be displayed in output files.</p> <strong>Aliases:</strong> <code>--</code>

@@ -175,7 +175,7 @@

<section class="section"> <header> - <h1 id="h_150" class="notoc">Parameters</h1> + <h3 id="h_150" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -193,7 +193,7 @@

<section class="section"> <header> - <h1 id="h_151" class="notoc">Remarks</h1> + <h3 id="h_151" class="notoc">Remarks</h1> </header> <p>Macros are not expanded within comments.</p>

@@ -205,7 +205,7 @@

<section class="section"> <header> - <h1 id="m_condition" class="toc"><code>condition</code></h1> + <h3 id="m_condition" class="toc"><code>condition</code></h1> </header> <p>Tests a conditional expression. For more information, see <a href="/glyph/book/text_editing/conditionals.html#cond_macros">Conditional Macros</a>.</p>

@@ -216,7 +216,7 @@

<section class="section"> <header> - <h1 id="h_153" class="notoc">Parameters</h1> + <h3 id="h_153" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -240,7 +240,7 @@

<section class="section"> <header> - <h1 id="h_154" class="notoc">Remarks</h1> + <h3 id="h_154" class="notoc">Remarks</h1> </header> <p>For examples see any of the following:</p> <ul>

@@ -259,7 +259,7 @@

<section class="section"> <header> - <h1 id="m_config" class="toc"><code>config</code></h1> + <h3 id="m_config" class="toc"><code>config</code></h1> </header> <p>Returns the value of a configuration setting.</p> <strong>Aliases:</strong> <code>$</code>

@@ -269,7 +269,7 @@

<section class="section"> <header> - <h1 id="h_156" class="notoc">Parameters</h1> + <h3 id="h_156" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -290,7 +290,7 @@

<section class="section"> <header> - <h1 id="m_config_" class="toc"><code>config:</code></h1> + <h3 id="m_config_" class="toc"><code>config:</code></h1> </header> <p>Sets the value of a configuration setting.</p> <strong>Aliases:</strong> <code>$:</code>

@@ -300,7 +300,7 @@

<section class="section"> <header> - <h1 id="h_158" class="notoc">Parameters</h1> + <h3 id="h_158" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -324,7 +324,7 @@

<section class="section"> <header> - <h1 id="h_159" class="notoc">Remarks</h1> + <h3 id="h_159" class="notoc">Remarks</h1> </header> <p>This macro cannot be used in <a href="/glyph/book/compiling/programmatic_usage.html#modes">safe mode</a>.</p>

@@ -336,7 +336,7 @@

<section class="section"> <header> - <h1 id="m_eq" class="toc"><code>eq</code></h1> + <h3 id="m_eq" class="toc"><code>eq</code></h1> </header> <p>Conditional equality operator, to be used with the <a href="#m_condition"><code>condition</code></a> macro.</p>

@@ -347,7 +347,7 @@

<section class="section"> <header> - <h1 id="h_161" class="notoc">Parameters</h1> + <h3 id="h_161" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -373,7 +373,7 @@

<section class="section"> <header> - <h1 id="m_escape" class="toc"><code>escape</code></h1> + <h3 id="m_escape" class="toc"><code>escape</code></h1> </header> <p>Evaluates to its value. Commonly used with the escaping delimiters <code>[=</code> and <code>=]</code>.</p> <strong>Aliases:</strong> <code>.</code>

@@ -383,7 +383,7 @@

<section class="section"> <header> - <h1 id="h_163" class="notoc">Parameters</h1> + <h3 id="h_163" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -404,7 +404,7 @@

<section class="section"> <header> - <h1 id="m_fragment" class="toc"><code>fragment</code></h1> + <h3 id="m_fragment" class="toc"><code>fragment</code></h1> </header> <p>Delimits a fragment of text that can be embedded using the <a href="#m_embed"><code>embed</code></a> macro.</p> <strong>Aliases:</strong> <code>##</code>

@@ -414,7 +414,7 @@

<section class="section"> <header> - <h1 id="h_165" class="notoc">Parameters</h1> + <h3 id="h_165" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -441,7 +441,7 @@

<section class="section"> <header> - <h1 id="m_embed" class="toc"><code>embed</code></h1> + <h3 id="m_embed" class="toc"><code>embed</code></h1> </header> <p>Embeds text previously-delimited using the <a href="#m_fragment"><code>fragment</code></a> macro.</p> <strong>Aliases:</strong> <code>&amp;=</code>

@@ -451,7 +451,7 @@

<section class="section"> <header> - <h1 id="h_167" class="notoc">Parameters</h1> + <h3 id="h_167" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -475,7 +475,7 @@

<section class="section"> <header> - <h1 id="m_gt" class="toc"><code>gt</code></h1> + <h3 id="m_gt" class="toc"><code>gt</code></h1> </header> <p>Returns <em>true</em> if the first parameter is gt the second one.</p>

@@ -485,7 +485,7 @@

<section class="section"> <header> - <h1 id="h_169" class="notoc">Parameters</h1> + <h3 id="h_169" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -514,7 +514,7 @@

<section class="section"> <header> - <h1 id="m_gte" class="toc"><code>gte</code></h1> + <h3 id="m_gte" class="toc"><code>gte</code></h1> </header> <p>Returns <em>true</em> if the first parameter is gte the second one.</p>

@@ -524,7 +524,7 @@

<section class="section"> <header> - <h1 id="h_171" class="notoc">Parameters</h1> + <h3 id="h_171" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -552,7 +552,7 @@

<section class="section"> <header> - <h1 id="m_include" class="toc"><code>include</code></h1> + <h3 id="m_include" class="toc"><code>include</code></h1> </header> <p>Evaluates to the contents of a text file stored in the <code>text/</code> directory referenced by its relative path. If the <a

@@ -567,7 +567,7 @@

<section class="section"> <header> - <h1 id="h_173" class="notoc">Parameters</h1> + <h3 id="h_173" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -585,7 +585,7 @@

<section class="section"> <header> - <h1 id="h_174" class="notoc">Remarks</h1> + <h3 id="h_174" class="notoc">Remarks</h1> </header> <ul> <li>

@@ -608,7 +608,7 @@

<section class="section"> <header> - <h1 id="m_let" class="toc"><code>let</code></h1> + <h3 id="m_let" class="toc"><code>let</code></h1> </header> <p>Used to bind one or more attributes via the <a href="#m_attribute"><code>attribute</code></a> macro. Actually, you can use <a href="#m_attribute"><code>attribute</code></a> macro inside any other macro, but it looks tidier

@@ -618,7 +618,7 @@

<section class="section"> <header> - <h1 id="h_176" class="notoc">Example</h1> + <h3 id="h_176" class="notoc">Example</h1> </header> <div class="CodeRay"> <div class="code">

@@ -639,7 +639,7 @@

<section class="section"> <header> - <h1 id="h_177" class="notoc">Parameters</h1> + <h3 id="h_177" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -660,7 +660,7 @@

<section class="section"> <header> - <h1 id="m_load" class="toc"><code>load</code></h1> + <h3 id="m_load" class="toc"><code>load</code></h1> </header> <p>Embeds the contents of a file.</p>

@@ -670,7 +670,7 @@

<section class="section"> <header> - <h1 id="h_179" class="notoc">Parameters</h1> + <h3 id="h_179" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -692,7 +692,7 @@

<section class="section"> <header> - <h1 id="m_lt" class="toc"><code>lt</code></h1> + <h3 id="m_lt" class="toc"><code>lt</code></h1> </header> <p>Returns <em>true</em> if the first parameter is lt the second one.</p>

@@ -702,7 +702,7 @@

<section class="section"> <header> - <h1 id="h_181" class="notoc">Parameters</h1> + <h3 id="h_181" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -731,7 +731,7 @@

<section class="section"> <header> - <h1 id="m_lte" class="toc"><code>lte</code></h1> + <h3 id="m_lte" class="toc"><code>lte</code></h1> </header> <p>Returns <em>true</em> if the first parameter is lte the second one.</p>

@@ -741,7 +741,7 @@

<section class="section"> <header> - <h1 id="h_183" class="notoc">Parameters</h1> + <h3 id="h_183" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -769,7 +769,7 @@

<section class="section"> <header> - <h1 id="m_match" class="toc"><code>match</code></h1> + <h3 id="m_match" class="toc"><code>match</code></h1> </header> <p>Checks a string against a regular expression.</p>

@@ -779,7 +779,7 @@

<section class="section"> <header> - <h1 id="h_185" class="notoc">Parameters</h1> + <h3 id="h_185" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -809,7 +809,7 @@

<section class="section"> <header> - <h1 id="h_186" class="notoc">Remarks</h1> + <h3 id="h_186" class="notoc">Remarks</h1> </header> <p>This macro must be used with the <a href="#m_condition"><code>condition</code></a> macro.</p>

@@ -821,7 +821,7 @@

<section class="section"> <header> - <h1 id="m_macro_" class="toc"><code>macro:</code></h1> + <h3 id="m_macro_" class="toc"><code>macro:</code></h1> </header> <p>Defines a macro.</p> <strong>Aliases:</strong> <code>%:</code>

@@ -831,7 +831,7 @@

<section class="section"> <header> - <h1 id="h_188" class="notoc">Parameters</h1> + <h3 id="h_188" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -855,7 +855,7 @@

<section class="section"> <header> - <h1 id="h_189" class="notoc">Remarks</h1> + <h3 id="h_189" class="notoc">Remarks</h1> </header> <ul> <li>

@@ -873,7 +873,7 @@

<section class="section"> <header> - <h1 id="m_multiply" class="toc"><code>multiply</code></h1> + <h3 id="m_multiply" class="toc"><code>multiply</code></h1> </header> <p>Multiplies two or more integers together.</p>

@@ -885,7 +885,7 @@

<section class="section"> <header> - <h1 id="m_not" class="toc"><code>not</code></h1> + <h3 id="m_not" class="toc"><code>not</code></h1> </header> <p>Conditional <code>not</code> operator, to be used with the <a href="#m_condition"><code>condition</code></a> macro.</p>

@@ -896,7 +896,7 @@

<section class="section"> <header> - <h1 id="h_192" class="notoc">Parameters</h1> + <h3 id="h_192" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -917,7 +917,7 @@

<section class="section"> <header> - <h1 id="m_output_" class="toc"><code>output?</code></h1> + <h3 id="m_output_" class="toc"><code>output?</code></h1> </header> <p>Evaluates to true if Glyph is generating output in the specified format(s).</p>

@@ -928,7 +928,7 @@

<section class="section"> <header> - <h1 id="h_194" class="notoc">Parameters</h1> + <h3 id="h_194" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -949,7 +949,7 @@

<section class="section"> <header> - <h1 id="m_or" class="toc"><code>or</code></h1> + <h3 id="m_or" class="toc"><code>or</code></h1> </header> <p>Conditional <code>or</code> operator, to be used with the <a href="#m_condition"><code>condition</code></a> macro.</p>

@@ -960,7 +960,7 @@

<section class="section"> <header> - <h1 id="h_196" class="notoc">Parameters</h1> + <h3 id="h_196" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -986,7 +986,7 @@

<section class="section"> <header> - <h1 id="m_define_" class="toc"><code>define:</code></h1> + <h3 id="m_define_" class="toc"><code>define:</code></h1> </header> <p>Defines a new macro in Glyph code (for more information, see <a href="/glyph/book/extending/interpreting.html#rewriting">Defining macros using Glyph</a>)</p>

@@ -995,7 +995,7 @@

<section class="section"> <header> - <h1 id="h_198" class="notoc">Example</h1> + <h3 id="h_198" class="notoc">Example</h1> </header> <div class="CodeRay"> <div class="code">

@@ -1017,7 +1017,7 @@

<section class="section"> <header> - <h1 id="h_199" class="notoc">Parameters</h1> + <h3 id="h_199" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -1041,7 +1041,7 @@

<section class="section"> <header> - <h1 id="h_200" class="notoc">Remarks</h1> + <h3 id="h_200" class="notoc">Remarks</h1> </header> <ul> <li>The new macro can only be used <em>after</em> its declaration.</li>

@@ -1059,7 +1059,7 @@

<section class="section"> <header> - <h1 id="m_ruby" class="toc"><code>ruby</code></h1> + <h3 id="m_ruby" class="toc"><code>ruby</code></h1> </header> <p>Evaluates its value as Ruby code within the context of the <a href="http://rubydoc.info/gems/glyph/Glyph">Glyph</a> module.</p>

@@ -1073,7 +1073,7 @@ </examples>

<section class="section"> <header> - <h1 id="h_202" class="notoc">Parameters</h1> + <h3 id="h_202" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -1091,7 +1091,7 @@

<section class="section"> <header> - <h1 id="h_203" class="notoc">Remarks</h1> + <h3 id="h_203" class="notoc">Remarks</h1> </header> <p>This macro cannot be used in <a href="/glyph/book/compiling/programmatic_usage.html#modes">safe mode</a>.</p>

@@ -1103,7 +1103,7 @@

<section class="section"> <header> - <h1 id="m_s" class="toc"><code>s</code></h1> + <h3 id="m_s" class="toc"><code>s</code></h1> </header> <p>Can be used to dispatch almost any instance method of the ruby <a href="http://rubydoc.info/stdlib/core/1.9.2/String">String</a> class.</p>

@@ -1121,7 +1121,7 @@

<section class="section"> <header> - <h1 id="m_snippet" class="toc"><code>snippet</code></h1> + <h3 id="m_snippet" class="toc"><code>snippet</code></h1> </header> <p>Returns the value of a snippet.</p> <strong>Aliases:</strong> <code>&amp;</code>

@@ -1131,7 +1131,7 @@

<section class="section"> <header> - <h1 id="h_206" class="notoc">Parameters</h1> + <h3 id="h_206" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -1152,7 +1152,7 @@

<section class="section"> <header> - <h1 id="m_snippet_" class="toc"><code>snippet:</code></h1> + <h3 id="m_snippet_" class="toc"><code>snippet:</code></h1> </header> <p>Defines a snippet.</p> <strong>Aliases:</strong> <code>&amp;:</code>

@@ -1162,7 +1162,7 @@

<section class="section"> <header> - <h1 id="h_208" class="notoc">Parameters</h1> + <h3 id="h_208" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -1186,7 +1186,7 @@

<section class="section"> <header> - <h1 id="h_209" class="notoc">Remarks</h1> + <h3 id="h_209" class="notoc">Remarks</h1> </header> <p>The new snippet can only be used <em>after</em> its declaration.</p>

@@ -1198,7 +1198,7 @@

<section class="section"> <header> - <h1 id="m_subtract" class="toc"><code>subtract</code></h1> + <h3 id="m_subtract" class="toc"><code>subtract</code></h1> </header> <p>Subtracts two or more integers together.</p>

@@ -1210,7 +1210,7 @@

<section class="section"> <header> - <h1 id="m_xml" class="toc"><code>xml</code></h1> + <h3 id="m_xml" class="toc"><code>xml</code></h1> </header> <p>When used composed with another macro, it can be used to render arbitrary raw <span class="caps">XML</span> tags. </p>

@@ -1223,7 +1223,7 @@

<section class="section"> <header> - <h1 id="m_while" class="toc"><code>while</code></h1> + <h3 id="m_while" class="toc"><code>while</code></h1> </header> <p>Keeps evaluating the second parameter while a condition is satisfied.</p>

@@ -1231,7 +1231,7 @@

<section class="section"> <header> - <h1 id="h_213" class="notoc">Example</h1> + <h3 id="h_213" class="notoc">Example</h1> </header> <div class="CodeRay"> <div class="code">

@@ -1253,7 +1253,7 @@

<section class="section"> <header> - <h1 id="h_214" class="notoc">Parameters</h1> + <h3 id="h_214" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>
M contents/glyph/book/macros/macros_filters.htmlcontents/glyph/book/macros/macros_filters.html

@@ -9,7 +9,7 @@

<section class="section"> <header> - <h1 id="m_markdown" class="toc"><code>markdown</code></h1> + <h3 id="m_markdown" class="toc"><code>markdown</code></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

@@ -27,7 +27,7 @@

<section class="section"> <header> - <h1 id="h_252" class="notoc">Parameters</h1> + <h3 id="h_252" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -49,7 +49,7 @@

<section class="section"> <header> - <h1 id="m_markdown_section" class="toc"><code>markdown_section</code></h1> + <h3 id="m_markdown_section" class="toc"><code>markdown_section</code></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>

@@ -58,7 +58,7 @@

<section class="section"> <header> - <h1 id="h_254" class="notoc">Example</h1> + <h3 id="h_254" class="notoc">Example</h1> </header> <div class="CodeRay"> <div class="code">

@@ -76,7 +76,7 @@

<section class="section"> <header> - <h1 id="h_255" class="notoc">Parameters</h1> + <h3 id="h_255" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -94,7 +94,7 @@

<section class="section"> <header> - <h1 id="h_256" class="notoc">Attributes</h1> + <h3 id="h_256" class="notoc">Attributes</h1> </header> <table style="width:100%;"> <tr>

@@ -127,7 +127,7 @@

<section class="section"> <header> - <h1 id="m_textile" class="toc"><code>textile</code></h1> + <h3 id="m_textile" class="toc"><code>textile</code></h1> </header> <p>Uses the RedCloth gem to transform the value into <span class="caps">HTML</span> or LaTeX, depending on the value of the <a href="/glyph/book/config/output.html#cfg_output"><code>output.*.filter_target</code></a>.</p>

@@ -143,7 +143,7 @@

<section class="section"> <header> - <h1 id="h_258" class="notoc">Parameters</h1> + <h3 id="h_258" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -165,7 +165,7 @@

<section class="section"> <header> - <h1 id="m_textile_section" class="toc"><code>textile_section</code></h1> + <h3 id="m_textile_section" class="toc"><code>textile_section</code></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>

@@ -174,7 +174,7 @@

<section class="section"> <header> - <h1 id="h_260" class="notoc">Example</h1> + <h3 id="h_260" class="notoc">Example</h1> </header> <div class="CodeRay"> <div class="code">

@@ -192,7 +192,7 @@

<section class="section"> <header> - <h1 id="h_261" class="notoc">Parameters</h1> + <h3 id="h_261" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -210,7 +210,7 @@

<section class="section"> <header> - <h1 id="h_262" class="notoc">Attributes</h1> + <h3 id="h_262" class="notoc">Attributes</h1> </header> <table style="width:100%;"> <tr>

@@ -243,7 +243,7 @@

<section class="section"> <header> - <h1 id="m_highlight" class="toc"><code>highlight</code></h1> + <h3 id="m_highlight" class="toc"><code>highlight</code></h1> </header> <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

@@ -253,7 +253,7 @@

<section class="section"> <header> - <h1 id="h_264" class="notoc">Example</h1> + <h3 id="h_264" class="notoc">Example</h1> </header> <div class="CodeRay"> <div class="code">

@@ -271,7 +271,7 @@

<section class="section"> <header> - <h1 id="h_265" class="notoc">Parameters</h1> + <h3 id="h_265" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>
M contents/glyph/book/macros/macros_inline.htmlcontents/glyph/book/macros/macros_inline.html

@@ -8,7 +8,7 @@ →</a></nav>

<section class="section"> <header> - <h1 id="m_anchor" class="toc"><code>anchor</code></h1> + <h3 id="m_anchor" class="toc"><code>anchor</code></h1> </header> <p>Creates a named anchor (or bookmark).</p> <strong>Aliases:</strong> <code>bookmark, #</code>

@@ -18,7 +18,7 @@

<section class="section"> <header> - <h1 id="h_242" class="notoc">Parameters</h1> + <h3 id="h_242" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -45,7 +45,7 @@

<section class="section"> <header> - <h1 id="m_draftcomment" class="toc"><code>draftcomment</code></h1> + <h3 id="m_draftcomment" class="toc"><code>draftcomment</code></h1> </header> <p>If the <a href="/glyph/book/config/document.html#s_document_draft"><code>document.draft</code></a> setting is set to <code>true</code>, displays a draft comment within the document.</p>

@@ -56,7 +56,7 @@

<section class="section"> <header> - <h1 id="h_244" class="notoc">Parameters</h1> + <h3 id="h_244" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -77,7 +77,7 @@

<section class="section"> <header> - <h1 id="m_fmi" class="toc"><code>fmi</code></h1> + <h3 id="m_fmi" class="toc"><code>fmi</code></h1> </header> <p>Creates a <em>For More Information</em> link (for an example usage, see the <a href="#m_link"><code>link</code></a> macro).</p>

@@ -88,7 +88,7 @@

<section class="section"> <header> - <h1 id="h_246" class="notoc">Parameters</h1> + <h3 id="h_246" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -115,7 +115,7 @@

<section class="section"> <header> - <h1 id="m_link" class="toc"><code>link</code></h1> + <h3 id="m_link" class="toc"><code>link</code></h1> </header> <p>Creates an hyperlink (<span class="fmi">for more information on <mark>creating links</mark>, see <a href="/glyph/book/text_editing/links.html#links">Links and Bookmarks</a></span>).</p>

@@ -126,7 +126,7 @@

<section class="section"> <header> - <h1 id="h_248" class="notoc">Parameters</h1> + <h3 id="h_248" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -153,7 +153,7 @@

<section class="section"> <header> - <h1 id="m_todo" class="toc"><code>todo</code></h1> + <h3 id="m_todo" class="toc"><code>todo</code></h1> </header> <p>Saves the value as a <span class="caps">TODO</span> item, which can be printed using the <a href="/glyph/book/ref_commands.html#c_todo"><code>todo</code></a> command and included in the document if
M contents/glyph/book/macros/macros_structure.htmlcontents/glyph/book/macros/macros_structure.html

@@ -8,7 +8,7 @@ →</a></nav>

<section class="section"> <header> - <h1 id="m_article" class="toc"><code>article</code></h1> + <h3 id="m_article" class="toc"><code>article</code></h1> </header> <p>Used to create a simple article. By default, it includes the following macros:</p> <ul>

@@ -41,7 +41,7 @@

<section class="section"> <header> - <h1 id="h_268" class="notoc">Parameters</h1> + <h3 id="h_268" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -59,7 +59,7 @@

<section class="section"> <header> - <h1 id="h_269" class="notoc">Attributes</h1> + <h3 id="h_269" class="notoc">Attributes</h1> </header> <table style="width:100%;"> <tr>

@@ -106,7 +106,7 @@

<section class="section"> <header> - <h1 id="m_book" class="toc"><code>book</code></h1> + <h3 id="m_book" class="toc"><code>book</code></h1> </header> <p>Used to create a book. By default, it includes the following macros:</p> <ul>

@@ -140,7 +140,7 @@

<section class="section"> <header> - <h1 id="h_271" class="notoc">Parameters</h1> + <h3 id="h_271" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -158,7 +158,7 @@

<section class="section"> <header> - <h1 id="h_272" class="notoc">Attributes</h1> + <h3 id="h_272" class="notoc">Attributes</h1> </header> <table style="width:100%;"> <tr>

@@ -223,7 +223,7 @@

<section class="section"> <header> - <h1 id="m_document" class="toc"><code>document</code></h1> + <h3 id="m_document" class="toc"><code>document</code></h1> </header> <p>Creates an <code>&lt;html&gt;</code> tag and a <span class="caps">DOCTYPE</span> declaration. Called internally by the <a href="#m_book"><code>book</code></a> macro and the <a href="#m_article"><code>article</code></a>

@@ -235,7 +235,7 @@

<section class="section"> <header> - <h1 id="h_274" class="notoc">Parameters</h1> + <h3 id="h_274" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -256,7 +256,7 @@

<section class="section"> <header> - <h1 id="m_head" class="toc"><code>head</code></h1> + <h3 id="m_head" class="toc"><code>head</code></h1> </header> <p>Creates a <code>&lt;head&gt;</code> tag, pre-populated with <code>title</code> and author/copyright <code>&lt;meta&gt;</code> tags.</p>

@@ -267,7 +267,7 @@

<section class="section"> <header> - <h1 id="h_276" class="notoc">Parameters</h1> + <h3 id="h_276" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -288,7 +288,7 @@

<section class="section"> <header> - <h1 id="m_section" class="toc"><code>section</code></h1> + <h3 id="m_section" class="toc"><code>section</code></h1> </header> <p>Creates a section (<code>&lt;div&gt;</code> or <code>&lt;section&gt;</code> tag).</p> <strong>Aliases:</strong>

@@ -297,7 +297,7 @@

<section class="section"> <header> - <h1 id="h_278" class="notoc">Example</h1> + <h3 id="h_278" class="notoc">Example</h1> </header> <div class="CodeRay"> <div class="code">

@@ -315,7 +315,7 @@

<section class="section"> <header> - <h1 id="h_279" class="notoc">Parameters</h1> + <h3 id="h_279" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -333,7 +333,7 @@

<section class="section"> <header> - <h1 id="h_280" class="notoc">Attributes</h1> + <h3 id="h_280" class="notoc">Attributes</h1> </header> <table style="width:100%;"> <tr>

@@ -366,7 +366,7 @@

<section class="section"> <header> - <h1 id="m_style" class="toc"><code>style</code></h1> + <h3 id="m_style" class="toc"><code>style</code></h1> </header> <p>Embeds the content of a <span class="caps">CSS</span> or Sass file within a <code>&lt;style&gt;</code> tag (<span class="fmi">for more information on <mark>stylesheets</mark>, see <a

@@ -378,7 +378,7 @@

<section class="section"> <header> - <h1 id="h_282" class="notoc">Parameters</h1> + <h3 id="h_282" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -399,7 +399,7 @@

<section class="section"> <header> - <h1 id="m_toc" class="toc"><code>toc</code></h1> + <h3 id="m_toc" class="toc"><code>toc</code></h1> </header> <p>Generates a <em>Table of Contents</em> based on how sections are nested in the current document.</p>

@@ -409,7 +409,7 @@

<section class="section"> <header> - <h1 id="h_284" class="notoc">Parameters</h1> + <h3 id="h_284" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>
M contents/glyph/book/ref_commands.htmlcontents/glyph/book/ref_commands.html

@@ -17,11 +17,11 @@ <li><em>parameters</em> are separated by whitespaces, and can be wrapped in quotes.</li>

</ul> <section class="section"> <header> - <h1 id="h_115" class="toc">Global Options</h1> + <h3 id="h_115" class="toc">Global Options</h1> </header> <section class="section"> <header> - <h1 id="debug_switch" class="toc"><code>-d</code>, <code>--debug</code></h1> + <h3 id="debug_switch" class="toc"><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>

@@ -29,7 +29,7 @@

</section> <section class="section"> <header> - <h1 id="help_switch" class="toc"><code>-h</code>, <code>--help</code></h1> + <h3 id="help_switch" class="toc"><code>-h</code>, <code>--help</code></h1> </header> <p>Displays help on the program.</p>

@@ -38,14 +38,14 @@

</section> <section class="section"> <header> - <h1 id="c_add" class="toc"><code>add</code></h1> + <h3 id="c_add" class="toc"><code>add</code></h1> </header> <p>Creates a new text file in the <code>text/</code> folder.</p> <p><strong>Example:</strong> <code>glyph add introduction.textile</code></p> <section class="section"> <header> - <h1 id="h_119" class="notoc">Parameters</h1> + <h3 id="h_119" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -63,7 +63,7 @@

</section> <section class="section"> <header> - <h1 id="c_compile" class="toc"><code>compile</code></h1> + <h3 id="c_compile" class="toc"><code>compile</code></h1> </header> <p>Compiles a Glyph document into an output file. If no options are specified, the <code>document.glyph</code> file is used as source to produce a standalone HTML file.</p>

@@ -71,7 +71,7 @@ <p><strong>Example:</strong> <code>glyph compile -f pdf</code></p>

<section class="section"> <header> - <h1 id="h_121" class="notoc">Parameters</h1> + <h3 id="h_121" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -95,7 +95,7 @@

<section class="section"> <header> - <h1 id="h_122" class="notoc">Options</h1> + <h3 id="h_122" class="notoc">Options</h1> </header> <table style="width:100%;"> <tr>

@@ -136,14 +136,14 @@

</section> <section class="section"> <header> - <h1 id="c_config" class="toc"><code>config</code></h1> + <h3 id="c_config" class="toc"><code>config</code></h1> </header> Gets or sets a configuration setting in the project or global configuration file (<span class="fmi">for more information on <mark>configuration files</mark>, see <a href="/glyph/book/getting_started/configuration.html#cfg">Project Configuration</a></span>). <section class="section"> <header> - <h1 id="h_124" class="notoc">Examples</h1> + <h3 id="h_124" class="notoc">Examples</h1> </header> <p> <code>glyph config document.filename</code>

@@ -156,7 +156,7 @@ </section>

<section class="section"> <header> - <h1 id="h_125" class="notoc">Options</h1> + <h3 id="h_125" class="notoc">Options</h1> </header> <table style="width:100%;"> <tr>

@@ -177,7 +177,7 @@

<section class="section"> <header> - <h1 id="h_126" class="notoc">Parameters</h1> + <h3 id="h_126" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -202,12 +202,12 @@

</section> <section class="section"> <header> - <h1 id="c_help" class="toc"><code>help</code></h1> + <h3 id="c_help" class="toc"><code>help</code></h1> </header> Prints information about all Glyph commands or about one specific command. <section class="section"> <header> - <h1 id="h_128" class="notoc">Examples</h1> + <h3 id="h_128" class="notoc">Examples</h1> </header> <p> <code>glyph help</code>

@@ -220,7 +220,7 @@ </section>

<section class="section"> <header> - <h1 id="h_129" class="notoc">Parameters</h1> + <h3 id="h_129" class="notoc">Parameters</h1> </header> <table style="width:100%;"> <tr>

@@ -238,7 +238,7 @@

</section> <section class="section"> <header> - <h1 id="c_init" class="toc"><code>init</code></h1> + <h3 id="c_init" class="toc"><code>init</code></h1> </header> Creates a new Glyph project in the current directory (if empty). <p><strong>Example:</strong> <code>glyph init</code></p>

@@ -246,13 +246,13 @@

</section> <section class="section"> <header> - <h1 id="c_outline" class="toc"><code>outline</code></h1> + <h3 id="c_outline" class="toc"><code>outline</code></h1> </header> Display an outline of the current document. <section class="section"> <header> - <h1 id="h_132" class="notoc">Options</h1> + <h3 id="h_132" class="notoc">Options</h1> </header> <table style="width:100%;"> <tr>

@@ -295,7 +295,7 @@ </section>

<section class="section"> <header> - <h1 id="h_133" class="notoc">Examples</h1> + <h3 id="h_133" class="notoc">Examples</h1> </header> <p> <code>glyph outline -it -l 1</code>

@@ -312,13 +312,13 @@

</section> <section class="section"> <header> - <h1 id="c_stats" class="toc"><code>stats</code></h1> + <h3 id="c_stats" class="toc"><code>stats</code></h1> </header> <p>Displays project statistics (<span class="fmi">for more information on <mark>this command</mark>, see <a href="/glyph/book/config/document.html#stats">Document Statistics</a></span>).</p> <section class="section"> <header> - <h1 id="h_135" class="notoc">Examples</h1> + <h3 id="h_135" class="notoc">Examples</h1> </header> <p> <code>glyph stats -m</code>

@@ -331,7 +331,7 @@ </section>

<section class="section"> <header> - <h1 id="h_136" class="notoc">Options</h1> + <h3 id="h_136" class="notoc">Options</h1> </header> <table style="width:100%;"> <tr>

@@ -419,7 +419,7 @@

</section> <section class="section"> <header> - <h1 id="c_todo" class="toc"><code>todo</code></h1> + <h3 id="c_todo" class="toc"><code>todo</code></h1> </header> Prints all the todo items saved using the <a href="/glyph/book/macros/macros_inline.html#m_todo"><code>todo</code></a> macro.
M contents/glyph/book/stats/bookmarks.htmlcontents/glyph/book/stats/bookmarks.html

@@ -7,7 +7,7 @@ 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_72" class="toc">Displaying stats about all bookmarks</h1> + <h3 id="h_72" class="toc">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>

@@ -41,7 +41,7 @@ </div>

<section class="section"> <header> - <h1 id="h_73" class="toc">Remarks</h1> + <h3 id="h_73" class="toc">Remarks</h1> </header> <ul> <li>All the automatically-generated bookmarks (like headers, starting with <code>h_</code>) are included as well.

@@ -54,7 +54,7 @@ </section>

<section class="section"> <header> - <h1 id="h_74" class="toc">Displaying stats about a single bookmark</h1> + <h3 id="h_74" class="toc">Displaying stats about a single bookmark</h1> </header> <p>To display statistics about a single bookmark (e.g. <code>rubydoc</code>), execute <code>glyph stats --bookmark=c_config</code>. Glyph displays something like this:</p>

@@ -71,7 +71,7 @@ </div>

<section class="section"> <header> - <h1 id="h_75" class="toc">Remarks</h1> + <h3 id="h_75" class="toc">Remarks</h1> </header> <ul> <li>Do not prepend the bookmark ID with <code>#</code>.</li>
M contents/glyph/book/stats/links.htmlcontents/glyph/book/stats/links.html

@@ -8,7 +8,7 @@ internals →</a></nav>

<section class="section"> <header> - <h1 id="h_77" class="toc">Displaying stats about all links</h1> + <h3 id="h_77" class="toc">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>

@@ -51,7 +51,7 @@ </div>

<section class="section"> <header> - <h1 id="h_78" class="toc">Remarks</h1> + <h3 id="h_78" class="toc">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.

@@ -64,7 +64,7 @@ </section>

<section class="section"> <header> - <h1 id="h_79" class="toc">Displaying stats about links matching a regular expression</h1> + <h3 id="h_79" class="toc">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>

@@ -113,7 +113,7 @@ </div>

<section class="section"> <header> - <h1 id="h_80" class="toc">Remarks</h1> + <h3 id="h_80" class="toc">Remarks</h1> </header> <ul> <li>No distinction between external and internal targets is made.</li>
M contents/glyph/book/stats/macros.htmlcontents/glyph/book/stats/macros.html

@@ -8,7 +8,7 @@ </nav>

<section class="section"> <header> - <h1 id="h_62" class="toc">Displaying stats about all macros</h1> + <h3 id="h_62" class="toc">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>

@@ -52,7 +52,7 @@ </div>

<section class="section"> <header> - <h1 id="h_63" class="toc">Remarks</h1> + <h3 id="h_63" class="toc">Remarks</h1> </header> <ul> <li>Only macro <em>definitions</em> (not their <em>aliases</em>) are displayed, both default and user-defined.

@@ -69,7 +69,7 @@ </section>

<section class="section"> <header> - <h1 id="h_64" class="toc">Displaying stats about a single macro</h1> + <h3 id="h_64" class="toc">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>

@@ -96,7 +96,7 @@ </div>

<section class="section"> <header> - <h1 id="h_65" class="toc">Remarks</h1> + <h3 id="h_65" class="toc">Remarks</h1> </header> <ul> <li>All the instances of the specified macro definition <em>and all its aliases</em> are collected, regardless
M contents/glyph/book/stats/snippets.htmlcontents/glyph/book/stats/snippets.html

@@ -8,7 +8,7 @@ </nav>

<section class="section"> <header> - <h1 id="h_67" class="toc">Displaying stats about all snippets</h1> + <h3 id="h_67" class="toc">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>

@@ -35,7 +35,7 @@ </div>

<section class="section"> <header> - <h1 id="h_68" class="toc">Remarks</h1> + <h3 id="h_68" class="toc">Remarks</h1> </header> <ul> <li>Information on snippet usage and definitions is available only when displaying statistics for a single

@@ -48,7 +48,7 @@ </section>

<section class="section"> <header> - <h1 id="h_69" class="toc">Displaying stats about a single snippet</h1> + <h3 id="h_69" class="toc">Displaying stats about a single snippet</h1> </header> <p>To display statistics about a single snippet (e.g. <code>rubydoc</code>), execute <code>glyph stats --snippet=rubydoc</code>. Glyph displays something like this:</p>

@@ -73,7 +73,7 @@ </div>

<section class="section"> <header> - <h1 id="h_70" class="toc">Remarks</h1> + <h3 id="h_70" class="toc">Remarks</h1> </header> <ul> <li>Nested snippets appear as within the file containing the top-level snippet.</li>
M contents/glyph/book/text_editing/conditionals.htmlcontents/glyph/book/text_editing/conditionals.html

@@ -53,7 +53,7 @@ <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_42" class="toc">Results of conditional expressions</h1> + <h3 id="h_42" class="toc">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
M contents/glyph/book/text_editing/evaluation.htmlcontents/glyph/book/text_editing/evaluation.html

@@ -7,7 +7,7 @@ href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/compiling/compiling.html">Compiling a project

→</a></nav> <section class="section"> <header> - <h1 id="h_44" class="toc">Turing-completeness</h1> + <h3 id="h_44" class="toc">Turing-completeness</h1> </header> <p>As of version 0.5.0, Glyph can be considered <em>Turing-complete</em>, as it satisfies the following <a href="http://c2.com/cgi/wiki?LanguageRequirementsForTuringCompleteness">requirements for Turing-completeness</a>:

@@ -29,7 +29,7 @@ </section>

<section class="section"> <header> - <h1 id="h_45" class="toc">Operations on integer values</h1> + <h3 id="h_45" class="toc">Operations on integer values</h1> </header> <p>Glyph can be used to perform operation on integer values (additions, subtractions and multiplications). For example, <code>add[2|3|7]</code> will evaluate to @12@, and <code>multiply[add[3|7]|subtract[5|1|2]]</code> will

@@ -57,7 +57,7 @@

</section> <section class="section"> <header> - <h1 id="h_46" class="toc">Lexically-scoped attribute assignment</h1> + <h3 id="h_46" class="toc">Lexically-scoped attribute assignment</h1> </header> <p><a href="/glyph/book/text_editing/inclusions.html#snippets">Snippets</a> can be used in a similar way as <em>variables</em> are used in programming languages. Or better, they can be used as <em>global variables</em>, as

@@ -91,7 +91,7 @@ attributes! Feel free to use the <a href="/glyph/book/macros/macros_core.html#m_attribute"><code>attribute</code></a>

macro to access standard attributes like <code>title</code>, etc.</p> <section class="section"> <header> - <h1 id="h_47" class="toc">Evaluating Ruby code</h1> + <h3 id="h_47" class="toc">Evaluating Ruby code</h1> </header> <p>For anything more complex than what described in the previous sections you can also evaluate simple ruby code snippets using the <code>ruby</code> macro (aliased to <code>%</code>), like this:</p>
M contents/glyph/book/text_editing/inclusions.htmlcontents/glyph/book/text_editing/inclusions.html

@@ -7,7 +7,7 @@ href="/glyph/book/index.html">Contents</a> | <a href="/glyph/book/text_editing/conditionals.html">Conditional Macros

→</a></nav> <section class="section"> <header> - <h1 id="file-inclusions" class="toc">File inclusions</h1> + <h3 id="file-inclusions" class="toc">File inclusions</h1> </header> <p>If you&#8217;re authoring a user manual, a long article, or a book, writing everything inside a single <code>document.glyph</code> file may not be optimal. For this reason, Glyph provides an <a

@@ -28,7 +28,7 @@ <p>You can override this behavior by setting the <code>filters.by_file_extensions</code> configuration setting to

<code>false</code>. If no extension is specified, <code>.glyph</code> is assumed.</p> <section class="section"> <header> - <h1 id="h_39" class="toc">Remarks</h1> + <h3 id="h_39" class="toc">Remarks</h1> </header> <ul> <li>The <a href="/glyph/book/macros/macros_core.html#m_include"><code>include</code></a> macro can also be used to

@@ -43,7 +43,7 @@

</section> <section class="section"> <header> - <h1 id="snippets" class="toc">Snippets</h1> + <h3 id="snippets" class="toc">Snippets</h1> </header> <p>While including the context of an entire file is definitely a useful feature for content reuse, sometimes it can be an overkill. What if, for example, you just want to reuse a short procedure or even a sentence or a single word? In
M contents/glyph/book/text_editing/sections.htmlcontents/glyph/book/text_editing/sections.html

@@ -51,7 +51,7 @@ <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_25" class="toc">Markup-aware sections</h1> + <h3 id="h_25" class="toc">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,
M contents/glyph/book/text_editing/stylesheets.htmlcontents/glyph/book/text_editing/stylesheets.html

@@ -27,7 +27,7 @@

</aside> <section class="section"> <header> - <h1 id="default_stylesheets" class="toc">Default Stylesheets</h1> + <h3 id="default_stylesheets" class="toc">Default Stylesheets</h1> </header> <p>Glyph provides the following default stylesheets, that can be referenced directly using the <a href="/glyph/book/macros/macros_structure.html#m_style"><code>style</code></a> macro:</p>
M contents/glyph/book/text_editing/xml_fallback.htmlcontents/glyph/book/text_editing/xml_fallback.html

@@ -94,7 +94,7 @@ tag with the <a href="/glyph/book/macros/macros_core.html#m_xml"><code>xml</code></a> macro, so for example

<code>xml/snippet[test]</code> will be converted into <code>&lt;snippet&gt;test&lt;/snippet&gt;</code>.</p> <section class="section"> <header> - <h1 id="xml_blacklist" class="toc">Blacklisted XML tags</h1> + <h3 id="xml_blacklist" class="toc">Blacklisted XML tags</h1> </header> <p>By default, the following tags are blacklisted and will be ignored:</p> <ul>