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,1781 @@
|
|
|
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="tables">
|
|
838
|
+
Tables
|
|
839
|
+
</h1>
|
|
840
|
+
<nav class="page-toc" id="page-toc-top"><ul><li><a href="#tables">Tables</a><ul><li><a href="#standard-pipe-tables">Standard Pipe Tables</a></li><li><a href="#relaxed-tables">Relaxed Tables</a></li><li><a href="#grid-tables-pandoc-style">Grid Tables (Pandoc-style)</a></li><li><a href="#headerless-tables">Headerless Tables</a><ul><li><a href="#row-header-columns">Row Header Columns</a></li></ul></li><li><a href="#inline-tables-from-csvtsv">Inline Tables from CSV/TSV</a><ul><li><a href="#fenced-csvtsv-tables">Fenced CSV/TSV Tables</a></li><li><a href="#alignment-rows-in-csvtsv-tables">Alignment Rows in CSV/TSV Tables</a></li><li><a href="#table-markers"><!--TABLE--> Markers</a></li></ul></li><li><a href="#column-spans">Column Spans</a><ul><li><a href="#consecutive-pipes">Consecutive Pipes</a></li><li><a href="#marker"><< Marker</a></li></ul></li><li><a href="#row-spans">Row Spans</a></li><li><a href="#combined-row-and-column-spans">Combined Row and Column Spans</a></li><li><a href="#individual-cell-alignment">Individual Cell Alignment</a></li><li><a href="#table-footers-tfoot">Table Footers (tfoot)</a></li><li><a href="#table-captions">Table Captions</a><ul><li><a href="#multimarkdown-style-captions">MultiMarkdown-Style Captions</a></li><li><a href="#pandoc-style-captions">Pandoc-Style Captions</a></li><li><a href="#pandoc-table-attributes-extension">Pandoc Table Attributes Extension</a></li><li><a href="#caption-position">Caption Position</a></li></ul></li><li><a href="#inline-attribute-lists-ials-for-tables">Inline Attribute Lists (IALs) for Tables</a><ul><li><a href="#ials-after-tables">IALs After Tables</a></li><li><a href="#ials-in-table-captions">IALs in Table Captions</a></li></ul></li><li><a href="#complete-example">Complete Example</a></li><li><a href="#see-also">See Also</a></li></ul></li></ul></nav>
|
|
841
|
+
|
|
842
|
+
<p>
|
|
843
|
+
Apex supports comprehensive table syntax including standard pipe tables, CSV/TSV tables, and advanced features like column/row spans, per-cell alignment, captions, and IAL attributes.
|
|
844
|
+
</p>
|
|
845
|
+
|
|
846
|
+
<h2 id="standard-pipe-tables">
|
|
847
|
+
Standard Pipe Tables
|
|
848
|
+
</h2>
|
|
849
|
+
|
|
850
|
+
<p>
|
|
851
|
+
Basic pipe table syntax with header row and separator:
|
|
852
|
+
</p>
|
|
853
|
+
|
|
854
|
+
<div class="highlight">
|
|
855
|
+
<pre><span></span>| Header 1 | Header 2 | Header 3 |
|
|
856
|
+
| -------- | <span class=\"emoji\">:------:</span> | -------: |
|
|
857
|
+
| Left | Center | Right |
|
|
858
|
+
| Data | Data | Data |
|
|
859
|
+
</pre>
|
|
860
|
+
</div>
|
|
861
|
+
|
|
862
|
+
<p>
|
|
863
|
+
Column alignment is specified in the separator row:
|
|
864
|
+
</p>
|
|
865
|
+
|
|
866
|
+
<ul>
|
|
867
|
+
|
|
868
|
+
<li>
|
|
869
|
+
<code>:---</code> or <code>---</code> - Left (default)
|
|
870
|
+
</li>
|
|
871
|
+
|
|
872
|
+
<li>
|
|
873
|
+
<code><span class=\"emoji\">:---:</span></code> - Center
|
|
874
|
+
</li>
|
|
875
|
+
|
|
876
|
+
<li>
|
|
877
|
+
<code>---:</code> - Right
|
|
878
|
+
</li>
|
|
879
|
+
|
|
880
|
+
</ul>
|
|
881
|
+
|
|
882
|
+
<h2 id="relaxed-tables">
|
|
883
|
+
Relaxed Tables
|
|
884
|
+
</h2>
|
|
885
|
+
|
|
886
|
+
<p>
|
|
887
|
+
In <strong>unified</strong> and <strong>kramdown</strong> modes, tables don’t require separator rows:
|
|
888
|
+
</p>
|
|
889
|
+
|
|
890
|
+
<div class="highlight">
|
|
891
|
+
<pre><span></span>one | two | three
|
|
892
|
+
1 | 2 | 3
|
|
893
|
+
4 | 5 | 6
|
|
894
|
+
</pre>
|
|
895
|
+
</div>
|
|
896
|
+
|
|
897
|
+
<p>
|
|
898
|
+
This automatically becomes a table. See <a href="Modes.html">Modes</a> for details.
|
|
899
|
+
</p>
|
|
900
|
+
|
|
901
|
+
<h2 id="grid-tables-pandoc-style">
|
|
902
|
+
Grid Tables (Pandoc-style)
|
|
903
|
+
</h2>
|
|
904
|
+
|
|
905
|
+
<p>
|
|
906
|
+
Pandoc <strong>grid tables</strong> use ASCII border rows instead of pipe separators. Enable with <code>--grid-tables</code> or disable explicitly with <code>--no-grid-tables</code> (disabled by default in unified mode).
|
|
907
|
+
</p>
|
|
908
|
+
|
|
909
|
+
<div class="highlight">
|
|
910
|
+
<pre><span></span>+---------------+---------------+
|
|
911
|
+
| Fruit | Price |
|
|
912
|
+
+:=============+==============:+
|
|
913
|
+
| Bananas | $1.34 |
|
|
914
|
+
| Oranges | $2.10 |
|
|
915
|
+
+---------------+---------------+
|
|
916
|
+
</pre>
|
|
917
|
+
</div>
|
|
918
|
+
|
|
919
|
+
<p>
|
|
920
|
+
<strong>Features supported:</strong>
|
|
921
|
+
</p>
|
|
922
|
+
|
|
923
|
+
<ul>
|
|
924
|
+
|
|
925
|
+
<li>
|
|
926
|
+
Header rows (<code>+===+</code> separator)
|
|
927
|
+
</li>
|
|
928
|
+
|
|
929
|
+
<li>
|
|
930
|
+
Column alignment from <code>:</code> markers in border rows (<code>+:===+</code>, <code>+===:+</code>, <code>+:===:+</code>)
|
|
931
|
+
</li>
|
|
932
|
+
|
|
933
|
+
<li>
|
|
934
|
+
Multiline cells (including lists and other block markdown in cells)
|
|
935
|
+
</li>
|
|
936
|
+
|
|
937
|
+
<li>
|
|
938
|
+
Full-row colspan (single cell spanning the table width)
|
|
939
|
+
</li>
|
|
940
|
+
|
|
941
|
+
<li>
|
|
942
|
+
Nested grids inside colspan cells
|
|
943
|
+
</li>
|
|
944
|
+
|
|
945
|
+
<li>
|
|
946
|
+
Partial in-row separators (<code>| Label +---+---+</code> patterns) with rowspan/colspan
|
|
947
|
+
<strong>Notes:</strong>
|
|
948
|
+
</li>
|
|
949
|
+
|
|
950
|
+
<li>
|
|
951
|
+
Grid tables require a blank line before and after the table block (same as pipe tables).
|
|
952
|
+
</li>
|
|
953
|
+
|
|
954
|
+
<li>
|
|
955
|
+
Lines inside fenced code blocks are never converted.
|
|
956
|
+
</li>
|
|
957
|
+
|
|
958
|
+
<li>
|
|
959
|
+
Complex layouts may differ slightly from Pandoc; see <a href="Limitations-and-Roadmap.html">Limitations and Roadmap</a>.
|
|
960
|
+
</li>
|
|
961
|
+
|
|
962
|
+
</ul>
|
|
963
|
+
|
|
964
|
+
<h2 id="headerless-tables">
|
|
965
|
+
Headerless Tables
|
|
966
|
+
</h2>
|
|
967
|
+
|
|
968
|
+
<p>
|
|
969
|
+
Apex supports tables that start with alignment rows (separator rows) without header rows. The alignment specified in the separator row is automatically applied to all columns:
|
|
970
|
+
</p>
|
|
971
|
+
|
|
972
|
+
<div class="highlight">
|
|
973
|
+
<pre><span></span>| | | |
|
|
974
|
+
| --- | --- | --- |
|
|
975
|
+
| a | b | c |
|
|
976
|
+
| 1 | 2 | 3 |
|
|
977
|
+
</pre>
|
|
978
|
+
</div>
|
|
979
|
+
|
|
980
|
+
<p>
|
|
981
|
+
Alignment specifiers work as usual:
|
|
982
|
+
</p>
|
|
983
|
+
|
|
984
|
+
<div class="highlight">
|
|
985
|
+
<pre><span></span>| | | |
|
|
986
|
+
|:---|<span class=\"emoji\">:---:</span>|---:|
|
|
987
|
+
| left | center | right |
|
|
988
|
+
</pre>
|
|
989
|
+
</div>
|
|
990
|
+
|
|
991
|
+
<p>
|
|
992
|
+
In this case, the first row (the alignment row) specifies the column alignment, and all subsequent data rows inherit that alignment. The empty header row that would normally be required is automatically handled.
|
|
993
|
+
</p>
|
|
994
|
+
|
|
995
|
+
<h3 id="row-header-columns">
|
|
996
|
+
Row Header Columns
|
|
997
|
+
</h3>
|
|
998
|
+
|
|
999
|
+
<p>
|
|
1000
|
+
You can mark the <strong>first column</strong> as a row-header column by starting the header row with an <strong>empty first cell</strong>:
|
|
1001
|
+
</p>
|
|
1002
|
+
|
|
1003
|
+
<div class="highlight">
|
|
1004
|
+
<pre><span></span>| | Header 1 | Header 2 |
|
|
1005
|
+
| Row 1 | data 1.1 | data 1.2 |
|
|
1006
|
+
| Row 2 | data 2.1 | data 2.2 |
|
|
1007
|
+
</pre>
|
|
1008
|
+
</div>
|
|
1009
|
+
|
|
1010
|
+
<p>
|
|
1011
|
+
When the first header cell is empty (for example, <code>| |</code> or <code>| |</code>), Apex will:
|
|
1012
|
+
</p>
|
|
1013
|
+
|
|
1014
|
+
<ul>
|
|
1015
|
+
|
|
1016
|
+
<li>
|
|
1017
|
+
Treat the rest of the header row as usual column headers.
|
|
1018
|
+
</li>
|
|
1019
|
+
|
|
1020
|
+
<li>
|
|
1021
|
+
Render the first cell of each body row as a <strong>row header</strong> using <code><th scope="row">Row 1</th></code>, <code><th scope="row">Row 2</th></code>, etc.
|
|
1022
|
+
Notes:
|
|
1023
|
+
</li>
|
|
1024
|
+
|
|
1025
|
+
<li>
|
|
1026
|
+
The row-header behavior only applies to the <strong>first column</strong> and only when the <strong>first header cell is empty</strong>.
|
|
1027
|
+
</li>
|
|
1028
|
+
|
|
1029
|
+
<li>
|
|
1030
|
+
Tables that start with <code>|data|data|</code> or <code>data|data</code> do <strong>not</strong> enable row headers.
|
|
1031
|
+
</li>
|
|
1032
|
+
|
|
1033
|
+
<li>
|
|
1034
|
+
This works together with all other table features (relaxed tables, headerless tables, colspans/rowspans, captions, etc.).
|
|
1035
|
+
</li>
|
|
1036
|
+
|
|
1037
|
+
</ul>
|
|
1038
|
+
|
|
1039
|
+
<h2 id="inline-tables-from-csvtsv">
|
|
1040
|
+
Inline Tables from CSV/TSV
|
|
1041
|
+
</h2>
|
|
1042
|
+
|
|
1043
|
+
<p>
|
|
1044
|
+
In addition to regular pipe tables, Apex can convert inline CSV/TSV text into tables.
|
|
1045
|
+
</p>
|
|
1046
|
+
|
|
1047
|
+
<h3 id="fenced-csvtsv-tables">
|
|
1048
|
+
Fenced CSV/TSV Tables
|
|
1049
|
+
</h3>
|
|
1050
|
+
|
|
1051
|
+
<p>
|
|
1052
|
+
Use a fenced code block with the info string <code>table</code>. The delimiter is detected automatically:
|
|
1053
|
+
</p>
|
|
1054
|
+
|
|
1055
|
+
<ul>
|
|
1056
|
+
|
|
1057
|
+
<li>
|
|
1058
|
+
If any non-blank line contains a <strong>tab</strong>, the block is treated as TSV.
|
|
1059
|
+
</li>
|
|
1060
|
+
|
|
1061
|
+
<li>
|
|
1062
|
+
Otherwise, if any non-blank line contains a <strong>comma</strong>, the block is treated as CSV.
|
|
1063
|
+
</li>
|
|
1064
|
+
|
|
1065
|
+
<li>
|
|
1066
|
+
If no tabs or commas are found, the block is left unchanged as a normal <code>table</code>-info code block (useful for showing literal CSV/TSV).
|
|
1067
|
+
</li>
|
|
1068
|
+
|
|
1069
|
+
</ul>
|
|
1070
|
+
|
|
1071
|
+
<div class="highlight">
|
|
1072
|
+
<pre><span></span><span class="sb">```table</span>
|
|
1073
|
+
<span class="s">header 1,header 2,header 3</span>
|
|
1074
|
+
<span class="s">data 1,data 2,data 3</span>
|
|
1075
|
+
<span class="s">,,data 2c</span>
|
|
1076
|
+
<span class="sb">```</span>
|
|
1077
|
+
</pre>
|
|
1078
|
+
</div>
|
|
1079
|
+
|
|
1080
|
+
<p>
|
|
1081
|
+
You can also use TSV with real tab characters:
|
|
1082
|
+
</p>
|
|
1083
|
+
|
|
1084
|
+
<div class="highlight">
|
|
1085
|
+
<pre><span></span><span class="sb">```table</span>
|
|
1086
|
+
<span class="s">col1 col2 col3</span>
|
|
1087
|
+
<span class="s">val1 val2 val3</span>
|
|
1088
|
+
<span class="sb">```</span>
|
|
1089
|
+
</pre>
|
|
1090
|
+
</div>
|
|
1091
|
+
|
|
1092
|
+
<h3 id="alignment-rows-in-csvtsv-tables">
|
|
1093
|
+
Alignment Rows in CSV/TSV Tables
|
|
1094
|
+
</h3>
|
|
1095
|
+
|
|
1096
|
+
<p>
|
|
1097
|
+
CSV/TSV inline tables can specify column alignment using a row of <strong>alignment keywords</strong>:
|
|
1098
|
+
</p>
|
|
1099
|
+
|
|
1100
|
+
<div class="highlight">
|
|
1101
|
+
<pre><span></span><span class="sb">```table</span>
|
|
1102
|
+
<span class="s">H1,H2,H3</span>
|
|
1103
|
+
<span class="s">left,center,right</span>
|
|
1104
|
+
<span class="s">a,b,c</span>
|
|
1105
|
+
<span class="sb">```</span>
|
|
1106
|
+
</pre>
|
|
1107
|
+
</div>
|
|
1108
|
+
|
|
1109
|
+
<p>
|
|
1110
|
+
The alignment row is not rendered as data; it is converted to the equivalent Markdown alignment row:
|
|
1111
|
+
</p>
|
|
1112
|
+
|
|
1113
|
+
<ul>
|
|
1114
|
+
|
|
1115
|
+
<li>
|
|
1116
|
+
<code>left</code> → <code>:---</code>
|
|
1117
|
+
</li>
|
|
1118
|
+
|
|
1119
|
+
<li>
|
|
1120
|
+
<code>center</code> → <code><span class=\"emoji\">:---:</span></code>
|
|
1121
|
+
</li>
|
|
1122
|
+
|
|
1123
|
+
<li>
|
|
1124
|
+
<code>right</code> → <code>---:</code>
|
|
1125
|
+
</li>
|
|
1126
|
+
|
|
1127
|
+
<li>
|
|
1128
|
+
<code>auto</code> → <code>---</code>
|
|
1129
|
+
If the first row contains only alignment keywords, it becomes a <strong>headless table</strong>: the alignment row is emitted first and all following rows become body rows. If there is <strong>no alignment row at all</strong>, Apex emits a default <code>---</code> separator row so that relaxed/headless table handling still works as expected.
|
|
1130
|
+
</li>
|
|
1131
|
+
|
|
1132
|
+
</ul>
|
|
1133
|
+
|
|
1134
|
+
<h3 id="table-markers">
|
|
1135
|
+
<code><!--TABLE--></code> Markers
|
|
1136
|
+
</h3>
|
|
1137
|
+
|
|
1138
|
+
<p>
|
|
1139
|
+
You can also start an inline CSV/TSV table with an HTML comment:
|
|
1140
|
+
</p>
|
|
1141
|
+
|
|
1142
|
+
<div class="highlight">
|
|
1143
|
+
<pre><span></span><!--TABLE-->
|
|
1144
|
+
header 1,header 2,header 3
|
|
1145
|
+
data 1,data 2,data 3
|
|
1146
|
+
,,data 2c
|
|
1147
|
+
</pre>
|
|
1148
|
+
</div>
|
|
1149
|
+
|
|
1150
|
+
<table>
|
|
1151
|
+
|
|
1152
|
+
<thead>
|
|
1153
|
+
|
|
1154
|
+
<tr>
|
|
1155
|
+
|
|
1156
|
+
<th>
|
|
1157
|
+
<code>| </code> consumes the following <strong>contiguous non-blank lines</strong> as table data (stopping at the first blank line)
|
|
1158
|
+
</th>
|
|
1159
|
+
|
|
1160
|
+
<th>
|
|
1161
|
+
applies the same delimiter detection and optional alignment-row handling
|
|
1162
|
+
</th>
|
|
1163
|
+
|
|
1164
|
+
<th>
|
|
1165
|
+
and converts the block into a table. If no tabs or commas are found
|
|
1166
|
+
</th>
|
|
1167
|
+
|
|
1168
|
+
<th>
|
|
1169
|
+
the comment and lines are left unchanged.
|
|
1170
|
+
</th>
|
|
1171
|
+
|
|
1172
|
+
</tr>
|
|
1173
|
+
|
|
1174
|
+
</thead>
|
|
1175
|
+
|
|
1176
|
+
</table>
|
|
1177
|
+
|
|
1178
|
+
<h2 id="column-spans">
|
|
1179
|
+
Column Spans
|
|
1180
|
+
</h2>
|
|
1181
|
+
|
|
1182
|
+
<p>
|
|
1183
|
+
Column spans allow a cell to span multiple columns. There are two ways to create column spans:
|
|
1184
|
+
</p>
|
|
1185
|
+
|
|
1186
|
+
<h3 id="consecutive-pipes">
|
|
1187
|
+
Consecutive Pipes
|
|
1188
|
+
</h3>
|
|
1189
|
+
|
|
1190
|
+
<p>
|
|
1191
|
+
Use consecutive pipes with no content between them to create column spans. Place the consecutive pipes after the cell content, and they will cause that cell to span the specified number of additional columns:
|
|
1192
|
+
</p>
|
|
1193
|
+
|
|
1194
|
+
<div class="highlight">
|
|
1195
|
+
<pre><span></span>| | Table | Has | Colspans |
|
|
1196
|
+
| ------ | ------ | --- | -------------- |
|
|
1197
|
+
| row 1 ||| colspan |
|
|
1198
|
+
| row 2 | span 2 || &larr; colspan |
|
|
1199
|
+
</pre>
|
|
1200
|
+
</div>
|
|
1201
|
+
|
|
1202
|
+
<ul>
|
|
1203
|
+
|
|
1204
|
+
<li>
|
|
1205
|
+
<code>| << |</code> (2 consecutive pipes) causes the previous cell to span 2 columns total (its own column plus 1 additional)
|
|
1206
|
+
</li>
|
|
1207
|
+
|
|
1208
|
+
<li>
|
|
1209
|
+
<code>| << | << |</code> (3 consecutive pipes) causes the previous cell to span 3 columns total (its own column plus 2 additional)
|
|
1210
|
+
</li>
|
|
1211
|
+
|
|
1212
|
+
<li>
|
|
1213
|
+
<code>| << | << | << |</code> (4 consecutive pipes) causes the previous cell to span 4 columns total (its own column plus 3 additional)
|
|
1214
|
+
In the first row above, <code>| << | << |</code> after “colspan” causes “colspan” to span across 3 columns total. In the second row, <code>| << |</code> after “cell” causes “cell” to span across 2 columns total (its own column plus the next column).
|
|
1215
|
+
</li>
|
|
1216
|
+
|
|
1217
|
+
</ul>
|
|
1218
|
+
|
|
1219
|
+
<h3 `| ` consumes the following **contiguous non-blank lines** as table data (stopping at the first blank line) id="marker">
|
|
1220
|
+
<code><<</code> Marker
|
|
1221
|
+
</h3>
|
|
1222
|
+
|
|
1223
|
+
<p>
|
|
1224
|
+
You can also use the <code><<</code> marker in a cell to force a colspan without using consecutive pipes. This allows whitespace and table alignment in the Markdown source:
|
|
1225
|
+
</p>
|
|
1226
|
+
|
|
1227
|
+
<div class="highlight">
|
|
1228
|
+
<pre><span></span>| A | B | C |
|
|
1229
|
+
| --- | --- | --- |
|
|
1230
|
+
| D | << | << |
|
|
1231
|
+
</pre>
|
|
1232
|
+
</div>
|
|
1233
|
+
|
|
1234
|
+
<p>
|
|
1235
|
+
The <code><<</code> marker creates a column span just like consecutive pipes, but allows you to maintain proper table alignment and add whitespace for readability in your source Markdown. Each <code><<</code> marker in a cell indicates that cell is part of a colspan from the previous cell. In the example above, <code>D</code> spans 3 columns total (its own column plus the 2 columns containing <code><<</code> markers).
|
|
1236
|
+
To include a <strong>literal</strong> <code><<</code> in a table cell (without creating a colspan), escape the first <code><</code> with a backslash: <code>\<<</code>. The backslash-plus-less-than is treated as an escaped <code><</code>, so <code>\<<</code> is rendered as the two characters <code><<</code> and does not trigger colspan behavior. For text plus literal <code><<</code> (e.g. “raw <<”), use <code>raw \<<</code> so the cell is not treated as a colspan and the column is preserved.
|
|
1237
|
+
<strong>Note:</strong> Blank cells containing whitespace (like <code>| |</code> or <code>| |</code>) are rendered as empty cells, <strong>not</strong> as column spans. Only cells with no whitespace and no content between consecutive pipes (like <code>| << |</code> or <code>| << | << |</code>) create column spans.
|
|
1238
|
+
</p>
|
|
1239
|
+
|
|
1240
|
+
<h2 applies the same delimiter detection and optional alignment-row handling id="row-spans">
|
|
1241
|
+
Row Spans
|
|
1242
|
+
</h2>
|
|
1243
|
+
|
|
1244
|
+
<p>
|
|
1245
|
+
Row spans allow a cell to span multiple rows. Use the <code>^^</code> marker to create a row span:
|
|
1246
|
+
</p>
|
|
1247
|
+
|
|
1248
|
+
<div class="highlight">
|
|
1249
|
+
<pre><span></span>| A | B |
|
|
1250
|
+
| --- | --- |
|
|
1251
|
+
| C | D |
|
|
1252
|
+
| ^^ | E |
|
|
1253
|
+
</pre>
|
|
1254
|
+
</div>
|
|
1255
|
+
|
|
1256
|
+
<p>
|
|
1257
|
+
The <code>^^</code> marker creates a row span on the cell above. In this example, the cell containing “C” spans two rows.
|
|
1258
|
+
Consecutive <code>^^</code> markers stack to create larger row spans:
|
|
1259
|
+
</p>
|
|
1260
|
+
|
|
1261
|
+
<div class="highlight">
|
|
1262
|
+
<pre><span></span>| A | B | C |
|
|
1263
|
+
| --- | --- | --- |
|
|
1264
|
+
| X | Y | Z |
|
|
1265
|
+
| ^^ | W | V |
|
|
1266
|
+
| ^^ | U | T |
|
|
1267
|
+
</pre>
|
|
1268
|
+
</div>
|
|
1269
|
+
|
|
1270
|
+
<p>
|
|
1271
|
+
Here, the cell “X” spans three rows total.
|
|
1272
|
+
</p>
|
|
1273
|
+
|
|
1274
|
+
<h2 and converts the block into a table. If no tabs or commas are found id="combined-row-and-column-spans">
|
|
1275
|
+
Combined Row and Column Spans
|
|
1276
|
+
</h2>
|
|
1277
|
+
|
|
1278
|
+
<p>
|
|
1279
|
+
You can mix rowspans and colspans in the same table to create more complex layouts:
|
|
1280
|
+
</p>
|
|
1281
|
+
|
|
1282
|
+
<div class="highlight">
|
|
1283
|
+
<pre><span></span>| Department | Employee | Q1-Q2 Average | Q3 | Q4 | Overall |
|
|
1284
|
+
| ----------- | -------- | ------------- | ------ | --- | ------- |
|
|
1285
|
+
| Engineering | Alice | 93.5 | 94 | 96 | 94.25 |
|
|
1286
|
+
| ^^ | Bob | 89.0 | 87 | 91 | 89.00 |
|
|
1287
|
+
| Marketing | Charlie | 92.0 | Absent | | 92.00 |
|
|
1288
|
+
| Sales | Diana | 87.5 | 88 | 90 | 88.50 |
|
|
1289
|
+
| ^^ | Eve | 93.0 | 95 | 93 | 93.50 |
|
|
1290
|
+
</pre>
|
|
1291
|
+
</div>
|
|
1292
|
+
|
|
1293
|
+
<p>
|
|
1294
|
+
Here <code>^^</code> creates rowspans for the <code>Department</code> column. The example demonstrates how rowspans work with regular data rows.
|
|
1295
|
+
</p>
|
|
1296
|
+
|
|
1297
|
+
<h2 the comment and lines are left unchanged. id="individual-cell-alignment">
|
|
1298
|
+
Individual Cell Alignment
|
|
1299
|
+
</h2>
|
|
1300
|
+
|
|
1301
|
+
<p>
|
|
1302
|
+
Table cells can be aligned individually using colons, similar to Jekyll Spaceship. This allows you to override the default column alignment on a per-cell basis:
|
|
1303
|
+
</p>
|
|
1304
|
+
|
|
1305
|
+
<div class="highlight">
|
|
1306
|
+
<pre><span></span>| Header | Header | Header |
|
|
1307
|
+
| --- | --- | --- |
|
|
1308
|
+
| :Left | Center: | <span class=\"emoji\">:Center:</span> |
|
|
1309
|
+
| Right: | Normal | :Left |
|
|
1310
|
+
</pre>
|
|
1311
|
+
</div>
|
|
1312
|
+
|
|
1313
|
+
<p>
|
|
1314
|
+
Alignment syntax:
|
|
1315
|
+
</p>
|
|
1316
|
+
|
|
1317
|
+
<ul>
|
|
1318
|
+
|
|
1319
|
+
<li>
|
|
1320
|
+
<code>:Text</code> or <code>: Text</code> - Left align (leading colon)
|
|
1321
|
+
</li>
|
|
1322
|
+
|
|
1323
|
+
<li>
|
|
1324
|
+
<code>Text:</code> or <code>Text :</code> - Right align (trailing colon)
|
|
1325
|
+
</li>
|
|
1326
|
+
|
|
1327
|
+
<li>
|
|
1328
|
+
<code><span class=\"emoji\">:Text:</span></code> or <code>: Text :</code> - Center align (both colons)
|
|
1329
|
+
The colons are removed from the output, and the alignment is applied via CSS <code>text-align</code> styles. Escaped colons (<code>\:</code>) are not treated as alignment markers.
|
|
1330
|
+
Cell-level alignment overrides the column-level alignment specified in the separator row.
|
|
1331
|
+
</li>
|
|
1332
|
+
|
|
1333
|
+
</ul>
|
|
1334
|
+
|
|
1335
|
+
<h2 id="table-footers-tfoot">
|
|
1336
|
+
Table Footers (tfoot)
|
|
1337
|
+
</h2>
|
|
1338
|
+
|
|
1339
|
+
<p>
|
|
1340
|
+
You can create table footers using a row where every cell contains only <code>===</code> (three or more equals, with optional extra <code>=</code> and whitespace). This row acts as a <strong>footer divider</strong>:
|
|
1341
|
+
</p>
|
|
1342
|
+
|
|
1343
|
+
<div class="highlight">
|
|
1344
|
+
<pre><span></span>| h1 | h2 | h3 |
|
|
1345
|
+
| --- | <span class=\"emoji\">:---:</span> | --- |
|
|
1346
|
+
| d1 | d2 | d3 |
|
|
1347
|
+
| d1 | d2 | d3 |
|
|
1348
|
+
| === | === | === |
|
|
1349
|
+
| d-4 | d-5 | d-6 |
|
|
1350
|
+
</pre>
|
|
1351
|
+
</div>
|
|
1352
|
+
|
|
1353
|
+
<p>
|
|
1354
|
+
The <code>===</code> row is treated as a footer divider and is removed from the output. All following rows are rendered inside <code><tfoot></code>.
|
|
1355
|
+
The footer separator must appear after all body rows. Once the <code>===</code> row is encountered, all subsequent rows until the end of the table (or a blank line) are treated as footer rows.
|
|
1356
|
+
</p>
|
|
1357
|
+
|
|
1358
|
+
<h2 id="table-captions">
|
|
1359
|
+
Table Captions
|
|
1360
|
+
</h2>
|
|
1361
|
+
|
|
1362
|
+
<p>
|
|
1363
|
+
Tables can have captions that appear before or after the table. Apex supports multiple caption formats:
|
|
1364
|
+
</p>
|
|
1365
|
+
|
|
1366
|
+
<h3 id="multimarkdown-style-captions">
|
|
1367
|
+
MultiMarkdown-Style Captions
|
|
1368
|
+
</h3>
|
|
1369
|
+
|
|
1370
|
+
<p>
|
|
1371
|
+
Captions in square brackets:
|
|
1372
|
+
</p>
|
|
1373
|
+
|
|
1374
|
+
<div class="highlight">
|
|
1375
|
+
<pre><span></span>[Table Caption]
|
|
1376
|
+
|
|
1377
|
+
| A | B |
|
|
1378
|
+
| --- | --- |
|
|
1379
|
+
| C | D |
|
|
1380
|
+
</pre>
|
|
1381
|
+
</div>
|
|
1382
|
+
|
|
1383
|
+
<p>
|
|
1384
|
+
Captions can appear <strong>before or after</strong> a table. They must be contiguous with the table (no other content between them), but a blank line is allowed:
|
|
1385
|
+
</p>
|
|
1386
|
+
|
|
1387
|
+
<div class="highlight">
|
|
1388
|
+
<pre><span></span>| A | B |
|
|
1389
|
+
| --- | --- |
|
|
1390
|
+
| C | D |
|
|
1391
|
+
|
|
1392
|
+
[Caption after table]
|
|
1393
|
+
</pre>
|
|
1394
|
+
</div>
|
|
1395
|
+
|
|
1396
|
+
<h3 id="pandoc-style-captions">
|
|
1397
|
+
Pandoc-Style Captions
|
|
1398
|
+
</h3>
|
|
1399
|
+
|
|
1400
|
+
<p>
|
|
1401
|
+
Pandoc-style <code> [Caption</code> lines are also supported:]
|
|
1402
|
+
</p>
|
|
1403
|
+
|
|
1404
|
+
<div class="highlight">
|
|
1405
|
+
<pre><span></span>| A | B |
|
|
1406
|
+
| --- | --- |
|
|
1407
|
+
| C | D |
|
|
1408
|
+
|
|
1409
|
+
Table: Caption after table
|
|
1410
|
+
</pre>
|
|
1411
|
+
</div>
|
|
1412
|
+
|
|
1413
|
+
<p>
|
|
1414
|
+
Pandoc-style <code> [Caption</code> lines are normalized to <code>[Caption]</code> before parsing, so they work with the same caption rendering as MultiMarkdown captions.]
|
|
1415
|
+
</p>
|
|
1416
|
+
|
|
1417
|
+
<h3 id="pandoc-table-attributes-extension">
|
|
1418
|
+
Pandoc Table Attributes Extension
|
|
1419
|
+
</h3>
|
|
1420
|
+
|
|
1421
|
+
<p>
|
|
1422
|
+
Apex supports Pandoc’s <code>table_attributes</code> extension using the <code>: Caption</code> syntax:
|
|
1423
|
+
</p>
|
|
1424
|
+
|
|
1425
|
+
<div class="highlight">
|
|
1426
|
+
<pre><span></span>| Key | Value |
|
|
1427
|
+
| --- | <span class=\"emoji\">:---:</span> |
|
|
1428
|
+
| one | 1 |
|
|
1429
|
+
| two | 2 |
|
|
1430
|
+
|
|
1431
|
+
: Key value table {#table-id .testing key="value"}
|
|
1432
|
+
</pre>
|
|
1433
|
+
</div>
|
|
1434
|
+
|
|
1435
|
+
<p>
|
|
1436
|
+
The <code>: Caption</code> format (with optional IAL attributes) is recognized when it appears immediately before or after a table. IAL attributes in the caption are extracted and applied to the table element itself.
|
|
1437
|
+
<strong>Note:</strong> The <code>: Caption</code> syntax only works when adjacent to a table to avoid conflicts with definition list syntax. If a line starting with <code>:</code> is not next to a table, it will be processed as a definition list item.
|
|
1438
|
+
</p>
|
|
1439
|
+
|
|
1440
|
+
<h3 id="caption-position">
|
|
1441
|
+
Caption Position
|
|
1442
|
+
</h3>
|
|
1443
|
+
|
|
1444
|
+
<p>
|
|
1445
|
+
By default, captions appear <strong>below</strong> the table. Use the <code>--captions above</code> option to place captions above the table instead. The <code>--captions below</code> option (or default) places them below. See <a href="Command-Line-Options.html">Command Line Options</a> for details.
|
|
1446
|
+
</p>
|
|
1447
|
+
|
|
1448
|
+
<h2 id="inline-attribute-lists-ials-for-tables">
|
|
1449
|
+
Inline Attribute Lists (IALs) for Tables
|
|
1450
|
+
</h2>
|
|
1451
|
+
|
|
1452
|
+
<p>
|
|
1453
|
+
Tables support Inline Attribute Lists (IALs) for adding HTML attributes like IDs, classes, and custom key-value pairs. See <a href="Inline-Attribute-Lists.html">Inline Attribute Lists</a> for complete IAL syntax documentation.
|
|
1454
|
+
</p>
|
|
1455
|
+
|
|
1456
|
+
<h3 id="ials-after-tables">
|
|
1457
|
+
IALs After Tables
|
|
1458
|
+
</h3>
|
|
1459
|
+
|
|
1460
|
+
<p>
|
|
1461
|
+
Tables can have IALs applied on a separate line after the table:
|
|
1462
|
+
</p>
|
|
1463
|
+
|
|
1464
|
+
<div class="highlight">
|
|
1465
|
+
<pre><span></span>| Key | Value |
|
|
1466
|
+
| --- | <span class=\"emoji\">:---:</span> |
|
|
1467
|
+
| one | 1 |
|
|
1468
|
+
| two | 2 |
|
|
1469
|
+
|
|
1470
|
+
{: <span class="ni">#data</span>-table .striped .bordered}
|
|
1471
|
+
</pre>
|
|
1472
|
+
</div>
|
|
1473
|
+
|
|
1474
|
+
<p>
|
|
1475
|
+
This applies the attributes to the <code><table></code> element:
|
|
1476
|
+
</p>
|
|
1477
|
+
|
|
1478
|
+
<div class="highlight">
|
|
1479
|
+
<pre><span></span><span class="p"><</span><span class="nt">table</span> <span class="na">id</span><span class="o">=</span><span class="s">"data-table"</span> <span class="na">class</span><span class="o">=</span><span class="s">"striped bordered"</span><span class="p">></span>
|
|
1480
|
+
<span class="cm"><!-- table content --></span>
|
|
1481
|
+
<span class="p"></</span><span class="nt">table</span><span class="p">></span>
|
|
1482
|
+
</pre>
|
|
1483
|
+
</div>
|
|
1484
|
+
|
|
1485
|
+
<p>
|
|
1486
|
+
Apex supports both Kramdown-style IALs (<code>{: #id .class}</code>) and Pandoc-style IALs without the colon (<code>{#id .class}</code>):
|
|
1487
|
+
</p>
|
|
1488
|
+
|
|
1489
|
+
<div class="highlight">
|
|
1490
|
+
<pre><span></span>| Key | Value |
|
|
1491
|
+
| --- | <span class=\"emoji\">:---:</span> |
|
|
1492
|
+
| one | 1 |
|
|
1493
|
+
| two | 2 |
|
|
1494
|
+
|
|
1495
|
+
{#table-id .my-class key="value"}
|
|
1496
|
+
</pre>
|
|
1497
|
+
</div>
|
|
1498
|
+
|
|
1499
|
+
<h3 id="ials-in-table-captions">
|
|
1500
|
+
IALs in Table Captions
|
|
1501
|
+
</h3>
|
|
1502
|
+
|
|
1503
|
+
<p>
|
|
1504
|
+
When using Pandoc-style captions with the <code>: Caption</code> syntax, IAL attributes in the caption are extracted and applied to the table:
|
|
1505
|
+
</p>
|
|
1506
|
+
|
|
1507
|
+
<div class="highlight">
|
|
1508
|
+
<pre><span></span>| Key | Value |
|
|
1509
|
+
| --- | <span class=\"emoji\">:---:</span> |
|
|
1510
|
+
| one | 1 |
|
|
1511
|
+
| two | 2 |
|
|
1512
|
+
|
|
1513
|
+
: Key value table {#table-id .testing key="value"}
|
|
1514
|
+
</pre>
|
|
1515
|
+
</div>
|
|
1516
|
+
|
|
1517
|
+
<p>
|
|
1518
|
+
This is equivalent to:
|
|
1519
|
+
</p>
|
|
1520
|
+
|
|
1521
|
+
<div class="highlight">
|
|
1522
|
+
<pre><span></span>| Key | Value |
|
|
1523
|
+
| --- | <span class=\"emoji\">:---:</span> |
|
|
1524
|
+
| one | 1 |
|
|
1525
|
+
| two | 2 |
|
|
1526
|
+
|
|
1527
|
+
{: <span class="ni">#table</span>-id .testing key="value"}
|
|
1528
|
+
</pre>
|
|
1529
|
+
</div>
|
|
1530
|
+
|
|
1531
|
+
<p>
|
|
1532
|
+
Both Kramdown-style IALs (<code>{: #id .class}</code>) and Pandoc-style IALs without the colon (<code>{#id .class}</code>) are supported in table captions.
|
|
1533
|
+
</p>
|
|
1534
|
+
|
|
1535
|
+
<h2 id="complete-example">
|
|
1536
|
+
Complete Example
|
|
1537
|
+
</h2>
|
|
1538
|
+
|
|
1539
|
+
<p>
|
|
1540
|
+
Here’s a comprehensive example combining multiple advanced features:
|
|
1541
|
+
</p>
|
|
1542
|
+
|
|
1543
|
+
<div class="highlight">
|
|
1544
|
+
<pre><span></span>[Employee Performance Q4 2025]
|
|
1545
|
+
| Department | Employee | Q1-Q2 Average | Q3 | Q4 | Overall |
|
|
1546
|
+
| ----------- | -------- | ------------- | ------ | --- | ------- |
|
|
1547
|
+
| Engineering | Alice | 93.5 | 94 | 96 | 94.25 |
|
|
1548
|
+
| ^^ | Bob | 89.0 | 87 | 91 | 89.00 |
|
|
1549
|
+
| Marketing | Charlie | 92.0 | Absent ||| 92.00 |
|
|
1550
|
+
| Sales | Diana | 87.5 | 88 | 90 | 88.50 |
|
|
1551
|
+
| ^^ | Eve | 93.0 | 95 | 93 | 93.50 |
|
|
1552
|
+
| === | === | === | === | === | === |
|
|
1553
|
+
| Total ||| <span class=\"emoji\">:Center:</span> ||| 92.05 |
|
|
1554
|
+
|
|
1555
|
+
{: .performance-table <span class="ni">#q4</span>-results .striped}
|
|
1556
|
+
</pre>
|
|
1557
|
+
</div>
|
|
1558
|
+
|
|
1559
|
+
<p>
|
|
1560
|
+
This example demonstrates:
|
|
1561
|
+
</p>
|
|
1562
|
+
|
|
1563
|
+
<ul>
|
|
1564
|
+
|
|
1565
|
+
<li>
|
|
1566
|
+
<strong>Caption</strong>: <code>[Employee Performance Q4 2025]</code> before the table
|
|
1567
|
+
</li>
|
|
1568
|
+
|
|
1569
|
+
<li>
|
|
1570
|
+
<strong>Row spans</strong>: <code>^^</code> markers create rowspans for the Department column
|
|
1571
|
+
</li>
|
|
1572
|
+
|
|
1573
|
+
<li>
|
|
1574
|
+
<strong>Column spans</strong>: Consecutive pipes (<code>| << | << |</code>) in the “Absent” row create a colspan spanning the Q4 column
|
|
1575
|
+
</li>
|
|
1576
|
+
|
|
1577
|
+
<li>
|
|
1578
|
+
<strong>Per-cell alignment</strong>: <code><span class=\"emoji\">:Center:</span></code> in the footer row overrides column alignment
|
|
1579
|
+
</li>
|
|
1580
|
+
|
|
1581
|
+
<li>
|
|
1582
|
+
<strong>Table footer</strong>: <code>===</code> row creates a footer section
|
|
1583
|
+
</li>
|
|
1584
|
+
|
|
1585
|
+
<li>
|
|
1586
|
+
<strong>IAL attributes</strong>: <code>{: .performance-table #q4-results .striped}</code> applies classes and ID to the table
|
|
1587
|
+
</li>
|
|
1588
|
+
|
|
1589
|
+
</ul>
|
|
1590
|
+
|
|
1591
|
+
<h2 id="see-also">
|
|
1592
|
+
See Also
|
|
1593
|
+
</h2>
|
|
1594
|
+
|
|
1595
|
+
<ul>
|
|
1596
|
+
|
|
1597
|
+
<li>
|
|
1598
|
+
<a href="Syntax.html">Syntax</a> - General syntax documentation
|
|
1599
|
+
</li>
|
|
1600
|
+
|
|
1601
|
+
<li>
|
|
1602
|
+
<a href="Inline-Attribute-Lists.html">Inline Attribute Lists</a> - Complete IAL syntax reference
|
|
1603
|
+
</li>
|
|
1604
|
+
|
|
1605
|
+
<li>
|
|
1606
|
+
<a href="Command-Line-Options.html">Command Line Options</a> - Table-related command-line options
|
|
1607
|
+
</li>
|
|
1608
|
+
|
|
1609
|
+
<li>
|
|
1610
|
+
<a href="Modes.html">Modes</a> - Table features available in different modes
|
|
1611
|
+
</li>
|
|
1612
|
+
|
|
1613
|
+
</ul>
|
|
1614
|
+
|
|
1615
|
+
<script>
|
|
1616
|
+
// Hamburger menu functionality
|
|
1617
|
+
(function() {
|
|
1618
|
+
function initHamburgerMenu() {
|
|
1619
|
+
var hamburger = document.getElementById('hamburger-menu');
|
|
1620
|
+
var sidebar = document.querySelector('.main-toc, .sidebar');
|
|
1621
|
+
var overlay = document.getElementById('mobile-menu-overlay');
|
|
1622
|
+
|
|
1623
|
+
if (!hamburger || !sidebar) return;
|
|
1624
|
+
|
|
1625
|
+
function toggleMenu() {
|
|
1626
|
+
var isOpen = sidebar.classList.contains('mobile-open');
|
|
1627
|
+
if (isOpen) {
|
|
1628
|
+
sidebar.classList.remove('mobile-open');
|
|
1629
|
+
hamburger.classList.remove('active');
|
|
1630
|
+
if (overlay) overlay.classList.remove('active');
|
|
1631
|
+
} else {
|
|
1632
|
+
sidebar.classList.add('mobile-open');
|
|
1633
|
+
hamburger.classList.add('active');
|
|
1634
|
+
if (overlay) overlay.classList.add('active');
|
|
1635
|
+
}
|
|
1636
|
+
}
|
|
1637
|
+
|
|
1638
|
+
hamburger.addEventListener('click', function(e) {
|
|
1639
|
+
e.stopPropagation();
|
|
1640
|
+
toggleMenu();
|
|
1641
|
+
});
|
|
1642
|
+
|
|
1643
|
+
if (overlay) {
|
|
1644
|
+
overlay.addEventListener('click', function() {
|
|
1645
|
+
toggleMenu();
|
|
1646
|
+
});
|
|
1647
|
+
}
|
|
1648
|
+
|
|
1649
|
+
// Close menu when clicking on a sidebar link (mobile only)
|
|
1650
|
+
if (window.innerWidth <= 768) {
|
|
1651
|
+
var sidebarLinks = sidebar.querySelectorAll('a');
|
|
1652
|
+
sidebarLinks.forEach(function(link) {
|
|
1653
|
+
link.addEventListener('click', function() {
|
|
1654
|
+
setTimeout(function() {
|
|
1655
|
+
sidebar.classList.remove('mobile-open');
|
|
1656
|
+
hamburger.classList.remove('active');
|
|
1657
|
+
if (overlay) overlay.classList.remove('active');
|
|
1658
|
+
}, 100);
|
|
1659
|
+
});
|
|
1660
|
+
});
|
|
1661
|
+
}
|
|
1662
|
+
|
|
1663
|
+
// Close menu on window resize if going to desktop
|
|
1664
|
+
window.addEventListener('resize', function() {
|
|
1665
|
+
if (window.innerWidth > 768) {
|
|
1666
|
+
sidebar.classList.remove('mobile-open');
|
|
1667
|
+
hamburger.classList.remove('active');
|
|
1668
|
+
if (overlay) overlay.classList.remove('active');
|
|
1669
|
+
}
|
|
1670
|
+
});
|
|
1671
|
+
}
|
|
1672
|
+
|
|
1673
|
+
// Initialize when DOM is ready
|
|
1674
|
+
if (document.readyState === 'loading') {
|
|
1675
|
+
document.addEventListener('DOMContentLoaded', initHamburgerMenu);
|
|
1676
|
+
} else {
|
|
1677
|
+
initHamburgerMenu();
|
|
1678
|
+
}
|
|
1679
|
+
})();
|
|
1680
|
+
|
|
1681
|
+
</script>
|
|
1682
|
+
<script>
|
|
1683
|
+
(function() {
|
|
1684
|
+
// Clone the page TOC for floating TOC
|
|
1685
|
+
function initFloatingTOC() {
|
|
1686
|
+
var pageTOC = document.getElementById('page-toc-top');
|
|
1687
|
+
var floatingTOCContent = document.getElementById('floating-toc-content');
|
|
1688
|
+
var floatingTOC = document.getElementById('floating-toc');
|
|
1689
|
+
|
|
1690
|
+
if (!pageTOC || !floatingTOCContent || !floatingTOC) return;
|
|
1691
|
+
|
|
1692
|
+
// Clone the TOC structure
|
|
1693
|
+
var tocClone = pageTOC.cloneNode(true);
|
|
1694
|
+
tocClone.id = 'floating-toc-clone';
|
|
1695
|
+
floatingTOCContent.appendChild(tocClone);
|
|
1696
|
+
|
|
1697
|
+
// Update all links to use smooth scrolling
|
|
1698
|
+
var allTOCLinks = document.querySelectorAll('.page-toc a, .floating-toc-content a');
|
|
1699
|
+
allTOCLinks.forEach(function(link) {
|
|
1700
|
+
link.addEventListener('click', function(e) {
|
|
1701
|
+
var href = this.getAttribute('href');
|
|
1702
|
+
if (href && href.startsWith('#')) {
|
|
1703
|
+
e.preventDefault();
|
|
1704
|
+
var targetId = href.substring(1);
|
|
1705
|
+
var targetElement = document.getElementById(targetId);
|
|
1706
|
+
if (targetElement) {
|
|
1707
|
+
var offset = 20; // Offset from top
|
|
1708
|
+
|
|
1709
|
+
// Function to calculate absolute position from document top
|
|
1710
|
+
function getAbsoluteTop(element) {
|
|
1711
|
+
var top = 0;
|
|
1712
|
+
while (element) {
|
|
1713
|
+
top += element.offsetTop;
|
|
1714
|
+
element = element.offsetParent;
|
|
1715
|
+
}
|
|
1716
|
+
return top;
|
|
1717
|
+
}
|
|
1718
|
+
|
|
1719
|
+
var absoluteTop = getAbsoluteTop(targetElement);
|
|
1720
|
+
var scrollTop = window.pageYOffset || document.documentElement.scrollTop;
|
|
1721
|
+
var offsetPosition = absoluteTop - offset;
|
|
1722
|
+
|
|
1723
|
+
// Only scroll if we're not already at the target position
|
|
1724
|
+
if (Math.abs(scrollTop - offsetPosition) > 10) {
|
|
1725
|
+
window.scrollTo({
|
|
1726
|
+
top: Math.max(0, offsetPosition),
|
|
1727
|
+
behavior: 'smooth'
|
|
1728
|
+
});
|
|
1729
|
+
}
|
|
1730
|
+
|
|
1731
|
+
// Update URL hash without triggering scroll
|
|
1732
|
+
if (history.pushState) {
|
|
1733
|
+
history.pushState(null, null, href);
|
|
1734
|
+
}
|
|
1735
|
+
}
|
|
1736
|
+
}
|
|
1737
|
+
});
|
|
1738
|
+
});
|
|
1739
|
+
|
|
1740
|
+
// Handle scroll to show/hide floating TOC
|
|
1741
|
+
var tocTop = pageTOC.getBoundingClientRect().top + window.pageYOffset;
|
|
1742
|
+
var tocBottom = tocTop + pageTOC.offsetHeight;
|
|
1743
|
+
|
|
1744
|
+
function updateFloatingTOC() {
|
|
1745
|
+
var scrollY = window.pageYOffset || document.documentElement.scrollTop;
|
|
1746
|
+
|
|
1747
|
+
if (scrollY > tocBottom) {
|
|
1748
|
+
floatingTOC.classList.add('visible');
|
|
1749
|
+
} else {
|
|
1750
|
+
floatingTOC.classList.remove('visible');
|
|
1751
|
+
}
|
|
1752
|
+
}
|
|
1753
|
+
|
|
1754
|
+
// Throttle scroll events
|
|
1755
|
+
var ticking = false;
|
|
1756
|
+
window.addEventListener('scroll', function() {
|
|
1757
|
+
if (!ticking) {
|
|
1758
|
+
window.requestAnimationFrame(function() {
|
|
1759
|
+
updateFloatingTOC();
|
|
1760
|
+
ticking = false;
|
|
1761
|
+
});
|
|
1762
|
+
ticking = true;
|
|
1763
|
+
}
|
|
1764
|
+
});
|
|
1765
|
+
|
|
1766
|
+
// Initial check
|
|
1767
|
+
updateFloatingTOC();
|
|
1768
|
+
}
|
|
1769
|
+
|
|
1770
|
+
// Initialize when DOM is ready
|
|
1771
|
+
if (document.readyState === 'loading') {
|
|
1772
|
+
document.addEventListener('DOMContentLoaded', initFloatingTOC);
|
|
1773
|
+
} else {
|
|
1774
|
+
initFloatingTOC();
|
|
1775
|
+
}
|
|
1776
|
+
})();
|
|
1777
|
+
</script>
|
|
1778
|
+
<footer class="page-footer"><p>Copyright 2025 Brett Terpstra, All Rights Reserved | MIT License</p></footer></body>
|
|
1779
|
+
|
|
1780
|
+
</html>
|
|
1781
|
+
|