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

@@ -0,0 +1,1531 @@
+<!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="metadata-transforms">
+      Metadata Transforms
+    </h1>
+<nav class="page-toc" id="page-toc-top"><ul><li><a href="#metadata-transforms">Metadata Transforms</a><ul><li><a href="#metadata-sources">Metadata Sources</a></li><li><a href="#basic-usage">Basic Usage</a></li><li><a href="#enabling-transforms">Enabling Transforms</a></li><li><a href="#case-transforms">Case Transforms</a><ul><li><a href="#upper">upper</a></li><li><a href="#lower">lower</a></li><li><a href="#title">title</a></li><li><a href="#capitalize">capitalize</a></li></ul></li><li><a href="#string-manipulation">String Manipulation</a><ul><li><a href="#trim">trim</a></li><li><a href="#slug-slugify">slug / slugify</a></li><li><a href="#replaceoldnew-replaceregexpatternreplacement">replace(OLD,NEW) / replace(regex:PATTERN,REPLACEMENT)</a></li><li><a href="#substringstartend-substrstartend">substring(START,END) / substr(START,END)</a></li><li><a href="#truncatelengthsuffix">truncate(LENGTH,SUFFIX)</a></li><li><a href="#reverse">reverse</a></li></ul></li><li><a href="#array-transforms">Array Transforms</a><ul><li><a href="#splitdelimiter">split(DELIMITER)</a></li><li><a href="#joindelimiter">join(DELIMITER)</a></li><li><a href="#first">first</a></li><li><a href="#last">last</a></li><li><a href="#slicestartlength">slice(START,LENGTH)</a></li></ul></li><li><a href="#utility-transforms">Utility Transforms</a><ul><li><a href="#defaultvalue">default(VALUE)</a></li><li><a href="#escape-htmlescape">escape / html_escape</a></li><li><a href="#basename">basename</a></li><li><a href="#urlencode">urlencode</a></li><li><a href="#urldecode">urldecode</a></li><li><a href="#prefixvalue">prefix(VALUE)</a></li><li><a href="#suffixvalue">suffix(VALUE)</a></li><li><a href="#removestring">remove(STRING)</a></li><li><a href="#repeatcount">repeat(COUNT)</a></li></ul></li><li><a href="#formatting-transforms">Formatting Transforms</a><ul><li><a href="#formatformatstring">format(FORMAT_STRING)</a></li><li><a href="#length">length</a></li><li><a href="#padwidthchar">pad(WIDTH,CHAR)</a></li><li><a href="#containsstring">contains(STRING)</a></li></ul></li><li><a href="#datetime-transforms">Date/Time Transforms</a><ul><li><a href="#strftimeformat">strftime(FORMAT)</a></li></ul></li><li><a href="#transform-chaining">Transform Chaining</a></li><li><a href="#notes">Notes</a></li></ul></li></ul></nav>
+    <p>
+      Metadata transforms allow you to modify metadata values using the <code>[%key:transform]</code> syntax. Transforms can be chained together, and many accept optional parameters.
+    </p>
+    <h2 id="metadata-sources">
+      Metadata Sources
+    </h2>
+    <p>
+      Metadata can come from three sources (merged in priority order):
+    </p>
+    <ol>
+      <li>
+<strong>        Command-line</strong>: <code>--meta KEY=VALUE</code> (highest priority)
+      </li>
+      <li>
+<strong>        Document</strong>: Metadata embedded in the document (YAML, MMD, or Pandoc format)
+      </li>
+      <li>
+<strong>        External file</strong>: <code>--meta-file FILE</code> (lowest priority)
+      </li>
+    </ol>
+    <p>
+      See <a href="Command-Line-Options.html">Command Line Options</a> for details on <code>--meta-file</code> and <code>--meta</code> flags.
+    </p>
+    <h2 id="basic-usage">
+      Basic Usage
+    </h2>
+    <p>
+      The basic syntax is <code>[%key:transform]</code> where <code>key</code> is a metadata key and <code>transform</code> is one of the available transforms:
+    </p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">hello world</span>
+<span class="nn">---</span>
+<span class="gh"># [%title:upper]</span>
+<span class="c">&lt;!-- Outputs: # HELLO WORLD --&gt;</span>
+</code></pre>
+  <p>
+    Transforms can be chained using colons:
+  </p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">hello world</span>
+<span class="nn">---</span>
+<span class="gh"># [%title🐢split( ):first]</span>
+<span class="c">&lt;!-- Outputs: # Hello --&gt;</span>
+</code></pre>
+<h2 id="enabling-transforms">
+  Enabling Transforms
+</h2>
+<p>
+  Metadata transforms are <strong>enabled by default in unified mode</strong>. For other modes, use the <code>--transforms</code> flag:
+</p>
+<pre><code class="highlight language-bash">apex document.md <span class="nt">--transforms</span>
+</code></pre>
+<p>
+  To disable transforms (even in unified mode), use <code>--no-transforms</code>.
+</p>
+<h2 id="case-transforms">
+  Case Transforms
+</h2>
+<h3 id="upper">
+<code>upper</code>
+</h3>
+<p>
+  Converts the value to uppercase.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">hello world</span>
+<span class="nn">---</span>
+[%title:upper]
+<span class="c">&lt;!-- Outputs: HELLO WORLD --&gt;</span>
+</code></pre>
+<h3 id="lower">
+<code>lower</code>
+</h3>
+<p>
+  Converts the value to lowercase.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">HELLO WORLD</span>
+<span class="nn">---</span>
+[%title:lower]
+<span class="c">&lt;!-- Outputs: hello world --&gt;</span>
+</code></pre>
+<h3 id="title">
+<code>title</code>
+</h3>
+<p>
+  Converts the value to title case (capitalizes first letter of each word).
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">hello world</span>
+<span class="nn">---</span>
+[%title:title]
+<span class="c">&lt;!-- Outputs: Hello World --&gt;</span>
+</code></pre>
+<h3 id="capitalize">
+<code>capitalize</code>
+</h3>
+<p>
+  Capitalizes only the first letter of the value.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">hello world</span>
+<span class="nn">---</span>
+[%title:capitalize]
+<span class="c">&lt;!-- Outputs: Hello world --&gt;</span>
+</code></pre>
+<h2 id="string-manipulation">
+  String Manipulation
+</h2>
+<h3 id="trim">
+<code>trim</code>
+</h3>
+<p>
+  Removes leading and trailing whitespace.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s2">"</span><span class="nv">  </span><span class="s">hello</span><span class="nv"> </span><span class="s">world</span><span class="nv">  </span><span class="s">"</span>
+<span class="nn">---</span>
+[%title:trim]
+<span class="c">&lt;!-- Outputs: hello world --&gt;</span>
+</code></pre>
+<h3 id="slug-slugify">
+<code>slug</code> / <code>slugify</code>
+</h3>
+<p>
+  Converts the value to a URL-friendly slug (lowercase, spaces and special characters replaced with hyphens).
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">My Great Post!</span>
+<span class="nn">---</span>
+[%title:slug]
+<span class="c">&lt;!-- Outputs: my-great-post --&gt;</span>
+</code></pre>
+<h3 id="replaceoldnew-replaceregexpatternreplacement">
+<code>replace(OLD,NEW)</code> / <code>replace(regex:PATTERN,REPLACEMENT)</code>
+</h3>
+<p>
+  Replaces occurrences of <code>OLD</code> with <code>NEW</code>. Supports both simple string replacement and regex patterns.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">url</span><span class="pi">:</span> <span class="s">http://example.com</span>
+<span class="nn">---</span>
+[%url:replace(http:,https:)]
+<span class="c">&lt;!-- Outputs: https://example.com --&gt;</span>
+</code></pre>
+<p>
+<strong>  Regex replacement:</strong>
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">text</span><span class="pi">:</span> <span class="s">Hello 123 World</span>
+<span class="nn">---</span>
+[%text:replace(regex:[0-9]+,N)]
+<span class="c">&lt;!-- Outputs: Hello N World --&gt;</span>
+</code></pre>
+<h3 id="substringstartend-substrstartend">
+<code>substring(START,END)</code> / <code>substr(START,END)</code>
+</h3>
+<p>
+  Extracts a substring. Supports negative indices (from end).
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">Hello World</span>
+<span class="nn">---</span>
+[%title:substr(0,5)]
+<span class="c">&lt;!-- Outputs: Hello --&gt;</span>
+[%title:substr(-5)]
+<span class="c">&lt;!-- Outputs: World (last 5 characters) --&gt;</span>
+</code></pre>
+<h3 id="truncatelengthsuffix">
+<code>truncate(LENGTH,SUFFIX)</code>
+</h3>
+<p>
+  Truncates the value to the specified length, optionally appending a suffix.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">This is a very long title</span>
+<span class="nn">---</span>
+[%title:truncate(15,...)]
+<span class="c">&lt;!-- Outputs: This is a very... --&gt;</span>
+</code></pre>
+<h3 id="reverse">
+<code>reverse</code>
+</h3>
+<p>
+  Reverses the order of characters in the value.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">text</span><span class="pi">:</span> <span class="s">Hello</span>
+<span class="nn">---</span>
+[%text:reverse]
+<span class="c">&lt;!-- Outputs: olleH --&gt;</span>
+</code></pre>
+<h2 id="array-transforms">
+  Array Transforms
+</h2>
+<h3 id="splitdelimiter">
+<code>split(DELIMITER)</code>
+</h3>
+<p>
+  Splits a string into an array using the specified delimiter (default: space).
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">tags</span><span class="pi">:</span> <span class="s">tag1,tag2,tag3</span>
+<span class="nn">---</span>
+[%tags:split(,)]
+<span class="c">&lt;!-- Outputs: tag1 (first element as representation) --&gt;</span>
+<span class="c">&lt;!-- Use with :first, :last, :slice, or :join to work with the array --&gt;</span>
+</code></pre>
+<h3 id="joindelimiter">
+<code>join(DELIMITER)</code>
+</h3>
+<p>
+  Joins an array into a string using the specified delimiter.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">tags</span><span class="pi">:</span> <span class="s">tag1,tag2,tag3</span>
+<span class="nn">---</span>
+[%tags:split(,):join( | )]
+<span class="c">&lt;!-- Outputs: tag1 | tag2 | tag3 --&gt;</span>
+</code></pre>
+<h3 id="first">
+<code>first</code>
+</h3>
+<p>
+  Returns the first element of an array.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">tags</span><span class="pi">:</span> <span class="s">tag1,tag2,tag3</span>
+<span class="nn">---</span>
+[%tags:split(,):first]
+<span class="c">&lt;!-- Outputs: tag1 --&gt;</span>
+</code></pre>
+<h3 id="last">
+<code>last</code>
+</h3>
+<p>
+  Returns the last element of an array.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">tags</span><span class="pi">:</span> <span class="s">tag1,tag2,tag3</span>
+<span class="nn">---</span>
+[%tags:split(,):last]
+<span class="c">&lt;!-- Outputs: tag3 --&gt;</span>
+</code></pre>
+<h3 id="slicestartlength">
+<code>slice(START,LENGTH)</code>
+</h3>
+<p>
+  Extracts a slice from an array. If applied to a non-array value, splits the string into individual characters.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">tags</span><span class="pi">:</span> <span class="s">tag1,tag2,tag3</span>
+<span class="nn">---</span>
+[%tags:split(,):slice(0,2):join(,)]
+<span class="c">&lt;!-- Outputs: tag1,tag2 --&gt;</span>
+<span class="p">
+---</span>
+<span class="gh">text: Hello
+---
+</span>
+[%text:slice(0,5)]
+<span class="c">&lt;!-- Outputs: Hello (characters 0-5) --&gt;</span>
+</code></pre>
+<h2 id="utility-transforms">
+  Utility Transforms
+</h2>
+<h3 id="defaultvalue">
+<code>default(VALUE)</code>
+</h3>
+<p>
+  Returns the specified default value if the metadata value is empty.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">desc</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span>
+<span class="nn">---</span>
+[%desc:default(No description)]
+<span class="c">&lt;!-- Outputs: No description --&gt;</span>
+</code></pre>
+<h3 id="escape-htmlescape">
+<code>escape</code> / <code>html_escape</code>
+</h3>
+<p>
+  Escapes HTML special characters (<code>&amp;</code>, <code>&lt;</code>, <code>&gt;</code>, <code>&quot;</code>, <code>'</code>).
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">A &amp; B</span>
+<span class="nn">---</span>
+[%title:html_escape]
+<span class="c">&lt;!-- Outputs: A &amp;amp; B --&gt;</span>
+</code></pre>
+<h3 id="basename">
+<code>basename</code>
+</h3>
+<p>
+  Extracts the filename from a path.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">image</span><span class="pi">:</span> <span class="s">/path/to/image.jpg</span>
+<span class="nn">---</span>
+[%image:basename]
+<span class="c">&lt;!-- Outputs: image.jpg --&gt;</span>
+</code></pre>
+<h3 id="urlencode">
+<code>urlencode</code>
+</h3>
+<p>
+  URL-encodes the value.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">search</span><span class="pi">:</span> <span class="s">hello world</span>
+<span class="nn">---</span>
+[%search:urlencode]
+<span class="c">&lt;!-- Outputs: hello%20world --&gt;</span>
+</code></pre>
+<h3 id="urldecode">
+<code>urldecode</code>
+</h3>
+<p>
+  URL-decodes the value.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">search</span><span class="pi">:</span> <span class="s">hello%20world</span>
+<span class="nn">---</span>
+[%search:urldecode]
+<span class="c">&lt;!-- Outputs: hello world --&gt;</span>
+</code></pre>
+<h3 id="prefixvalue">
+<code>prefix(VALUE)</code>
+</h3>
+<p>
+  Adds a prefix to the value.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">url</span><span class="pi">:</span> <span class="s">example.com</span>
+<span class="nn">---</span>
+[%url:prefix(https://)]
+<span class="c">&lt;!-- Outputs: https://example.com --&gt;</span>
+</code></pre>
+<h3 id="suffixvalue">
+<code>suffix(VALUE)</code>
+</h3>
+<p>
+  Adds a suffix to the value.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">Hello</span>
+<span class="nn">---</span>
+[%title:suffix(!)]
+<span class="c">&lt;!-- Outputs: Hello! --&gt;</span>
+</code></pre>
+<h3 id="removestring">
+<code>remove(STRING)</code>
+</h3>
+<p>
+  Removes all occurrences of the specified string.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">Hello'World</span>
+<span class="nn">---</span>
+[%title:remove(')]
+<span class="c">&lt;!-- Outputs: HelloWorld --&gt;</span>
+</code></pre>
+<h3 id="repeatcount">
+<code>repeat(COUNT)</code>
+</h3>
+<p>
+  Repeats the value the specified number of times.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">sep</span><span class="pi">:</span> <span class="s">-</span>
+<span class="nn">---</span>
+[%sep:repeat(3)]
+<span class="c">&lt;!-- Outputs: --- --&gt;</span>
+</code></pre>
+<h2 id="formatting-transforms">
+  Formatting Transforms
+</h2>
+<h3 id="formatformatstring">
+<code>format(FORMAT_STRING)</code>
+</h3>
+<p>
+  Formats a numeric value using <code>sprintf</code>-style formatting.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">price</span><span class="pi">:</span> <span class="m">42.5</span>
+<span class="nn">---</span>
+[%price:format($%.2f)]
+<span class="c">&lt;!-- Outputs: $42.50 --&gt;</span>
+</code></pre>
+<h3 id="length">
+<code>length</code>
+</h3>
+<p>
+  Returns the length of the value as a string.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">text</span><span class="pi">:</span> <span class="s">Hello</span>
+<span class="nn">---</span>
+[%text:length]
+<span class="c">&lt;!-- Outputs: 5 --&gt;</span>
+</code></pre>
+<h3 id="padwidthchar">
+<code>pad(WIDTH,CHAR)</code>
+</h3>
+<p>
+  Pads the value to the specified width with the specified character (default: space).
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">number</span><span class="pi">:</span> <span class="m">42</span>
+<span class="nn">---</span>
+[%number:pad(5,0)]
+<span class="c">&lt;!-- Outputs: 00042 --&gt;</span>
+</code></pre>
+<h3 id="containsstring">
+<code>contains(STRING)</code>
+</h3>
+<p>
+  Returns <code>&quot;true&quot;</code> if the value contains the specified string, <code>&quot;false&quot;</code> otherwise.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">tags</span><span class="pi">:</span> <span class="s">javascript,html,css</span>
+<span class="nn">---</span>
+[%tags:contains(javascript)]
+<span class="c">&lt;!-- Outputs: true --&gt;</span>
+</code></pre>
+<h2 id="datetime-transforms">
+  Date/Time Transforms
+</h2>
+<h3 id="strftimeformat">
+<code>strftime(FORMAT)</code>
+</h3>
+<p>
+  Formats a date using <code>strftime</code>-style format strings. Parses dates in formats like <code>YYYY-MM-DD</code>, <code>YYYY-MM-DD HH:MM</code>, or <code>YYYY-MM-DD HHⓂ️SS</code>.
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">date</span><span class="pi">:</span> <span class="s">2024-03-15</span>
+<span class="nn">---</span>
+[%date:strftime(%Y)]
+<span class="c">&lt;!-- Outputs: 2024 --&gt;</span>
+[%date:strftime(%B %d, %Y)]
+<span class="c">&lt;!-- Outputs: March 15, 2024 --&gt;</span>
+</code></pre>
+<h2 id="transform-chaining">
+  Transform Chaining
+</h2>
+<p>
+  Multiple transforms can be chained together using colons. Each transform operates on the result of the previous transform:
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">hello world</span>
+<span class="nn">---</span>
+[%title🐢split( ):first]
+&lt;!--
+<span class="p">  1.</span> title -&gt; "Hello World"
+<span class="p">  2.</span> split( ) -&gt; ["Hello", "World"] (array)
+<span class="p">  3.</span> first -&gt; "Hello"
+--&gt;
+</code></pre>
+<p>
+<strong>  Example with dates:</strong>
+</p>
+<pre><code class="highlight language-markdown"><span class="nn">---</span>
+<span class="na">date</span><span class="pi">:</span> <span class="s">2024-03-15 14:30</span>
+<span class="nn">---</span>
+[%date:strftime(%Y)]
+<span class="c">&lt;!-- Outputs: 2024 --&gt;</span>
+</code></pre>
+<h2 id="notes">
+  Notes
+</h2>
+<ul>
+  <li>
+    Transforms are case-sensitive
+  </li>
+  <li>
+    Array transforms (<code>split</code>, <code>join</code>, <code>first</code>, <code>last</code>, <code>slice</code>) work together - use <code>split</code> to create an array, then apply other array transforms
+  </li>
+  <li>
+    The <code>slice</code> transform automatically converts non-array strings into character arrays if needed
+  </li>
+  <li>
+    Regex patterns in <code>replace</code> support POSIX Extended Regular Expressions and can include character classes like <code>[0-9]+</code>
+  </li>
+  <li>
+    Date parsing supports common formats but may not handle all date string formats
+  </li>
+  <li>
+    Unknown transforms are ignored and return the original value
+  </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>