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.
- checksums.yaml +4 -4
- data/README.md +17 -3
- data/ext/apex_ext/apex_ext.c +260 -91
- data/ext/apex_ext/apex_src/CHANGELOG.md +440 -0
- data/ext/apex_ext/apex_src/CMakeLists.txt +15 -1
- data/ext/apex_ext/apex_src/Formula/apex.rb +7 -2
- data/ext/apex_ext/apex_src/Package.swift +15 -4
- data/ext/apex_ext/apex_src/README.md +94 -35
- data/ext/apex_ext/apex_src/VERSION +1 -1
- data/ext/apex_ext/apex_src/apex-debug.log +4 -0
- data/ext/apex_ext/apex_src/apex.code-workspace +38 -0
- data/ext/apex_ext/apex_src/apex.taskpaper +12 -0
- data/ext/apex_ext/apex_src/apex_deflist_debug.log +25 -0
- data/ext/apex_ext/apex_src/buildnotes.md +1435 -0
- data/ext/apex_ext/apex_src/cli/main.c +262 -33
- data/ext/apex_ext/apex_src/debug.log +7 -0
- data/ext/apex_ext/apex_src/docs/CITATIONS_EXAMPLES.md +274 -0
- data/ext/apex_ext/apex_src/docs/CITATIONS_IMPLEMENTATION_PLAN.md +749 -0
- data/ext/apex_ext/apex_src/docs/CITATIONS_PLAN.md +744 -0
- data/ext/apex_ext/apex_src/docs/INDEX_IMPLEMENTATION_ANALYSIS.md +382 -0
- data/ext/apex_ext/apex_src/docs/plans/2025-02-27-man-page-output-implementation.md +351 -0
- data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-12-toc-output-format.md +745 -0
- data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-18-bear-image-attributes.md +829 -0
- data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-19-apex-node-npm.md +1148 -0
- data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-12-toc-output-format-design.md +161 -0
- data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-18-bear-image-attributes-design.md +184 -0
- data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-19-apex-node-npm-design.md +211 -0
- data/ext/apex_ext/apex_src/documentation/app-settings-table.md +67 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Citations.md +340 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Credits.md +11 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Header-IDs.md +234 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Inline-Attribute-Lists.md +516 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Metadata-Transforms.md +461 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Modes.md +193 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Multi-File-Documents.md +201 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Plugins.md +678 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Syntax.md +1367 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex Command Line Options.cheatsheet.txt +6 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/C-API.html +774 -300
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Callouts.html +1194 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Citations.html +416 -216
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Command-Line-Options.html +3544 -1094
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Configuration.html +371 -97
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Credits.html +153 -23
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Examples.html +358 -124
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Filters.html +1656 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Generating-Man-Pages.html +1226 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Getting-Started.html +201 -56
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Header-IDs.html +279 -109
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Home.html +200 -53
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Indices.html +2327 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Inline-Attribute-Lists.html +690 -271
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Installation.html +201 -55
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Limitations-and-Roadmap.html +238 -68
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Metadata-Transforms.html +421 -221
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Modes.html +340 -78
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Multi-File-Documents.html +251 -86
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Multi-Format-Images.html +1362 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Pandoc-Integration.html +277 -90
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Plugins.html +673 -346
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Quarto-Mode.html +1405 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Rendering-Markdown-In-Terminal.html +1902 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Syntax.html +1939 -1698
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Tables.html +1781 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Troubleshooting.html +315 -140
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Usage.html +307 -113
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Using-Apex-with-Jekyll.html +1132 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Writing-Tests.html +1754 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Xcode-Integration.html +872 -376
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/docSet.dsidx +0 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/optimizedIndex.dsidx +0 -0
- data/ext/apex_ext/apex_src/documentation/html/apex-app-docs.html +8746 -0
- data/ext/apex_ext/apex_src/documentation/shared_styles.css +20 -15
- data/ext/apex_ext/apex_src/documentation/transform_for_app.md +55 -0
- data/ext/apex_ext/apex_src/escaping-repro.md +103 -0
- data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/Info.plist +8 -0
- data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/QuickLook/Preview.png +0 -0
- data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/document.wflow +547 -0
- data/ext/apex_ext/apex_src/examples/quick-actions/Markdown-to-RTF.workflow.zip +0 -0
- data/ext/apex_ext/apex_src/examples/quick-actions/README.md +33 -0
- data/ext/apex_ext/apex_src/include/apex/apex.h +92 -6
- data/ext/apex_ext/apex_src/include/apex/ast_rtf.h +23 -0
- data/ext/apex_ext/apex_src/include/apex/ast_terminal.h +6 -0
- data/ext/apex_ext/apex_src/include/apex/module.modulemap +5 -0
- data/ext/apex_ext/apex_src/include/apex/plugins.h +105 -0
- data/ext/apex_ext/apex_src/include/apexc.h +1 -0
- data/ext/apex_ext/apex_src/man/apex.1 +82 -78
- data/ext/apex_ext/apex_src/man/apex.1.md +81 -4
- data/ext/apex_ext/apex_src/objc/Apex.swift +73 -0
- data/ext/apex_ext/apex_src/objc/ApexPlugins.swift +79 -0
- data/ext/apex_ext/apex_src/objc/NSString+Apex.h +83 -5
- data/ext/apex_ext/apex_src/objc/NSString+Apex.m +244 -1
- data/ext/apex_ext/apex_src/objc/NSString+ApexPlugins.h +76 -0
- data/ext/apex_ext/apex_src/objc/NSString+ApexPlugins.m +169 -0
- data/ext/apex_ext/apex_src/output.html +87 -0
- data/ext/apex_ext/apex_src/plans/quarto-mode.md +442 -0
- data/ext/apex_ext/apex_src/src/_README.md +85 -32
- data/ext/apex_ext/apex_src/src/apex.c +770 -200
- data/ext/apex_ext/apex_src/src/ast_rtf.c +848 -0
- data/ext/apex_ext/apex_src/src/ast_terminal.c +184 -7
- data/ext/apex_ext/apex_src/src/extensions/abbreviations.c +10 -3
- data/ext/apex_ext/apex_src/src/extensions/advanced_tables.c +7 -11
- data/ext/apex_ext/apex_src/src/extensions/bear_image_attrs.c +467 -0
- data/ext/apex_ext/apex_src/src/extensions/bear_image_attrs.h +27 -0
- data/ext/apex_ext/apex_src/src/extensions/callouts.c +400 -4
- data/ext/apex_ext/apex_src/src/extensions/callouts.h +15 -5
- data/ext/apex_ext/apex_src/src/extensions/citations.c +26 -5
- data/ext/apex_ext/apex_src/src/extensions/code_fence_attrs.c +632 -0
- data/ext/apex_ext/apex_src/src/extensions/code_fence_attrs.h +22 -0
- data/ext/apex_ext/apex_src/src/extensions/concordance.c +632 -0
- data/ext/apex_ext/apex_src/src/extensions/definition_list.c +129 -15
- data/ext/apex_ext/apex_src/src/extensions/grid_tables.c +1050 -121
- data/ext/apex_ext/apex_src/src/extensions/html_markdown.c +569 -16
- data/ext/apex_ext/apex_src/src/extensions/ial.c +502 -52
- data/ext/apex_ext/apex_src/src/extensions/ial.h +2 -1
- data/ext/apex_ext/apex_src/src/extensions/includes.c +532 -33
- data/ext/apex_ext/apex_src/src/extensions/includes.h +7 -1
- data/ext/apex_ext/apex_src/src/extensions/index.c +1427 -140
- data/ext/apex_ext/apex_src/src/extensions/index.h +28 -0
- data/ext/apex_ext/apex_src/src/extensions/metadata.c +200 -161
- data/ext/apex_ext/apex_src/src/extensions/quarto_diagrams.c +251 -0
- data/ext/apex_ext/apex_src/src/extensions/quarto_diagrams.h +22 -0
- data/ext/apex_ext/apex_src/src/extensions/quarto_lists.c +624 -0
- data/ext/apex_ext/apex_src/src/extensions/quarto_lists.h +35 -0
- data/ext/apex_ext/apex_src/src/extensions/quarto_polish.c +264 -0
- data/ext/apex_ext/apex_src/src/extensions/quarto_polish.h +23 -0
- data/ext/apex_ext/apex_src/src/extensions/quarto_shortcodes.c +307 -0
- data/ext/apex_ext/apex_src/src/extensions/quarto_shortcodes.h +21 -0
- data/ext/apex_ext/apex_src/src/extensions/raw_content.c +351 -0
- data/ext/apex_ext/apex_src/src/extensions/raw_content.h +20 -0
- data/ext/apex_ext/apex_src/src/extensions/relaxed_tables.c +117 -3
- data/ext/apex_ext/apex_src/src/extensions/special_markers.c +53 -0
- data/ext/apex_ext/apex_src/src/extensions/syntax_highlight.c +23 -1
- data/ext/apex_ext/apex_src/src/extensions/table_html_postprocess.c +83 -92
- data/ext/apex_ext/apex_src/src/extensions/toc.c +446 -25
- data/ext/apex_ext/apex_src/src/extensions/toc.h +26 -1
- data/ext/apex_ext/apex_src/src/extensions/wiki_links.c +28 -0
- data/ext/apex_ext/apex_src/src/html_renderer.c +387 -17
- data/ext/apex_ext/apex_src/src/plugin_catalog.c +517 -0
- data/ext/apex_ext/apex_src/src/plugins_remote.c +88 -14
- data/ext/apex_ext/apex_src/src/plugins_remote.h +34 -0
- data/ext/apex_ext/apex_src/src/pretty_html.c +6 -1
- data/ext/apex_ext/apex_src/tests/fixtures/comprehensive_test.md +21 -0
- data/ext/apex_ext/apex_src/tests/fixtures/images/bear_image_attributes.md +10 -0
- data/ext/apex_ext/apex_src/tests/fixtures/includes/sections.md +19 -0
- data/ext/apex_ext/apex_src/tests/fixtures/includes/sections.txt +11 -0
- data/ext/apex_ext/apex_src/tests/fixtures/minimal_pb.md +2 -0
- data/ext/apex_ext/apex_src/tests/fixtures/obsidian-callouts.md +46 -0
- data/ext/apex_ext/apex_src/tests/fixtures/pagebreak_html_repro.md +5 -0
- data/ext/apex_ext/apex_src/tests/fixtures/python-callouts.md +47 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/callouts.md +3 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/code-attrs.md +3 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/diagrams.md +8 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/lists.md +19 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/raw-content.md +5 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/shortcodes.md +7 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/smoke.md +81 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/spans.md +5 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto-callouts.md +47 -0
- data/ext/apex_ext/apex_src/tests/fixtures/speed.md +192 -0
- data/ext/apex_ext/apex_src/tests/fixtures/tables/grid-tables.md +37 -0
- data/ext/apex_ext/apex_src/tests/paginate_cli_test.sh +16 -0
- data/ext/apex_ext/apex_src/tests/test_bear_image_attrs.c +301 -0
- data/ext/apex_ext/apex_src/tests/test_concordance.tsv +4 -0
- data/ext/apex_ext/apex_src/tests/test_escaping_repro.c +82 -0
- data/ext/apex_ext/apex_src/tests/test_extensions.c +821 -1
- data/ext/apex_ext/apex_src/tests/test_ial.c +7 -0
- data/ext/apex_ext/apex_src/tests/test_marked_integration.c +25 -0
- data/ext/apex_ext/apex_src/tests/test_metadata.c +129 -0
- data/ext/apex_ext/apex_src/tests/test_output.c +568 -2
- data/ext/apex_ext/apex_src/tests/test_runner.c +11 -0
- data/ext/apex_ext/apex_src/tests/test_tables.c +420 -0
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/CMakeLists.txt +1 -1
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/extensions/autolink.c +77 -1
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/extensions/table.c +135 -5
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/blocks.c +56 -1
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/config.h +38 -0
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/main.c +1 -1
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/__pycache__/cmark.cpython-314.pyc +0 -0
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/__pycache__/normalize.cpython-314.pyc +0 -0
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/extensions.txt +69 -0
- data/ext/apex_ext/apex_src/xcode_build/CMakeScripts/ReRunCMake.make +74 -0
- data/ext/apex_ext/apex_src/xcode_build/CTestTestfile.cmake +22 -0
- data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/Apex +0 -0
- data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/Resources/Info.plist +44 -0
- data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/_CodeSignature/CodeResources +128 -0
- data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.pbxproj +5118 -0
- data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings +8 -0
- data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcuserdata/ttscoff.xcuserdatad/UserInterfaceState.xcuserstate +0 -0
- data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcuserdata/ttscoff.xcuserdatad/WorkspaceSettings.xcsettings +8 -0
- data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/xcuserdata/ttscoff.xcuserdatad/xcschemes/xcschememanagement.plist +99 -0
- data/ext/apex_ext/apex_src/xcode_build/cmake_install.cmake +452 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/CMakeScripts/ReRunCMake.make +52 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmake_install.cmake +55 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmark-gfm.xcodeproj/project.pbxproj +2455 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmark-gfm.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings +8 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/extensions/cmake_install.cmake +171 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/man/cmake_install.cmake +55 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmake_install.cmake +220 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmark-gfm_export.h +43 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmark-gfm_version.h +7 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/config.h +76 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/libcmark-gfm.pc +10 -0
- data/ext/apex_ext/extconf.rb +35 -0
- data/lib/apex/version.rb +2 -2
- metadata +117 -2
- 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 Images
|
|
839
|
+
</h1>
|
|
840
|
+
<nav class="page-toc" id="page-toc-top"><ul><li><a href="#multi-format-images">Multi-Format Images</a><ul><li><a href="#retina-2x-and-3x">Retina / @2x and @3x</a></li><li><a href="#webp-and-avif">WebP and AVIF</a></li><li><a href="#auto-discovery">Auto discovery</a></li><li><a href="#wildcard-extension">Wildcard extension (*)</a></li><li><a href="#video-urls">Video URLs</a><ul><li><a href="#video-format-alternatives">Video format alternatives</a></li><li><a href="#video-with-auto-or">Video with auto or *</a></li></ul></li><li><a href="#quick-reference">Quick reference</a></li><li><a href="#requirements">Requirements</a></li><li><a href="#see-also">See 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><video></code> elements instead of <code><img></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 and @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>
|
|
860
|
+

|
|
861
|
+
</pre>
|
|
862
|
+
</div>
|
|
863
|
+
|
|
864
|
+
<p>
|
|
865
|
+
<strong>Inline:</strong>
|
|
866
|
+
</p>
|
|
867
|
+
|
|
868
|
+
<div class="highlight">
|
|
869
|
+
<pre><span></span>
|
|
870
|
+

|
|
871
|
+
</pre>
|
|
872
|
+
</div>
|
|
873
|
+
|
|
874
|
+
<p>
|
|
875
|
+
<strong>Reference-style:</strong>
|
|
876
|
+
</p>
|
|
877
|
+
|
|
878
|
+
<div class="highlight">
|
|
879
|
+
<pre><span></span>
|
|
880
|
+
</pre>
|
|
881
|
+
</div>
|
|
882
|
+
|
|
883
|
+
<p>
|
|
884
|
+
<strong>With IAL:</strong>
|
|
885
|
+
</p>
|
|
886
|
+
|
|
887
|
+
<div class="highlight">
|
|
888
|
+
<pre><span></span>
|
|
889
|
+
</pre>
|
|
890
|
+
</div>
|
|
891
|
+
|
|
892
|
+
<p>
|
|
893
|
+
Output:
|
|
894
|
+
</p>
|
|
895
|
+
|
|
896
|
+
<div class="highlight">
|
|
897
|
+
<pre><span></span><span class="p"><</span><span class="nt">img</span> <span class="na">src</span><span class="o">=</span><span class="s">"img/icon.png"</span> <span class="na">srcset</span><span class="o">=</span><span class="s">"img/icon.png 1x, img/icon@2x.png 2x"</span> <span class="na">alt</span><span class="o">=</span><span class="s">"Alt"</span><span class="p">></span>
|
|
898
|
+
</pre>
|
|
899
|
+
</div>
|
|
900
|
+
|
|
901
|
+
<h2 id="webp-and-avif">
|
|
902
|
+
WebP and 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><picture></code> element with the appropriate <code><source></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>
|
|
911
|
+

|
|
912
|
+

|
|
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>
|
|
922
|
+

|
|
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>
|
|
932
|
+
</pre>
|
|
933
|
+
</div>
|
|
934
|
+
|
|
935
|
+
<p>
|
|
936
|
+
That produces a <code><picture></code> with AVIF sources and keeps <code>loading</code>, <code>width</code>, and <code>height</code> on the fallback <code><img></code>.
|
|
937
|
+
</p>
|
|
938
|
+
|
|
939
|
+
<h2 id="auto-discovery">
|
|
940
|
+
Auto 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><picture></code> or <code><video></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>
|
|
965
|
+
</pre>
|
|
966
|
+
</div>
|
|
967
|
+
|
|
968
|
+
<h2 id="wildcard-extension">
|
|
969
|
+
Wildcard extension (*)
|
|
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>
|
|
978
|
+
</pre>
|
|
979
|
+
</div>
|
|
980
|
+
|
|
981
|
+
<p>
|
|
982
|
+
<code></code> is equivalent to <code></code>. The base filename is derived from the path; Apex discovers which formats exist on disk and generates the appropriate <code><picture></code> or <code><video></code> element.
|
|
983
|
+
</p>
|
|
984
|
+
|
|
985
|
+
<h2 id="video-urls">
|
|
986
|
+
Video 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><video></code> tag instead of <code><img></code>:
|
|
991
|
+
</p>
|
|
992
|
+
|
|
993
|
+
<div class="highlight">
|
|
994
|
+
<pre><span></span>
|
|
995
|
+
</pre>
|
|
996
|
+
</div>
|
|
997
|
+
|
|
998
|
+
<p>
|
|
999
|
+
Output:
|
|
1000
|
+
</p>
|
|
1001
|
+
|
|
1002
|
+
<div class="highlight">
|
|
1003
|
+
<pre><span></span><span class="p"><</span><span class="nt">video</span><span class="p">><</span><span class="nt">source</span> <span class="na">src</span><span class="o">=</span><span class="s">"media/demo.mp4"</span> <span class="na">type</span><span class="o">=</span><span class="s">"video/mp4"</span><span class="p">></</span><span class="nt">video</span><span class="p">></span>
|
|
1004
|
+
</pre>
|
|
1005
|
+
</div>
|
|
1006
|
+
|
|
1007
|
+
<h3 id="video-format-alternatives">
|
|
1008
|
+
Video format 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>
|
|
1017
|
+

|
|
1018
|
+
</pre>
|
|
1019
|
+
</div>
|
|
1020
|
+
|
|
1021
|
+
<p>
|
|
1022
|
+
Apex adds <code><source></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 auto or *
|
|
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><video></code> element with the appropriate <code><source></code> tags.
|
|
1031
|
+
</p>
|
|
1032
|
+
|
|
1033
|
+
<h2 id="quick-reference">
|
|
1034
|
+
Quick 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></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></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></code>
|
|
1083
|
+
</td>
|
|
1084
|
+
|
|
1085
|
+
<td>
|
|
1086
|
+
<code><picture></code> with WebP source
|
|
1087
|
+
</td>
|
|
1088
|
+
|
|
1089
|
+
</tr>
|
|
1090
|
+
<tr>
|
|
1091
|
+
|
|
1092
|
+
<td>
|
|
1093
|
+
<code></code>
|
|
1094
|
+
</td>
|
|
1095
|
+
|
|
1096
|
+
<td>
|
|
1097
|
+
<code><picture></code> with AVIF source
|
|
1098
|
+
</td>
|
|
1099
|
+
|
|
1100
|
+
</tr>
|
|
1101
|
+
<tr>
|
|
1102
|
+
|
|
1103
|
+
<td>
|
|
1104
|
+
<code></code>
|
|
1105
|
+
</td>
|
|
1106
|
+
|
|
1107
|
+
<td>
|
|
1108
|
+
WebP with retina srcset
|
|
1109
|
+
</td>
|
|
1110
|
+
|
|
1111
|
+
</tr>
|
|
1112
|
+
<tr>
|
|
1113
|
+
|
|
1114
|
+
<td>
|
|
1115
|
+
<code></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></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></code>
|
|
1138
|
+
</td>
|
|
1139
|
+
|
|
1140
|
+
<td>
|
|
1141
|
+
<code><video></code> with mp4 source
|
|
1142
|
+
</td>
|
|
1143
|
+
|
|
1144
|
+
</tr>
|
|
1145
|
+
<tr>
|
|
1146
|
+
|
|
1147
|
+
<td>
|
|
1148
|
+
<code></code>
|
|
1149
|
+
</td>
|
|
1150
|
+
|
|
1151
|
+
<td>
|
|
1152
|
+
<code><video></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><source></code> elements from the primary URL path.
|
|
1176
|
+
</li>
|
|
1177
|
+
|
|
1178
|
+
</ul>
|
|
1179
|
+
|
|
1180
|
+
<h2 id="see-also">
|
|
1181
|
+
See 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
|
+
|