apex-ruby 1.0.18 → 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,1405 @@
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="quarto-mode">
838
+ Quarto&nbsp;Mode
839
+ </h1>
840
+ <nav class="page-toc" id="page-toc-top"><ul><li><a href="#quarto-mode">Quarto&nbsp;Mode</a><ul><li><a href="#quick-start">Quick&nbsp;start</a></li><li><a href="#enabled-by-default">Enabled&nbsp;by&nbsp;default</a></li><li><a href="#feature-overview">Feature&nbsp;overview</a></li><li><a href="#out-of-scope">Out&nbsp;of&nbsp;scope</a></li><li><a href="#per-feature-metadata-toggles">Per-feature metadata&nbsp;toggles</a></li><li><a href="#shortcodes-and-plugins">Shortcodes and&nbsp;plugins</a></li><li><a href="#test-fixtures">Test&nbsp;fixtures</a></li><li><a href="#related">Related</a></li></ul></li></ul></nav>
841
+
842
+ <p>
843
+ <strong>Command:</strong> <code>apex --mode quarto document.qmd</code>
844
+ </p>
845
+
846
+ <p>
847
+ Quarto mode targets <a href="https://quarto.org/docs/authoring/markdown-basics.html">Pandoc/Quarto markdown</a> for HTML output. It is a unified-family mode with Quarto-specific preprocessors enabled by default.
848
+ </p>
849
+
850
+ <h2 id="quick-start">
851
+ Quick&nbsp;start
852
+ </h2>
853
+
854
+ <div class="highlight">
855
+ <pre><span></span>apex<span class="w"> </span>document.qmd<span class="w"> </span>--mode<span class="w"> </span>quarto<span class="w"> </span>--standalone
856
+ apex<span class="w"> </span>document.qmd<span class="w"> </span>--mode<span class="w"> </span>quarto<span class="w"> </span>--standalone<span class="w"> </span>--script<span class="w"> </span>mermaid
857
+ </pre>
858
+ </div>
859
+
860
+ <p>
861
+ Metadata:
862
+ </p>
863
+
864
+ <div class="highlight">
865
+ <pre><span></span><span class="nn">---</span>
866
+ <span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">My Doc</span>
867
+ <span class="nt">mode</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">quarto</span>
868
+ <span class="nn">---</span>
869
+ </pre>
870
+ </div>
871
+
872
+ <h2 id="enabled-by-default">
873
+ Enabled&nbsp;by&nbsp;default
874
+ </h2>
875
+
876
+ <p>
877
+ Compared to unified mode, Quarto mode:
878
+ </p>
879
+
880
+ <ul>
881
+
882
+ <li>
883
+ Enables Quarto callouts, fenced divs, and bracketed spans
884
+ </li>
885
+
886
+ <li>
887
+ Enables Pandoc/Quarto preprocessors (raw content, lists, code fence attrs, diagrams, shortcodes)
888
+ </li>
889
+
890
+ <li>
891
+ Disables Marked-specific extensions, wiki links, and index syntax
892
+ </li>
893
+
894
+ <li>
895
+ Keeps <code>unsafe</code> HTML enabled (required for raw content and diagram blocks)
896
+ </li>
897
+
898
+ </ul>
899
+
900
+ <h2 id="feature-overview">
901
+ Feature&nbsp;overview
902
+ </h2>
903
+
904
+ <table>
905
+
906
+ <thead>
907
+
908
+ <tr>
909
+
910
+ <th>
911
+ Feature
912
+ </th>
913
+
914
+ <th>
915
+ Syntax
916
+ </th>
917
+
918
+ <th>
919
+ Notes
920
+ </th>
921
+
922
+ </tr>
923
+
924
+ </thead>
925
+
926
+ <tbody>
927
+
928
+ <tr>
929
+
930
+ <td>
931
+ Callouts
932
+ </td>
933
+
934
+ <td>
935
+ <code>::: {.callout-note}</code>
936
+ </td>
937
+
938
+ <td>
939
+ See <a href="Callouts.html">Callouts</a>
940
+ </td>
941
+
942
+ </tr>
943
+ <tr>
944
+
945
+ <td>
946
+ Bracketed spans
947
+ </td>
948
+
949
+ <td>
950
+ <code>[text]{.smallcaps}</code>
951
+ </td>
952
+
953
+ <td>
954
+ Semantic CSS in standalone output
955
+ </td>
956
+
957
+ </tr>
958
+ <tr>
959
+
960
+ <td>
961
+ fig-alt
962
+ </td>
963
+
964
+ <td>
965
+ <code>![Caption](img.png)</code>
966
+ </td>
967
+
968
+ <td>
969
+ Maps alt text to <code>&lt;img alt&gt;</code>
970
+ </td>
971
+
972
+ </tr>
973
+ <tr>
974
+
975
+ <td>
976
+ Raw content
977
+ </td>
978
+
979
+ <td>
980
+ <code>```{=html}</code> / <code>`{=html}`</code>
981
+ </td>
982
+
983
+ <td>
984
+ Requires unsafe
985
+ </td>
986
+
987
+ </tr>
988
+ <tr>
989
+
990
+ <td>
991
+ Example lists
992
+ </td>
993
+
994
+ <td>
995
+ <code>(@) Item</code>
996
+ </td>
997
+
998
+ <td>
999
+ Pandoc example list markers
1000
+ </td>
1001
+
1002
+ </tr>
1003
+ <tr>
1004
+
1005
+ <td>
1006
+ Roman lists
1007
+ </td>
1008
+
1009
+ <td>
1010
+ <code>i) Item</code>
1011
+ </td>
1012
+
1013
+ <td>
1014
+ lower-roman styling
1015
+ </td>
1016
+
1017
+ </tr>
1018
+ <tr>
1019
+
1020
+ <td>
1021
+ Line blocks
1022
+ </td>
1023
+
1024
+ <td>
1025
+ <code>| Line</code>
1026
+ </td>
1027
+
1028
+ <td>
1029
+ Preserves spacing
1030
+ </td>
1031
+
1032
+ </tr>
1033
+ <tr>
1034
+
1035
+ <td>
1036
+ Code fence attrs
1037
+ </td>
1038
+
1039
+ <td>
1040
+ <code>```{.python filename=&quot;x.py&quot;}</code>
1041
+ </td>
1042
+
1043
+ <td>
1044
+ data-* on <code>&lt;pre&gt;</code>
1045
+ </td>
1046
+
1047
+ </tr>
1048
+ <tr>
1049
+
1050
+ <td>
1051
+ Diagrams
1052
+ </td>
1053
+
1054
+ <td>
1055
+ <code>```{mermaid}</code> / <code>{dot}</code>
1056
+ </td>
1057
+
1058
+ <td>
1059
+ <code>&lt;pre class=&quot;mermaid&quot;&gt;</code>; auto mermaid.js in standalone
1060
+ </td>
1061
+
1062
+ </tr>
1063
+ <tr>
1064
+
1065
+ <td>
1066
+ Shortcodes
1067
+ </td>
1068
+
1069
+ <td>
1070
+ <code>{{&lt; pagebreak &gt;}}</code>, <code>{{&lt; kbd &gt;}}</code>, <code>{{&lt; include &gt;}}</code>
1071
+ </td>
1072
+
1073
+ <td>
1074
+ Thin core shim; kbd uses <a href="Plugins.html">Plugins</a>
1075
+ </td>
1076
+
1077
+ </tr>
1078
+ <tr>
1079
+
1080
+ <td>
1081
+ Cross-refs
1082
+ </td>
1083
+
1084
+ <td>
1085
+ <code>@fig-id</code>, <code>@sec-id</code>
1086
+ </td>
1087
+
1088
+ <td>
1089
+ Wrapped in <code>&lt;span class=&quot;quarto-xref&quot;&gt;</code> (display only; no resolution)
1090
+ </td>
1091
+
1092
+ </tr>
1093
+ <tr>
1094
+
1095
+ <td>
1096
+ Hidden divs
1097
+ </td>
1098
+
1099
+ <td>
1100
+ <code>::: {.hidden}</code>
1101
+ </td>
1102
+
1103
+ <td>
1104
+ Hidden via standalone CSS
1105
+ </td>
1106
+
1107
+ </tr>
1108
+ </tbody>
1109
+
1110
+ </table>
1111
+
1112
+ <h2 id="out-of-scope">
1113
+ Out&nbsp;of&nbsp;scope
1114
+ </h2>
1115
+
1116
+ <p>
1117
+ Apex does not implement Quarto’s full engine. These remain out of scope:
1118
+ </p>
1119
+
1120
+ <ul>
1121
+
1122
+ <li>
1123
+ Cell execution, project/site rendering, conditional content
1124
+ </li>
1125
+
1126
+ <li>
1127
+ Cross-ref resolution (<code>@fig-…</code> is marked up, not linked)
1128
+ </li>
1129
+
1130
+ <li>
1131
+ CSL/bibliography pipeline (use Apex citations separately if needed)
1132
+ </li>
1133
+
1134
+ <li>
1135
+ PDF/Typst/Word multi-format output (use <a href="Pandoc-Integration.html">Pandoc Integration</a>)
1136
+ </li>
1137
+
1138
+ </ul>
1139
+
1140
+ <h2 id="per-feature-metadata-toggles">
1141
+ Per-feature metadata&nbsp;toggles
1142
+ </h2>
1143
+
1144
+ <p>
1145
+ Individual preprocessors can be toggled in YAML:
1146
+ </p>
1147
+
1148
+ <div class="highlight">
1149
+ <pre><span></span><span class="nt">quarto-extensions</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
1150
+ <span class="nt">quarto-raw</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
1151
+ <span class="nt">quarto-list-continuation</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
1152
+ <span class="nt">quarto-line-blocks</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
1153
+ <span class="nt">quarto-roman-lists</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
1154
+ <span class="nt">quarto-code-attrs</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
1155
+ <span class="nt">quarto-diagrams</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
1156
+ <span class="nt">quarto-shortcodes</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
1157
+ <span class="nt">quarto-callouts</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
1158
+ <span class="nt">quarto-xrefs</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
1159
+ <span class="nt">quarto-strict-lists</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">false</span>
1160
+ </pre>
1161
+ </div>
1162
+
1163
+ <p>
1164
+ Set a key to <code>false</code> to disable that preprocessor while keeping <code>--mode quarto</code>.
1165
+ </p>
1166
+
1167
+ <h2 Feature id="shortcodes-and-plugins">
1168
+ Shortcodes and&nbsp;plugins
1169
+ </h2>
1170
+
1171
+ <p>
1172
+ Core converts a small set of Quarto shortcodes before parsing:
1173
+ </p>
1174
+
1175
+ <ul>
1176
+
1177
+ <li>
1178
+ <code>{{&lt; pagebreak &gt;}}</code> → page break HTML
1179
+ </li>
1180
+
1181
+ <li>
1182
+ <code>{{&lt; kbd ... &gt;}}</code> → <code>&lt;span class=&quot;keycombo combined&quot; title=&quot;...&quot;&gt;&lt;kbd class=&quot;key symbol&quot;&gt;...&lt;/kbd&gt;&lt;/span&gt;</code> (render with the <a href="https://github.com/ApexMarkdown/apex-kbd-plugin">kbd plugin</a>)
1183
+ </li>
1184
+
1185
+ <li>
1186
+ <code>{{&lt; include file.md &gt;}}</code> → <code>&lt;&lt;[file.md]&gt;</code> include syntax
1187
+ </li>
1188
+
1189
+ </ul>
1190
+
1191
+ <p>
1192
+ Other shortcodes (e.g. <code>{{&lt; video &gt;}}</code>) should be handled by <a href="Plugins.html">plugins</a>. Unknown shortcodes pass through unchanged; set <code>APEX_VERBOSE=1</code> for warnings.
1193
+ </p>
1194
+
1195
+ <h2 Syntax id="test-fixtures">
1196
+ Test&nbsp;fixtures
1197
+ </h2>
1198
+
1199
+ <p>
1200
+ Examples live under <code>tests/fixtures/quarto/</code> in the Apex repository:
1201
+ </p>
1202
+
1203
+ <ul>
1204
+
1205
+ <li>
1206
+ <code>smoke.md</code> — integration smoke test
1207
+ </li>
1208
+
1209
+ <li>
1210
+ <code>callouts.md</code>, <code>spans.md</code>, <code>raw-content.md</code>, <code>lists.md</code>, <code>code-attrs.md</code>, <code>diagrams.md</code>, <code>shortcodes.md</code>
1211
+ </li>
1212
+
1213
+ </ul>
1214
+
1215
+ <h2 Notes id="related">
1216
+ Related
1217
+ </h2>
1218
+
1219
+ <ul>
1220
+
1221
+ <li>
1222
+ <a href="Modes.html">Modes</a> — all processor modes
1223
+ </li>
1224
+
1225
+ <li>
1226
+ <a href="Command-Line-Options.html">Command Line Options</a> — <code>--mode quarto</code>
1227
+ </li>
1228
+
1229
+ <li>
1230
+ <a href="Callouts.html">Callouts</a> — Quarto callout syntax
1231
+ </li>
1232
+
1233
+ <li>
1234
+ <a href="Plugins.html">Plugins</a> — extending shortcodes and syntax
1235
+ </li>
1236
+
1237
+ </ul>
1238
+
1239
+ <script>
1240
+ // Hamburger menu functionality
1241
+ (function() {
1242
+ function initHamburgerMenu() {
1243
+ var hamburger = document.getElementById('hamburger-menu');
1244
+ var sidebar = document.querySelector('.main-toc, .sidebar');
1245
+ var overlay = document.getElementById('mobile-menu-overlay');
1246
+
1247
+ if (!hamburger || !sidebar) return;
1248
+
1249
+ function toggleMenu() {
1250
+ var isOpen = sidebar.classList.contains('mobile-open');
1251
+ if (isOpen) {
1252
+ sidebar.classList.remove('mobile-open');
1253
+ hamburger.classList.remove('active');
1254
+ if (overlay) overlay.classList.remove('active');
1255
+ } else {
1256
+ sidebar.classList.add('mobile-open');
1257
+ hamburger.classList.add('active');
1258
+ if (overlay) overlay.classList.add('active');
1259
+ }
1260
+ }
1261
+
1262
+ hamburger.addEventListener('click', function(e) {
1263
+ e.stopPropagation();
1264
+ toggleMenu();
1265
+ });
1266
+
1267
+ if (overlay) {
1268
+ overlay.addEventListener('click', function() {
1269
+ toggleMenu();
1270
+ });
1271
+ }
1272
+
1273
+ // Close menu when clicking on a sidebar link (mobile only)
1274
+ if (window.innerWidth <= 768) {
1275
+ var sidebarLinks = sidebar.querySelectorAll('a');
1276
+ sidebarLinks.forEach(function(link) {
1277
+ link.addEventListener('click', function() {
1278
+ setTimeout(function() {
1279
+ sidebar.classList.remove('mobile-open');
1280
+ hamburger.classList.remove('active');
1281
+ if (overlay) overlay.classList.remove('active');
1282
+ }, 100);
1283
+ });
1284
+ });
1285
+ }
1286
+
1287
+ // Close menu on window resize if going to desktop
1288
+ window.addEventListener('resize', function() {
1289
+ if (window.innerWidth > 768) {
1290
+ sidebar.classList.remove('mobile-open');
1291
+ hamburger.classList.remove('active');
1292
+ if (overlay) overlay.classList.remove('active');
1293
+ }
1294
+ });
1295
+ }
1296
+
1297
+ // Initialize when DOM is ready
1298
+ if (document.readyState === 'loading') {
1299
+ document.addEventListener('DOMContentLoaded', initHamburgerMenu);
1300
+ } else {
1301
+ initHamburgerMenu();
1302
+ }
1303
+ })();
1304
+
1305
+ </script>
1306
+ <script>
1307
+ (function() {
1308
+ // Clone the page TOC for floating TOC
1309
+ function initFloatingTOC() {
1310
+ var pageTOC = document.getElementById('page-toc-top');
1311
+ var floatingTOCContent = document.getElementById('floating-toc-content');
1312
+ var floatingTOC = document.getElementById('floating-toc');
1313
+
1314
+ if (!pageTOC || !floatingTOCContent || !floatingTOC) return;
1315
+
1316
+ // Clone the TOC structure
1317
+ var tocClone = pageTOC.cloneNode(true);
1318
+ tocClone.id = 'floating-toc-clone';
1319
+ floatingTOCContent.appendChild(tocClone);
1320
+
1321
+ // Update all links to use smooth scrolling
1322
+ var allTOCLinks = document.querySelectorAll('.page-toc a, .floating-toc-content a');
1323
+ allTOCLinks.forEach(function(link) {
1324
+ link.addEventListener('click', function(e) {
1325
+ var href = this.getAttribute('href');
1326
+ if (href && href.startsWith('#')) {
1327
+ e.preventDefault();
1328
+ var targetId = href.substring(1);
1329
+ var targetElement = document.getElementById(targetId);
1330
+ if (targetElement) {
1331
+ var offset = 20; // Offset from top
1332
+
1333
+ // Function to calculate absolute position from document top
1334
+ function getAbsoluteTop(element) {
1335
+ var top = 0;
1336
+ while (element) {
1337
+ top += element.offsetTop;
1338
+ element = element.offsetParent;
1339
+ }
1340
+ return top;
1341
+ }
1342
+
1343
+ var absoluteTop = getAbsoluteTop(targetElement);
1344
+ var scrollTop = window.pageYOffset || document.documentElement.scrollTop;
1345
+ var offsetPosition = absoluteTop - offset;
1346
+
1347
+ // Only scroll if we're not already at the target position
1348
+ if (Math.abs(scrollTop - offsetPosition) > 10) {
1349
+ window.scrollTo({
1350
+ top: Math.max(0, offsetPosition),
1351
+ behavior: 'smooth'
1352
+ });
1353
+ }
1354
+
1355
+ // Update URL hash without triggering scroll
1356
+ if (history.pushState) {
1357
+ history.pushState(null, null, href);
1358
+ }
1359
+ }
1360
+ }
1361
+ });
1362
+ });
1363
+
1364
+ // Handle scroll to show/hide floating TOC
1365
+ var tocTop = pageTOC.getBoundingClientRect().top + window.pageYOffset;
1366
+ var tocBottom = tocTop + pageTOC.offsetHeight;
1367
+
1368
+ function updateFloatingTOC() {
1369
+ var scrollY = window.pageYOffset || document.documentElement.scrollTop;
1370
+
1371
+ if (scrollY > tocBottom) {
1372
+ floatingTOC.classList.add('visible');
1373
+ } else {
1374
+ floatingTOC.classList.remove('visible');
1375
+ }
1376
+ }
1377
+
1378
+ // Throttle scroll events
1379
+ var ticking = false;
1380
+ window.addEventListener('scroll', function() {
1381
+ if (!ticking) {
1382
+ window.requestAnimationFrame(function() {
1383
+ updateFloatingTOC();
1384
+ ticking = false;
1385
+ });
1386
+ ticking = true;
1387
+ }
1388
+ });
1389
+
1390
+ // Initial check
1391
+ updateFloatingTOC();
1392
+ }
1393
+
1394
+ // Initialize when DOM is ready
1395
+ if (document.readyState === 'loading') {
1396
+ document.addEventListener('DOMContentLoaded', initFloatingTOC);
1397
+ } else {
1398
+ initFloatingTOC();
1399
+ }
1400
+ })();
1401
+ </script>
1402
+ <footer class="page-footer"><p>Copyright 2025 Brett Terpstra, All Rights Reserved | MIT License</p></footer></body>
1403
+
1404
+ </html>
1405
+