ref: 5b19a26556cc7a533b0e2559e5f1740b892a2f53
parent: 0b7229f7b2a4fbc3537404802cae4c66cedb526c
author: Anthony Fok <[email protected]>
date: Wed Aug 5 12:24:03 EDT 2015
docs: Extend documentation on Blackfriday options Especially to spell out how the `latexDashes` flag changes the behavior of smart dashes
--- a/docs/content/overview/configuration.md
+++ b/docs/content/overview/configuration.md
@@ -32,7 +32,8 @@
baseurl: "http://yoursite.example.com/"
...
-The following is an example of a toml config file with some of the default values. Values under `[params]` will populate the `.Site.Params` variable for use in templates:
+The following is an example of a toml config file with some of the default values.
+Values under `[params]` will populate the `.Site.Params` variable for use in templates:
contentdir = "content"
layoutdir = "layouts"
@@ -49,7 +50,7 @@
description = "Tesla's Awesome Hugo Site"
author = "Nikola Tesla"
-Here is a yaml configuration file which sets a few more options
+Here is a yaml configuration file which sets a few more options:
---
baseurl: "http://yoursite.example.com/"
@@ -172,7 +173,8 @@
</tr>
<tr>
<td class="purpose-title">Purpose:</td>
-<td class="purpose-description" colspan="2">Enable enable smart punctuation substitutions.</td>
+<td class="purpose-description" colspan="2">Enable/Disable smart punctuation substitutions such as smart quotes, smart dashes, etc.
+May be fine-tuned with the <code>angledQuotes</code>, <code>fractions</code> and <code>latexDashes</code> flags below.</td>
</tr>
<tr>
@@ -182,7 +184,8 @@
</tr>
<tr>
<td class="purpose-title">Purpose:</td>
-<td class="purpose-description" colspan="2">Enable smart angled double quotes <small>(e.g. <code>"Hugo"</code> renders to «Hugo» instead of “Hugo”)</small></td>
+<td class="purpose-description" colspan="2">Enable/Disable smart angled double quotes.<br>
+<small><strong>Example:</strong> <code>"Hugo"</code> renders to «Hugo» instead of “Hugo”.</small></td>
</tr>
<tr>
@@ -192,8 +195,8 @@
</tr>
<tr>
<td class="purpose-title">Purpose:</td>
-<td class="purpose-description" colspan="2">Enable smart fractions
-<small>(e.g. <code>5/12</code> renders to <sup>5</sup>⁄<sub>12</sub> (<code><sup>5</sup>&frasl;<sub>12</sub></code>))<br>
+<td class="purpose-description" colspan="2">Enable/Disable smart fractions.<br>
+<small><strong>Example:</strong> <code>5/12</code> renders to <sup>5</sup>⁄<sub>12</sub> (<code><sup>5</sup>&frasl;<sub>12</sub></code>)<br>
<strong>Caveat:</strong> Even with <code>fractions = false</code>,
Blackfriday would still convert 1/2, 1/4 and 3/4 to ½ (<code>&frac12;</code>),
¼ (<code>&frac14;</code>) and ¾ (<code>&frac34;</code>) respectively,
@@ -207,10 +210,12 @@
</tr>
<tr>
<td class="purpose-title">Purpose:</td>
-<td class="purpose-description" colspan="2">Disable LaTeX style dashes.</small></td>
+<td class="purpose-description" colspan="2">Choose between LaTeX-style smart dashes and “conventional” smart dashes.<br>
+<strong>If <code>true</code>,</strong> <code>--</code> is translated into “–” (<code>&ndash;</code>), and <code>---</code> is translated into “—” (<code>&mdash;</code>).<br>
+<strong>If <code>false</code>,</strong> <code>--</code> is translated into “—” (<code>&mdash;</code>), whereas a <em>spaced</em> single hyphen between two words is turned into an en dash, e.g. <code>12 June - 3 July</code> becomes <code>12 June &ndash; 3 July</code>.</td>
</tr>
-<tr style="height: 0.3em;"></tr>
+<tr style="height: 0.5em;"></tr>
<tr>
<td><code><strong>hrefTargetBlank</strong></code></td>
@@ -219,7 +224,7 @@
</tr>
<tr>
<td class="purpose-title">Purpose:</td>
-<td class="purpose-description" colspan="2">Open external links in a new window/tab.</small></td>
+<td class="purpose-description" colspan="2">Open external links in a new window/tab.</td>
</tr>
<tr>
@@ -229,10 +234,11 @@
</tr>
<tr>
<td class="purpose-title">Purpose:</td>
-<td class="purpose-description" colspan="2">If <code>true</code>, then header and footnote IDs are generated without the document ID <small>(e.g. <code>#my-header</code> instead of <code>#my-header:bec3ed8ba720b9073ab75abcf3ba5d97</code>)</small></td>
+<td class="purpose-description" colspan="2">If <code>true</code>, then header and footnote IDs are generated without the document ID.<br>
+<small><strong>Example:</strong> <code>#my-header</code> instead of <code>#my-header:bec3ed8ba720b9073ab75abcf3ba5d97</code>.</small></td>
</tr>
-<tr style="height: 0.3em;"></tr>
+<tr style="height: 0.5em;"></tr>
<tr>
<td><code><strong>extensions</strong></code></td>
@@ -241,7 +247,8 @@
</tr>
<tr>
<td class="purpose-title">Purpose:</td>
-<td class="purpose-description" colspan="2">Use non-default additional extensions <small>(e.g. Add <code>"hardLineBreak"</code> to use <code>EXTENSION_HARD_LINE_BREAK</code>)</small></td>
+<td class="purpose-description" colspan="2">Use non-default additional extensions.<br>
+<small><strong>Example:</strong> Add <code>"hardLineBreak"</code> to use <code>EXTENSION_HARD_LINE_BREAK</code>.</small></td>
</tr>
<tr>
@@ -251,7 +258,8 @@
</tr>
<tr>
<td class="purpose-title">Purpose:</td>
-<td class="purpose-description" colspan="2">Extensions in this option won't be loaded. <small>(e.g. Add <code>"autoHeaderIds"</code> to disable <code>EXTENSION_AUTO_HEADER_IDS</code>)</small></td>
+<td class="purpose-description" colspan="2">Extensions in this option won't be loaded.<br>
+<small><strong>Example:</strong> Add <code>"autoHeaderIds"</code> to disable <code>EXTENSION_AUTO_HEADER_IDS</code>.</small></td>
</tr>
</tbody>
</table>