Line Numbers: Improved documentation (#2456)
diff --git a/plugins/line-numbers/index.html b/plugins/line-numbers/index.html
index 6b81b43..0fcb2af 100644
--- a/plugins/line-numbers/index.html
+++ b/plugins/line-numbers/index.html
@@ -22,7 +22,25 @@
<h1>How to use</h1>
<p>Obviously, this is supposed to work only for code blocks (<code><pre><code></code>) and not for inline code.</p>
- <p>Add the <code>line-numbers</code> class to your desired <code><pre></code> or any of its ancestors, and the line-numbers plugin will take care of the rest. To give all code blocks line numbers, add the <code>line-numbers</code> class to the <code><body></code> of the page.</p>
+ <p>Add the <code>line-numbers</code> class to your desired <code><pre></code> or any of its ancestors, and the Line Numbers plugin will take care of the rest. To give all code blocks line numbers, add the <code>line-numbers</code> class to the <code><body></code> of the page. This is part of a general activation mechanism where adding the <code>line-numbers</code> (or <code>no-line-numbers</code>) class to any element will enable (or disable) the Line Numbers plugin for all code blocks in that element. <br> Example:</p>
+
+ <pre><code><body class="line-number"> <!-- enabled for the whole page -->
+
+ <!-- with line numbers -->
+ <pre><code>...</code></pre>
+ <!-- disabled for a specific element - without line numbers -->
+ <pre class="no-line-numbers"><code>...</code></pre>
+
+ <div class="no-line-numbers"> <!-- disabled for this subtree -->
+
+ <!-- without line numbers -->
+ <pre><code>...</code></pre>
+ <!-- enabled for a specific element - with line numbers -->
+ <pre class="line-number"><code>...</code></pre>
+
+ </div>
+</body></code></pre>
+
<p>Optional: You can specify the <code>data-start</code> (Number) attribute on the <code><pre></code> element. It will shift the line counter.</p>
<p>Optional: To support multiline line numbers using soft wrap, apply the CSS <code>white-space: pre-line;</code> or <code>white-space: pre-wrap;</code> to your desired <code><pre></code>.</p>
</section>