markdown_helper 2.2.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '09204d578d4034b5940afc983b9d3989adff2d1b05763b0e6e867e3183b338c8'
-  data.tar.gz: a90232dc47c8d901f1fa1a5bed7964e0deee6fb3b3bd9d2713f46ea105b162b2
+  metadata.gz: 5f87e472a6df990e637dacc06c4e6bc7daffd512634c69c4202e3d9d6f96bc43
+  data.tar.gz: 414fe00be28329fef09722912fffe9bb9a5bb1ba998c69432d68908219a639e3
 SHA512:
-  metadata.gz: ad9d3e8cbf0a1fa17eba25579c02165571e5408ea979747600aa6db74b52122fd2157d61d6f2a65e7302eac52a443e40343d10d0c291eae7912d64ccd099ed6f
-  data.tar.gz: 4ee21575e5d049259b9c365ab9842d904127ebe8df9f023304bcb35c34242f3eb81edf37a055aee6cdce61283c635fb4d38bb4ffbfa7cdc54f6b7f8584fb8672
+  metadata.gz: b8a99c9e3a3b2ffa39abbf36fcf44a21650b19498849ed2d60e78e418792464c8efffe680c758c6f23b65bc95c4fdef67a97e894339a96d6196bc7c7d362851d
+  data.tar.gz: 861b07f382444226d6fcacf224e16da75e94a3822305592fbf9dba7b1d38f0686a0f890fc1914f33c8640c04f2bf3a3d39ecfd52014c39ae95b47d40ddc008b5

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    markdown_helper (2.2.0)
+    markdown_helper (2.3.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -5,7 +5,7 @@
 
 ## What's New?
 
-Command line creation of page TOC (table of contents), previously deprecated, is removed.
+Inclusion of text as details is added.  See the [use case](markdown/use_cases/include_files/include_text_as_details/use_case.md#include-text-as-details).
 
 ## Contents
 - [What's a Markdown Helper?](#whats-a-markdown-helper)
@@ -21,7 +21,8 @@ Command line creation of page TOC (table of contents), previously deprecated, is
     - [Highlighted Code Block](#highlighted-code-block)
     - [Plain Code Block](#plain-code-block)
     - [Comment](#comment)
-  - [Pre-Formattted Text](#pre-formattted-text)
+    - [Details](#details)
+  - [Pre-Formatted Text](#pre-formatted-text)
   - [Usage](#usage)
     - [CLI](#cli)
     - [API](#api)
@@ -100,7 +101,11 @@ You can also include a code block without highlighting.  See the [use case](mark
 
 You can include text that's to become a comment in the markdown.  See the [use case](markdown/use_cases/include_files/include_text_as_comment/use_case.md#include-text-as-comment).
 
-### Pre-Formattted Text
+#### Details
+
+You can include text that's to become details in the markdown.  See the [use case](markdown/use_cases/include_files/include_text_as_details/use_case.md#include-text-as-details).
+
+### Pre-Formatted Text
 
 You can include text that's pre-formatted.  See the [use case](markdown/use_cases/include_files/include_text_as_pre/use_case.md#include-text-as-pre).
 
@@ -159,8 +164,9 @@ where:
   * Highlighting mode such as <code>[ruby]</code>, to include a highlighted code block.  This can be any Ace mode mentioned in [GitHub Languages](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml).
   * <code>[:code_block]</code>, to include a plain code block.
   * <code>[:markdown]</code>, to include text markdown (to be rendered as markdown).
-  * <code>[:comment]</code>, to insert text as a markdown comment.
+  * <code>[:comment]</code>, to include text as a markdown comment.
   * <code>[:pre]</code>, to include pre-formatted text.
+  * <code>[:details]</code>, to include text as details.
 * *relative_file_path* points to the file to be included.
 
 ##### Example Include Descriptions

data/lib/markdown_helper/version.rb

@@ -1,3 +1,3 @@
 class MarkdownHelper
-  VERSION = '2.2.0'
+  VERSION = '2.3.0'
 end

data/lib/markdown_helper.rb

@@ -68,8 +68,9 @@ class MarkdownHelper
     Dir.chdir(File.dirname(template_file_path)) do
       markdown_lines = []
       unless File.readable?(template_file_path)
+        path_in_project = MarkdownHelper.path_in_project(template_file_path )
         message = [
-            'Could not read template file:',
+            "Could not read template file: #{path_in_project}",
             MarkdownHelper.backtrace_inclusions(@inclusions),
         ].join("\n")
         e = UnreadableTemplateError.new(message)
@@ -96,27 +97,31 @@ class MarkdownHelper
             includee_file_path,
             @inclusions
             )
-        treatment.sub!(/^:/, '')
         case treatment
-        when 'markdown'
+        when ':markdown'
           check_includee(inclusion)
           check_circularity(inclusion)
           @inclusions.push(inclusion)
           includee_lines = include_markdown(File.absolute_path(includee_file_path))
           markdown_lines.concat(includee_lines)
-        when 'comment'
+        when ':comment'
           text = File.read(includee_file_path)
           markdown_lines.push(MarkdownHelper.comment(text))
           @inclusions.push(inclusion)
-        when 'pre'
+        when ':pre'
           text = File.read(includee_file_path)
           markdown_lines.push(MarkdownHelper.pre(text))
           @inclusions.push(inclusion)
+        when ':details'
+          text = File.read(includee_file_path)
+          markdown_lines.push(MarkdownHelper.details(text))
+          @inclusions.push(inclusion)
         else
           markdown_lines.push(template_line)
           next
         end
         @inclusions.pop
+        treatment.sub!(/^:/, '')
         add_inclusion_comments(treatment, includee_file_path, markdown_lines)
       end
       markdown_lines
@@ -222,6 +227,10 @@ class MarkdownHelper
     "<pre>\n#{text}</pre>"
   end
 
+  def self.details(text)
+    "<details>\n#{text}</details>"
+  end
+
   def self.git_clone_dir_path
     git_dir = `git rev-parse --show-toplevel`.chomp
     unless $?.success?

data/markdown/readme/README.template.md

@@ -4,7 +4,7 @@
 
 ## What's New?
 
-Command line creation of page TOC (table of contents), previously deprecated, is removed.
+Inclusion of text as details is added.  See the [use case](markdown/use_cases/include_files/include_text_as_details/use_case.md#include-text-as-details).
 
 @[:page_toc](## Contents)
 
@@ -74,7 +74,11 @@ You can also include a code block without highlighting.  See the [use case](mark
 
 You can include text that's to become a comment in the markdown.  See the [use case](markdown/use_cases/include_files/include_text_as_comment/use_case.md#include-text-as-comment).
 
-### Pre-Formattted Text
+#### Details
+
+You can include text that's to become details in the markdown.  See the [use case](markdown/use_cases/include_files/include_text_as_details/use_case.md#include-text-as-details).
+
+### Pre-Formatted Text
 
 You can include text that's pre-formatted.  See the [use case](markdown/use_cases/include_files/include_text_as_pre/use_case.md#include-text-as-pre).
 
@@ -100,8 +104,9 @@ where:
   * Highlighting mode such as <code>[ruby]</code>, to include a highlighted code block.  This can be any Ace mode mentioned in [GitHub Languages](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml).
   * <code>[:code_block]</code>, to include a plain code block.
   * <code>[:markdown]</code>, to include text markdown (to be rendered as markdown).
-  * <code>[:comment]</code>, to insert text as a markdown comment.
+  * <code>[:comment]</code>, to include text as a markdown comment.
   * <code>[:pre]</code>, to include pre-formatted text.
+  * <code>[:details]</code>, to include text as details.
 * *relative_file_path* points to the file to be included.
 
 ##### Example Include Descriptions

data/markdown/use_cases/Rakefile

@@ -1,4 +1,3 @@
-require_relative 'include_files/include_use_case'
 require_relative '../../lib/string_helper'
 
 namespace :build do
@@ -18,7 +17,6 @@ EOT
       )
       dir_path = File.dirname(__FILE__)
       Dir.chdir(dir_path) do
-        IncludeUseCase.write_interface_file
         use_case_dirs = {
             :include_files => %w/
                 reuse_text
@@ -27,6 +25,7 @@ EOT
                 include_code_block
                 include_highlighted_code
                 include_page_toc
+                include_text_as_details
                 include_text_as_comment
                 include_text_as_pre
                 include_generated_text
@@ -54,29 +53,27 @@ EOT
           # Each use case is in a separate directory.
           dir_names.each do |dir_name|
             Dir.chdir("#{section}/#{dir_name}") do
-
-              # There should be a conventionally-named ruby file to build the use case.
-              fail dir_name unless File.exist?(UseCase::BUILDER_FILE_NAME)
-
-              # There should be a conventionally-named use-case template.
-              fail dir_name unless File.exist?(UseCase::TEMPLATE_FILE_NAME)
-
-              class_name = camelize(dir_name)
-              command = "ruby -I . -r #{UseCase::BUILDER_FILE_NAME} -e #{class_name}.build"
-              if backtrace_cases.include?(dir_name)
-                command += " 2> #{dir_name}.err"
-                begin
+              if File.exist?('includer.md')
+                command = 'markdown_helper include --pristine includer.md included.md'
+                if backtrace_cases.include?(dir_name)
+                  # Capture the exception.
+                  command += " 2> #{dir_name}.err"
+                  # Generate the error.
+                  begin
+                    system(command)
+                  rescue
+                    #
+                  end
+                else
                   system(command)
-                rescue
-                  #
                 end
-              else
-                system(command)
               end
+              command = 'markdown_helper include --pristine use_case_template.md use_case.md'
+              system(command)
 
-              title_line = File.open(UseCase::TEMPLATE_FILE_NAME).grep(/^#/).first.chomp
+              title_line = File.open('use_case_template.md').grep(/^#/).first.chomp
               title = title_line.split(/\s/, 2).pop
-              use_case_file_name = File.basename(UseCase::USE_CASE_FILE_NAME)
+              use_case_file_name = File.basename('use_case.md')
               use_case_anchor = dir_name.gsub('_', '-')
               use_case_relative_url = File.join(
                   section.to_s,

data/markdown/use_cases/include_files/diagnose_circular_includes/diagnose_circular_includes.err

@@ -1,26 +1,26 @@
-C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/markdown_helper-2.1.0/bin/_include: Includes are circular: (MarkdownHelper::CircularIncludeError)
+C:/Ruby26-x64/lib/ruby/gems/2.6.0/gems/markdown_helper-2.3.0/bin/_include: Includes are circular: (MarkdownHelper::CircularIncludeError)
   Backtrace (innermost include first):
     Level 0:
       Includer:
-        Location: markdown/use_cases/include_files/diagnose_circular_includes/includer_2.md:1
-        Include description: @[:markdown](includer_0.md)
+        Location: markdown/use_cases/include_files/diagnose_circular_includes/includer_2.md:0
+        Include pragma: @[:markdown](includer_0.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_circular_includes/includer_0.md
     Level 1:
       Includer:
-        Location: markdown/use_cases/include_files/diagnose_circular_includes/includer_1.md:1
-        Include description: @[:markdown](includer_2.md)
+        Location: markdown/use_cases/include_files/diagnose_circular_includes/includer_1.md:0
+        Include pragma: @[:markdown](includer_2.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_circular_includes/includer_2.md
     Level 2:
       Includer:
-        Location: markdown/use_cases/include_files/diagnose_circular_includes/includer_0.md:1
-        Include description: @[:markdown](includer_1.md)
+        Location: markdown/use_cases/include_files/diagnose_circular_includes/includer_0.md:0
+        Include pragma: @[:markdown](includer_1.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_circular_includes/includer_1.md
     Level 3:
       Includer:
-        Location: includer.md:1
-        Include description: @[:markdown](includer_0.md)
+        Location: markdown/use_cases/include_files/diagnose_circular_includes/includer.md:0
+        Include pragma: @[:markdown](includer_0.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_circular_includes/includer_0.md

data/markdown/use_cases/include_files/diagnose_circular_includes/use_case.md

@@ -30,23 +30,18 @@ This file initiates the nested inclusions.
 @[:markdown](includer_0.md)
 ```
 
-#### CLI
-
-You can use the command-line interface to perform the inclusion.
-
-##### Command
+#### Include Via <code>markdown_helper</code>
+<details>
+<summary>CLI</summary>
 
 ```sh
 markdown_helper include --pristine includer.md included.md
 ```
 
 (Option ```--pristine``` suppresses comment insertion.)
-
-#### API
-
-You can use the API to perform the inclusion.
-
-##### Ruby Code
+</details>
+<details>
+<summary>API</summary>
 
 ```include.rb```:
 ```ruby
@@ -57,11 +52,7 @@ markdown_helper = MarkdownHelper.new(:pristine => true)
 markdown_helper.include('includer.md', 'included.md')
 ```
 
-##### Command
-
-```sh
-ruby include.rb
-```
+</details>
 
 #### Error and Backtrace
 
@@ -69,30 +60,30 @@ Here's the resulting backtrace of inclusions.
 
 ```diagnose_circular_includes.err```:
 ```
-C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/markdown_helper-2.1.0/bin/_include: Includes are circular: (MarkdownHelper::CircularIncludeError)
+C:/Ruby26-x64/lib/ruby/gems/2.6.0/gems/markdown_helper-2.3.0/bin/_include: Includes are circular: (MarkdownHelper::CircularIncludeError)
   Backtrace (innermost include first):
     Level 0:
       Includer:
-        Location: markdown/use_cases/include_files/diagnose_circular_includes/includer_2.md:1
-        Include description: @[:markdown](includer_0.md)
+        Location: markdown/use_cases/include_files/diagnose_circular_includes/includer_2.md:0
+        Include pragma: @[:markdown](includer_0.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_circular_includes/includer_0.md
     Level 1:
       Includer:
-        Location: markdown/use_cases/include_files/diagnose_circular_includes/includer_1.md:1
-        Include description: @[:markdown](includer_2.md)
+        Location: markdown/use_cases/include_files/diagnose_circular_includes/includer_1.md:0
+        Include pragma: @[:markdown](includer_2.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_circular_includes/includer_2.md
     Level 2:
       Includer:
-        Location: markdown/use_cases/include_files/diagnose_circular_includes/includer_0.md:1
-        Include description: @[:markdown](includer_1.md)
+        Location: markdown/use_cases/include_files/diagnose_circular_includes/includer_0.md:0
+        Include pragma: @[:markdown](includer_1.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_circular_includes/includer_1.md
     Level 3:
       Includer:
-        Location: includer.md:1
-        Include description: @[:markdown](includer_0.md)
+        Location: markdown/use_cases/include_files/diagnose_circular_includes/includer.md:0
+        Include pragma: @[:markdown](includer_0.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_circular_includes/includer_0.md
 ```

data/markdown/use_cases/include_files/diagnose_missing_includee/diagnose_missing_includee.err

@@ -1,26 +1,26 @@
-C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/markdown_helper-2.1.0/bin/_include: Could not read include file, (MarkdownHelper::UnreadableInputError)
+C:/Ruby26-x64/lib/ruby/gems/2.6.0/gems/markdown_helper-2.3.0/bin/_include: Could not read includee file: (MarkdownHelper::UnreadableIncludeeError)
   Backtrace (innermost include first):
     Level 0:
       Includer:
-        Location: markdown/use_cases/include_files/diagnose_missing_includee/includer_2.md:1
-        Include description: @[:markdown](includer_3.md)
+        Location: markdown/use_cases/include_files/diagnose_missing_includee/includer_2.md:0
+        Include pragma: @[:markdown](includer_3.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_missing_includee/includer_3.md
     Level 1:
       Includer:
-        Location: markdown/use_cases/include_files/diagnose_missing_includee/includer_1.md:1
-        Include description: @[:markdown](includer_2.md)
+        Location: markdown/use_cases/include_files/diagnose_missing_includee/includer_1.md:0
+        Include pragma: @[:markdown](includer_2.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_missing_includee/includer_2.md
     Level 2:
       Includer:
-        Location: markdown/use_cases/include_files/diagnose_missing_includee/includer_0.md:1
-        Include description: @[:markdown](includer_1.md)
+        Location: markdown/use_cases/include_files/diagnose_missing_includee/includer_0.md:0
+        Include pragma: @[:markdown](includer_1.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_missing_includee/includer_1.md
     Level 3:
       Includer:
-        Location: includer.md:1
-        Include description: @[:markdown](includer_0.md)
+        Location: markdown/use_cases/include_files/diagnose_missing_includee/includer.md:0
+        Include pragma: @[:markdown](includer_0.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_missing_includee/includer_0.md

data/markdown/use_cases/include_files/diagnose_missing_includee/use_case.md

@@ -32,23 +32,18 @@ This file initiates the nested inclusions.
 @[:markdown](includer_0.md)
 ```
 
-#### CLI
-
-You can use the command-line interface to perform the inclusion.
-
-##### Command
+#### Include Via <code>markdown_helper</code>
+<details>
+<summary>CLI</summary>
 
 ```sh
 markdown_helper include --pristine includer.md included.md
 ```
 
 (Option ```--pristine``` suppresses comment insertion.)
-
-#### API
-
-You can use the API to perform the inclusion.
-
-##### Ruby Code
+</details>
+<details>
+<summary>API</summary>
 
 ```include.rb```:
 ```ruby
@@ -59,11 +54,7 @@ markdown_helper = MarkdownHelper.new(:pristine => true)
 markdown_helper.include('includer.md', 'included.md')
 ```
 
-##### Command
-
-```sh
-ruby include.rb
-```
+</details>
 
 #### Error and Backtrace
 
@@ -71,30 +62,30 @@ Here's the resulting backtrace of inclusions.
 
 ```diagnose_missing_includee.err```:
 ```
-C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/markdown_helper-2.1.0/bin/_include: Could not read include file, (MarkdownHelper::UnreadableInputError)
+C:/Ruby26-x64/lib/ruby/gems/2.6.0/gems/markdown_helper-2.3.0/bin/_include: Could not read includee file: (MarkdownHelper::UnreadableIncludeeError)
   Backtrace (innermost include first):
     Level 0:
       Includer:
-        Location: markdown/use_cases/include_files/diagnose_missing_includee/includer_2.md:1
-        Include description: @[:markdown](includer_3.md)
+        Location: markdown/use_cases/include_files/diagnose_missing_includee/includer_2.md:0
+        Include pragma: @[:markdown](includer_3.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_missing_includee/includer_3.md
     Level 1:
       Includer:
-        Location: markdown/use_cases/include_files/diagnose_missing_includee/includer_1.md:1
-        Include description: @[:markdown](includer_2.md)
+        Location: markdown/use_cases/include_files/diagnose_missing_includee/includer_1.md:0
+        Include pragma: @[:markdown](includer_2.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_missing_includee/includer_2.md
     Level 2:
       Includer:
-        Location: markdown/use_cases/include_files/diagnose_missing_includee/includer_0.md:1
-        Include description: @[:markdown](includer_1.md)
+        Location: markdown/use_cases/include_files/diagnose_missing_includee/includer_0.md:0
+        Include pragma: @[:markdown](includer_1.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_missing_includee/includer_1.md
     Level 3:
       Includer:
-        Location: includer.md:1
-        Include description: @[:markdown](includer_0.md)
+        Location: markdown/use_cases/include_files/diagnose_missing_includee/includer.md:0
+        Include pragma: @[:markdown](includer_0.md)
       Includee:
         File path: markdown/use_cases/include_files/diagnose_missing_includee/includer_0.md
 ```

data/markdown/use_cases/include_files/include_code_block/use_case.md

@@ -27,28 +27,22 @@ Here's a template file that includes it:
 This file includes the code as a code block.
 
 @[:code_block](hello.rb)
-
 ```
 
 The treatment token ```:code_block``` specifies that the included text is to be treated as a code block.
 
-#### CLI
-
-You can use the command-line interface to perform the inclusion.
-
-##### Command
+#### Include Via <code>markdown_helper</code>
+<details>
+<summary>CLI</summary>
 
 ```sh
 markdown_helper include --pristine includer.md included.md
 ```
 
 (Option ```--pristine``` suppresses comment insertion.)
-
-#### API
-
-You can use the API to perform the inclusion.
-
-##### Ruby Code
+</details>
+<details>
+<summary>API</summary>
 
 ```include.rb```:
 ```ruby
@@ -59,11 +53,7 @@ markdown_helper = MarkdownHelper.new(:pristine => true)
 markdown_helper.include('includer.md', 'included.md')
 ```
 
-##### Command
-
-```sh
-ruby include.rb
-```
+</details>
 
 #### File with Inclusion
 

data/markdown/use_cases/include_files/include_highlighted_code/use_case.md

@@ -27,30 +27,24 @@ Here's a template file that includes it:
 This file includes the code as highlighted code.
 
 @[ruby](hello.rb)
-
 ```
 
 The treatment token ```ruby``` specifies that the included text is to be highlighted as Ruby code.
 
 The treatment token can be any Ace mode mentioned in [GitHub Languages](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml).  The file lists about 100 Ace modes, covering just about every language and format.
 
-#### CLI
-
-You can use the command-line interface to perform the inclusion.
-
-##### Command
+#### Include Via <code>markdown_helper</code>
+<details>
+<summary>CLI</summary>
 
 ```sh
 markdown_helper include --pristine includer.md included.md
 ```
 
 (Option ```--pristine``` suppresses comment insertion.)
-
-#### API
-
-You can use the API to perform the inclusion.
-
-##### Ruby Code
+</details>
+<details>
+<summary>API</summary>
 
 ```include.rb```:
 ```ruby
@@ -61,11 +55,7 @@ markdown_helper = MarkdownHelper.new(:pristine => true)
 markdown_helper.include('includer.md', 'included.md')
 ```
 
-##### Command
-
-```sh
-ruby include.rb
-```
+</details>
 
 #### File with Inclusion
 

data/markdown/use_cases/include_files/include_markdown/use_case.md

@@ -29,28 +29,22 @@ Here's a template file that includes it:
 This file includes the markdown file.
 
 @[:markdown](markdown.md)
-
 ```
 
 The treatment token ```:markdown``` specifies that the included text is to be treated as markdown.
 
-#### CLI
-
-You can use the command-line interface to perform the inclusion.
-
-##### Command
+#### Include Via <code>markdown_helper</code>
+<details>
+<summary>CLI</summary>
 
 ```sh
 markdown_helper include --pristine includer.md included.md
 ```
 
 (Option ```--pristine``` suppresses comment insertion.)
-
-#### API
-
-You can use the API to perform the inclusion.
-
-##### Ruby Code
+</details>
+<details>
+<summary>API</summary>
 
 ```include.rb```:
 ```ruby
@@ -61,11 +55,7 @@ markdown_helper = MarkdownHelper.new(:pristine => true)
 markdown_helper.include('includer.md', 'included.md')
 ```
 
-##### Command
-
-```sh
-ruby include.rb
-```
+</details>
 
 #### File with Inclusion
 
@@ -85,7 +75,6 @@ This is an unordered list:
 * One.
 * Two.
 * Three.
-
 ```
 
 And here's the finished markdown, as rendered on this page:

data/markdown/use_cases/include_files/include_page_toc/included.md

@@ -1,4 +1,3 @@
-<!-- >>>>>> BEGIN GENERATED FILE (include): SOURCE includer.md -->
 # Page Title
 
 ## Page Contents
@@ -23,7 +22,6 @@
 
 ## Another includer level-two title.
 
-<!-- >>>>>> BEGIN INCLUDED FILE (markdown): SOURCE markdown/use_cases/include_files/include_page_toc/markdown_0.md -->
         
 ## Includee 0 level-two title.
 
@@ -32,9 +30,7 @@
 ### Another includee 0 level-three title.
 
 ## Another includee 0 level-two title.
-<!-- <<<<<< END INCLUDED FILE (markdown): SOURCE markdown/use_cases/include_files/include_page_toc/markdown_0.md -->
 
-<!-- >>>>>> BEGIN INCLUDED FILE (markdown): SOURCE markdown/use_cases/include_files/include_page_toc/markdown_1.md -->
         
 ## Includee 1 level-two title.
 
@@ -43,6 +39,4 @@
 ### Another includee 1 level-three title.
 
 ## Another includee 1 level-two title.
-<!-- <<<<<< END INCLUDED FILE (markdown): SOURCE markdown/use_cases/include_files/include_page_toc/markdown_1.md -->
 
-<!-- <<<<<< END GENERATED FILE (include): SOURCE includer.md -->