markdown_exec 2.6.0 → 2.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c8e475323e8db8b8288c18f8d97f1c52552c0a292854c42ab2780620bcdb8aa5
-  data.tar.gz: 254288c200e344c55f49c5fad1717d46550df1892eb526033180ed066f6c449d
+  metadata.gz: 2777165b185482931d9fe8e519921490e8e252dcb93d141abf52fc6e53b95ba7
+  data.tar.gz: c5925bd62f6853ad701946a2ecca3bf57c8b967b7f65c9990f72c17748591398
 SHA512:
-  metadata.gz: b5a6372f45da7c45ae20b0c65058347c66fa17b7afffbacb63f0000c52ff0efd99e18a22f826e7803a1f130868a1dcf0b2f59b48279d19bb1326709a2dc3c04a
-  data.tar.gz: 4308b84a0591e44e5e2d317c6f0c5cd7b6d74848f91a65aaf85897058321ca041113ee80889313d2b0c1a31a587796af708879f3cd3b169a976755f6cce879c9
+  metadata.gz: 0f534d77704be9418666e804a2bf1ecfd6c41ae4cee8b0c7f3c7753f2967b88b257e1962f3f8dc9565af09a697f75fb823054f062bffea9a7aabef9d9bae885e
+  data.tar.gz: 18bcdb411c4655bb3f99c8e7557adf7d872c0562fcfeef18700134578dcc9c8e8ecf9992c43c82521eb773aad6d97a95e7f6859d90a36ded25a2ac88e3a2babc

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [2.7.0] - 2024-12-09
+
+### Added
+
+- Collapse or expand sections defined by heading and dividers per options, section definitions, and user interaction.
+- Command substitution to displayed menu items.
+- Margin on menu to highlight selections.
+- Cycling to file selection menu.
+- Print entire document if there are no active elements.
+- Option to set a screen width. The document and interface are formatted to fit this dimension. The default is 0, which causes to read and use the console width.
+
+### Changed
+
+- Highlight prior selection in menu.
+- Display live environment variable values in examples.
+
 ## [2.6.0] - 2024-11-27
 
 ### Added
@@ -7,7 +23,7 @@
 - Ability to collapse and expand sections.
 - Collapsible state configurable per document and per section.
 - User can collapse and expand sections in the UI.
-- Live shell variable expansion in document text and block content.
+- Live shell variable expansion in text and various non-shell blocks.
 - Option for name of function to manage executed scripts.
 
 ### Changed
@@ -156,7 +172,7 @@
 ### Changed
 
 - Fix block name processing for blocks with no name.
-  Demo in examples/block_names.md loads content of examples/load1.sh.
+  Demo in examples/block_names.md loads content of docs/dev/load1.sh.
 
 ## [2.0.5] - 2024-04-24
 

data/Gemfile.lock

@@ -1,12 +1,12 @@
 PATH
   remote: .
   specs:
-    markdown_exec (2.6.0)
+    markdown_exec (2.7.1)
       clipboard (~> 1.3.6)
       open3 (~> 0.1.1)
       optparse (~> 0.1.1)
       tty-prompt (~> 0.23.1)
-      yaml (>= 0.2.0)
+      yaml (~> 0.2)
 
 GEM
   remote: https://rubygems.org/

data/Rakefile

@@ -85,11 +85,17 @@ task :bats do
   end
 end
 
+desc 'list Ruby files with tests'
+task :listtests do
+  puts `find lib -name '*.rb' -type f | xargs grep '< Minitest::Test' -l | sort`
+end
+
 desc 'minitest'
 task :minitest do
   commands = [
     './lib/argument_processor.rb',
     './lib/cached_nested_file_reader.rb',
+    './lib/collapser.rb',
     './lib/directory_searcher.rb',
     './lib/evaluate_shell_expressions.rb',
     './lib/fcb.rb',
@@ -203,3 +209,33 @@ def words_list(words)
     %("#{word}")
   end.join ' '
 end
+
+desc 'Build the Docker image for MarkdownExec'
+task :docker_build do
+  dockerfile = 'Dockerfile.ruby-3.3'
+  image_tag = "mde-#{MarkdownExec::VERSION}.gem"
+
+  command = [
+    "docker build",
+    "--build-arg VERSION=#{MarkdownExec::VERSION}",
+    "-f #{dockerfile}",
+    "-t #{image_tag}",
+    "."
+  ].join(' ')
+
+  puts "Building Docker image: #{image_tag} using #{dockerfile}..."
+  puts system(command) || abort("Docker build failed. Please check the output for details.")
+end
+
+desc 'Launch an interactive Docker Bash shell'
+task :docker_exec do
+  exec "docker exec -it mde-#{MarkdownExec::VERSION}.gem bash"
+end
+
+desc 'Run the mde binary inside a Docker container. eg `docker_run -- args`'
+task :docker_run, [:args] do
+  args = ARGV.dup
+  args.shift
+  args.shift if args[0] == '--'
+  exec "docker run -it mde-#{MarkdownExec::VERSION}.gem mde #{args.join(' ')}"
+end

data/bats/command-substitution.bats

@@ -0,0 +1,8 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'Command substitution' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/command-substitution.md \
+   'CURRENT BASE NAME IS: MARKDOWN_EXEC_current base name is: markdown_exec_current base name is: markdown_exec_| current base name |_| ----------------- |_| markdown_exec     |_: notice the string is not expanded in Shell block types (names or body)._  echo "current base name is now $(basename `pwd`)"__load: file_markdown_exec.sh'
+}

data/bats/options.bats

@@ -72,10 +72,10 @@ load 'test_helper'
 # }
 
 @test 'Options - load-code' {
-  BATS_OUTPUT_FILTER=A
-  BATS_OUTPUT_GREP=var1
-  spec_mde_args_expect examples/load_code.md --load-code examples/load1.sh display_variables \
-   'var1: line2'
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/load_code.md \
+   --load-code docs/dev/load1.sh \
+   --list-blocks-message dname --list-blocks-type 3 --list-blocks \
+   'Demonstrate loading inherited code via the command line.__Run this command to display the inherited code._mde --load-code docs/dev/load1.sh docs/dev/load_code.md__| Variable | Value |_| -------- | ----- |_| var1     | line2 |_| var2     | line4 |'
 }
 
 @test 'Options - pwd' {

data/bats/plain.bats

@@ -0,0 +1,8 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'no-active-elements' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/no-active-elements.md \
+   'DEMONSTRATE A DOCUMENT WITH NO ACTIVE ELEMENTS_A document with no active elements.'
+}

data/bats/table.bats

@@ -4,5 +4,10 @@ load 'test_helper'
 
 @test 'Tables - indented' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/table-indent.md \
-   ' DEMONSTRATE TABLE INDENTATION__Table flush at left._Centered columns._|     Common Name      |          Species          |    Genus     |    Family     | Year Discovered |_| -------------------- | ------------------------- | ------------ | ------------- | --------------- |_|  Tapanuli Orangutan  |    Pongo tapanuliensis    |    Pongo     |   Hominidae   |      2017       |_| Psychedelic Frogfish | Histiophryne psychedelica | Histiophryne | Antennariidae |      2009       |_|    Ruby Seadragon    |   Phyllopteryx dewysea    | Phyllopteryx | Syngnathidae  |      2015       |__  Table indented with two spaces._  Left-justified columns._  | Common Name                | Species        | Genus   | Family          | Year Discovered |_  | -------------------------- | -------------- | ------- | --------------- | --------------- |_  | Illacme tobini (Millipede) | Illacme tobini | Illacme | Siphonorhinidae | 2016            |__    Table indented with one tab._    Right-justified columns._    |     Common Name |             Species |     Genus |     Family | Year Discovered |_    | --------------- | ------------------- | --------- | ---------- | --------------- |_    | Spiny Dandelion | Taraxacum japonicum | Taraxacum | Asteraceae |            2022 |'
+   'DEMONSTRATE TABLE INDENTATION__Table flush at left._Centered columns._|     Common Name      |          Species          |    Genus     |    Family     | Year Discovered |_| -------------------- | ------------------------- | ------------ | ------------- | --------------- |_|  Tapanuli Orangutan  |    Pongo tapanuliensis    |    Pongo     |   Hominidae   |      2017       |_| Psychedelic Frogfish | Histiophryne psychedelica | Histiophryne | Antennariidae |      2009       |_|    Ruby Seadragon    |   Phyllopteryx dewysea    | Phyllopteryx | Syngnathidae  |      2015       |__  Table indented with two spaces._  Left-justified columns._  | Common Name                | Species        | Genus   | Family          | Year Discovered |_  | -------------------------- | -------------- | ------- | --------------- | --------------- |_  | Illacme tobini (Millipede) | Illacme tobini | Illacme | Siphonorhinidae | 2016            |__    Table indented with one tab._    Right-justified columns._    |     Common Name |             Species |     Genus |     Family | Year Discovered |_    | --------------- | ------------------- | --------- | ---------- | --------------- |_    | Spiny Dandelion | Taraxacum japonicum | Taraxacum | Asteraceae |            2022 |'
+}
+
+@test 'Tables - invalid' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/table-invalid.md \
+  'Missing column names__| ------------------- | - |_| Pongo tapanuliensis |   |__Missing dividers__| Species_| Pongo tapanuliensis__Missing table rows__| Species |_| ------- |'
 }

data/bats/variable-expansion.bats

@@ -4,27 +4,27 @@ load 'test_helper'
 
 @test 'Variable expansion - default' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/variable-expansion.md \
-   ' EVIDENCE_ SOURCE is: ${SOURCE}_SOURCE is: ${SOURCE}_SOURCE is: ${SOURCE}_| SOURCE    |_| --------- |_| ${SOURCE} |_name_with_${SOURCE}_in_name_load: file_${SOURCE}.sh_ SOURCES'
+   'EVIDENCE_SOURCE is:_SOURCE is:_SOURCE is:_| SOURCE |_| ------ |__name_with_${SOURCE}_in_name_load: file_.sh_SOURCES'
 }
 
 @test 'Variable expansion - LINK_LOAD_SOURCE' {
   echo "SOURCE='Loaded file'" > temp_variable_expansion.sh
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/variable-expansion.md \
    '(LINK_LOAD_SOURCE)' \
-   ' EVIDENCE_ SOURCE is: Loaded file_SOURCE is: Loaded file_SOURCE is: Loaded file_| SOURCE      |_| ----------- |_| Loaded file |_name_with_${SOURCE}_in_name_load: file_Loaded file.sh_ SOURCES'
+   'EVIDENCE_SOURCE is: Loaded file_SOURCE is: Loaded file_SOURCE is: Loaded file_| SOURCE      |_| ----------- |_| Loaded file |_name_with_${SOURCE}_in_name_load: file_Loaded file.sh_SOURCES'
   rm temp_variable_expansion.sh
 }
 
 @test 'Variable expansion - LINK_VARS_SOURCE' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/variable-expansion.md \
    '(LINK_VARS_SOURCE)' \
-   ' EVIDENCE_ SOURCE is: Link block_SOURCE is: Link block_SOURCE is: Link block_| SOURCE     |_| ---------- |_| Link block |_name_with_${SOURCE}_in_name_load: file_Link block.sh_ SOURCES'
+   'EVIDENCE_SOURCE is: Link block_SOURCE is: Link block_SOURCE is: Link block_| SOURCE     |_| ---------- |_| Link block |_name_with_${SOURCE}_in_name_load: file_Link block.sh_SOURCES'
 }
 
 @test 'Variable expansion - VARS_SOURCE' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/variable-expansion.md \
    '(VARS_SOURCE)' \
-   ' EVIDENCE_ SOURCE is: Vars block_SOURCE is: Vars block_SOURCE is: Vars block_| SOURCE     |_| ---------- |_| Vars block |_name_with_${SOURCE}_in_name_load: file_Vars block.sh_ SOURCES'
+   'EVIDENCE_SOURCE is: Vars block_SOURCE is: Vars block_SOURCE is: Vars block_| SOURCE     |_| ---------- |_| Vars block |_name_with_${SOURCE}_in_name_load: file_Vars block.sh_SOURCES'
 }
 
 ### Load source

data/bin/bmde

@@ -2,10 +2,54 @@
 # frozen_string_literal: true
 
 # encoding=utf-8
-
 require 'bundler/setup'
 Bundler.require(:default)
 
 require_relative '../lib/markdown_exec'
 
-MarkdownExec::MarkParse.new.run
+trace_enabled = false
+
+if ENV['MDE_TRACE_POINT']
+  trace_output = if ENV['MDE_TRACE_POINT_FILE']
+                   File.open(ENV['MDE_TRACE_POINT_FILE'], 'a')
+                 else
+                   $stderr
+                 end
+
+  trace = TracePoint.new(:line) do |tp|
+    next unless trace_enabled
+
+    method_name = tp.method_id || 'unknown_method'
+    next if method_name == :method_missing
+
+    next if tp.path.match?(%r{(/\.bundle/|/\.rbenv/|internal:|lib/colorize|lib/object_present|lib/resize_terminal)})
+
+    message = "#{'.' * Thread.current.backtrace_locations.size} #{tp.path.sub(Dir.pwd, '')} [#{method_name}] #{tp.lineno + 1}"
+
+    if trace_output.is_a?(File)
+      trace_output.puts(message)
+    else
+      warn message
+      $stderr.flush
+    end
+  end
+
+  def tpbreak
+    trace_enabled = false
+    binding.irb
+  end
+
+  def tpgo
+    trace_enabled = true
+  end
+
+  trace.enable
+  trace_enabled = true
+end
+
+begin
+  MarkdownExec::MarkParse.new.run
+ensure
+  trace&.disable
+  trace_output&.close if trace_output.is_a?(File)
+end

data/bin/tab_completion.sh

@@ -13,7 +13,7 @@ __filedirs_all()
 }
 
 _mde_echo_version() {
-  echo "2.6.0"
+  echo "2.7.1"
 }
 
 _mde() {

data/docs/dev/command-substitution.md

@@ -0,0 +1,24 @@
+# current base name is: $(basename `pwd`)
+:::: current base name is: $(basename `pwd`)
+current base name is: $(basename `pwd`)
+| current base name
+| -
+| $(basename `pwd`)
+```bash
+: notice the string is not expanded in Shell block types (names or body).
+echo "current base name is now $(basename `pwd`)"
+```
+```link
+load: file_$(basename `pwd`).sh
+```
+@import bats-document-configuration.md
+```opts :(document_opts)
+heading1_center: false
+heading2_center: false
+heading3_center: false
+menu_final_divider:
+menu_for_saved_lines: false
+menu_initial_divider:
+menu_vars_set_format:
+table_center: false
+```

data/docs/dev/load_code.md

@@ -0,0 +1,14 @@
+Demonstrate loading inherited code via the command line.
+
+Run this command to display the inherited code.
+`mde --load-code docs/dev/load1.sh docs/dev/load_code.md`
+
+| Variable| Value
+| -| -
+| var1| ${var1}
+| var2| ${var2}
+@import bats-document-configuration.md
+```opts :(document_opts)
+menu_for_saved_lines: false
+table_center: false
+```

data/docs/dev/no-active-elements.md

@@ -0,0 +1,6 @@
+# Demonstrate a document with no active elements
+A **document** with no active elements.
+@import bats-document-configuration.md
+```opts :(document_opts)
+heading1_center: false
+```

data/docs/dev/screen-width.md

@@ -0,0 +1,21 @@
+The text from "1" to "16" is 38 digits, spaces.
+::: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
+The text from "17" to "23" is 20 digits, spaces.
+::: 17 18 19 20 21 22 23
+```opts
+screen_width: 80
+```
+```opts
+screen_width: 60
+```
+```opts
+screen_width: 40
+```
+```opts
+screen_width: 20
+```
+@import bats-document-configuration.md
+```opts :(document_opts)
+divider4_center: true
+divider4_collapsible: false
+```

data/docs/dev/table-invalid.md

@@ -0,0 +1,20 @@
+::: Missing column names
+
+| -| -
+| Pongo tapanuliensis
+
+
+::: Missing dividers
+
+| Species
+| Pongo tapanuliensis
+
+::: Missing table rows
+
+| Species
+| -
+
+@import bats-document-configuration.md
+```opts :(document_opts)
+table_center: false
+```

data/examples/bash-blocks.md

@@ -50,9 +50,10 @@ The hidden block "(taxonomy)" prints "taxonomy".
     echo "taxonomy"
     ```
 
+@import example-document-opts.md
 ```opts :(document_opts)
 execute_in_own_window: false
 output_execution_report: false
 output_execution_summary: false
 pause_after_script_execution: true
-```
+```

data/examples/block-names.md

@@ -54,9 +54,10 @@ The hidden block "(success)" is required above. It prints "Success".
 echo "Success"
 ```
 
+@import example-document-opts.md
 ```opts :(document_opts)
 execute_in_own_window: false
 output_execution_report: false
 output_execution_summary: false
 pause_after_script_execution: true
-```
+```

data/examples/block-types.md

@@ -16,10 +16,11 @@ Specified block types.
         a: 1
         ```
 
+@import example-document-opts.md
 ```opts :(document_opts)
 bash_only: false
 execute_in_own_window: false
 output_execution_report: false
 output_execution_summary: false
 pause_after_script_execution: true
-```
+```

data/examples/data-files.md

@@ -1,5 +1,6 @@
 # Demonstrate data blocks
 
+@import example-document-opts.md
 ```opts :(document_opts)
 pause_after_script_execution: true
 ```

data/examples/document_options.md

@@ -1,5 +1,6 @@
 This document demonstrates the automatic loading of options in a block with a reserved name.
 
+@import example-document-opts.md
 ```opts :(document_opts)
 menu_divider_format: "=> %{line} == %{line} <="
 ```

data/examples/example-document-opts.md

@@ -0,0 +1,6 @@
+```opts :(document_opts)
+heading1_collapsible: false
+heading2_collapsible: false
+heading3_collapsible: false
+divider4_collapsible: false
+```

data/examples/index.md

@@ -37,7 +37,7 @@ file: examples/linked3.md
 file: examples/llm.md
 ```
 ```link
-file: examples/load1.sh
+file: docs/dev/load1.sh
 ```
 ```link
 file: examples/load2.sh

data/examples/interrupt.md

@@ -1,3 +1,4 @@
+@import example-document-opts.md
 ```opts :(document_opts)
 pause_after_script_execution: false
 ```

data/examples/link-blocks-load-save.md

@@ -1,7 +1,7 @@
 ::: Load file into inherited lines
 Load (do not evaluate) and append to inherited lines.
 ```link :load1
-load: examples/load1.sh
+load: docs/dev/load1.sh
 ```
 Load, evaluate, and append output to inherited lines.
 ```link :load2_eval
@@ -12,9 +12,8 @@ eval: true
 ::: Load file into inherited lines and switch document
 Load (do not evaluate) and append to inherited lines and switch document.
 ```link :load_from_file_link_and_show
-block: show_vars
 file: examples/linked_show.md
-load: examples/load1.sh
+load: docs/dev/load1.sh
 ```
 
 ::: Save and Load
@@ -23,17 +22,16 @@ Save inherited lines to a file.
 save: tmp/save1.sh
 ```
 Load inherited lines from a file.
-Subsequently, run the `display_variables` block.
 ```link :load_saved
 load: tmp/save1.sh
-block: display_variables
-```
-Display variables ALPHA, var1, var2
-```bash :display_variables
-source bin/colorize_env_vars.sh
-colorize_env_vars '' ALPHA var1 var2
 ```
 
+| Variable| Value
+| -| -
+| ALPHA| ${ALPHA}
+| var1| ${var1}
+| var2| ${var2}
+
 ::: Load file matching glob pattern into inherited lines
 Load (do not evaluate) and append to inherited lines.
 ```link :load_glob_load1*

data/examples/link-blocks-vars.md

@@ -1,4 +1,5 @@
 # Demonstrate link blocks set variables
+@import example-document-opts.md
 ```opts :(document_opts)
 execute_in_own_window: false
 menu_with_inherited_lines: true
@@ -9,15 +10,14 @@ pause_after_script_execution: true
 
 ## Demonstrate a link block that sets a variable
 ::: Select below to trigger. If it prints "VARIABLE1: 1", the Link block was processed.
-The hidden block "(print-VARIABLE1)" is required below. It prints variable "VARIABLE1".
-```bash :(print-VARIABLE1)
-source bin/colorize_env_vars.sh
-colorize_env_vars '' VARIABLE1
-```
-The block sets VARIABLE1 and requires hidden block "(print-VARIABLE1)".
+
+| Variable| Value
+| -| -
+| VARIABLE1| ${VARIABLE1}
+
+The block sets VARIABLE1.
 For each environment variable in `vars`, append an inherited line that assigns the variable the specified value.
     ```link
-    block: (print-VARIABLE1)
     vars:
       VARIABLE1: 1
     ```
@@ -50,7 +50,10 @@ These blocks require the *output* of the execution of the code in the named shel
     eval: true
     next_block: "(display_variable_ALPHA)"
     ```
+
+| Variable| Value
+| -| -
+| ALPHA| ${ALPHA}
+
 ```bash :(display_variable_ALPHA)
-source bin/colorize_env_vars.sh
-colorize_env_vars '' ALPHA
 ```

data/examples/linked.md

@@ -1,5 +1,6 @@
 Demonstrate setting variable values interactively for use in generated scripts.
 
+@import example-document-opts.md
 ```opts :(document_opts)
 menu_with_inherited_lines: true
 pause_after_script_execution: false
@@ -14,7 +15,6 @@ ALPHA: 1
 ```
 
 Make the code in the required block `(bash_set_to_3)` into inherited lines.
-Subsequently, run the `display_variable_ALPHA` block.
 ```bash :(bash_set_to_3)
 ALPHA=3
 ```
@@ -24,7 +24,6 @@ block: display_variable_ALPHA
 
 Evaluate the code in the required block `(bash_eval_set_to_4)` and
  save (transformed) output into inherited lines.
-Subsequently, run the `display_variable_ALPHA` block.
 ```link :[set_ALPHA_to_4_via_evaluated_required_block_and_display] +(bash_eval_set_to_4)
 eval: true
 next_block: display_variable_ALPHA
@@ -33,16 +32,15 @@ next_block: display_variable_ALPHA
 echo 'ALPHA="4"'
 ```
 
-::: Display value of ALPHA
+/::: Display value of ALPHA
 ```bash :display_variable_ALPHA
-source bin/colorize_env_vars.sh
-echo The current value of environment variable ALPHA is now:
-colorize_env_vars '' ALPHA
 ```
+| Variable| Value
+| -| -
+| ALPHA| ${ALPHA}
 
 Execute a script requiring input from the user.
 Save the output setting TIMESTAMP into inherited lines.
-Subsequently, run the `display_TIMESTAMP` block.
 ```bash :(input_timestamp)
 if [[ -z $TIMESTAMP ]]; then
   default="$(date -u +%y%m%d)"
@@ -56,13 +54,12 @@ echo "TIMESTAMP=\"$TIMESTAMP\""
 ```
 ```link :set_timestamp +(input_timestamp) +(inherit_timestamp)
 exec: true
-block: display_TIMESTAMP
-```
-```bash :display_TIMESTAMP
-source bin/colorize_env_vars.sh
-colorize_env_vars '' TIMESTAMP
 ```
 
+| Variable| Value
+| -| -
+| TIMESTAMP| ${TIMESTAMP}
+
 ## Values
 Spaces in variable value are unchanged.
     ```link :link_with_vars_with_spaces

data/examples/linked1.md

@@ -1,5 +1,6 @@
 # Demo document linking
 
+@import example-document-opts.md
 ```opts :(document_opts)
 dump_inherited_lines: true
 pause_after_script_execution: false
@@ -11,11 +12,12 @@ user_must_approve: false
 
 ::: This Bash block displays the value of variables "page1_var_via_environment" and "page2_var_via_environment"
 
-```bash :show_vars
-source bin/colorize_env_vars.sh
-colorize_env_vars 'vars for page2' PAGE2_VAR_VIA_INHERIT page2_var_via_environment
-colorize_env_vars 'vars for page3' PAGE3_VAR_VIA_INHERIT page3_var_via_environment
-```
+| Variable| Value
+| -| -
+| PAGE2_VAR_VIA_INHERIT| ${PAGE2_VAR_VIA_INHERIT}
+| page2_var_via_environment| ${page2_var_via_environment}
+| PAGE3_VAR_VIA_INHERIT| ${PAGE3_VAR_VIA_INHERIT}
+| page3_var_via_environment| ${page3_var_via_environment}
 
 ```bash :(vars2)
 PAGE2_VAR_VIA_INHERIT=for_page2_from_page1_via_inherited_code_blocks
@@ -37,7 +39,6 @@ file: examples/linked2.md
 
 ```link :linked2_import_vars +(vars2)
 file: examples/linked2.md
-block: show_vars
 vars:
   page2_var_via_environment: for_page2_from_page1_via_current_environment
 ```

data/examples/linked2.md

@@ -5,16 +5,16 @@
 
 ::: This Bash block displays the value of variables "page1_var_via_environment" and "page2_var_via_environment"
 
-```bash :show_vars
-source bin/colorize_env_vars.sh
-colorize_env_vars 'vars for page2' PAGE2_VAR_VIA_INHERIT page2_var_via_environment
-colorize_env_vars 'vars for page3' PAGE3_VAR_VIA_INHERIT page3_var_via_environment
-```
+| Variable| Value
+| -| -
+| PAGE2_VAR_VIA_INHERIT| ${PAGE2_VAR_VIA_INHERIT}
+| page2_var_via_environment| ${page2_var_via_environment}
+| PAGE3_VAR_VIA_INHERIT| ${PAGE3_VAR_VIA_INHERIT}
+| page3_var_via_environment| ${page3_var_via_environment}
 
 ::: This Link block requires a block that
 ::: 1. sets environment variable PAGE3_VAR_VIA_INHERIT,
 ::: 2. navigates to document 3, and
-::: 3. executes block "show_vars" to display the imported PAGE3_VAR_VIA_INHERIT.
 
 ```bash :(vars3)
 PAGE3_VAR_VIA_INHERIT=for_page3_from_page2_via_inherited_code_blocks
@@ -30,7 +30,6 @@ file: examples/linked3.md
 
 ```link :linked3_import_vars +(vars3)
 file: examples/linked3.md
-block: show_vars
 vars:
   page3_var_via_environment: for_page3_from_page2_via_current_environment
 ```