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/Troubleshooting.html ADDED Viewed

@@ -0,0 +1,1454 @@
+<!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="troubleshooting">
+      Troubleshooting
+    </h1>
+<nav class="page-toc" id="page-toc-top"><ul><li><a href="#troubleshooting">Troubleshooting</a><ul><li><a href="#build-issues">Build Issues</a><ul><li><a href="#cmake-not-found">CMake Not Found</a></li><li><a href="#compilation-errors">Compilation Errors</a></li><li><a href="#linking-errors">Linking Errors</a></li></ul></li><li><a href="#runtime-issues">Runtime Issues</a><ul><li><a href="#table-not-rendering">Table Not Rendering</a></li><li><a href="#header-ids-not-generated">Header IDs Not Generated</a></li><li><a href="#math-not-rendering">Math Not Rendering</a></li><li><a href="#wiki-links-not-working">Wiki Links Not Working</a></li><li><a href="#file-includes-not-working">File Includes Not Working</a></li></ul></li><li><a href="#output-issues">Output Issues</a><ul><li><a href="#no-output">No Output</a></li><li><a href="#html-not-formatted">HTML Not Formatted</a></li><li><a href="#missing-styles">Missing Styles</a></li></ul></li><li><a href="#mode-specific-issues">Mode-Specific Issues</a><ul><li><a href="#feature-not-available">Feature Not Available</a></li><li><a href="#id-format-wrong">ID Format Wrong</a></li></ul></li><li><a href="#api-issues">API Issues</a><ul><li><a href="#memory-leaks">Memory Leaks</a></li><li><a href="#thread-safety">Thread Safety</a></li><li><a href="#framework-not-found-xcode">Framework Not Found (Xcode)</a></li></ul></li><li><a href="#performance-issues">Performance Issues</a><ul><li><a href="#slow-conversion">Slow Conversion</a></li><li><a href="#high-memory-usage">High Memory Usage</a></li></ul></li><li><a href="#getting-help">Getting Help</a></li><li><a href="#related">Related</a></li></ul></li></ul></nav>
+    <p>
+      Common issues and solutions when using Apex.
+    </p>
+    <h2 id="build-issues">
+      Build Issues
+    </h2>
+    <h3 id="cmake-not-found">
+      CMake Not Found
+    </h3>
+    <p>
+<strong>      Error:</strong> <code>cmake: command not found</code>
+    </p>
+    <p>
+<strong>      Solution:</strong>
+    </p>
+    <ul>
+      <li>
+        macOS: <code>brew install cmake</code>
+      </li>
+      <li>
+        Ubuntu/Debian: <code>sudo apt-get install cmake</code>
+      </li>
+      <li>
+        Fedora: <code>sudo dnf install cmake</code>
+      </li>
+    </ul>
+    <h3 id="compilation-errors">
+      Compilation Errors
+    </h3>
+    <p>
+<strong>      Error:</strong> Compiler not found or incompatible
+    </p>
+    <p>
+<strong>      Solution:</strong>
+    </p>
+    <ul>
+      <li>
+        macOS: Install Xcode Command Line Tools: <code>xcode-select --install</code>
+      </li>
+      <li>
+        Linux: Install build essentials: <code>sudo apt-get install build-essential</code>
+      </li>
+    </ul>
+    <h3 id="linking-errors">
+      Linking Errors
+    </h3>
+    <p>
+<strong>      Error:</strong> <code>undefined reference to apex_*</code>
+    </p>
+    <p>
+<strong>      Solution:</strong>
+    </p>
+    <ul>
+      <li>
+        Ensure library is built: <code>make</code> in build directory
+      </li>
+      <li>
+        Check library path: <code>LD_LIBRARY_PATH</code> (Linux) or <code>DYLD_LIBRARY_PATH</code> (macOS)
+      </li>
+      <li>
+        Verify linking: <code>-lapex</code> flag is present
+      </li>
+    </ul>
+    <h2 id="runtime-issues">
+      Runtime Issues
+    </h2>
+    <h3 id="table-not-rendering">
+      Table Not Rendering
+    </h3>
+    <p>
+<strong>      Problem:</strong> Tables appear as code or plain text
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Ensure tables are enabled: Don’t use <code>--no-tables</code>
+      </li>
+      <li>
+        Check mode: Some modes disable tables
+      </li>
+      <li>
+        Verify table syntax: Requires proper pipe alignment
+      </li>
+    </ul>
+    <h3 id="header-ids-not-generated">
+      Header IDs Not Generated
+    </h3>
+    <p>
+<strong>      Problem:</strong> Headers don’t have <code>id</code> attributes
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Check if IDs are disabled: Remove <code>--no-ids</code> flag
+      </li>
+      <li>
+        Verify mode: All modes generate IDs by default
+      </li>
+      <li>
+        Check manual ID syntax: May be incorrectly formatted
+      </li>
+    </ul>
+    <h3 id="math-not-rendering">
+      Math Not Rendering
+    </h3>
+    <p>
+<strong>      Problem:</strong> Math appears as plain text
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Ensure math is enabled: Don’t use <code>--no-math</code>
+      </li>
+      <li>
+        Check mode: CommonMark and GFM modes disable math
+      </li>
+      <li>
+        Verify MathJax/KaTeX: Apex outputs HTML, you need a math renderer
+      </li>
+    </ul>
+    <h3 id="wiki-links-not-working">
+      Wiki Links Not Working
+    </h3>
+    <p>
+<strong>      Problem:</strong> Wiki links appear as plain text
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Enable wiki links: Use <code>--wikilinks</code> flag (disabled by default in all modes)
+      </li>
+      <li>
+        Check syntax: <code>[[Page]]</code> not <code>[Page]</code>
+      </li>
+      <li>
+        Example: <code>apex document.md --wikilinks</code>
+      </li>
+    </ul>
+    <h3 id="file-includes-not-working">
+      File Includes Not Working
+    </h3>
+    <p>
+<strong>      Problem:</strong> Include syntax not processed
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Enable includes: Use <code>--includes</code> flag (enabled by default in unified mode)
+      </li>
+      <li>
+        Check file paths: Relative to document or use <code>base_directory</code> in API
+      </li>
+      <li>
+        Verify syntax: `` or <code>{{file.md}}</code>
+      </li>
+    </ul>
+    <h2 id="output-issues">
+      Output Issues
+    </h2>
+    <h3 id="no-output">
+      No Output
+    </h3>
+    <p>
+<strong>      Problem:</strong> Command produces no output
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Check input: Verify file exists or stdin has content
+      </li>
+      <li>
+        Check errors: Run with verbose output if available
+      </li>
+      <li>
+        Verify mode: Some modes may filter content
+      </li>
+    </ul>
+    <h3 id="html-not-formatted">
+      HTML Not Formatted
+    </h3>
+    <p>
+<strong>      Problem:</strong> HTML is all on one line
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Use <code>--pretty</code> flag for formatted output
+      </li>
+      <li>
+        Check if pretty printing is disabled in options
+      </li>
+    </ul>
+    <h3 id="missing-styles">
+      Missing Styles
+    </h3>
+    <p>
+<strong>      Problem:</strong> Standalone document has no styling
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Add stylesheet: <code>--style styles.css</code>
+      </li>
+      <li>
+        Use inline styles: Apex includes basic default styles
+      </li>
+      <li>
+        Check CSS path: Ensure file exists and path is correct
+      </li>
+    </ul>
+    <h2 id="mode-specific-issues">
+      Mode-Specific Issues
+    </h2>
+    <h3 id="feature-not-available">
+      Feature Not Available
+    </h3>
+    <p>
+<strong>      Problem:</strong> Syntax feature doesn’t work
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Check mode: Feature may not be available in current mode
+      </li>
+      <li>
+        Switch to unified mode: <code>--mode unified</code> has all features
+      </li>
+      <li>
+        See <a href="Modes.html">Modes</a> for feature availability
+      </li>
+    </ul>
+    <h3 id="id-format-wrong">
+      ID Format Wrong
+    </h3>
+    <p>
+<strong>      Problem:</strong> Header IDs don’t match expected format
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Check mode: Each mode has its own ID format
+      </li>
+      <li>
+        Override format: Use <code>--id-format</code> in unified mode
+      </li>
+      <li>
+        See <a href="Header-IDs.html">Header IDs</a> for format details
+      </li>
+    </ul>
+    <h2 id="api-issues">
+      API Issues
+    </h2>
+    <h3 id="memory-leaks">
+      Memory Leaks
+    </h3>
+    <p>
+<strong>      Problem:</strong> Application memory usage grows
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Free all strings: Always call <code>apex_free_string()</code> on returned strings
+      </li>
+      <li>
+        Check for NULL: Don’t free NULL pointers (safe, but unnecessary)
+      </li>
+      <li>
+        Reuse options: Create options once, reuse for multiple conversions
+      </li>
+    </ul>
+    <h3 id="thread-safety">
+      Thread Safety
+    </h3>
+    <p>
+<strong>      Problem:</strong> Crashes or incorrect output in multi-threaded code
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Use separate options: Each thread needs its own <code>apex_options</code>
+      </li>
+      <li>
+        Don’t share nodes: Document nodes are not thread-safe
+      </li>
+      <li>
+        See <a href="C-API.html">C API</a> for thread safety details
+      </li>
+    </ul>
+    <h3 id="framework-not-found-xcode">
+      Framework Not Found (Xcode)
+    </h3>
+    <p>
+<strong>      Problem:</strong> <code>Apex.framework</code> not found at runtime
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Embed framework: Set to “Embed &amp; Sign” in Xcode
+      </li>
+      <li>
+        Check search paths: Verify framework search paths
+      </li>
+      <li>
+        Verify architecture: Ensure framework matches app architecture
+      </li>
+    </ul>
+    <h2 id="performance-issues">
+      Performance Issues
+    </h2>
+    <h3 id="slow-conversion">
+      Slow Conversion
+    </h3>
+    <p>
+<strong>      Problem:</strong> Conversion takes too long
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Disable unused features: Turn off extensions you don’t need
+      </li>
+      <li>
+        Check input size: Large documents take longer
+      </li>
+      <li>
+        Profile: Use profiling tools to identify bottlenecks
+      </li>
+    </ul>
+    <p>
+      You can also enable Apex’s built-in profiling output with environment variables: setting <code>APEX_PROFILE=1</code> (or <code>yes</code>/<code>true</code>) will print per-phase timings from the core converter (e.g. metadata, citations, autolinks) to stderr, while <code>APEX_PROFILE_PLUGINS=1</code> enables detailed timing for plugin execution, including a total time for each plugin phase (<code>pre_parse</code> and <code>post_render</code>) and individual timings for every discovered plugin; this is especially useful for tracking down slow external handlers or regex plugins—run commands like <code>APEX_PROFILE_PLUGINS=1 apex --plugins input.md &gt; /dev/null</code> to capture just the timing lines.
+    </p>
+    <h3 id="high-memory-usage">
+      High Memory Usage
+    </h3>
+    <p>
+<strong>      Problem:</strong> Application uses too much memory
+    </p>
+    <p>
+<strong>      Solutions:</strong>
+    </p>
+    <ul>
+      <li>
+        Free strings promptly: Don’t keep HTML strings longer than needed
+      </li>
+      <li>
+        Process in chunks: For very large documents, consider splitting
+      </li>
+      <li>
+        Check for leaks: Use memory profiling tools
+      </li>
+    </ul>
+    <h2 id="getting-help">
+      Getting Help
+    </h2>
+    <p>
+      If you encounter issues not covered here:
+    </p>
+    <ol>
+      <li>
+        Check the <a href="Syntax.html">Syntax</a> page for correct syntax
+      </li>
+      <li>
+        Review <a href="Modes.html">Modes</a> to ensure feature is available
+      </li>
+      <li>
+        See <a href="Command-Line-Options.html">Command Line Options</a> for flag usage
+      </li>
+      <li>
+        Check <a href="C-API.html">C API</a> for programmatic issues
+      </li>
+    </ol>
+    <h2 id="related">
+      Related
+    </h2>
+    <ul>
+      <li>
+<a href="Installation.html">        Installation</a> - Build and installation issues
+      </li>
+      <li>
+<a href="Usage.html">        Usage</a> - Usage examples
+      </li>
+      <li>
+<a href="C-API.html">        C API</a> - API-specific troubleshooting
+      </li>
+    </ul>
+  <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>