RubyGems - apex-ruby - Versions diffs - 1.0.6 - Mend

apex-ruby 1.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (501) hide show

data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Multi-File-Documents.html ADDED Viewed

@@ -0,0 +1,1368 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+      <meta charset="UTF-8">
+      <meta name="viewport" content="width=device-width, initial-scale=1.0">
+      <meta name="generator" content="Apex 0.1.49">
+      <title>Document</title>
+      <style>
+        body {
+          font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+          line-height: 1.6;
+          max-width: 800px;
+          margin: 2rem auto;
+          padding: 0 1rem;
+          color: #333;
+        }
+        pre { background: #f5f5f5; padding: 1rem; overflow-x: auto; }
+        code { background: #f0f0f0; padding: 0.2em 0.4em; border-radius: 3px; }
+        blockquote { border-left: 4px solid #ddd; margin: 0; padding-left: 1rem; color: #666; }
+        table { border-collapse: collapse; width: 100%%; }
+        th, td { border: 1px solid #ddd; padding: 0.5rem; }
+        th { background: #f5f5f5; }
+        tfoot td { background: #e8e8e8; }
+        figure.table-figure { width: fit-content; margin: 1em 0; }
+        figure.table-figure table { width: auto; }
+        figcaption { text-align: center; font-weight: bold; font-size: 0.8em; }
+        .page-break { page-break-after: always; }
+        .callout { padding: 1rem; margin: 1rem 0; border-left: 4px solid; }
+        .callout-note { border-color: #3b82f6; background: #eff6ff; }
+        .callout-warning { border-color: #f59e0b; background: #fffbeb; }
+        .callout-tip { border-color: #10b981; background: #f0fdf4; }
+        .callout-danger { border-color: #ef4444; background: #fef2f2; }
+        ins { background: #d4fcbc; text-decoration: none; }
+        del { background: #fbb6c2; text-decoration: line-through; }
+        mark { background: #fff3cd; }
+        .critic.comment { background: #e7e7e7; color: #666; font-style: italic; }
+      </style>
+  <style>
+/* Base styles */
+body {
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  font-size: 17px;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
+    "Helvetica Neue", Arial, sans-serif;
+  line-height: 1.65;
+  color: #1e293b;
+  background-color: #fff;
+}
+/* Sidebar / Main TOC - wider on larger screens */
+.main-toc,
+.sidebar {
+  position: fixed;
+  left: 0;
+  top: 0;
+  width: auto;
+  min-width: 180px;
+  max-width: 250px;
+  height: 100vh;
+  overflow-y: auto;
+  background: #1e293b;
+  color: rgba(255, 255, 255, 0.9);
+  border-right: 2px solid rgba(255, 255, 255, 0.1);
+  padding: 24px 20px 130px;
+  font-size: 14px;
+  z-index: 100;
+  margin-right: 1rem;
+  box-shadow: 4px 0 24px rgba(0, 0, 0, 0.08);
+  transition: transform 0.3s ease;
+}
+.main-toc ul,
+.sidebar ul {
+  list-style: none;
+  padding-left: 0;
+  margin: 0;
+  padding-bottom: 80px;
+}
+.main-toc ul::after,
+.sidebar ul::after {
+  content: "";
+  display: block;
+  height: 80px;
+}
+.main-toc li,
+.sidebar li {
+  margin: 0.25em 0;
+}
+.main-toc a,
+.sidebar a {
+  color: rgba(255, 255, 255, 0.85);
+  text-decoration: none;
+  display: block;
+  padding: 6px 12px;
+  border-radius: 4px;
+  transition: all 0.15s ease;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.main-toc a:hover,
+.sidebar a:hover {
+  background: #334155;
+  color: #fff;
+}
+.sidebar a.active {
+  color: #0ea5e9;
+  font-weight: 500;
+}
+/* Body margin for sidebar */
+body {
+  margin-left: 270px;
+}
+/* Hamburger menu button */
+.hamburger-menu {
+  display: none;
+  position: fixed;
+  top: 12px;
+  left: 12px;
+  z-index: 200;
+  background: #1e293b;
+  border: 2px solid rgba(255, 255, 255, 0.1);
+  border-radius: 6px;
+  padding: 10px;
+  cursor: pointer;
+  color: rgba(255, 255, 255, 0.9);
+  font-size: 20px;
+  line-height: 1;
+  width: 44px;
+  height: 44px;
+  align-items: center;
+  justify-content: center;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
+  transition: all 0.2s ease;
+  opacity: 0.2;
+}
+.hamburger-menu:hover {
+  background: #334155;
+  color: #fff;
+  opacity: 1;
+}
+/* Move hamburger to the right of the sidebar when menu is open */
+.hamburger-menu.active {
+  left: calc(
+    250px + 12px
+  ); /* Position just to the right of sidebar (max-width 250px + 12px padding) */
+}
+.hamburger-menu.active {
+  background: #0ea5e9;
+}
+.hamburger-menu::before {
+  content: "☰";
+}
+.hamburger-menu.active::before {
+  content: "✕";
+}
+/* Mobile menu overlay */
+.mobile-menu-overlay {
+  display: none;
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: rgba(0, 0, 0, 0.5);
+  z-index: 150;
+  opacity: 0;
+  visibility: hidden;
+  transition: opacity 0.3s ease, visibility 0.3s ease;
+}
+.mobile-menu-overlay.active {
+  opacity: 1;
+  visibility: visible;
+}
+/* Page TOC */
+.page-toc {
+  background: #f9f9f9;
+  border: 1px solid #ddd;
+  border-radius: 4px;
+  padding: 1rem;
+  margin: 1.5rem 0;
+}
+.page-toc ul {
+  list-style: none;
+  padding-left: 0;
+  margin: 0;
+}
+.page-toc > ul {
+  padding-left: 0;
+}
+.page-toc li {
+  margin: 0.25em 0;
+}
+.page-toc a {
+  color: #0066cc;
+  text-decoration: none;
+  display: block;
+  padding: 0.25em 0.5em;
+  border-radius: 3px;
+}
+.page-toc a:hover {
+  background: #e0e0e0;
+  color: #004499;
+}
+.page-toc ul ul {
+  list-style: none;
+  padding-left: 1.5em;
+  margin-top: 0.25em;
+  margin-left: 0;
+}
+.page-toc ul ul ul {
+  padding-left: 1.5em;
+}
+.page-toc ul ul a {
+  font-size: 0.9em;
+  color: #555;
+}
+.page-toc ul ul ul a {
+  font-size: 0.85em;
+  color: #666;
+}
+/* Floating TOC */
+.floating-toc {
+  position: fixed;
+  top: 0;
+  left: 270px;
+  right: 0;
+  z-index: 50;
+  opacity: 0;
+  visibility: hidden;
+  transition: opacity 0.2s ease, visibility 0.2s ease;
+  pointer-events: none;
+  display: flex;
+  justify-content: flex-end;
+  padding-right: 2rem;
+}
+.floating-toc.visible {
+  opacity: 1;
+  visibility: visible;
+  pointer-events: auto;
+}
+.floating-toc-container {
+  background: rgba(255, 255, 255, 0.95);
+  backdrop-filter: blur(10px);
+  border-bottom: 1px solid #ddd;
+  border-radius: 0 0 12px 12px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  width: fit-content;
+  max-width: 400px;
+  min-width: 200px;
+  overflow: hidden;
+  transition: max-height 0.3s ease;
+}
+.floating-toc-header {
+  padding: 8px 16px;
+  cursor: pointer;
+  user-select: none;
+  font-size: 14px;
+  font-weight: 500;
+  color: #1e293b;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+.floating-toc-header:hover {
+  background: rgba(0, 0, 0, 0.02);
+}
+.floating-toc-content {
+  max-height: 0;
+  overflow: hidden;
+  transition: max-height 0.3s ease;
+}
+.floating-toc-container:hover .floating-toc-content {
+  max-height: 70vh;
+  overflow-y: auto;
+}
+.floating-toc-content ul {
+  list-style: none;
+  padding: 8px 16px 16px;
+  margin: 0;
+}
+.floating-toc-content li {
+  margin: 0.1em 0;
+}
+.floating-toc-content a {
+  color: #0066cc;
+  text-decoration: none;
+  display: block;
+  padding: 0.2em 0.5em;
+  border-radius: 4px;
+  font-size: 13px;
+  transition: background 0.15s ease;
+}
+.floating-toc-content a:hover {
+  background: #e0e0e0;
+  color: #004499;
+}
+.floating-toc-content ul ul {
+  padding-left: 1.2em;
+  margin-top: 0;
+  margin-bottom: 0;
+}
+.floating-toc-content ul ul ul {
+  margin-top: 0;
+  margin-bottom: 0;
+}
+.floating-toc-content ul ul a {
+  font-size: 12px;
+  color: #555;
+}
+.floating-toc-content ul ul ul a {
+  font-size: 11px;
+  color: #666;
+}
+/* Smooth scrolling */
+html {
+  scroll-behavior: smooth;
+}
+/* Code blocks */
+code {
+  background: #f0f0f0;
+  padding: 0.2em 0.4em;
+  border-radius: 3px;
+  font-family: "Monaco", "Menlo", "Ubuntu Mono", monospace;
+  font-size: 0.9em;
+  margin: 0 0.1em;
+}
+pre {
+  background: #f5f5f5;
+  padding: 1rem;
+  overflow-x: auto;
+  border-radius: 4px;
+  margin: 1em 0;
+}
+pre code {
+  background: none;
+  padding: 0;
+  margin: 0;
+}
+/* Rouge syntax highlighting - GitHub theme, scoped to .highlight containers */
+.highlight {
+  color: #24292e;
+}
+.highlight .c {
+  color: #6a737d;
+  font-style: italic;
+} /* Comment */
+.highlight .err {
+  color: #a61717;
+  background-color: #e3d2d2;
+} /* Error */
+.highlight .k {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword */
+.highlight .l {
+  color: #032f62;
+} /* Literal */
+.highlight .n {
+  color: #24292e;
+} /* Name */
+.highlight .o {
+  color: #d73a49;
+} /* Operator */
+.highlight .p {
+  color: #24292e;
+} /* Punctuation */
+.highlight .cm {
+  color: #6a737d;
+  font-style: italic;
+} /* Comment.Multiline */
+.highlight .cp {
+  color: #6a737d;
+  font-weight: bold;
+} /* Comment.Preproc */
+.highlight .c1 {
+  color: #6a737d;
+  font-style: italic;
+} /* Comment.Single */
+.highlight .cs {
+  color: #6a737d;
+  font-weight: bold;
+  font-style: italic;
+} /* Comment.Special */
+.highlight .gd {
+  color: #24292e;
+  background-color: #ffeef0;
+} /* Generic.Deleted */
+.highlight .ge {
+  color: #24292e;
+  font-style: italic;
+} /* Generic.Emph */
+.highlight .gr {
+  color: #aa0000;
+} /* Generic.Error */
+.highlight .gh {
+  color: #999999;
+  font-weight: bold;
+} /* Generic.Heading */
+.highlight .gi {
+  color: #24292e;
+  background-color: #f0fff4;
+} /* Generic.Inserted */
+.highlight .go {
+  color: #888888;
+} /* Generic.Output */
+.highlight .gp {
+  color: #555555;
+} /* Generic.Prompt */
+.highlight .gs {
+  font-weight: bold;
+} /* Generic.Strong */
+.highlight .gu {
+  color: #aaaaaa;
+} /* Generic.Subheading */
+.highlight .gt {
+  color: #aa0000;
+} /* Generic.Traceback */
+.highlight .kc {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Constant */
+.highlight .kd {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Declaration */
+.highlight .kn {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Namespace */
+.highlight .kp {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Pseudo */
+.highlight .kr {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Reserved */
+.highlight .kt {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Type */
+.highlight .ld {
+  color: #032f62;
+} /* Literal.Date */
+.highlight .m {
+  color: #005cc5;
+} /* Literal.Number */
+.highlight .s {
+  color: #032f62;
+} /* Literal.String */
+.highlight .na {
+  color: #6f42c1;
+} /* Name.Attribute */
+.highlight .nb {
+  color: #005cc5;
+} /* Name.Builtin */
+.highlight .nc {
+  color: #6f42c1;
+  font-weight: bold;
+} /* Name.Class */
+.highlight .no {
+  color: #005cc5;
+} /* Name.Constant */
+.highlight .nd {
+  color: #6f42c1;
+  font-weight: bold;
+} /* Name.Decorator */
+.highlight .ni {
+  color: #800080;
+} /* Name.Entity */
+.highlight .ne {
+  color: #990000;
+  font-weight: bold;
+} /* Name.Exception */
+.highlight .nf {
+  color: #6f42c1;
+} /* Name.Function */
+.highlight .nl {
+  color: #990000;
+} /* Name.Label */
+.highlight .nn {
+  color: #555555;
+} /* Name.Namespace */
+.highlight .nx {
+  color: #6f42c1;
+} /* Name.Other */
+.highlight .py {
+  color: #990000;
+} /* Name.Property */
+.highlight .nt {
+  color: #22863a;
+} /* Name.Tag */
+.highlight .nv {
+  color: #e36209;
+} /* Name.Variable */
+.highlight .ow {
+  color: #d73a49;
+  font-weight: bold;
+} /* Operator.Word */
+.highlight .w {
+  color: #bbbbbb;
+} /* Text.Whitespace */
+.highlight .mf {
+  color: #005cc5;
+} /* Literal.Number.Float */
+.highlight .mh {
+  color: #005cc5;
+} /* Literal.Number.Hex */
+.highlight .mi {
+  color: #005cc5;
+} /* Literal.Number.Integer */
+.highlight .mo {
+  color: #005cc5;
+} /* Literal.Number.Oct */
+.highlight .sb {
+  color: #032f62;
+} /* Literal.String.Backtick */
+.highlight .sc {
+  color: #032f62;
+} /* Literal.String.Char */
+.highlight .sd {
+  color: #032f62;
+} /* Literal.String.Doc */
+.highlight .s2 {
+  color: #032f62;
+} /* Literal.String.Double */
+.highlight .se {
+  color: #032f62;
+} /* Literal.String.Escape */
+.highlight .sh {
+  color: #032f62;
+} /* Literal.String.Heredoc */
+.highlight .si {
+  color: #032f62;
+} /* Literal.String.Interpol */
+.highlight .sx {
+  color: #032f62;
+} /* Literal.String.Other */
+.highlight .sr {
+  color: #22863a;
+} /* Literal.String.Regex */
+.highlight .s1 {
+  color: #032f62;
+} /* Literal.String.Single */
+.highlight .ss {
+  color: #032f62;
+} /* Literal.String.Symbol */
+.highlight .bp {
+  color: #005cc5;
+} /* Name.Builtin.Pseudo */
+.highlight .vc {
+  color: #e36209;
+} /* Name.Variable.Class */
+.highlight .vg {
+  color: #e36209;
+} /* Name.Variable.Global */
+.highlight .vi {
+  color: #e36209;
+} /* Name.Variable.Instance */
+.highlight .il {
+  color: #005cc5;
+} /* Literal.Number.Integer.Long */
+/* Additional Rouge token classes that may be used */
+.highlight .token {
+  color: #5670a0;
+}
+.highlight .token.list {
+  color: #546e9f;
+}
+.highlight .token.punctuation {
+  color: #3e8dad;
+}
+.highlight .token.list.punctuation {
+  color: #e05b78;
+}
+.highlight .token.content {
+  padding: 0;
+}
+/* Nested lists in page content */
+ul ul,
+ol ol,
+ul ol,
+ol ul {
+  padding-left: 1.5em;
+  margin-top: 0.25em;
+}
+/* Page footer */
+.page-footer {
+  background: #f5f5f5;
+  border-top: 1px solid #ddd;
+  padding: 1.5rem;
+  margin-top: 3rem;
+  color: #666;
+  font-size: 0.9em;
+}
+.page-footer p {
+  margin: 0.5em 0;
+}
+.page-footer a {
+  color: #0066cc;
+  text-decoration: none;
+}
+.page-footer a:hover {
+  text-decoration: underline;
+}
+/* Mobile responsive */
+@media (max-width: 768px) {
+  .hamburger-menu {
+    display: flex;
+  }
+  .main-toc,
+  .sidebar {
+    transform: translateX(-100%);
+    z-index: 175;
+  }
+  .main-toc.mobile-open,
+  .sidebar.mobile-open {
+    transform: translateX(0);
+  }
+  body {
+    margin-left: 0;
+  }
+  .floating-toc {
+    left: 0;
+  }
+}
+</style></head>
+  <body>
+<div class="floating-toc" id="floating-toc">
+  <div class="floating-toc-container">
+    <div class="floating-toc-header">
+      <span>Table of Contents 🔻</span>
+    </div>
+    <div class="floating-toc-content" id="floating-toc-content">
+      <!-- Content will be populated by JavaScript -->
+    </div>
+  </div>
+</div>
+<button class="hamburger-menu" id="hamburger-menu" aria-label="Toggle navigation"></button>
+<div class="mobile-menu-overlay" id="mobile-menu-overlay"></div>
+<nav class="main-toc"><ul><li><a href="Home.html">Home</a></li><li><a href="Getting-Started.html">Getting Started</a></li><li><a href="Installation.html">Installation</a></li><li><a href="Usage.html">Usage</a></li><li><a href="Syntax.html">Syntax</a></li><li><a href="Inline-Attribute-Lists.html">Inline Attribute Lists</a></li><li><a href="Modes.html">Modes</a></li><li><a href="Command-Line-Options.html">Command Line Options</a></li><li><a href="Multi-File-Documents.html">Multi-file Documents</a></li><li><a href="Citations.html">Citations</a></li><li><a href="Metadata-Transforms.html">Metadata Transforms</a></li><li><a href="Pandoc-Integration.html">Integrating with Pandoc</a></li><li><a href="Header-IDs.html">Header IDs</a></li><li><a href="C-API.html">C API</a></li><li><a href="Xcode-Integration.html">Xcode Integration</a></li><li><a href="Examples.html">Examples</a></li><li><a href="Plugins.html">Plugins</a></li><li><a href="Troubleshooting.html">Troubleshooting</a></li><li><a href="Credits.html">Credits</a></li></ul></nav>
+    <h1 id="multi-file-documents-with-apex">
+      Multi-file documents with Apex
+    </h1>
+<nav class="page-toc" id="page-toc-top"><ul><li><a href="#multi-file-documents-with-apex">Multi-file documents with Apex</a><ul><li><a href="#using-combine">Using --combine</a><ul><li><a href="#basic-usage-with-multiple-files">Basic usage with multiple files</a></li><li><a href="#using-a-gitbook-style-summarymd">Using a GitBook-style SUMMARY.md</a></li></ul></li><li><a href="#using-mmd-merge-multimarkdown-style">Using --mmd-merge (MultiMarkdown-style)</a><ul><li><a href="#example-mmdmerge-index-file">Example mmd_merge index file</a></li><li><a href="#running-mmd-merge-and-piping-back-to-apex">Running --mmd-merge and piping back to Apex</a></li></ul></li><li><a href="#combining-multiple-files-directly-on-the-command-line">Combining multiple files directly on the command line</a></li><li><a href="#building-multi-file-documents-with-include-syntax">Building multi-file documents with include syntax</a><ul><li><a href="#multimarkdown-include-example">MultiMarkdown include example</a></li><li><a href="#marked-style-include-example">Marked-style include example</a></li><li><a href="#ia-writer-style-include-example">iA Writer-style include example</a></li><li><a href="#combining-includes-with-combine">Combining includes with --combine</a></li></ul></li><li><a href="#choosing-between-combine-mmd-merge-and-includes">Choosing between --combine, --mmd-merge, and includes</a></li></ul></li></ul></nav>
+    <p>
+      Apex can assemble larger documents from many smaller Markdown files. There are two primary tools for this:
+    </p>
+    <ul>
+      <li>
+<strong><code>--combine</code></strong>: Apex’s native Markdown combiner, with optional GitBook-style <code>SUMMARY.md</code> support.
+      </li>
+      <li>
+<strong><code>--mmd-merge</code></strong>: A MultiMarkdown-compatible mode that emulates <code>mmd_merge.pl</code>, reading a plain-text index file to stitch documents together.
+      </li>
+    </ul>
+    <p>
+      Both modes output <strong>raw Markdown</strong>, which you can then pipe back into <code>apex</code> for full HTML rendering.
+    </p>
+<hr />
+    <h2 id="using-combine">
+      Using <code>--combine</code>
+    </h2>
+    <h3 id="basic-usage-with-multiple-files">
+      Basic usage with multiple files
+    </h3>
+    <p>
+      You can pass multiple Markdown files after <code>--combine</code>. Apex will:
+    </p>
+    <ul>
+      <li>
+        Read each file in order
+      </li>
+      <li>
+        Expand any include syntax it supports (Marked, MultiMarkdown, iA Writer)
+      </li>
+      <li>
+        Separate each document with blank lines
+      </li>
+    </ul>
+    <p>
+      Example:
+    </p>
+<pre><code class="highlight language-bash">apex <span class="nt">--combine</span> intro.md chapter1.md chapter2.md <span class="o">&gt;</span> combined.md
+<span class="c"># Then render the combined Markdown:</span>
+apex combined.md <span class="nt">--standalone</span> <span class="nt">--title</span> <span class="s2">"My Book"</span> <span class="nt">-o</span> book.html
+</code></pre>
+  <p>
+    Or in a single pipeline:
+  </p>
+<pre><code class="highlight language-bash">apex <span class="nt">--combine</span> intro.md chapter1.md chapter2.md <span class="se">\</span>
+  | apex <span class="nt">--standalone</span> <span class="nt">--title</span> <span class="s2">"My Book"</span> <span class="nt">-o</span> book.html
+</code></pre>
+<h3 id="using-a-gitbook-style-summarymd">
+  Using a GitBook-style <code>SUMMARY.md</code>
+</h3>
+<p>
+  When one of the inputs to <code>--combine</code> is named <code>SUMMARY.md</code>, Apex treats it as a <strong>GitBook index</strong>. It scans the file for Markdown links and combines the referenced pages in order:
+</p>
+<p>
+  Example <code>SUMMARY.md</code>:
+</p>
+<pre><code class="highlight language-markdown"><span class="gh"># My Book</span>
+<span class="p">
+-</span> <span class="p">[</span><span class="nv">Introduction</span><span class="p">](</span><span class="sx">intro.md</span><span class="p">)</span>
+<span class="p">-</span> <span class="p">[</span><span class="nv">Getting Started</span><span class="p">](</span><span class="sx">getting-started.md</span><span class="p">)</span>
+<span class="p">-</span> <span class="p">[</span><span class="nv">Advanced Topics</span><span class="p">](</span><span class="sx">advanced.md</span><span class="p">)</span>
+<span class="p">  -</span> <span class="p">[</span><span class="nv">Performance</span><span class="p">](</span><span class="sx">performance.md</span><span class="p">)</span>
+<span class="p">  -</span> <span class="p">[</span><span class="nv">Appendix</span><span class="p">](</span><span class="sx">appendix.md</span><span class="p">)</span>
+</code></pre>
+<p>
+  To build your book:
+</p>
+<pre><code class="highlight language-bash">apex <span class="nt">--combine</span> SUMMARY.md <span class="se">\</span>
+  | apex <span class="nt">--standalone</span> <span class="nt">--title</span> <span class="s2">"My Book"</span> <span class="nt">-o</span> book.html
+</code></pre>
+<p>
+<code>--combine</code> will:
+</p>
+<ul>
+  <li>
+    Follow the link targets (<code>intro.md</code>, <code>getting-started.md</code>, etc.)
+  </li>
+  <li>
+    Expand any file includes inside those documents
+  </li>
+  <li>
+    Output a single Markdown stream to stdout, ready for final processing
+  </li>
+</ul>
+<hr />
+<h2 id="using-mmd-merge-multimarkdown-style">
+  Using <code>--mmd-merge</code> (MultiMarkdown-style)
+</h2>
+<p>
+<code>--mmd-merge</code> emulates the original MultiMarkdown <code>mmd_merge.pl</code> script. It reads one or more <strong>plain text index files</strong> and:
+</p>
+<ul>
+  <li>
+    Skips blank lines
+  </li>
+  <li>
+    Treats lines whose first non-whitespace character is <code>#</code> as <strong>comments</strong>
+  </li>
+  <li>
+    Treats all other lines as filenames to include
+  </li>
+  <li>
+    Uses <strong>indentation</strong> (tabs or groups of four spaces) to increase the header level of the included file
+  </li>
+</ul>
+<h3 id="example-mmdmerge-index-file">
+  Example mmd_merge index file
+</h3>
+<pre><code class="highlight language-text">metadata.txt
+Chapter-1.md
+    sub-chapter-1-1.md
+    sub-chapter-1-2.md
+Chapter-2.md
+    sub-chapter-2-1.md
+    sub-chapter-2-2.md
+FAQ.md
+Acknowledgments.md
+</code></pre>
+<p>
+  Behavior:
+</p>
+<ul>
+  <li>
+<code>metadata.txt</code>, <code>Chapter-1.md</code>, <code>Chapter-2.md</code>, <code>FAQ.md</code>, <code>Acknowledgments.md</code> are included at their original heading levels.
+  </li>
+  <li>
+    Files indented by <strong>one tab or four spaces</strong> (<code>sub-chapter-1-1.md</code>, <code>sub-chapter-1-2.md</code>, etc.) have all headings shifted <strong>down one level</strong>:
+    <ul>
+      <li>
+<code># Heading</code> → <code>## Heading</code>
+      </li>
+      <li>
+<code>## Subheading</code> → <code>### Subheading</code>, etc.
+      </li>
+    </ul>
+  </li>
+</ul>
+<p>
+  Comments are supported:
+</p>
+<pre><code class="highlight language-text"># This is my book index
+metadata.txt
+# Part 1
+Chapter-1.md
+    sub-chapter-1-1.md
+</code></pre>
+<p>
+  Lines starting with <code>#</code> after optional whitespace are ignored.
+</p>
+<h3 id="running-mmd-merge-and-piping-back-to-apex">
+  Running <code>--mmd-merge</code> and piping back to Apex
+</h3>
+<p>
+  Assuming the index file above is named <code>index.txt</code>:
+</p>
+<pre><code class="highlight language-bash">apex <span class="nt">--mmd-merge</span> index.txt <span class="se">\</span>
+  | apex <span class="nt">--mode</span> mmd <span class="nt">--standalone</span> <span class="nt">--title</span> <span class="s2">"My MMD Book"</span> <span class="nt">-o</span> book.html
+</code></pre>
+<p>
+  You can also merge multiple index files:
+</p>
+<pre><code class="highlight language-bash">apex <span class="nt">--mmd-merge</span> part1.txt part2.txt <span class="se">\</span>
+  | apex <span class="nt">--mode</span> mmd <span class="nt">--standalone</span> <span class="nt">--title</span> <span class="s2">"My Two-Part Book"</span> <span class="nt">-o</span> book.html
+</code></pre>
+<p>
+  Notes:
+</p>
+<ul>
+  <li>
+<code>--mmd-merge</code> does <strong>not</strong> itself expand includes; it just concatenates files and shifts headings.
+  </li>
+  <li>
+    For full MultiMarkdown semantics, use <code>--mode mmd</code> when piping the merged Markdown back into Apex.
+  </li>
+</ul>
+<hr />
+<h2 id="combining-multiple-files-directly-on-the-command-line">
+  Combining multiple files directly on the command line
+</h2>
+<p>
+  You don’t need an index file to combine documents. With <code>--combine</code>, you can just list the files in order:
+</p>
+<pre><code class="highlight language-bash">apex <span class="nt">--combine</span> metadata.md intro.md chapter1.md chapter2.md <span class="se">\</span>
+  | apex <span class="nt">--standalone</span> <span class="nt">--title</span> <span class="s2">"Direct Combine"</span> <span class="nt">-o</span> book.html
+</code></pre>
+<p>
+  This approach works well when:
+</p>
+<ul>
+  <li>
+    The order is simple and fixed
+  </li>
+  <li>
+    You don’t need header-level shifting based on indentation
+  </li>
+</ul>
+<p>
+  If you need finer control over header levels, use:
+</p>
+<ul>
+  <li>
+<code>--mmd-merge</code> with an index file (indentation-based)
+  </li>
+  <li>
+    Or explicit headings inside your individual files
+  </li>
+</ul>
+<hr />
+<h2 id="building-multi-file-documents-with-include-syntax">
+  Building multi-file documents with include syntax
+</h2>
+<p>
+  In addition to <code>--combine</code> and <code>--mmd-merge</code>, Apex supports <strong>file includes</strong> inside Markdown. This lets you treat one file as the “root” and pull in other files at specific points.
+</p>
+<p>
+  Supported include syntaxes:
+</p>
+<ul>
+  <li>
+<strong>    MultiMarkdown</strong>: <code>{{file.md}}</code>
+  </li>
+  <li>
+<strong>    Marked</strong>: <code>(Markdown include),</code> (code include), `` (raw HTML)
+  </li>
+  <li>
+<strong>    iA Writer</strong>: <code>/file.md</code> at the start of a line
+  </li>
+</ul>
+<h3 id="multimarkdown-include-example">
+  MultiMarkdown include example
+</h3>
+<p>
+<code>book.md</code>:
+</p>
+<pre><code class="highlight language-markdown">Title: My Included Book
+{{metadata.md}}
+{{intro.md}}
+{{chapter1.md}}
+{{chapter2.md}}
+{{appendix.md}}
+</code></pre>
+<p>
+  Build and render:
+</p>
+<pre><code class="highlight language-bash">apex book.md <span class="nt">--standalone</span> <span class="nt">--title</span> <span class="s2">"My Included Book"</span> <span class="nt">-o</span> book.html
+</code></pre>
+<h3 id="marked-style-include-example">
+  Marked-style include example
+</h3>
+<p>
+<code>book.md</code>:
+</p>
+<pre><code class="highlight language-markdown"><span class="gh"># My Marked-Style Book</span>
+</code></pre>
+<p>
+  Render:
+</p>
+<pre><code class="highlight language-bash">apex book.md <span class="nt">--standalone</span> <span class="nt">--title</span> <span class="s2">"My Marked Book"</span> <span class="nt">-o</span> book.html
+</code></pre>
+<h3 id="ia-writer-style-include-example">
+  iA Writer-style include example
+</h3>
+<p>
+<code>book.md</code>:
+</p>
+<pre><code class="highlight language-markdown"><span class="gh"># My iA Writer-Style Book</span>
+/intro.md
+/chapter1.md
+/chapter2.md
+</code></pre>
+<p>
+  Render:
+</p>
+<pre><code class="highlight language-bash">apex book.md <span class="nt">--standalone</span> <span class="nt">--title</span> <span class="s2">"My iA Book"</span> <span class="nt">-o</span> book.html
+</code></pre>
+<h3 id="combining-includes-with-combine">
+  Combining includes with <code>--combine</code>
+</h3>
+<p>
+  You can combine both approaches: use includes inside files and then use <code>--combine</code> on top:
+</p>
+<pre><code class="highlight language-bash"><span class="c"># Each chapter uses includes, and we combine chapters into one big stream:</span>
+apex <span class="nt">--combine</span> part1.md part2.md part3.md <span class="se">\</span>
+  | apex <span class="nt">--standalone</span> <span class="nt">--title</span> <span class="s2">"Big Included Book"</span> <span class="nt">-o</span> book.html
+</code></pre>
+<p>
+  This is especially useful when:
+</p>
+<ul>
+  <li>
+    Each part has its own local includes
+  </li>
+  <li>
+    You want a single final HTML output
+  </li>
+</ul>
+<hr />
+<h2 id="choosing-between-combine-mmd-merge-and-includes">
+  Choosing between <code>--combine</code>, <code>--mmd-merge</code>, and includes
+</h2>
+<ul>
+  <li>
+    <p>
+<strong>      Use <code>--combine</code></strong> when:
+    </p>
+    <ul>
+      <li>
+        You want Apex to expand includes
+      </li>
+      <li>
+        You like GitBook-style <code>SUMMARY.md</code> navigation
+      </li>
+      <li>
+        You just want to pass multiple files and let Apex concatenate them
+      </li>
+    </ul>
+  </li>
+  <li>
+    <p>
+<strong>      Use <code>--mmd-merge</code></strong> when:
+    </p>
+    <ul>
+      <li>
+        You have existing MultiMarkdown workflows or <code>mmd_merge.pl</code> index files
+      </li>
+      <li>
+        You want indentation-based header level shifting
+      </li>
+      <li>
+        You want a very simple, text-only index format
+      </li>
+    </ul>
+  </li>
+  <li>
+    <p>
+<strong>      Use include syntax</strong> when:
+    </p>
+    <ul>
+      <li>
+        You want one “master” document that controls where content appears
+      </li>
+      <li>
+        You prefer to keep structure inside Markdown files rather than an external index
+      </li>
+    </ul>
+  </li>
+</ul>
+<p>
+  All three can be mixed and matched, and all ultimately produce <strong>Markdown</strong> that you can feed back into <code>apex</code> to generate the final HTML, PDF (via Pandoc), or other formats in your toolchain.
+</p>
+<script>
+// Hamburger menu functionality
+(function() {
+  function initHamburgerMenu() {
+    var hamburger = document.getElementById('hamburger-menu');
+    var sidebar = document.querySelector('.main-toc, .sidebar');
+    var overlay = document.getElementById('mobile-menu-overlay');
+    if (!hamburger || !sidebar) return;
+    function toggleMenu() {
+      var isOpen = sidebar.classList.contains('mobile-open');
+      if (isOpen) {
+        sidebar.classList.remove('mobile-open');
+        hamburger.classList.remove('active');
+        if (overlay) overlay.classList.remove('active');
+      } else {
+        sidebar.classList.add('mobile-open');
+        hamburger.classList.add('active');
+        if (overlay) overlay.classList.add('active');
+      }
+    }
+    hamburger.addEventListener('click', function(e) {
+      e.stopPropagation();
+      toggleMenu();
+    });
+    if (overlay) {
+      overlay.addEventListener('click', function() {
+        toggleMenu();
+      });
+    }
+    // Close menu when clicking on a sidebar link (mobile only)
+    if (window.innerWidth <= 768) {
+      var sidebarLinks = sidebar.querySelectorAll('a');
+      sidebarLinks.forEach(function(link) {
+        link.addEventListener('click', function() {
+          setTimeout(function() {
+            sidebar.classList.remove('mobile-open');
+            hamburger.classList.remove('active');
+            if (overlay) overlay.classList.remove('active');
+          }, 100);
+        });
+      });
+    }
+    // Close menu on window resize if going to desktop
+    window.addEventListener('resize', function() {
+      if (window.innerWidth > 768) {
+        sidebar.classList.remove('mobile-open');
+        hamburger.classList.remove('active');
+        if (overlay) overlay.classList.remove('active');
+      }
+    });
+  }
+  // Initialize when DOM is ready
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', initHamburgerMenu);
+  } else {
+    initHamburgerMenu();
+  }
+})();
+</script>
+<script>
+  (function() {
+    // Clone the page TOC for floating TOC
+    function initFloatingTOC() {
+      var pageTOC = document.getElementById('page-toc-top');
+      var floatingTOCContent = document.getElementById('floating-toc-content');
+      var floatingTOC = document.getElementById('floating-toc');
+      if (!pageTOC || !floatingTOCContent || !floatingTOC) return;
+      // Clone the TOC structure
+      var tocClone = pageTOC.cloneNode(true);
+      tocClone.id = 'floating-toc-clone';
+      floatingTOCContent.appendChild(tocClone);
+      // Update all links to use smooth scrolling
+      var allTOCLinks = document.querySelectorAll('.page-toc a, .floating-toc-content a');
+      allTOCLinks.forEach(function(link) {
+        link.addEventListener('click', function(e) {
+          var href = this.getAttribute('href');
+          if (href && href.startsWith('#')) {
+            e.preventDefault();
+            var targetId = href.substring(1);
+            var targetElement = document.getElementById(targetId);
+            if (targetElement) {
+              var offset = 20; // Offset from top
+              // Function to calculate absolute position from document top
+              function getAbsoluteTop(element) {
+                var top = 0;
+                while (element) {
+                  top += element.offsetTop;
+                  element = element.offsetParent;
+                }
+                return top;
+              }
+              var absoluteTop = getAbsoluteTop(targetElement);
+              var scrollTop = window.pageYOffset || document.documentElement.scrollTop;
+              var offsetPosition = absoluteTop - offset;
+              // Only scroll if we're not already at the target position
+              if (Math.abs(scrollTop - offsetPosition) > 10) {
+                window.scrollTo({
+                  top: Math.max(0, offsetPosition),
+                  behavior: 'smooth'
+                });
+              }
+              // Update URL hash without triggering scroll
+              if (history.pushState) {
+                history.pushState(null, null, href);
+              }
+            }
+          }
+        });
+      });
+      // Handle scroll to show/hide floating TOC
+      var tocTop = pageTOC.getBoundingClientRect().top + window.pageYOffset;
+      var tocBottom = tocTop + pageTOC.offsetHeight;
+      function updateFloatingTOC() {
+        var scrollY = window.pageYOffset || document.documentElement.scrollTop;
+        if (scrollY > tocBottom) {
+          floatingTOC.classList.add('visible');
+        } else {
+          floatingTOC.classList.remove('visible');
+        }
+      }
+      // Throttle scroll events
+      var ticking = false;
+      window.addEventListener('scroll', function() {
+        if (!ticking) {
+          window.requestAnimationFrame(function() {
+            updateFloatingTOC();
+            ticking = false;
+          });
+          ticking = true;
+        }
+      });
+      // Initial check
+      updateFloatingTOC();
+    }
+    // Initialize when DOM is ready
+    if (document.readyState === 'loading') {
+      document.addEventListener('DOMContentLoaded', initFloatingTOC);
+    } else {
+      initFloatingTOC();
+    }
+  })();
+</script>
+<footer class="page-footer"><p>Copyright 2025 Brett Terpstra, All Rights Reserved | MIT License</p></footer></body>
+</html>