apex-ruby 1.0.17 → 1.0.20

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 (207) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +17 -3
  3. data/ext/apex_ext/apex_ext.c +260 -91
  4. data/ext/apex_ext/apex_src/CHANGELOG.md +440 -0
  5. data/ext/apex_ext/apex_src/CMakeLists.txt +15 -1
  6. data/ext/apex_ext/apex_src/Formula/apex.rb +7 -2
  7. data/ext/apex_ext/apex_src/Package.swift +15 -4
  8. data/ext/apex_ext/apex_src/README.md +94 -35
  9. data/ext/apex_ext/apex_src/VERSION +1 -1
  10. data/ext/apex_ext/apex_src/apex-debug.log +4 -0
  11. data/ext/apex_ext/apex_src/apex.code-workspace +38 -0
  12. data/ext/apex_ext/apex_src/apex.taskpaper +12 -0
  13. data/ext/apex_ext/apex_src/apex_deflist_debug.log +25 -0
  14. data/ext/apex_ext/apex_src/buildnotes.md +1435 -0
  15. data/ext/apex_ext/apex_src/cli/main.c +262 -33
  16. data/ext/apex_ext/apex_src/debug.log +7 -0
  17. data/ext/apex_ext/apex_src/docs/CITATIONS_EXAMPLES.md +274 -0
  18. data/ext/apex_ext/apex_src/docs/CITATIONS_IMPLEMENTATION_PLAN.md +749 -0
  19. data/ext/apex_ext/apex_src/docs/CITATIONS_PLAN.md +744 -0
  20. data/ext/apex_ext/apex_src/docs/INDEX_IMPLEMENTATION_ANALYSIS.md +382 -0
  21. data/ext/apex_ext/apex_src/docs/plans/2025-02-27-man-page-output-implementation.md +351 -0
  22. data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-12-toc-output-format.md +745 -0
  23. data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-18-bear-image-attributes.md +829 -0
  24. data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-19-apex-node-npm.md +1148 -0
  25. data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-12-toc-output-format-design.md +161 -0
  26. data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-18-bear-image-attributes-design.md +184 -0
  27. data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-19-apex-node-npm-design.md +211 -0
  28. data/ext/apex_ext/apex_src/documentation/app-settings-table.md +67 -0
  29. data/ext/apex_ext/apex_src/documentation/app-transformed/Citations.md +340 -0
  30. data/ext/apex_ext/apex_src/documentation/app-transformed/Credits.md +11 -0
  31. data/ext/apex_ext/apex_src/documentation/app-transformed/Header-IDs.md +234 -0
  32. data/ext/apex_ext/apex_src/documentation/app-transformed/Inline-Attribute-Lists.md +516 -0
  33. data/ext/apex_ext/apex_src/documentation/app-transformed/Metadata-Transforms.md +461 -0
  34. data/ext/apex_ext/apex_src/documentation/app-transformed/Modes.md +193 -0
  35. data/ext/apex_ext/apex_src/documentation/app-transformed/Multi-File-Documents.md +201 -0
  36. data/ext/apex_ext/apex_src/documentation/app-transformed/Plugins.md +678 -0
  37. data/ext/apex_ext/apex_src/documentation/app-transformed/Syntax.md +1367 -0
  38. data/ext/apex_ext/apex_src/documentation/docsets/Apex Command Line Options.cheatsheet.txt +6 -0
  39. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/C-API.html +774 -300
  40. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Callouts.html +1194 -0
  41. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Citations.html +416 -216
  42. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Command-Line-Options.html +3544 -1094
  43. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Configuration.html +371 -97
  44. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Credits.html +153 -23
  45. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Examples.html +358 -124
  46. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Filters.html +1656 -0
  47. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Generating-Man-Pages.html +1226 -0
  48. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Getting-Started.html +201 -56
  49. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Header-IDs.html +279 -109
  50. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Home.html +200 -53
  51. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Indices.html +2327 -0
  52. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Inline-Attribute-Lists.html +690 -271
  53. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Installation.html +201 -55
  54. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Limitations-and-Roadmap.html +238 -68
  55. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Metadata-Transforms.html +421 -221
  56. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Modes.html +340 -78
  57. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Multi-File-Documents.html +251 -86
  58. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Multi-Format-Images.html +1362 -0
  59. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Pandoc-Integration.html +277 -90
  60. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Plugins.html +673 -346
  61. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Quarto-Mode.html +1405 -0
  62. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Rendering-Markdown-In-Terminal.html +1902 -0
  63. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Syntax.html +1939 -1698
  64. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Tables.html +1781 -0
  65. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Troubleshooting.html +315 -140
  66. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Usage.html +307 -113
  67. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Using-Apex-with-Jekyll.html +1132 -0
  68. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Writing-Tests.html +1754 -0
  69. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Xcode-Integration.html +872 -376
  70. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/docSet.dsidx +0 -0
  71. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/optimizedIndex.dsidx +0 -0
  72. data/ext/apex_ext/apex_src/documentation/html/apex-app-docs.html +8746 -0
  73. data/ext/apex_ext/apex_src/documentation/shared_styles.css +20 -15
  74. data/ext/apex_ext/apex_src/documentation/transform_for_app.md +55 -0
  75. data/ext/apex_ext/apex_src/escaping-repro.md +103 -0
  76. data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/Info.plist +8 -0
  77. data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/QuickLook/Preview.png +0 -0
  78. data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/document.wflow +547 -0
  79. data/ext/apex_ext/apex_src/examples/quick-actions/Markdown-to-RTF.workflow.zip +0 -0
  80. data/ext/apex_ext/apex_src/examples/quick-actions/README.md +33 -0
  81. data/ext/apex_ext/apex_src/include/apex/apex.h +92 -6
  82. data/ext/apex_ext/apex_src/include/apex/ast_rtf.h +23 -0
  83. data/ext/apex_ext/apex_src/include/apex/ast_terminal.h +6 -0
  84. data/ext/apex_ext/apex_src/include/apex/module.modulemap +5 -0
  85. data/ext/apex_ext/apex_src/include/apex/plugins.h +105 -0
  86. data/ext/apex_ext/apex_src/include/apexc.h +1 -0
  87. data/ext/apex_ext/apex_src/man/apex.1 +82 -78
  88. data/ext/apex_ext/apex_src/man/apex.1.md +81 -4
  89. data/ext/apex_ext/apex_src/objc/Apex.swift +73 -0
  90. data/ext/apex_ext/apex_src/objc/ApexPlugins.swift +79 -0
  91. data/ext/apex_ext/apex_src/objc/NSString+Apex.h +83 -5
  92. data/ext/apex_ext/apex_src/objc/NSString+Apex.m +244 -1
  93. data/ext/apex_ext/apex_src/objc/NSString+ApexPlugins.h +76 -0
  94. data/ext/apex_ext/apex_src/objc/NSString+ApexPlugins.m +169 -0
  95. data/ext/apex_ext/apex_src/output.html +87 -0
  96. data/ext/apex_ext/apex_src/plans/quarto-mode.md +442 -0
  97. data/ext/apex_ext/apex_src/src/_README.md +85 -32
  98. data/ext/apex_ext/apex_src/src/apex.c +770 -200
  99. data/ext/apex_ext/apex_src/src/ast_rtf.c +848 -0
  100. data/ext/apex_ext/apex_src/src/ast_terminal.c +184 -7
  101. data/ext/apex_ext/apex_src/src/extensions/abbreviations.c +10 -3
  102. data/ext/apex_ext/apex_src/src/extensions/advanced_tables.c +7 -11
  103. data/ext/apex_ext/apex_src/src/extensions/bear_image_attrs.c +467 -0
  104. data/ext/apex_ext/apex_src/src/extensions/bear_image_attrs.h +27 -0
  105. data/ext/apex_ext/apex_src/src/extensions/callouts.c +400 -4
  106. data/ext/apex_ext/apex_src/src/extensions/callouts.h +15 -5
  107. data/ext/apex_ext/apex_src/src/extensions/citations.c +26 -5
  108. data/ext/apex_ext/apex_src/src/extensions/code_fence_attrs.c +632 -0
  109. data/ext/apex_ext/apex_src/src/extensions/code_fence_attrs.h +22 -0
  110. data/ext/apex_ext/apex_src/src/extensions/concordance.c +632 -0
  111. data/ext/apex_ext/apex_src/src/extensions/definition_list.c +129 -15
  112. data/ext/apex_ext/apex_src/src/extensions/grid_tables.c +1050 -121
  113. data/ext/apex_ext/apex_src/src/extensions/html_markdown.c +569 -16
  114. data/ext/apex_ext/apex_src/src/extensions/ial.c +502 -52
  115. data/ext/apex_ext/apex_src/src/extensions/ial.h +2 -1
  116. data/ext/apex_ext/apex_src/src/extensions/includes.c +532 -33
  117. data/ext/apex_ext/apex_src/src/extensions/includes.h +7 -1
  118. data/ext/apex_ext/apex_src/src/extensions/index.c +1427 -140
  119. data/ext/apex_ext/apex_src/src/extensions/index.h +28 -0
  120. data/ext/apex_ext/apex_src/src/extensions/metadata.c +200 -161
  121. data/ext/apex_ext/apex_src/src/extensions/quarto_diagrams.c +251 -0
  122. data/ext/apex_ext/apex_src/src/extensions/quarto_diagrams.h +22 -0
  123. data/ext/apex_ext/apex_src/src/extensions/quarto_lists.c +624 -0
  124. data/ext/apex_ext/apex_src/src/extensions/quarto_lists.h +35 -0
  125. data/ext/apex_ext/apex_src/src/extensions/quarto_polish.c +264 -0
  126. data/ext/apex_ext/apex_src/src/extensions/quarto_polish.h +23 -0
  127. data/ext/apex_ext/apex_src/src/extensions/quarto_shortcodes.c +307 -0
  128. data/ext/apex_ext/apex_src/src/extensions/quarto_shortcodes.h +21 -0
  129. data/ext/apex_ext/apex_src/src/extensions/raw_content.c +351 -0
  130. data/ext/apex_ext/apex_src/src/extensions/raw_content.h +20 -0
  131. data/ext/apex_ext/apex_src/src/extensions/relaxed_tables.c +117 -3
  132. data/ext/apex_ext/apex_src/src/extensions/special_markers.c +53 -0
  133. data/ext/apex_ext/apex_src/src/extensions/syntax_highlight.c +23 -1
  134. data/ext/apex_ext/apex_src/src/extensions/table_html_postprocess.c +83 -92
  135. data/ext/apex_ext/apex_src/src/extensions/toc.c +446 -25
  136. data/ext/apex_ext/apex_src/src/extensions/toc.h +26 -1
  137. data/ext/apex_ext/apex_src/src/extensions/wiki_links.c +28 -0
  138. data/ext/apex_ext/apex_src/src/html_renderer.c +387 -17
  139. data/ext/apex_ext/apex_src/src/plugin_catalog.c +517 -0
  140. data/ext/apex_ext/apex_src/src/plugins_remote.c +88 -14
  141. data/ext/apex_ext/apex_src/src/plugins_remote.h +34 -0
  142. data/ext/apex_ext/apex_src/src/pretty_html.c +6 -1
  143. data/ext/apex_ext/apex_src/tests/fixtures/comprehensive_test.md +21 -0
  144. data/ext/apex_ext/apex_src/tests/fixtures/images/bear_image_attributes.md +10 -0
  145. data/ext/apex_ext/apex_src/tests/fixtures/includes/sections.md +19 -0
  146. data/ext/apex_ext/apex_src/tests/fixtures/includes/sections.txt +11 -0
  147. data/ext/apex_ext/apex_src/tests/fixtures/minimal_pb.md +2 -0
  148. data/ext/apex_ext/apex_src/tests/fixtures/obsidian-callouts.md +46 -0
  149. data/ext/apex_ext/apex_src/tests/fixtures/pagebreak_html_repro.md +5 -0
  150. data/ext/apex_ext/apex_src/tests/fixtures/python-callouts.md +47 -0
  151. data/ext/apex_ext/apex_src/tests/fixtures/quarto/callouts.md +3 -0
  152. data/ext/apex_ext/apex_src/tests/fixtures/quarto/code-attrs.md +3 -0
  153. data/ext/apex_ext/apex_src/tests/fixtures/quarto/diagrams.md +8 -0
  154. data/ext/apex_ext/apex_src/tests/fixtures/quarto/lists.md +19 -0
  155. data/ext/apex_ext/apex_src/tests/fixtures/quarto/raw-content.md +5 -0
  156. data/ext/apex_ext/apex_src/tests/fixtures/quarto/shortcodes.md +7 -0
  157. data/ext/apex_ext/apex_src/tests/fixtures/quarto/smoke.md +81 -0
  158. data/ext/apex_ext/apex_src/tests/fixtures/quarto/spans.md +5 -0
  159. data/ext/apex_ext/apex_src/tests/fixtures/quarto-callouts.md +47 -0
  160. data/ext/apex_ext/apex_src/tests/fixtures/speed.md +192 -0
  161. data/ext/apex_ext/apex_src/tests/fixtures/tables/grid-tables.md +37 -0
  162. data/ext/apex_ext/apex_src/tests/paginate_cli_test.sh +16 -0
  163. data/ext/apex_ext/apex_src/tests/test_bear_image_attrs.c +301 -0
  164. data/ext/apex_ext/apex_src/tests/test_concordance.tsv +4 -0
  165. data/ext/apex_ext/apex_src/tests/test_escaping_repro.c +82 -0
  166. data/ext/apex_ext/apex_src/tests/test_extensions.c +821 -1
  167. data/ext/apex_ext/apex_src/tests/test_ial.c +7 -0
  168. data/ext/apex_ext/apex_src/tests/test_marked_integration.c +25 -0
  169. data/ext/apex_ext/apex_src/tests/test_metadata.c +129 -0
  170. data/ext/apex_ext/apex_src/tests/test_output.c +568 -2
  171. data/ext/apex_ext/apex_src/tests/test_runner.c +11 -0
  172. data/ext/apex_ext/apex_src/tests/test_tables.c +420 -0
  173. data/ext/apex_ext/apex_src/vendor/cmark-gfm/CMakeLists.txt +1 -1
  174. data/ext/apex_ext/apex_src/vendor/cmark-gfm/extensions/autolink.c +77 -1
  175. data/ext/apex_ext/apex_src/vendor/cmark-gfm/extensions/table.c +135 -5
  176. data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/blocks.c +56 -1
  177. data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/config.h +38 -0
  178. data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/main.c +1 -1
  179. data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/__pycache__/cmark.cpython-314.pyc +0 -0
  180. data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/__pycache__/normalize.cpython-314.pyc +0 -0
  181. data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/extensions.txt +69 -0
  182. data/ext/apex_ext/apex_src/xcode_build/CMakeScripts/ReRunCMake.make +74 -0
  183. data/ext/apex_ext/apex_src/xcode_build/CTestTestfile.cmake +22 -0
  184. data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/Apex +0 -0
  185. data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/Resources/Info.plist +44 -0
  186. data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/_CodeSignature/CodeResources +128 -0
  187. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.pbxproj +5118 -0
  188. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings +8 -0
  189. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcuserdata/ttscoff.xcuserdatad/UserInterfaceState.xcuserstate +0 -0
  190. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcuserdata/ttscoff.xcuserdatad/WorkspaceSettings.xcsettings +8 -0
  191. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/xcuserdata/ttscoff.xcuserdatad/xcschemes/xcschememanagement.plist +99 -0
  192. data/ext/apex_ext/apex_src/xcode_build/cmake_install.cmake +452 -0
  193. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/CMakeScripts/ReRunCMake.make +52 -0
  194. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmake_install.cmake +55 -0
  195. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmark-gfm.xcodeproj/project.pbxproj +2455 -0
  196. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmark-gfm.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings +8 -0
  197. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/extensions/cmake_install.cmake +171 -0
  198. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/man/cmake_install.cmake +55 -0
  199. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmake_install.cmake +220 -0
  200. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmark-gfm_export.h +43 -0
  201. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmark-gfm_version.h +7 -0
  202. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/config.h +76 -0
  203. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/libcmark-gfm.pc +10 -0
  204. data/ext/apex_ext/extconf.rb +35 -0
  205. data/lib/apex/version.rb +2 -2
  206. metadata +117 -2
  207. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/tempOptimizedIndex.dsidx +0 -0
@@ -0,0 +1,1362 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+
4
+ <head>
5
+
6
+ <meta charset="UTF-8">
7
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
8
+ <meta name="generator" content="Apex 1.1.12">
9
+ <title>Document</title>
10
+ <style>
11
+ /* GitHub-style syntax highlighting for Pygments and Skylighting */
12
+ /* Don't apply background to wrapper when code highlighting is enabled - let default styles handle it */
13
+ .code-highlighted .highlight, .code-highlighted .sourceCode { background: inherit; border-radius: 6px; padding: 16px; overflow-x: auto; }
14
+ .highlight pre, .sourceCode pre { margin: 0; padding: 0; background: transparent; }
15
+ .highlight code, .sourceCode code { font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace; font-size: 12px; line-height: 1.45; }
16
+ /* Pygments classes */
17
+ .highlight .k { color: #d73a49; font-weight: 600; } /* Keyword */
18
+ .highlight .kt { color: #d73a49; } /* Keyword.Type */
19
+ .highlight .kd { color: #d73a49; font-weight: 600; } /* Keyword.Declaration */
20
+ .highlight .kn { color: #d73a49; } /* Keyword.Namespace */
21
+ .highlight .kp { color: #d73a49; } /* Keyword.Pseudo */
22
+ .highlight .kr { color: #d73a49; font-weight: 600; } /* Keyword.Reserved */
23
+ .highlight .n { color: #6f42c1; } /* Name */
24
+ .highlight .na { color: #6f42c1; } /* Name.Attribute */
25
+ .highlight .nc { color: #6f42c1; font-weight: 600; } /* Name.Class */
26
+ .highlight .no { color: #005cc5; } /* Name.Constant */
27
+ .highlight .nd { color: #6f42c1; font-weight: 600; } /* Name.Decorator */
28
+ .highlight .ni { color: #800080; } /* Name.Entity */
29
+ .highlight .ne { color: #990000; font-weight: 600; } /* Name.Exception */
30
+ .highlight .nf { color: #6f42c1; font-weight: 600; } /* Name.Function */
31
+ .highlight .nl { color: #6f42c1; } /* Name.Label */
32
+ .highlight .nn { color: #555; } /* Name.Namespace */
33
+ .highlight .nt { color: #22863a; } /* Name.Tag */
34
+ .highlight .nv { color: #e36209; } /* Name.Variable */
35
+ .highlight .s { color: #032f62; } /* String */
36
+ .highlight .sb { color: #032f62; } /* String.Backtick */
37
+ .highlight .sc { color: #032f62; } /* String.Char */
38
+ .highlight .sd { color: #032f62; } /* String.Doc */
39
+ .highlight .s2 { color: #032f62; } /* String.Double */
40
+ .highlight .se { color: #032f62; } /* String.Escape */
41
+ .highlight .sh { color: #032f62; } /* String.Heredoc */
42
+ .highlight .si { color: #032f62; } /* String.Interpol */
43
+ .highlight .sx { color: #032f62; } /* String.Other */
44
+ .highlight .sr { color: #032f62; } /* String.Regex */
45
+ .highlight .s1 { color: #032f62; } /* String.Single */
46
+ .highlight .ss { color: #032f62; } /* String.Symbol */
47
+ .highlight .c { color: #6a737d; font-style: italic; } /* Comment */
48
+ .highlight .c1 { color: #6a737d; font-style: italic; } /* Comment.Single */
49
+ .highlight .cm { color: #6a737d; font-style: italic; } /* Comment.Multiline */
50
+ .highlight .cp { color: #6a737d; font-weight: 600; } /* Comment.Preproc */
51
+ .highlight .cs { color: #6a737d; font-weight: 600; font-style: italic; } /* Comment.Special */
52
+ .highlight .m { color: #005cc5; } /* Literal.Number */
53
+ .highlight .mb { color: #005cc5; } /* Literal.Number.Bin */
54
+ .highlight .mf { color: #005cc5; } /* Literal.Number.Float */
55
+ .highlight .mh { color: #005cc5; } /* Literal.Number.Hex */
56
+ .highlight .mi { color: #005cc5; } /* Literal.Number.Integer */
57
+ .highlight .il { color: #005cc5; } /* Literal.Number.Integer.Long */
58
+ .highlight .mo { color: #005cc5; } /* Literal.Number.Oct */
59
+ .highlight .o { color: #d73a49; } /* Operator */
60
+ .highlight .ow { color: #d73a49; } /* Operator.Word */
61
+ .highlight .p { color: #24292e; } /* Punctuation */
62
+ .highlight .w { color: #e1e4e8; } /* Text.Whitespace */
63
+ /* Skylighting classes */
64
+ .sourceCode .kw { color: #d73a49; font-weight: 600; } /* Keyword */
65
+ .sourceCode .dt { color: #6f42c1; } /* DataType */
66
+ .sourceCode .dv { color: #005cc5; } /* DecVal */
67
+ .sourceCode .bn { color: #005cc5; } /* BaseN */
68
+ .sourceCode .fl { color: #005cc5; } /* Float */
69
+ .sourceCode .ch { color: #032f62; } /* Char */
70
+ .sourceCode .st { color: #032f62; } /* String */
71
+ .sourceCode .co { color: #6a737d; font-style: italic; } /* Comment */
72
+ .sourceCode .ot { color: #22863a; } /* Other */
73
+ .sourceCode .al { color: #e36209; font-weight: 600; } /* Alert */
74
+ .sourceCode .fu { color: #6f42c1; font-weight: 600; } /* Function */
75
+ .sourceCode .re { color: #032f62; } /* RegionMarker */
76
+ .sourceCode .er { color: #d73a49; font-weight: 600; } /* Error */
77
+ .sourceCode .cf { color: #d73a49; font-weight: 600; } /* ControlFlow */
78
+ .sourceCode .op { color: #d73a49; } /* Operator */
79
+ .sourceCode .pp { color: #6a737d; } /* Preprocessor */
80
+ .sourceCode .at { color: #005cc5; } /* Attribute */
81
+ .sourceCode .do { color: #6a737d; font-style: italic; } /* Documentation */
82
+ .sourceCode .an { color: #6a737d; font-weight: 600; } /* Annotation */
83
+ .sourceCode .cv { color: #6a737d; font-weight: 600; font-style: italic; } /* CommentVar */
84
+ .sourceCode .in { color: #6a737d; } /* Information */
85
+ .sourceCode .wa { color: #e36209; font-weight: 600; } /* Warning */
86
+ .sourceCode .im { color: #d73a49; } /* Import */
87
+ .sourceCode .bu { color: #005cc5; } /* BuiltIn */
88
+ .sourceCode .ex { color: #6f42c1; } /* Extension */
89
+ .sourceCode .va { color: #e36209; } /* Variable */
90
+ .sourceCode .ss { color: #032f62; } /* SpecialString */
91
+ .sourceCode .sc { color: #032f62; } /* SpecialChar */
92
+ .sourceCode .vs { color: #032f62; } /* VerbatimString */
93
+ .sourceCode .il { color: #005cc5; } /* Special */
94
+ /* Line numbers (Skylighting) */
95
+ .sourceCode.numberSource .sourceCode { counter-reset: line; }
96
+ .sourceCode.numberSource .sourceCode > span { position: relative; left: -4em; counter-increment: line; }
97
+ .sourceCode.numberSource .sourceCode > span > a:first-child::before { content: counter(line); position: relative; left: -1em; text-align: right; vertical-align: baseline; border: none; display: inline-block; min-width: 1em; padding-right: 0.5em; color: #aaa; }
98
+ </style>
99
+ <style>
100
+ body {
101
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
102
+ line-height: 1.6;
103
+ max-width: 800px;
104
+ margin: 2rem auto;
105
+ padding: 0 1rem;
106
+ color: #333;
107
+ }
108
+ pre { background: #f5f5f5; padding: 1rem; overflow-x: auto; }
109
+ code { background: #f0f0f0; padding: 0.2em 0.4em; border-radius: 3px; }
110
+ blockquote { border-left: 4px solid #ddd; margin: 0; padding-left: 1rem; color: #666; }
111
+ table { border-collapse: collapse; width: 100%%; }
112
+ th, td { border: 1px solid #ddd; padding: 0.5rem; }
113
+ th { background: #f5f5f5; }
114
+ tfoot td { background: #e8e8e8; }
115
+ figure.table-figure { width: fit-content; margin: 1em 0; }
116
+ figure.table-figure table { width: auto; }
117
+ figcaption { text-align: center; font-weight: bold; font-size: 0.8em; }
118
+ .page-break { page-break-after: always; }
119
+ .callout { padding: 1rem; margin: 1rem 0; border-left: 4px solid; }
120
+ .callout-note { border-color: #3b82f6; background: #eff6ff; }
121
+ .callout-warning { border-color: #f59e0b; background: #fffbeb; }
122
+ .callout-tip { border-color: #10b981; background: #f0fdf4; }
123
+ .callout-danger { border-color: #ef4444; background: #fef2f2; }
124
+ ins { background: #d4fcbc; text-decoration: none; }
125
+ del { background: #fbb6c2; text-decoration: line-through; }
126
+ mark { background: #fff3cd; }
127
+ .smallcaps { font-variant: small-caps; }
128
+ .underline { text-decoration: underline; }
129
+ span.mark { background: #fff3cd; }
130
+ .hidden { display: none; }
131
+ .quarto-xref { font-variant: normal; }
132
+ .critic.comment { background: #e7e7e7; color: #666; font-style: italic; }
133
+ .mkhashtag { color: #666; }
134
+ .mkstyledtag {
135
+ display: inline-block;
136
+ background: #e0e0e0;
137
+ padding: 3px 9px;
138
+ border-radius: 20px;
139
+ font-size: 0.9em;
140
+ line-height: 1.4;
141
+ color: #333;
142
+ margin: 0 2px;
143
+ }
144
+ </style>
145
+ <meta name="paginate" content="symbols"/>
146
+ <meta name="highlight-language-only" content="true"/>
147
+ <meta name="code-line-numbers" content="false"/>
148
+ <meta name="code-highlight" content="pygments"/>
149
+ <meta name="sup-sub" content="true"/>
150
+ <meta name="relaxed-tables" content="true"/>
151
+ <meta name="includes" content="true"/>
152
+ <meta name="autolink" content="true"/>
153
+ <meta name="pretty" content="false"/>
154
+ <meta name="standalone" content="false"/>
155
+ <meta name="mode" content="unified"/>
156
+ <meta name="markdown-in-html" content="true"/>
157
+ <meta name="image-captions" content="true"/>
158
+ <meta name="wikilink-extension" content="html"/>
159
+ <meta name="wikilink-space" content="hyphen"/>
160
+ <meta name="wikilinks" content="true"/>
161
+ <meta name="widont" content="true"/>
162
+ <meta name="plugins" content="true"/>
163
+ <meta name="id-format" content="gfm"/>
164
+
165
+ <style>
166
+ :root {
167
+ /* border-box width of the fixed sidebar; body offset includes a small gap */
168
+ --sidebar-width: 250px;
169
+ --sidebar-offset: 270px;
170
+ }
171
+
172
+ /* Base styles — override Apex standalone centering (max-width + margin: auto) */
173
+ body {
174
+ -webkit-font-smoothing: antialiased;
175
+ -moz-osx-font-smoothing: grayscale;
176
+ font-size: 17px;
177
+ font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
178
+ "Helvetica Neue", Arial, sans-serif;
179
+ line-height: 1.65;
180
+ color: #1e293b;
181
+ background-color: #fff;
182
+ max-width: none;
183
+ width: auto;
184
+ margin: 2rem 2rem 2rem var(--sidebar-offset);
185
+ padding: 0 1rem;
186
+ box-sizing: border-box;
187
+ }
188
+
189
+ /* Sidebar / Main TOC - wider on larger screens */
190
+ .main-toc,
191
+ .sidebar {
192
+ position: fixed;
193
+ left: 0;
194
+ top: 0;
195
+ box-sizing: border-box;
196
+ width: var(--sidebar-width);
197
+ min-width: var(--sidebar-width);
198
+ max-width: var(--sidebar-width);
199
+ height: 100vh;
200
+ overflow-y: auto;
201
+ background: #1e293b;
202
+ color: rgba(255, 255, 255, 0.9);
203
+ border-right: 2px solid rgba(255, 255, 255, 0.1);
204
+ padding: 24px 20px 130px;
205
+ font-size: 14px;
206
+ z-index: 100;
207
+ box-shadow: 4px 0 24px rgba(0, 0, 0, 0.08);
208
+ transition: transform 0.3s ease;
209
+ }
210
+
211
+ .main-toc ul,
212
+ .sidebar ul {
213
+ list-style: none;
214
+ padding-left: 0;
215
+ margin: 0;
216
+ padding-bottom: 80px;
217
+ }
218
+
219
+ .main-toc ul::after,
220
+ .sidebar ul::after {
221
+ content: "";
222
+ display: block;
223
+ height: 80px;
224
+ }
225
+
226
+ .main-toc li,
227
+ .sidebar li {
228
+ margin: 0.25em 0;
229
+ }
230
+
231
+ .main-toc a,
232
+ .sidebar a {
233
+ color: rgba(255, 255, 255, 0.85);
234
+ text-decoration: none;
235
+ display: block;
236
+ padding: 6px 12px;
237
+ border-radius: 4px;
238
+ transition: all 0.15s ease;
239
+ white-space: nowrap;
240
+ overflow: hidden;
241
+ text-overflow: ellipsis;
242
+ }
243
+
244
+ .main-toc a:hover,
245
+ .sidebar a:hover {
246
+ background: #334155;
247
+ color: #fff;
248
+ }
249
+
250
+ .sidebar a.active {
251
+ color: #0ea5e9;
252
+ font-weight: 500;
253
+ }
254
+
255
+ /* Hamburger menu button */
256
+ .hamburger-menu {
257
+ display: none;
258
+ position: fixed;
259
+ top: 12px;
260
+ left: 12px;
261
+ z-index: 200;
262
+ background: #1e293b;
263
+ border: 2px solid rgba(255, 255, 255, 0.1);
264
+ border-radius: 6px;
265
+ padding: 10px;
266
+ cursor: pointer;
267
+ color: rgba(255, 255, 255, 0.9);
268
+ font-size: 20px;
269
+ line-height: 1;
270
+ box-sizing: border-box;
271
+ width: 44px;
272
+ height: 44px;
273
+ align-items: center;
274
+ justify-content: center;
275
+ box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
276
+ transition: all 0.2s ease;
277
+ opacity: 0.2;
278
+ }
279
+
280
+ .hamburger-menu:hover {
281
+ background: #334155;
282
+ color: #fff;
283
+ opacity: 1;
284
+ }
285
+
286
+ /* Move hamburger to the right of the sidebar when menu is open */
287
+ .hamburger-menu.active {
288
+ left: calc(var(--sidebar-width) + 12px);
289
+ }
290
+
291
+ .hamburger-menu.active {
292
+ background: #0ea5e9;
293
+ }
294
+
295
+ .hamburger-menu::before {
296
+ content: "☰";
297
+ }
298
+
299
+ .hamburger-menu.active::before {
300
+ content: "✕";
301
+ }
302
+
303
+ /* Mobile menu overlay */
304
+ .mobile-menu-overlay {
305
+ display: none;
306
+ position: fixed;
307
+ top: 0;
308
+ left: 0;
309
+ right: 0;
310
+ bottom: 0;
311
+ background: rgba(0, 0, 0, 0.5);
312
+ z-index: 150;
313
+ opacity: 0;
314
+ visibility: hidden;
315
+ transition: opacity 0.3s ease, visibility 0.3s ease;
316
+ }
317
+
318
+ .mobile-menu-overlay.active {
319
+ opacity: 1;
320
+ visibility: visible;
321
+ }
322
+
323
+ /* Page TOC */
324
+ .page-toc {
325
+ background: #f9f9f9;
326
+ border: 1px solid #ddd;
327
+ border-radius: 4px;
328
+ padding: 1rem;
329
+ margin: 1.5rem 0;
330
+ }
331
+
332
+ .page-toc ul {
333
+ list-style: none;
334
+ padding-left: 0;
335
+ margin: 0;
336
+ }
337
+
338
+ .page-toc > ul {
339
+ padding-left: 0;
340
+ }
341
+
342
+ .page-toc li {
343
+ margin: 0.25em 0;
344
+ }
345
+
346
+ .page-toc a {
347
+ color: #0066cc;
348
+ text-decoration: none;
349
+ display: block;
350
+ padding: 0.25em 0.5em;
351
+ border-radius: 3px;
352
+ }
353
+
354
+ .page-toc a:hover {
355
+ background: #e0e0e0;
356
+ color: #004499;
357
+ }
358
+
359
+ .page-toc ul ul {
360
+ list-style: none;
361
+ padding-left: 1.5em;
362
+ margin-top: 0.25em;
363
+ margin-left: 0;
364
+ }
365
+
366
+ .page-toc ul ul ul {
367
+ padding-left: 1.5em;
368
+ }
369
+
370
+ .page-toc ul ul a {
371
+ font-size: 0.9em;
372
+ color: #555;
373
+ }
374
+
375
+ .page-toc ul ul ul a {
376
+ font-size: 0.85em;
377
+ color: #666;
378
+ }
379
+
380
+ /* Floating TOC */
381
+ .floating-toc {
382
+ position: fixed;
383
+ top: 0;
384
+ left: var(--sidebar-offset);
385
+ right: 0;
386
+ z-index: 50;
387
+ opacity: 0;
388
+ visibility: hidden;
389
+ transition: opacity 0.2s ease, visibility 0.2s ease;
390
+ pointer-events: none;
391
+ display: flex;
392
+ justify-content: flex-end;
393
+ padding-right: 2rem;
394
+ }
395
+
396
+ .floating-toc.visible {
397
+ opacity: 1;
398
+ visibility: visible;
399
+ pointer-events: auto;
400
+ }
401
+
402
+ .floating-toc-container {
403
+ background: rgba(255, 255, 255, 0.95);
404
+ backdrop-filter: blur(10px);
405
+ border-bottom: 1px solid #ddd;
406
+ border-radius: 0 0 12px 12px;
407
+ box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
408
+ width: fit-content;
409
+ max-width: 400px;
410
+ min-width: 200px;
411
+ overflow: hidden;
412
+ transition: max-height 0.3s ease;
413
+ }
414
+
415
+ .floating-toc-header {
416
+ padding: 8px 16px;
417
+ cursor: pointer;
418
+ user-select: none;
419
+ font-size: 14px;
420
+ font-weight: 500;
421
+ color: #1e293b;
422
+ display: flex;
423
+ align-items: center;
424
+ justify-content: space-between;
425
+ }
426
+
427
+ .floating-toc-header:hover {
428
+ background: rgba(0, 0, 0, 0.02);
429
+ }
430
+
431
+ .floating-toc-content {
432
+ max-height: 0;
433
+ overflow: hidden;
434
+ transition: max-height 0.3s ease;
435
+ }
436
+
437
+ .floating-toc-container:hover .floating-toc-content {
438
+ max-height: 70vh;
439
+ overflow-y: auto;
440
+ }
441
+
442
+ .floating-toc-content ul {
443
+ list-style: none;
444
+ padding: 8px 16px 16px;
445
+ margin: 0;
446
+ }
447
+
448
+ .floating-toc-content li {
449
+ margin: 0.1em 0;
450
+ }
451
+
452
+ .floating-toc-content a {
453
+ color: #0066cc;
454
+ text-decoration: none;
455
+ display: block;
456
+ padding: 0.2em 0.5em;
457
+ border-radius: 4px;
458
+ font-size: 13px;
459
+ transition: background 0.15s ease;
460
+ }
461
+
462
+ .floating-toc-content a:hover {
463
+ background: #e0e0e0;
464
+ color: #004499;
465
+ }
466
+
467
+ .floating-toc-content ul ul {
468
+ padding-left: 1.2em;
469
+ margin-top: 0;
470
+ margin-bottom: 0;
471
+ }
472
+
473
+ .floating-toc-content ul ul ul {
474
+ margin-top: 0;
475
+ margin-bottom: 0;
476
+ }
477
+
478
+ .floating-toc-content ul ul a {
479
+ font-size: 12px;
480
+ color: #555;
481
+ }
482
+
483
+ .floating-toc-content ul ul ul a {
484
+ font-size: 11px;
485
+ color: #666;
486
+ }
487
+
488
+ /* Smooth scrolling */
489
+ html {
490
+ scroll-behavior: smooth;
491
+ }
492
+
493
+ /* Code blocks */
494
+ code {
495
+ background: #f0f0f0;
496
+ padding: 0.2em 0.4em;
497
+ border-radius: 3px;
498
+ font-family: "Monaco", "Menlo", "Ubuntu Mono", monospace;
499
+ font-size: 0.9em;
500
+ margin: 0 0.1em;
501
+ }
502
+
503
+ pre {
504
+ background: #f5f5f5;
505
+ padding: 1rem;
506
+ overflow-x: auto;
507
+ border-radius: 4px;
508
+ margin: 1em 0;
509
+ }
510
+
511
+ pre code {
512
+ background: none;
513
+ padding: 0;
514
+ margin: 0;
515
+ }
516
+
517
+ /* Rouge syntax highlighting - GitHub theme, scoped to .highlight containers */
518
+ .highlight {
519
+ color: #24292e;
520
+ }
521
+
522
+ .highlight .c {
523
+ color: #6a737d;
524
+ font-style: italic;
525
+ } /* Comment */
526
+ .highlight .err {
527
+ color: #a61717;
528
+ background-color: #e3d2d2;
529
+ } /* Error */
530
+ .highlight .k {
531
+ color: #d73a49;
532
+ font-weight: bold;
533
+ } /* Keyword */
534
+ .highlight .l {
535
+ color: #032f62;
536
+ } /* Literal */
537
+ .highlight .n {
538
+ color: #24292e;
539
+ } /* Name */
540
+ .highlight .o {
541
+ color: #d73a49;
542
+ } /* Operator */
543
+ .highlight .p {
544
+ color: #24292e;
545
+ } /* Punctuation */
546
+ .highlight .cm {
547
+ color: #6a737d;
548
+ font-style: italic;
549
+ } /* Comment.Multiline */
550
+ .highlight .cp {
551
+ color: #6a737d;
552
+ font-weight: bold;
553
+ } /* Comment.Preproc */
554
+ .highlight .c1 {
555
+ color: #6a737d;
556
+ font-style: italic;
557
+ } /* Comment.Single */
558
+ .highlight .cs {
559
+ color: #6a737d;
560
+ font-weight: bold;
561
+ font-style: italic;
562
+ } /* Comment.Special */
563
+ .highlight .gd {
564
+ color: #24292e;
565
+ background-color: #ffeef0;
566
+ } /* Generic.Deleted */
567
+ .highlight .ge {
568
+ color: #24292e;
569
+ font-style: italic;
570
+ } /* Generic.Emph */
571
+ .highlight .gr {
572
+ color: #aa0000;
573
+ } /* Generic.Error */
574
+ .highlight .gh {
575
+ color: #999999;
576
+ font-weight: bold;
577
+ } /* Generic.Heading */
578
+ .highlight .gi {
579
+ color: #24292e;
580
+ background-color: #f0fff4;
581
+ } /* Generic.Inserted */
582
+ .highlight .go {
583
+ color: #888888;
584
+ } /* Generic.Output */
585
+ .highlight .gp {
586
+ color: #555555;
587
+ } /* Generic.Prompt */
588
+ .highlight .gs {
589
+ font-weight: bold;
590
+ } /* Generic.Strong */
591
+ .highlight .gu {
592
+ color: #aaaaaa;
593
+ } /* Generic.Subheading */
594
+ .highlight .gt {
595
+ color: #aa0000;
596
+ } /* Generic.Traceback */
597
+ .highlight .kc {
598
+ color: #d73a49;
599
+ font-weight: bold;
600
+ } /* Keyword.Constant */
601
+ .highlight .kd {
602
+ color: #d73a49;
603
+ font-weight: bold;
604
+ } /* Keyword.Declaration */
605
+ .highlight .kn {
606
+ color: #d73a49;
607
+ font-weight: bold;
608
+ } /* Keyword.Namespace */
609
+ .highlight .kp {
610
+ color: #d73a49;
611
+ font-weight: bold;
612
+ } /* Keyword.Pseudo */
613
+ .highlight .kr {
614
+ color: #d73a49;
615
+ font-weight: bold;
616
+ } /* Keyword.Reserved */
617
+ .highlight .kt {
618
+ color: #d73a49;
619
+ font-weight: bold;
620
+ } /* Keyword.Type */
621
+ .highlight .ld {
622
+ color: #032f62;
623
+ } /* Literal.Date */
624
+ .highlight .m {
625
+ color: #005cc5;
626
+ } /* Literal.Number */
627
+ .highlight .s {
628
+ color: #032f62;
629
+ } /* Literal.String */
630
+ .highlight .na {
631
+ color: #6f42c1;
632
+ } /* Name.Attribute */
633
+ .highlight .nb {
634
+ color: #005cc5;
635
+ } /* Name.Builtin */
636
+ .highlight .nc {
637
+ color: #6f42c1;
638
+ font-weight: bold;
639
+ } /* Name.Class */
640
+ .highlight .no {
641
+ color: #005cc5;
642
+ } /* Name.Constant */
643
+ .highlight .nd {
644
+ color: #6f42c1;
645
+ font-weight: bold;
646
+ } /* Name.Decorator */
647
+ .highlight .ni {
648
+ color: #800080;
649
+ } /* Name.Entity */
650
+ .highlight .ne {
651
+ color: #990000;
652
+ font-weight: bold;
653
+ } /* Name.Exception */
654
+ .highlight .nf {
655
+ color: #6f42c1;
656
+ } /* Name.Function */
657
+ .highlight .nl {
658
+ color: #990000;
659
+ } /* Name.Label */
660
+ .highlight .nn {
661
+ color: #555555;
662
+ } /* Name.Namespace */
663
+ .highlight .nx {
664
+ color: #6f42c1;
665
+ } /* Name.Other */
666
+ .highlight .py {
667
+ color: #990000;
668
+ } /* Name.Property */
669
+ .highlight .nt {
670
+ color: #22863a;
671
+ } /* Name.Tag */
672
+ .highlight .nv {
673
+ color: #e36209;
674
+ } /* Name.Variable */
675
+ .highlight .ow {
676
+ color: #d73a49;
677
+ font-weight: bold;
678
+ } /* Operator.Word */
679
+ .highlight .w {
680
+ color: #bbbbbb;
681
+ } /* Text.Whitespace */
682
+ .highlight .mf {
683
+ color: #005cc5;
684
+ } /* Literal.Number.Float */
685
+ .highlight .mh {
686
+ color: #005cc5;
687
+ } /* Literal.Number.Hex */
688
+ .highlight .mi {
689
+ color: #005cc5;
690
+ } /* Literal.Number.Integer */
691
+ .highlight .mo {
692
+ color: #005cc5;
693
+ } /* Literal.Number.Oct */
694
+ .highlight .sb {
695
+ color: #032f62;
696
+ } /* Literal.String.Backtick */
697
+ .highlight .sc {
698
+ color: #032f62;
699
+ } /* Literal.String.Char */
700
+ .highlight .sd {
701
+ color: #032f62;
702
+ } /* Literal.String.Doc */
703
+ .highlight .s2 {
704
+ color: #032f62;
705
+ } /* Literal.String.Double */
706
+ .highlight .se {
707
+ color: #032f62;
708
+ } /* Literal.String.Escape */
709
+ .highlight .sh {
710
+ color: #032f62;
711
+ } /* Literal.String.Heredoc */
712
+ .highlight .si {
713
+ color: #032f62;
714
+ } /* Literal.String.Interpol */
715
+ .highlight .sx {
716
+ color: #032f62;
717
+ } /* Literal.String.Other */
718
+ .highlight .sr {
719
+ color: #22863a;
720
+ } /* Literal.String.Regex */
721
+ .highlight .s1 {
722
+ color: #032f62;
723
+ } /* Literal.String.Single */
724
+ .highlight .ss {
725
+ color: #032f62;
726
+ } /* Literal.String.Symbol */
727
+ .highlight .bp {
728
+ color: #005cc5;
729
+ } /* Name.Builtin.Pseudo */
730
+ .highlight .vc {
731
+ color: #e36209;
732
+ } /* Name.Variable.Class */
733
+ .highlight .vg {
734
+ color: #e36209;
735
+ } /* Name.Variable.Global */
736
+ .highlight .vi {
737
+ color: #e36209;
738
+ } /* Name.Variable.Instance */
739
+ .highlight .il {
740
+ color: #005cc5;
741
+ } /* Literal.Number.Integer.Long */
742
+
743
+ /* Additional Rouge token classes that may be used */
744
+ .highlight .token {
745
+ color: #5670a0;
746
+ }
747
+ .highlight .token.list {
748
+ color: #546e9f;
749
+ }
750
+ .highlight .token.punctuation {
751
+ color: #3e8dad;
752
+ }
753
+ .highlight .token.list.punctuation {
754
+ color: #e05b78;
755
+ }
756
+ .highlight .token.content {
757
+ padding: 0;
758
+ }
759
+
760
+ /* Nested lists in page content */
761
+ ul ul,
762
+ ol ol,
763
+ ul ol,
764
+ ol ul {
765
+ padding-left: 1.5em;
766
+ margin-top: 0.25em;
767
+ }
768
+
769
+ /* Page footer */
770
+ .page-footer {
771
+ background: #f5f5f5;
772
+ border-top: 1px solid #ddd;
773
+ padding: 1.5rem;
774
+ margin-top: 3rem;
775
+ color: #666;
776
+ font-size: 0.9em;
777
+ }
778
+
779
+ .page-footer p {
780
+ margin: 0.5em 0;
781
+ }
782
+
783
+ .page-footer a {
784
+ color: #0066cc;
785
+ text-decoration: none;
786
+ }
787
+
788
+ .page-footer a:hover {
789
+ text-decoration: underline;
790
+ }
791
+
792
+ /* Mobile responsive */
793
+ @media (max-width: 768px) {
794
+ .hamburger-menu {
795
+ display: flex;
796
+ }
797
+
798
+ .main-toc,
799
+ .sidebar {
800
+ transform: translateX(-100%);
801
+ z-index: 175;
802
+ }
803
+
804
+ .main-toc.mobile-open,
805
+ .sidebar.mobile-open {
806
+ transform: translateX(0);
807
+ }
808
+
809
+ body {
810
+ margin: 2rem 1rem;
811
+ }
812
+
813
+ .floating-toc {
814
+ left: 0;
815
+ }
816
+ }
817
+
818
+ </style></head>
819
+
820
+ <body class="code-highlighted">
821
+ <div class="floating-toc" id="floating-toc">
822
+ <div class="floating-toc-container">
823
+ <div class="floating-toc-header">
824
+ <span>Table of Contents 🔻</span>
825
+ </div>
826
+ <div class="floating-toc-content" id="floating-toc-content">
827
+ <!-- Content will be populated by JavaScript -->
828
+ </div>
829
+ </div>
830
+ </div>
831
+
832
+ <button class="hamburger-menu" id="hamburger-menu" aria-label="Toggle navigation"></button>
833
+ <div class="mobile-menu-overlay" id="mobile-menu-overlay"></div>
834
+
835
+ <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="Callouts.html">Callouts</a></li><li><a href="Tables.html">Tables</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="Quarto-Mode.html">Quarto Mode</a></li><li><a href="Command-Line-Options.html">Command Line Options</a></li><li><a href="Rendering-Markdown-In-Terminal.html">Rendering Markdown in the Terminal</a></li><li><a href="Generating-Man-Pages.html">Generating Man Pages</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="Indices.html">Indices</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="Using-Apex-with-Jekyll.html">Using Apex with Jekyll</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="Writing-Tests.html">Writing Tests</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="Filters.html">Filters</a></li><li><a href="Troubleshooting.html">Troubleshooting</a></li><li><a href="Credits.html">Credits</a></li></ul></nav>
836
+
837
+ <h1 id="multi-format-images">
838
+ Multi-Format&nbsp;Images
839
+ </h1>
840
+ <nav class="page-toc" id="page-toc-top"><ul><li><a href="#multi-format-images">Multi-Format&nbsp;Images</a><ul><li><a href="#retina-2x-and-3x">Retina / @2x&nbsp;and&nbsp;@3x</a></li><li><a href="#webp-and-avif">WebP&nbsp;and&nbsp;AVIF</a></li><li><a href="#auto-discovery">Auto&nbsp;discovery</a></li><li><a href="#wildcard-extension">Wildcard extension&nbsp;(*)</a></li><li><a href="#video-urls">Video&nbsp;URLs</a><ul><li><a href="#video-format-alternatives">Video format&nbsp;alternatives</a></li><li><a href="#video-with-auto-or">Video with&nbsp;auto&nbsp;or&nbsp;*</a></li></ul></li><li><a href="#quick-reference">Quick&nbsp;reference</a></li><li><a href="#requirements">Requirements</a></li><li><a href="#see-also">See&nbsp;also</a></li></ul></li></ul></nav>
841
+
842
+ <p>
843
+ Apex extends standard Markdown image syntax with attributes for serving multiple image formats (WebP, AVIF), retina variants (@2x, @3x), and automatic format discovery. It also detects video URLs and emits <code>&lt;video&gt;</code> elements instead of <code>&lt;img&gt;</code> when appropriate.
844
+ </p>
845
+
846
+ <p>
847
+ These features are available in <strong>unified</strong>, <strong>MultiMarkdown</strong>, and <strong>GFM</strong> modes.
848
+ </p>
849
+
850
+ <h2 id="retina-2x-and-3x">
851
+ Retina / @2x&nbsp;and&nbsp;@3x
852
+ </h2>
853
+
854
+ <p>
855
+ Add <code>@2x</code> or <code>@3x</code> after the URL to generate a <code>srcset</code> for high-DPI displays. Apex assumes the variant has the same path with <code>@2x</code> or <code>@3x</code> inserted before the file extension (e.g. <code>icon.png</code> → <code>icon@2x.png</code>).
856
+ </p>
857
+
858
+ <div class="highlight">
859
+ <pre><span></span>![<span class="nt">Alt</span>](<span class="na">img/icon.png </span>)
860
+ ![<span class="nt">Alt</span>](<span class="na">img/hero.png </span>)
861
+ </pre>
862
+ </div>
863
+
864
+ <p>
865
+ <strong>Inline:</strong>
866
+ </p>
867
+
868
+ <div class="highlight">
869
+ <pre><span></span>![<span class="nt">Alt</span>](<span class="na">img/icon.png </span>)
870
+ ![<span class="nt">Alt</span>](<span class="na">img/icon.png </span>)
871
+ </pre>
872
+ </div>
873
+
874
+ <p>
875
+ <strong>Reference-style:</strong>
876
+ </p>
877
+
878
+ <div class="highlight">
879
+ <pre><span></span>![<span class="nt">Logo</span>](<span class="na">img/hero.png</span>)
880
+ </pre>
881
+ </div>
882
+
883
+ <p>
884
+ <strong>With IAL:</strong>
885
+ </p>
886
+
887
+ <div class="highlight">
888
+ <pre><span></span>![<span class="nt">Alt</span>](<span class="na">img/icon.png</span>)
889
+ </pre>
890
+ </div>
891
+
892
+ <p>
893
+ Output:
894
+ </p>
895
+
896
+ <div class="highlight">
897
+ <pre><span></span><span class="p">&lt;</span><span class="nt">img</span> <span class="na">src</span><span class="o">=</span><span class="s">&quot;img/icon.png&quot;</span> <span class="na">srcset</span><span class="o">=</span><span class="s">&quot;img/icon.png 1x, img/icon@2x.png 2x&quot;</span> <span class="na">alt</span><span class="o">=</span><span class="s">&quot;Alt&quot;</span><span class="p">&gt;</span>
898
+ </pre>
899
+ </div>
900
+
901
+ <h2 id="webp-and-avif">
902
+ WebP&nbsp;and&nbsp;AVIF
903
+ </h2>
904
+
905
+ <p>
906
+ Add <code>webp</code> or <code>avif</code> after the URL and Apex wraps the image in a <code>&lt;picture&gt;</code> element with the appropriate <code>&lt;source&gt;</code> tags. Browsers that support the format use it; others fall back to the main image.
907
+ </p>
908
+
909
+ <div class="highlight">
910
+ <pre><span></span>![<span class="nt">Hero</span>](<span class="na">img/hero.png </span>)
911
+ ![<span class="nt">Hero</span>](<span class="na">img/hero.png </span>)
912
+ ![<span class="nt">Modern formats</span>](<span class="na">img/banner.jpg </span>)
913
+ </pre>
914
+ </div>
915
+
916
+ <p>
917
+ Both attributes combine with <code>@2x</code> and <code>@3x</code> for retina srcsets:
918
+ </p>
919
+
920
+ <div class="highlight">
921
+ <pre><span></span>![<span class="nt">Retina WebP</span>](<span class="na">img/hero.png </span>)
922
+ ![<span class="nt">Retina AVIF</span>](<span class="na">img/hero.png </span>)
923
+ </pre>
924
+ </div>
925
+
926
+ <p>
927
+ You can combine format generation and image IAL attributes in one image:
928
+ </p>
929
+
930
+ <div class="highlight">
931
+ <pre><span></span>![<span class="nt">text-basic widget screenshot</span>](<span class="na">/assets/images/shots/macos/text-basic.jpg </span>)
932
+ </pre>
933
+ </div>
934
+
935
+ <p>
936
+ That produces a <code>&lt;picture&gt;</code> with AVIF sources and keeps <code>loading</code>, <code>width</code>, and <code>height</code> on the fallback <code>&lt;img&gt;</code>.
937
+ </p>
938
+
939
+ <h2 id="auto-discovery">
940
+ Auto&nbsp;discovery
941
+ </h2>
942
+
943
+ <p>
944
+ Use the <code>auto</code> attribute to discover formats from the filesystem. When <code>base_directory</code> is set (e.g. from the document path or <code>--base-directory</code>), Apex checks for existing variants and emits <code>&lt;picture&gt;</code> or <code>&lt;video&gt;</code> with only the variants that exist.
945
+ </p>
946
+
947
+ <p>
948
+ <strong>For images</strong>, Apex looks for:
949
+ </p>
950
+
951
+ <ul>
952
+
953
+ <li>
954
+ 2x and 3x variants (e.g. <code>image@2x.png</code>, <code>image@3x.png</code>)
955
+ </li>
956
+
957
+ <li>
958
+ WebP and AVIF versions (e.g. <code>image.webp</code>, <code>image.avif</code>)
959
+ </li>
960
+
961
+ </ul>
962
+
963
+ <div class="highlight">
964
+ <pre><span></span>![<span class="nt">Profile menu</span>](<span class="na">img/app-pass-1-profile-menu.jpg </span>)
965
+ </pre>
966
+ </div>
967
+
968
+ <h2 id="wildcard-extension">
969
+ Wildcard extension&nbsp;(*)
970
+ </h2>
971
+
972
+ <p>
973
+ Using <code>*</code> as the extension is equivalent to <code>auto</code>. It scans for jpg, png, gif, webp, and avif (plus 2x and 3x variants) for images, and mp4, webm, ogg, mov, and m4v for videos.
974
+ </p>
975
+
976
+ <div class="highlight">
977
+ <pre><span></span>![<span class="nt">Profile menu</span>](<span class="na">img/app-pass-1-profile-menu.*</span>)
978
+ </pre>
979
+ </div>
980
+
981
+ <p>
982
+ <code>![](image.*)</code> is equivalent to <code>![](image.png )</code>. The base filename is derived from the path; Apex discovers which formats exist on disk and generates the appropriate <code>&lt;picture&gt;</code> or <code>&lt;video&gt;</code> element.
983
+ </p>
984
+
985
+ <h2 id="video-urls">
986
+ Video&nbsp;URLs
987
+ </h2>
988
+
989
+ <p>
990
+ When the image URL ends in a video extension (mp4, mov, webm, ogg, ogv, m4v), Apex emits a <code>&lt;video&gt;</code> tag instead of <code>&lt;img&gt;</code>:
991
+ </p>
992
+
993
+ <div class="highlight">
994
+ <pre><span></span>![<span class="nt">Demo video</span>](<span class="na">media/demo.mp4</span>)
995
+ </pre>
996
+ </div>
997
+
998
+ <p>
999
+ Output:
1000
+ </p>
1001
+
1002
+ <div class="highlight">
1003
+ <pre><span></span><span class="p">&lt;</span><span class="nt">video</span><span class="p">&gt;&lt;</span><span class="nt">source</span> <span class="na">src</span><span class="o">=</span><span class="s">&quot;media/demo.mp4&quot;</span> <span class="na">type</span><span class="o">=</span><span class="s">&quot;video/mp4&quot;</span><span class="p">&gt;&lt;/</span><span class="nt">video</span><span class="p">&gt;</span>
1004
+ </pre>
1005
+ </div>
1006
+
1007
+ <h3 id="video-format-alternatives">
1008
+ Video format&nbsp;alternatives
1009
+ </h3>
1010
+
1011
+ <p>
1012
+ Add format attributes to include alternative sources for broader browser support:
1013
+ </p>
1014
+
1015
+ <div class="highlight">
1016
+ <pre><span></span>![<span class="nt">Demo with WebM</span>](<span class="na">media/demo.mp4 </span>)
1017
+ ![<span class="nt">Demo with OGG</span>](<span class="na">media/intro.mp4 </span>)
1018
+ </pre>
1019
+ </div>
1020
+
1021
+ <p>
1022
+ Apex adds <code>&lt;source&gt;</code> elements for each format. The primary URL stays as the fallback; the attributes add webm, ogg, or other formats before it.
1023
+ </p>
1024
+
1025
+ <h3 id="video-with-auto-or">
1026
+ Video with&nbsp;auto&nbsp;or&nbsp;*
1027
+ </h3>
1028
+
1029
+ <p>
1030
+ When using <code>auto</code> or <code>*</code> with a video base filename, Apex discovers which video formats exist (mp4, webm, ogg, mov, m4v) and emits a <code>&lt;video&gt;</code> element with the appropriate <code>&lt;source&gt;</code> tags.
1031
+ </p>
1032
+
1033
+ <h2 id="quick-reference">
1034
+ Quick&nbsp;reference
1035
+ </h2>
1036
+
1037
+ <table>
1038
+
1039
+ <thead>
1040
+
1041
+ <tr>
1042
+
1043
+ <th>
1044
+ Syntax
1045
+ </th>
1046
+
1047
+ <th>
1048
+ Result
1049
+ </th>
1050
+
1051
+ </tr>
1052
+
1053
+ </thead>
1054
+
1055
+ <tbody>
1056
+
1057
+ <tr>
1058
+
1059
+ <td>
1060
+ <code>![alt](url )</code>
1061
+ </td>
1062
+
1063
+ <td>
1064
+ <code>srcset</code> with 1x and 2x
1065
+ </td>
1066
+
1067
+ </tr>
1068
+ <tr>
1069
+
1070
+ <td>
1071
+ <code>![alt](url )</code>
1072
+ </td>
1073
+
1074
+ <td>
1075
+ <code>srcset</code> with 1x, 2x, and 3x
1076
+ </td>
1077
+
1078
+ </tr>
1079
+ <tr>
1080
+
1081
+ <td>
1082
+ <code>![alt](url )</code>
1083
+ </td>
1084
+
1085
+ <td>
1086
+ <code>&lt;picture&gt;</code> with WebP source
1087
+ </td>
1088
+
1089
+ </tr>
1090
+ <tr>
1091
+
1092
+ <td>
1093
+ <code>![alt](url )</code>
1094
+ </td>
1095
+
1096
+ <td>
1097
+ <code>&lt;picture&gt;</code> with AVIF source
1098
+ </td>
1099
+
1100
+ </tr>
1101
+ <tr>
1102
+
1103
+ <td>
1104
+ <code>![alt](url )</code>
1105
+ </td>
1106
+
1107
+ <td>
1108
+ WebP with retina srcset
1109
+ </td>
1110
+
1111
+ </tr>
1112
+ <tr>
1113
+
1114
+ <td>
1115
+ <code>![alt](url )</code>
1116
+ </td>
1117
+
1118
+ <td>
1119
+ Discovers formats from disk (requires base_directory)
1120
+ </td>
1121
+
1122
+ </tr>
1123
+ <tr>
1124
+
1125
+ <td>
1126
+ <code>![alt](url.*)</code>
1127
+ </td>
1128
+
1129
+ <td>
1130
+ Same as auto—scans image and video formats
1131
+ </td>
1132
+
1133
+ </tr>
1134
+ <tr>
1135
+
1136
+ <td>
1137
+ <code>![alt](video.mp4)</code>
1138
+ </td>
1139
+
1140
+ <td>
1141
+ <code>&lt;video&gt;</code> with mp4 source
1142
+ </td>
1143
+
1144
+ </tr>
1145
+ <tr>
1146
+
1147
+ <td>
1148
+ <code>![alt](video.mp4 )</code>
1149
+ </td>
1150
+
1151
+ <td>
1152
+ <code>&lt;video&gt;</code> with webm + mp4 fallback
1153
+ </td>
1154
+
1155
+ </tr>
1156
+ </tbody>
1157
+
1158
+ </table>
1159
+
1160
+ <h2 id="requirements">
1161
+ Requirements
1162
+ </h2>
1163
+
1164
+ <ul>
1165
+
1166
+ <li>
1167
+ <strong>base_directory</strong> must be set for <code>auto</code> and <code>*</code> to discover files. It is typically set automatically when processing a file, or via <code>--base-directory</code> or metadata.
1168
+ </li>
1169
+
1170
+ <li>
1171
+ Format attributes (<code>webp</code>, <code>avif</code>, <code>@2x</code>, <code>@3x</code>) work without base_directory; they generate URLs based on naming conventions.
1172
+ </li>
1173
+
1174
+ <li>
1175
+ Video format attributes (<code>webm</code>, <code>ogg</code>, etc.) also work without base_directory; they generate additional <code>&lt;source&gt;</code> elements from the primary URL path.
1176
+ </li>
1177
+
1178
+ </ul>
1179
+
1180
+ <h2 id="see-also">
1181
+ See&nbsp;also
1182
+ </h2>
1183
+
1184
+ <ul>
1185
+
1186
+ <li>
1187
+ <a href="Syntax.html">Syntax</a> — Full syntax reference
1188
+ </li>
1189
+
1190
+ <li>
1191
+ <a href="Inline-Attribute-Lists.html">Inline Attribute Lists</a> — IAL syntax for images
1192
+ </li>
1193
+
1194
+ </ul>
1195
+
1196
+ <script>
1197
+ // Hamburger menu functionality
1198
+ (function() {
1199
+ function initHamburgerMenu() {
1200
+ var hamburger = document.getElementById('hamburger-menu');
1201
+ var sidebar = document.querySelector('.main-toc, .sidebar');
1202
+ var overlay = document.getElementById('mobile-menu-overlay');
1203
+
1204
+ if (!hamburger || !sidebar) return;
1205
+
1206
+ function toggleMenu() {
1207
+ var isOpen = sidebar.classList.contains('mobile-open');
1208
+ if (isOpen) {
1209
+ sidebar.classList.remove('mobile-open');
1210
+ hamburger.classList.remove('active');
1211
+ if (overlay) overlay.classList.remove('active');
1212
+ } else {
1213
+ sidebar.classList.add('mobile-open');
1214
+ hamburger.classList.add('active');
1215
+ if (overlay) overlay.classList.add('active');
1216
+ }
1217
+ }
1218
+
1219
+ hamburger.addEventListener('click', function(e) {
1220
+ e.stopPropagation();
1221
+ toggleMenu();
1222
+ });
1223
+
1224
+ if (overlay) {
1225
+ overlay.addEventListener('click', function() {
1226
+ toggleMenu();
1227
+ });
1228
+ }
1229
+
1230
+ // Close menu when clicking on a sidebar link (mobile only)
1231
+ if (window.innerWidth <= 768) {
1232
+ var sidebarLinks = sidebar.querySelectorAll('a');
1233
+ sidebarLinks.forEach(function(link) {
1234
+ link.addEventListener('click', function() {
1235
+ setTimeout(function() {
1236
+ sidebar.classList.remove('mobile-open');
1237
+ hamburger.classList.remove('active');
1238
+ if (overlay) overlay.classList.remove('active');
1239
+ }, 100);
1240
+ });
1241
+ });
1242
+ }
1243
+
1244
+ // Close menu on window resize if going to desktop
1245
+ window.addEventListener('resize', function() {
1246
+ if (window.innerWidth > 768) {
1247
+ sidebar.classList.remove('mobile-open');
1248
+ hamburger.classList.remove('active');
1249
+ if (overlay) overlay.classList.remove('active');
1250
+ }
1251
+ });
1252
+ }
1253
+
1254
+ // Initialize when DOM is ready
1255
+ if (document.readyState === 'loading') {
1256
+ document.addEventListener('DOMContentLoaded', initHamburgerMenu);
1257
+ } else {
1258
+ initHamburgerMenu();
1259
+ }
1260
+ })();
1261
+
1262
+ </script>
1263
+ <script>
1264
+ (function() {
1265
+ // Clone the page TOC for floating TOC
1266
+ function initFloatingTOC() {
1267
+ var pageTOC = document.getElementById('page-toc-top');
1268
+ var floatingTOCContent = document.getElementById('floating-toc-content');
1269
+ var floatingTOC = document.getElementById('floating-toc');
1270
+
1271
+ if (!pageTOC || !floatingTOCContent || !floatingTOC) return;
1272
+
1273
+ // Clone the TOC structure
1274
+ var tocClone = pageTOC.cloneNode(true);
1275
+ tocClone.id = 'floating-toc-clone';
1276
+ floatingTOCContent.appendChild(tocClone);
1277
+
1278
+ // Update all links to use smooth scrolling
1279
+ var allTOCLinks = document.querySelectorAll('.page-toc a, .floating-toc-content a');
1280
+ allTOCLinks.forEach(function(link) {
1281
+ link.addEventListener('click', function(e) {
1282
+ var href = this.getAttribute('href');
1283
+ if (href && href.startsWith('#')) {
1284
+ e.preventDefault();
1285
+ var targetId = href.substring(1);
1286
+ var targetElement = document.getElementById(targetId);
1287
+ if (targetElement) {
1288
+ var offset = 20; // Offset from top
1289
+
1290
+ // Function to calculate absolute position from document top
1291
+ function getAbsoluteTop(element) {
1292
+ var top = 0;
1293
+ while (element) {
1294
+ top += element.offsetTop;
1295
+ element = element.offsetParent;
1296
+ }
1297
+ return top;
1298
+ }
1299
+
1300
+ var absoluteTop = getAbsoluteTop(targetElement);
1301
+ var scrollTop = window.pageYOffset || document.documentElement.scrollTop;
1302
+ var offsetPosition = absoluteTop - offset;
1303
+
1304
+ // Only scroll if we're not already at the target position
1305
+ if (Math.abs(scrollTop - offsetPosition) > 10) {
1306
+ window.scrollTo({
1307
+ top: Math.max(0, offsetPosition),
1308
+ behavior: 'smooth'
1309
+ });
1310
+ }
1311
+
1312
+ // Update URL hash without triggering scroll
1313
+ if (history.pushState) {
1314
+ history.pushState(null, null, href);
1315
+ }
1316
+ }
1317
+ }
1318
+ });
1319
+ });
1320
+
1321
+ // Handle scroll to show/hide floating TOC
1322
+ var tocTop = pageTOC.getBoundingClientRect().top + window.pageYOffset;
1323
+ var tocBottom = tocTop + pageTOC.offsetHeight;
1324
+
1325
+ function updateFloatingTOC() {
1326
+ var scrollY = window.pageYOffset || document.documentElement.scrollTop;
1327
+
1328
+ if (scrollY > tocBottom) {
1329
+ floatingTOC.classList.add('visible');
1330
+ } else {
1331
+ floatingTOC.classList.remove('visible');
1332
+ }
1333
+ }
1334
+
1335
+ // Throttle scroll events
1336
+ var ticking = false;
1337
+ window.addEventListener('scroll', function() {
1338
+ if (!ticking) {
1339
+ window.requestAnimationFrame(function() {
1340
+ updateFloatingTOC();
1341
+ ticking = false;
1342
+ });
1343
+ ticking = true;
1344
+ }
1345
+ });
1346
+
1347
+ // Initial check
1348
+ updateFloatingTOC();
1349
+ }
1350
+
1351
+ // Initialize when DOM is ready
1352
+ if (document.readyState === 'loading') {
1353
+ document.addEventListener('DOMContentLoaded', initFloatingTOC);
1354
+ } else {
1355
+ initFloatingTOC();
1356
+ }
1357
+ })();
1358
+ </script>
1359
+ <footer class="page-footer"><p>Copyright 2025 Brett Terpstra, All Rights Reserved | MIT License</p></footer></body>
1360
+
1361
+ </html>
1362
+