apex-ruby 1.0.17 → 1.0.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (207) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +17 -3
  3. data/ext/apex_ext/apex_ext.c +260 -91
  4. data/ext/apex_ext/apex_src/CHANGELOG.md +440 -0
  5. data/ext/apex_ext/apex_src/CMakeLists.txt +15 -1
  6. data/ext/apex_ext/apex_src/Formula/apex.rb +7 -2
  7. data/ext/apex_ext/apex_src/Package.swift +15 -4
  8. data/ext/apex_ext/apex_src/README.md +94 -35
  9. data/ext/apex_ext/apex_src/VERSION +1 -1
  10. data/ext/apex_ext/apex_src/apex-debug.log +4 -0
  11. data/ext/apex_ext/apex_src/apex.code-workspace +38 -0
  12. data/ext/apex_ext/apex_src/apex.taskpaper +12 -0
  13. data/ext/apex_ext/apex_src/apex_deflist_debug.log +25 -0
  14. data/ext/apex_ext/apex_src/buildnotes.md +1435 -0
  15. data/ext/apex_ext/apex_src/cli/main.c +262 -33
  16. data/ext/apex_ext/apex_src/debug.log +7 -0
  17. data/ext/apex_ext/apex_src/docs/CITATIONS_EXAMPLES.md +274 -0
  18. data/ext/apex_ext/apex_src/docs/CITATIONS_IMPLEMENTATION_PLAN.md +749 -0
  19. data/ext/apex_ext/apex_src/docs/CITATIONS_PLAN.md +744 -0
  20. data/ext/apex_ext/apex_src/docs/INDEX_IMPLEMENTATION_ANALYSIS.md +382 -0
  21. data/ext/apex_ext/apex_src/docs/plans/2025-02-27-man-page-output-implementation.md +351 -0
  22. data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-12-toc-output-format.md +745 -0
  23. data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-18-bear-image-attributes.md +829 -0
  24. data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-19-apex-node-npm.md +1148 -0
  25. data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-12-toc-output-format-design.md +161 -0
  26. data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-18-bear-image-attributes-design.md +184 -0
  27. data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-19-apex-node-npm-design.md +211 -0
  28. data/ext/apex_ext/apex_src/documentation/app-settings-table.md +67 -0
  29. data/ext/apex_ext/apex_src/documentation/app-transformed/Citations.md +340 -0
  30. data/ext/apex_ext/apex_src/documentation/app-transformed/Credits.md +11 -0
  31. data/ext/apex_ext/apex_src/documentation/app-transformed/Header-IDs.md +234 -0
  32. data/ext/apex_ext/apex_src/documentation/app-transformed/Inline-Attribute-Lists.md +516 -0
  33. data/ext/apex_ext/apex_src/documentation/app-transformed/Metadata-Transforms.md +461 -0
  34. data/ext/apex_ext/apex_src/documentation/app-transformed/Modes.md +193 -0
  35. data/ext/apex_ext/apex_src/documentation/app-transformed/Multi-File-Documents.md +201 -0
  36. data/ext/apex_ext/apex_src/documentation/app-transformed/Plugins.md +678 -0
  37. data/ext/apex_ext/apex_src/documentation/app-transformed/Syntax.md +1367 -0
  38. data/ext/apex_ext/apex_src/documentation/docsets/Apex Command Line Options.cheatsheet.txt +6 -0
  39. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/C-API.html +774 -300
  40. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Callouts.html +1194 -0
  41. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Citations.html +416 -216
  42. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Command-Line-Options.html +3544 -1094
  43. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Configuration.html +371 -97
  44. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Credits.html +153 -23
  45. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Examples.html +358 -124
  46. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Filters.html +1656 -0
  47. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Generating-Man-Pages.html +1226 -0
  48. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Getting-Started.html +201 -56
  49. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Header-IDs.html +279 -109
  50. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Home.html +200 -53
  51. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Indices.html +2327 -0
  52. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Inline-Attribute-Lists.html +690 -271
  53. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Installation.html +201 -55
  54. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Limitations-and-Roadmap.html +238 -68
  55. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Metadata-Transforms.html +421 -221
  56. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Modes.html +340 -78
  57. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Multi-File-Documents.html +251 -86
  58. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Multi-Format-Images.html +1362 -0
  59. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Pandoc-Integration.html +277 -90
  60. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Plugins.html +673 -346
  61. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Quarto-Mode.html +1405 -0
  62. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Rendering-Markdown-In-Terminal.html +1902 -0
  63. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Syntax.html +1939 -1698
  64. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Tables.html +1781 -0
  65. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Troubleshooting.html +315 -140
  66. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Usage.html +307 -113
  67. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Using-Apex-with-Jekyll.html +1132 -0
  68. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Writing-Tests.html +1754 -0
  69. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Xcode-Integration.html +872 -376
  70. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/docSet.dsidx +0 -0
  71. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/optimizedIndex.dsidx +0 -0
  72. data/ext/apex_ext/apex_src/documentation/html/apex-app-docs.html +8746 -0
  73. data/ext/apex_ext/apex_src/documentation/shared_styles.css +20 -15
  74. data/ext/apex_ext/apex_src/documentation/transform_for_app.md +55 -0
  75. data/ext/apex_ext/apex_src/escaping-repro.md +103 -0
  76. data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/Info.plist +8 -0
  77. data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/QuickLook/Preview.png +0 -0
  78. data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/document.wflow +547 -0
  79. data/ext/apex_ext/apex_src/examples/quick-actions/Markdown-to-RTF.workflow.zip +0 -0
  80. data/ext/apex_ext/apex_src/examples/quick-actions/README.md +33 -0
  81. data/ext/apex_ext/apex_src/include/apex/apex.h +92 -6
  82. data/ext/apex_ext/apex_src/include/apex/ast_rtf.h +23 -0
  83. data/ext/apex_ext/apex_src/include/apex/ast_terminal.h +6 -0
  84. data/ext/apex_ext/apex_src/include/apex/module.modulemap +5 -0
  85. data/ext/apex_ext/apex_src/include/apex/plugins.h +105 -0
  86. data/ext/apex_ext/apex_src/include/apexc.h +1 -0
  87. data/ext/apex_ext/apex_src/man/apex.1 +82 -78
  88. data/ext/apex_ext/apex_src/man/apex.1.md +81 -4
  89. data/ext/apex_ext/apex_src/objc/Apex.swift +73 -0
  90. data/ext/apex_ext/apex_src/objc/ApexPlugins.swift +79 -0
  91. data/ext/apex_ext/apex_src/objc/NSString+Apex.h +83 -5
  92. data/ext/apex_ext/apex_src/objc/NSString+Apex.m +244 -1
  93. data/ext/apex_ext/apex_src/objc/NSString+ApexPlugins.h +76 -0
  94. data/ext/apex_ext/apex_src/objc/NSString+ApexPlugins.m +169 -0
  95. data/ext/apex_ext/apex_src/output.html +87 -0
  96. data/ext/apex_ext/apex_src/plans/quarto-mode.md +442 -0
  97. data/ext/apex_ext/apex_src/src/_README.md +85 -32
  98. data/ext/apex_ext/apex_src/src/apex.c +770 -200
  99. data/ext/apex_ext/apex_src/src/ast_rtf.c +848 -0
  100. data/ext/apex_ext/apex_src/src/ast_terminal.c +184 -7
  101. data/ext/apex_ext/apex_src/src/extensions/abbreviations.c +10 -3
  102. data/ext/apex_ext/apex_src/src/extensions/advanced_tables.c +7 -11
  103. data/ext/apex_ext/apex_src/src/extensions/bear_image_attrs.c +467 -0
  104. data/ext/apex_ext/apex_src/src/extensions/bear_image_attrs.h +27 -0
  105. data/ext/apex_ext/apex_src/src/extensions/callouts.c +400 -4
  106. data/ext/apex_ext/apex_src/src/extensions/callouts.h +15 -5
  107. data/ext/apex_ext/apex_src/src/extensions/citations.c +26 -5
  108. data/ext/apex_ext/apex_src/src/extensions/code_fence_attrs.c +632 -0
  109. data/ext/apex_ext/apex_src/src/extensions/code_fence_attrs.h +22 -0
  110. data/ext/apex_ext/apex_src/src/extensions/concordance.c +632 -0
  111. data/ext/apex_ext/apex_src/src/extensions/definition_list.c +129 -15
  112. data/ext/apex_ext/apex_src/src/extensions/grid_tables.c +1050 -121
  113. data/ext/apex_ext/apex_src/src/extensions/html_markdown.c +569 -16
  114. data/ext/apex_ext/apex_src/src/extensions/ial.c +502 -52
  115. data/ext/apex_ext/apex_src/src/extensions/ial.h +2 -1
  116. data/ext/apex_ext/apex_src/src/extensions/includes.c +532 -33
  117. data/ext/apex_ext/apex_src/src/extensions/includes.h +7 -1
  118. data/ext/apex_ext/apex_src/src/extensions/index.c +1427 -140
  119. data/ext/apex_ext/apex_src/src/extensions/index.h +28 -0
  120. data/ext/apex_ext/apex_src/src/extensions/metadata.c +200 -161
  121. data/ext/apex_ext/apex_src/src/extensions/quarto_diagrams.c +251 -0
  122. data/ext/apex_ext/apex_src/src/extensions/quarto_diagrams.h +22 -0
  123. data/ext/apex_ext/apex_src/src/extensions/quarto_lists.c +624 -0
  124. data/ext/apex_ext/apex_src/src/extensions/quarto_lists.h +35 -0
  125. data/ext/apex_ext/apex_src/src/extensions/quarto_polish.c +264 -0
  126. data/ext/apex_ext/apex_src/src/extensions/quarto_polish.h +23 -0
  127. data/ext/apex_ext/apex_src/src/extensions/quarto_shortcodes.c +307 -0
  128. data/ext/apex_ext/apex_src/src/extensions/quarto_shortcodes.h +21 -0
  129. data/ext/apex_ext/apex_src/src/extensions/raw_content.c +351 -0
  130. data/ext/apex_ext/apex_src/src/extensions/raw_content.h +20 -0
  131. data/ext/apex_ext/apex_src/src/extensions/relaxed_tables.c +117 -3
  132. data/ext/apex_ext/apex_src/src/extensions/special_markers.c +53 -0
  133. data/ext/apex_ext/apex_src/src/extensions/syntax_highlight.c +23 -1
  134. data/ext/apex_ext/apex_src/src/extensions/table_html_postprocess.c +83 -92
  135. data/ext/apex_ext/apex_src/src/extensions/toc.c +446 -25
  136. data/ext/apex_ext/apex_src/src/extensions/toc.h +26 -1
  137. data/ext/apex_ext/apex_src/src/extensions/wiki_links.c +28 -0
  138. data/ext/apex_ext/apex_src/src/html_renderer.c +387 -17
  139. data/ext/apex_ext/apex_src/src/plugin_catalog.c +517 -0
  140. data/ext/apex_ext/apex_src/src/plugins_remote.c +88 -14
  141. data/ext/apex_ext/apex_src/src/plugins_remote.h +34 -0
  142. data/ext/apex_ext/apex_src/src/pretty_html.c +6 -1
  143. data/ext/apex_ext/apex_src/tests/fixtures/comprehensive_test.md +21 -0
  144. data/ext/apex_ext/apex_src/tests/fixtures/images/bear_image_attributes.md +10 -0
  145. data/ext/apex_ext/apex_src/tests/fixtures/includes/sections.md +19 -0
  146. data/ext/apex_ext/apex_src/tests/fixtures/includes/sections.txt +11 -0
  147. data/ext/apex_ext/apex_src/tests/fixtures/minimal_pb.md +2 -0
  148. data/ext/apex_ext/apex_src/tests/fixtures/obsidian-callouts.md +46 -0
  149. data/ext/apex_ext/apex_src/tests/fixtures/pagebreak_html_repro.md +5 -0
  150. data/ext/apex_ext/apex_src/tests/fixtures/python-callouts.md +47 -0
  151. data/ext/apex_ext/apex_src/tests/fixtures/quarto/callouts.md +3 -0
  152. data/ext/apex_ext/apex_src/tests/fixtures/quarto/code-attrs.md +3 -0
  153. data/ext/apex_ext/apex_src/tests/fixtures/quarto/diagrams.md +8 -0
  154. data/ext/apex_ext/apex_src/tests/fixtures/quarto/lists.md +19 -0
  155. data/ext/apex_ext/apex_src/tests/fixtures/quarto/raw-content.md +5 -0
  156. data/ext/apex_ext/apex_src/tests/fixtures/quarto/shortcodes.md +7 -0
  157. data/ext/apex_ext/apex_src/tests/fixtures/quarto/smoke.md +81 -0
  158. data/ext/apex_ext/apex_src/tests/fixtures/quarto/spans.md +5 -0
  159. data/ext/apex_ext/apex_src/tests/fixtures/quarto-callouts.md +47 -0
  160. data/ext/apex_ext/apex_src/tests/fixtures/speed.md +192 -0
  161. data/ext/apex_ext/apex_src/tests/fixtures/tables/grid-tables.md +37 -0
  162. data/ext/apex_ext/apex_src/tests/paginate_cli_test.sh +16 -0
  163. data/ext/apex_ext/apex_src/tests/test_bear_image_attrs.c +301 -0
  164. data/ext/apex_ext/apex_src/tests/test_concordance.tsv +4 -0
  165. data/ext/apex_ext/apex_src/tests/test_escaping_repro.c +82 -0
  166. data/ext/apex_ext/apex_src/tests/test_extensions.c +821 -1
  167. data/ext/apex_ext/apex_src/tests/test_ial.c +7 -0
  168. data/ext/apex_ext/apex_src/tests/test_marked_integration.c +25 -0
  169. data/ext/apex_ext/apex_src/tests/test_metadata.c +129 -0
  170. data/ext/apex_ext/apex_src/tests/test_output.c +568 -2
  171. data/ext/apex_ext/apex_src/tests/test_runner.c +11 -0
  172. data/ext/apex_ext/apex_src/tests/test_tables.c +420 -0
  173. data/ext/apex_ext/apex_src/vendor/cmark-gfm/CMakeLists.txt +1 -1
  174. data/ext/apex_ext/apex_src/vendor/cmark-gfm/extensions/autolink.c +77 -1
  175. data/ext/apex_ext/apex_src/vendor/cmark-gfm/extensions/table.c +135 -5
  176. data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/blocks.c +56 -1
  177. data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/config.h +38 -0
  178. data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/main.c +1 -1
  179. data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/__pycache__/cmark.cpython-314.pyc +0 -0
  180. data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/__pycache__/normalize.cpython-314.pyc +0 -0
  181. data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/extensions.txt +69 -0
  182. data/ext/apex_ext/apex_src/xcode_build/CMakeScripts/ReRunCMake.make +74 -0
  183. data/ext/apex_ext/apex_src/xcode_build/CTestTestfile.cmake +22 -0
  184. data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/Apex +0 -0
  185. data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/Resources/Info.plist +44 -0
  186. data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/_CodeSignature/CodeResources +128 -0
  187. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.pbxproj +5118 -0
  188. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings +8 -0
  189. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcuserdata/ttscoff.xcuserdatad/UserInterfaceState.xcuserstate +0 -0
  190. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcuserdata/ttscoff.xcuserdatad/WorkspaceSettings.xcsettings +8 -0
  191. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/xcuserdata/ttscoff.xcuserdatad/xcschemes/xcschememanagement.plist +99 -0
  192. data/ext/apex_ext/apex_src/xcode_build/cmake_install.cmake +452 -0
  193. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/CMakeScripts/ReRunCMake.make +52 -0
  194. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmake_install.cmake +55 -0
  195. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmark-gfm.xcodeproj/project.pbxproj +2455 -0
  196. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmark-gfm.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings +8 -0
  197. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/extensions/cmake_install.cmake +171 -0
  198. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/man/cmake_install.cmake +55 -0
  199. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmake_install.cmake +220 -0
  200. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmark-gfm_export.h +43 -0
  201. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmark-gfm_version.h +7 -0
  202. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/config.h +76 -0
  203. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/libcmark-gfm.pc +10 -0
  204. data/ext/apex_ext/extconf.rb +35 -0
  205. data/lib/apex/version.rb +2 -2
  206. metadata +117 -2
  207. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/tempOptimizedIndex.dsidx +0 -0
@@ -5,8 +5,97 @@
5
5
 
6
6
  <meta charset="UTF-8">
7
7
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
8
- <meta name="generator" content="Apex 0.1.49">
8
+ <meta name="generator" content="Apex 1.1.12">
9
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>
10
99
  <style>
11
100
  body {
12
101
  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
@@ -35,10 +124,52 @@
35
124
  ins { background: #d4fcbc; text-decoration: none; }
36
125
  del { background: #fbb6c2; text-decoration: line-through; }
37
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; }
38
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
+ }
39
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
+
40
165
  <style>
41
- /* Base styles */
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) */
42
173
  body {
43
174
  -webkit-font-smoothing: antialiased;
44
175
  -moz-osx-font-smoothing: grayscale;
@@ -48,6 +179,11 @@ body {
48
179
  line-height: 1.65;
49
180
  color: #1e293b;
50
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;
51
187
  }
52
188
 
53
189
  /* Sidebar / Main TOC - wider on larger screens */
@@ -56,9 +192,10 @@ body {
56
192
  position: fixed;
57
193
  left: 0;
58
194
  top: 0;
59
- width: auto;
60
- min-width: 180px;
61
- max-width: 250px;
195
+ box-sizing: border-box;
196
+ width: var(--sidebar-width);
197
+ min-width: var(--sidebar-width);
198
+ max-width: var(--sidebar-width);
62
199
  height: 100vh;
63
200
  overflow-y: auto;
64
201
  background: #1e293b;
@@ -67,7 +204,6 @@ body {
67
204
  padding: 24px 20px 130px;
68
205
  font-size: 14px;
69
206
  z-index: 100;
70
- margin-right: 1rem;
71
207
  box-shadow: 4px 0 24px rgba(0, 0, 0, 0.08);
72
208
  transition: transform 0.3s ease;
73
209
  }
@@ -116,11 +252,6 @@ body {
116
252
  font-weight: 500;
117
253
  }
118
254
 
119
- /* Body margin for sidebar */
120
- body {
121
- margin-left: 270px;
122
- }
123
-
124
255
  /* Hamburger menu button */
125
256
  .hamburger-menu {
126
257
  display: none;
@@ -136,6 +267,7 @@ body {
136
267
  color: rgba(255, 255, 255, 0.9);
137
268
  font-size: 20px;
138
269
  line-height: 1;
270
+ box-sizing: border-box;
139
271
  width: 44px;
140
272
  height: 44px;
141
273
  align-items: center;
@@ -153,9 +285,7 @@ body {
153
285
 
154
286
  /* Move hamburger to the right of the sidebar when menu is open */
155
287
  .hamburger-menu.active {
156
- left: calc(
157
- 250px + 12px
158
- ); /* Position just to the right of sidebar (max-width 250px + 12px padding) */
288
+ left: calc(var(--sidebar-width) + 12px);
159
289
  }
160
290
 
161
291
  .hamburger-menu.active {
@@ -251,7 +381,7 @@ body {
251
381
  .floating-toc {
252
382
  position: fixed;
253
383
  top: 0;
254
- left: 270px;
384
+ left: var(--sidebar-offset);
255
385
  right: 0;
256
386
  z-index: 50;
257
387
  opacity: 0;
@@ -677,7 +807,7 @@ ol ul {
677
807
  }
678
808
 
679
809
  body {
680
- margin-left: 0;
810
+ margin: 2rem 1rem;
681
811
  }
682
812
 
683
813
  .floating-toc {
@@ -687,7 +817,7 @@ ol ul {
687
817
 
688
818
  </style></head>
689
819
 
690
- <body>
820
+ <body class="code-highlighted">
691
821
  <div class="floating-toc" id="floating-toc">
692
822
  <div class="floating-toc-container">
693
823
  <div class="floating-toc-header">
@@ -702,77 +832,85 @@ ol ul {
702
832
  <button class="hamburger-menu" id="hamburger-menu" aria-label="Toggle navigation"></button>
703
833
  <div class="mobile-menu-overlay" id="mobile-menu-overlay"></div>
704
834
 
705
- <nav class="main-toc"><ul><li><a href="Home.html">Home</a></li><li><a href="Getting-Started.html">Getting Started</a></li><li><a href="Installation.html">Installation</a></li><li><a href="Usage.html">Usage</a></li><li><a href="Syntax.html">Syntax</a></li><li><a href="Inline-Attribute-Lists.html">Inline Attribute Lists</a></li><li><a href="Modes.html">Modes</a></li><li><a href="Command-Line-Options.html">Command Line Options</a></li><li><a href="Multi-File-Documents.html">Multi-file Documents</a></li><li><a href="Citations.html">Citations</a></li><li><a href="Metadata-Transforms.html">Metadata Transforms</a></li><li><a href="Pandoc-Integration.html">Integrating with Pandoc</a></li><li><a href="Header-IDs.html">Header IDs</a></li><li><a href="C-API.html">C API</a></li><li><a href="Xcode-Integration.html">Xcode Integration</a></li><li><a href="Examples.html">Examples</a></li><li><a href="Plugins.html">Plugins</a></li><li><a href="Troubleshooting.html">Troubleshooting</a></li><li><a href="Credits.html">Credits</a></li></ul></nav>
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>
706
836
 
707
837
  <h1 id="citations-and-bibliography">
708
- Citations and Bibliography
838
+ Citations and&nbsp;Bibliography
709
839
  </h1>
710
- <nav class="page-toc" id="page-toc-top"><ul><li><a href="#citations-and-bibliography">Citations and Bibliography</a><ul><li><a href="#quick-start">Quick Start</a></li><li><a href="#citation-syntaxes">Citation Syntaxes</a><ul><li><a href="#pandoc-syntax">Pandoc Syntax</a></li><li><a href="#multimarkdown-syntax">MultiMarkdown Syntax</a></li><li><a href="#mmark-syntax">mmark Syntax</a></li></ul></li><li><a href="#bibliography-formats">Bibliography Formats</a><ul><li><a href="#bibtex-bib">BibTeX (.bib)</a></li><li><a href="#csl-json-json">CSL JSON (.json)</a></li><li><a href="#csl-yaml-yml-yaml">CSL YAML (.yml, .yaml)</a></li></ul></li><li><a href="#specifying-bibliography">Specifying Bibliography</a><ul><li><a href="#command-line">Command Line</a></li><li><a href="#document-metadata">Document Metadata</a></li></ul></li><li><a href="#bibliography-generation">Bibliography Generation</a></li><li><a href="#citation-options">Citation Options</a><ul><li><a href="#link-citations">Link Citations</a></li><li><a href="#suppress-bibliography">Suppress Bibliography</a></li><li><a href="#citation-style-csl">Citation Style (CSL)</a></li></ul></li><li><a href="#mode-support">Mode Support</a></li><li><a href="#performance">Performance</a></li><li><a href="#related">Related</a></li></ul></li></ul></nav>
840
+ <nav class="page-toc" id="page-toc-top"><ul><li><a href="#citations-and-bibliography">Citations and&nbsp;Bibliography</a><ul><li><a href="#quick-start">Quick&nbsp;Start</a></li><li><a href="#citation-syntaxes">Citation&nbsp;Syntaxes</a><ul><li><a href="#pandoc-syntax">Pandoc&nbsp;Syntax</a></li><li><a href="#multimarkdown-syntax">MultiMarkdown&nbsp;Syntax</a></li><li><a href="#mmark-syntax">mmark&nbsp;Syntax</a></li></ul></li><li><a href="#bibliography-formats">Bibliography&nbsp;Formats</a><ul><li><a href="#bibtex-bib">BibTeX&nbsp;(.bib)</a></li><li><a href="#csl-json-json">CSL JSON&nbsp;(.json)</a></li><li><a href="#csl-yaml-yml-yaml">CSL YAML (.yml,&nbsp;.yaml)</a></li></ul></li><li><a href="#specifying-bibliography">Specifying Bibliography</a><ul><li><a href="#command-line">Command&nbsp;Line</a></li><li><a href="#document-metadata">Document&nbsp;Metadata</a></li></ul></li><li><a href="#bibliography-generation">Bibliography&nbsp;Generation</a></li><li><a href="#citation-options">Citation&nbsp;Options</a><ul><li><a href="#link-citations">Link&nbsp;Citations</a></li><li><a href="#suppress-bibliography">Suppress Bibliography</a></li><li><a href="#citation-style-csl">Citation Style&nbsp;(CSL)</a></li></ul></li><li><a href="#mode-support">Mode&nbsp;Support</a></li><li><a href="#performance">Performance</a></li><li><a href="#related">Related</a></li></ul></li></ul></nav>
711
841
 
712
842
  <p>
713
843
  Apex supports citations and bibliographies with multiple syntax styles and bibliography formats. Citations are processed in <strong>MultiMarkdown</strong> and <strong>unified</strong> modes.
714
844
  </p>
715
845
 
716
846
  <h2 id="quick-start">
717
- Quick Start
847
+ Quick&nbsp;Start
718
848
  </h2>
719
849
 
720
850
  <p>
721
- <strong> 1. Create a bibliography file:</strong>
851
+ <strong>1. Create a bibliography file:</strong>
722
852
  </p>
723
853
 
724
854
  <p>
725
855
  Create a BibTeX file (<code>references.bib</code>):
726
856
  </p>
727
857
 
728
- <pre><code class="highlight language-bibtex"><span class="nc">@article</span><span class="p">{</span><span class="nl">doe99</span><span class="p">,</span>
729
- <span class="na">author</span> <span class="p">=</span> <span class="s">{Doe, John}</span><span class="p">,</span>
730
- <span class="na">title</span> <span class="p">=</span> <span class="s">{Article Title}</span><span class="p">,</span>
731
- <span class="na">journal</span> <span class="p">=</span> <span class="s">{Journal Name}</span><span class="p">,</span>
732
- <span class="na">year</span> <span class="p">=</span> <span class="s">{1999}</span><span class="p">,</span>
733
- <span class="na">volume</span> <span class="p">=</span> <span class="s">{1}</span><span class="p">,</span>
734
- <span class="na">pages</span> <span class="p">=</span> <span class="s">{1--10}</span>
858
+ <div class="highlight">
859
+ <pre><span></span><span class="nc">@article</span><span class="p">{</span><span class="nl">doe99</span><span class="p">,</span>
860
+ <span class="w"> </span><span class="na">author</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{Doe, John}</span><span class="p">,</span>
861
+ <span class="w"> </span><span class="na">title</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{Article Title}</span><span class="p">,</span>
862
+ <span class="w"> </span><span class="na">journal</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{Journal Name}</span><span class="p">,</span>
863
+ <span class="w"> </span><span class="na">year</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{1999}</span><span class="p">,</span>
864
+ <span class="w"> </span><span class="na">volume</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{1}</span><span class="p">,</span>
865
+ <span class="w"> </span><span class="na">pages</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{1--10}</span>
735
866
  <span class="p">}</span>
736
867
 
737
868
  <span class="nc">@book</span><span class="p">{</span><span class="nl">smith2000</span><span class="p">,</span>
738
- <span class="na">author</span> <span class="p">=</span> <span class="s">{Smith, Jane}</span><span class="p">,</span>
739
- <span class="na">title</span> <span class="p">=</span> <span class="s">{Book Title}</span><span class="p">,</span>
740
- <span class="na">publisher</span> <span class="p">=</span> <span class="s">{Publisher}</span><span class="p">,</span>
741
- <span class="na">year</span> <span class="p">=</span> <span class="s">{2000}</span>
869
+ <span class="w"> </span><span class="na">author</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{Smith, Jane}</span><span class="p">,</span>
870
+ <span class="w"> </span><span class="na">title</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{Book Title}</span><span class="p">,</span>
871
+ <span class="w"> </span><span class="na">publisher</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{Publisher}</span><span class="p">,</span>
872
+ <span class="w"> </span><span class="na">year</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{2000}</span>
742
873
  <span class="p">}</span>
743
- </code></pre>
874
+ </pre>
875
+ </div>
744
876
 
745
877
  <p>
746
- <strong> 2. Add citations to your document:</strong>
878
+ <strong>2. Add citations to your document:</strong>
747
879
  </p>
748
880
 
749
- <pre><code class="highlight language-markdown"><span class="nn">---</span>
750
- <span class="na">bibliography</span><span class="pi">:</span> <span class="s">references.bib</span>
751
- <span class="nn">---</span>
881
+ <div class="highlight">
882
+ <pre><span></span>---
883
+ <span class="gu">bibliography: references.bib</span>
884
+ <span class="gu">---</span>
752
885
 
753
886
  See [@doe99] for details. Smith discusses this in [@smith2000].
754
887
 
755
888
  <span class="gu">## References</span>
756
889
 
757
- <span class="c">&lt;!-- REFERENCES --&gt;</span>
758
- </code></pre>
890
+ &lt;!-- REFERENCES --&gt;
891
+ </pre>
892
+ </div>
759
893
 
760
894
  <p>
761
- <strong> 3. Process with Apex:</strong>
895
+ <strong>3. Process with Apex:</strong>
762
896
  </p>
763
897
 
764
- <pre><code class="highlight language-bash">apex document.md <span class="nt">--bibliography</span> references.bib
765
- </code></pre>
898
+ <div class="highlight">
899
+ <pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--bibliography<span class="w"> </span>references.bib
900
+ </pre>
901
+ </div>
766
902
 
767
903
  <p>
768
904
  Or specify in metadata (as shown above) and just run:
769
905
  </p>
770
906
 
771
- <pre><code class="highlight language-bash">apex document.md
772
- </code></pre>
907
+ <div class="highlight">
908
+ <pre><span></span>apex<span class="w"> </span>document.md
909
+ </pre>
910
+ </div>
773
911
 
774
912
  <h2 id="citation-syntaxes">
775
- Citation Syntaxes
913
+ Citation&nbsp;Syntaxes
776
914
  </h2>
777
915
 
778
916
  <p>
@@ -780,7 +918,7 @@ See [@doe99] for details. Smith discusses this in [@smith2000].
780
918
  </p>
781
919
 
782
920
  <h3 id="pandoc-syntax">
783
- Pandoc Syntax
921
+ Pandoc&nbsp;Syntax
784
922
  </h3>
785
923
 
786
924
  <p>
@@ -788,53 +926,65 @@ See [@doe99] for details. Smith discusses this in [@smith2000].
788
926
  </p>
789
927
 
790
928
  <p>
791
- <strong> Basic citation:</strong>
929
+ <strong>Basic citation:</strong>
792
930
  </p>
793
931
 
794
- <pre><code class="highlight language-markdown">See [@doe99] for details.
795
- </code></pre>
932
+ <div class="highlight">
933
+ <pre><span></span>See [@doe99] for details.
934
+ </pre>
935
+ </div>
796
936
 
797
937
  <p>
798
- <strong> Multiple citations:</strong>
938
+ <strong>Multiple citations:</strong>
799
939
  </p>
800
940
 
801
- <pre><code class="highlight language-markdown">See [@doe99; @smith2000; @smith2004] for more information.
802
- </code></pre>
941
+ <div class="highlight">
942
+ <pre><span></span>See [@doe99; <span class="ni">@smith2000</span>; <span class="ni">@smith2004</span>] for more information.
943
+ </pre>
944
+ </div>
803
945
 
804
946
  <p>
805
- <strong> Author in text:</strong>
947
+ <strong>Author in text:</strong>
806
948
  </p>
807
949
 
808
- <pre><code class="highlight language-markdown">@smith04 says blah.
809
- </code></pre>
950
+ <div class="highlight">
951
+ <pre><span></span><span class="ni">@smith04</span> says blah.
952
+ </pre>
953
+ </div>
810
954
 
811
955
  <p>
812
- <strong> Author suppressed (year only):</strong>
956
+ <strong>Author suppressed (year only):</strong>
813
957
  </p>
814
958
 
815
- <pre><code class="highlight language-markdown">Smith says blah [-@smith04].
816
- </code></pre>
959
+ <div class="highlight">
960
+ <pre><span></span>Smith says blah [-@smith04].
961
+ </pre>
962
+ </div>
817
963
 
818
964
  <p>
819
- <strong> With locator (page numbers):</strong>
965
+ <strong>With locator (page numbers):</strong>
820
966
  </p>
821
967
 
822
- <pre><code class="highlight language-markdown">@smith04 [p. 33] says blah.
823
- See @doe99, pp. 33-35 and <span class="ge">*passim*</span>.
824
- </code></pre>
968
+ <div class="highlight">
969
+ <pre><span></span><span class="ni">@smith04</span> [p. 33] says blah.
970
+ See <span class="ni">@doe99</span>, pp. 33-35 and <span class="ge">*passim*</span>.
971
+ </pre>
972
+ </div>
825
973
 
826
974
  <p>
827
- <strong> Output:</strong>
975
+ <strong>Output:</strong>
828
976
  </p>
829
977
 
830
- <pre><code class="highlight language-html"><span class="nt">&lt;p&gt;</span>See <span class="nt">&lt;span</span> <span class="na">class=</span><span class="s">"citation"</span> <span class="na">data-cites=</span><span class="s">"doe99"</span><span class="nt">&gt;</span>(Doe, John 1999)<span class="nt">&lt;/span&gt;</span> for details.<span class="nt">&lt;/p&gt;</span>
831
- <span class="nt">&lt;p&gt;</span>See <span class="nt">&lt;span</span> <span class="na">class=</span><span class="s">"citation"</span> <span class="na">data-cites=</span><span class="s">"doe99 smith2000 smith2004"</span><span class="nt">&gt;</span>(Doe, John 1999; Smith, Jane 2000, 2004)<span class="nt">&lt;/span&gt;</span> for more information.<span class="nt">&lt;/p&gt;</span>
832
- <span class="nt">&lt;p&gt;&lt;span</span> <span class="na">class=</span><span class="s">"citation"</span> <span class="na">data-cites=</span><span class="s">"smith04"</span><span class="nt">&gt;</span>Smith, John (2004)<span class="nt">&lt;/span&gt;</span> says blah.<span class="nt">&lt;/p&gt;</span>
833
- <span class="nt">&lt;p&gt;</span>Smith says blah <span class="nt">&lt;span</span> <span class="na">class=</span><span class="s">"citation"</span> <span class="na">data-cites=</span><span class="s">"smith04"</span><span class="nt">&gt;</span>(2004)<span class="nt">&lt;/span&gt;</span>.<span class="nt">&lt;/p&gt;</span>
834
- </code></pre>
978
+ <div class="highlight">
979
+ <pre><span></span><span class="p">&lt;</span><span class="nt">p</span><span class="p">&gt;</span>See <span class="p">&lt;</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;citation&quot;</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">&quot;doe99&quot;</span><span class="p">&gt;</span>(Doe, John 1999)<span class="p">&lt;/</span><span class="nt">span</span><span class="p">&gt;</span> for details.<span class="p">&lt;/</span><span class="nt">p</span><span class="p">&gt;</span>
980
+ <span class="p">&lt;</span><span class="nt">p</span><span class="p">&gt;</span>See <span class="p">&lt;</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;citation&quot;</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">&quot;doe99 smith2000 smith2004&quot;</span><span class="p">&gt;</span>(Doe, John 1999; Smith, Jane 2000, 2004)<span class="p">&lt;/</span><span class="nt">span</span><span class="p">&gt;</span> for more information.<span class="p">&lt;/</span><span class="nt">p</span><span class="p">&gt;</span>
981
+ <span class="p">&lt;</span><span class="nt">p</span><span class="p">&gt;&lt;</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;citation&quot;</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">&quot;smith04&quot;</span><span class="p">&gt;</span>Smith, John (2004)<span class="p">&lt;/</span><span class="nt">span</span><span class="p">&gt;</span> says blah.<span class="p">&lt;/</span><span class="nt">p</span><span class="p">&gt;</span>
982
+ <span class="p">&lt;</span><span class="nt">p</span><span class="p">&gt;</span>Smith says blah <span class="p">&lt;</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;citation&quot;</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">&quot;smith04&quot;</span><span class="p">&gt;</span>(2004)<span class="p">&lt;/</span><span class="nt">span</span><span class="p">&gt;</span>.<span class="p">&lt;/</span><span class="nt">p</span><span class="p">&gt;</span>
983
+ </pre>
984
+ </div>
835
985
 
836
986
  <h3 id="multimarkdown-syntax">
837
- MultiMarkdown Syntax
987
+ MultiMarkdown&nbsp;Syntax
838
988
  </h3>
839
989
 
840
990
  <p>
@@ -842,43 +992,53 @@ See @doe99, pp. 33-35 and <span class="ge">*passim*</span>.
842
992
  </p>
843
993
 
844
994
  <p>
845
- <strong> Basic citation:</strong>
995
+ <strong>Basic citation:</strong>
846
996
  </p>
847
997
 
848
- <pre><code class="highlight language-markdown">This is a statement[#Doe:2006].
849
- </code></pre>
998
+ <div class="highlight">
999
+ <pre><span></span>This is a statement[#Doe:2006].
1000
+ </pre>
1001
+ </div>
850
1002
 
851
1003
  <p>
852
- <strong> With locator:</strong>
1004
+ <strong>With locator:</strong>
853
1005
  </p>
854
1006
 
855
- <pre><code class="highlight language-markdown">This is a statement<span class="p">[</span><span class="nv">p. 23</span><span class="p">][</span><span class="ss">#Doe:2006</span><span class="p">]</span>.
856
- </code></pre>
1007
+ <div class="highlight">
1008
+ <pre><span></span>This is a statement[p. 23][#Doe:2006].
1009
+ </pre>
1010
+ </div>
857
1011
 
858
1012
  <p>
859
- <strong> Empty locator:</strong>
1013
+ <strong>Empty locator:</strong>
860
1014
  </p>
861
1015
 
862
- <pre><code class="highlight language-markdown">This is a statement<span class="p">[][</span><span class="ss">#Doe:2006</span><span class="p">]</span>.
863
- </code></pre>
1016
+ <div class="highlight">
1017
+ <pre><span></span>This is a statement[][#Doe:2006].
1018
+ </pre>
1019
+ </div>
864
1020
 
865
1021
  <p>
866
- <strong> Inline citation:</strong>
1022
+ <strong>Inline citation:</strong>
867
1023
  </p>
868
1024
 
869
- <pre><code class="highlight language-markdown">As per Doe.[#John Doe. <span class="ge">*A Totally Fake Book 1*</span>. Vanity Press, 2006.]
870
- </code></pre>
1025
+ <div class="highlight">
1026
+ <pre><span></span>As per Doe.[#John Doe. <span class="ge">*A Totally Fake Book 1*</span>. Vanity Press, 2006.]
1027
+ </pre>
1028
+ </div>
871
1029
 
872
1030
  <p>
873
- <strong> Output:</strong>
1031
+ <strong>Output:</strong>
874
1032
  </p>
875
1033
 
876
- <pre><code class="highlight language-html"><span class="nt">&lt;p&gt;</span>This is a statement<span class="nt">&lt;span</span> <span class="na">class=</span><span class="s">"citation"</span> <span class="na">data-cites=</span><span class="s">"Doe:2006"</span><span class="nt">&gt;</span>(Doe:2006)<span class="nt">&lt;/span&gt;</span>.<span class="nt">&lt;/p&gt;</span>
877
- <span class="nt">&lt;p&gt;</span>This is a statement[p. 23]<span class="nt">&lt;span</span> <span class="na">class=</span><span class="s">"citation"</span> <span class="na">data-cites=</span><span class="s">"Doe:2006"</span><span class="nt">&gt;</span>(Doe:2006)<span class="nt">&lt;/span&gt;</span>.<span class="nt">&lt;/p&gt;</span>
878
- </code></pre>
1034
+ <div class="highlight">
1035
+ <pre><span></span><span class="p">&lt;</span><span class="nt">p</span><span class="p">&gt;</span>This is a statement<span class="p">&lt;</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;citation&quot;</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">&quot;Doe:2006&quot;</span><span class="p">&gt;</span>(Doe:2006)<span class="p">&lt;/</span><span class="nt">span</span><span class="p">&gt;</span>.<span class="p">&lt;/</span><span class="nt">p</span><span class="p">&gt;</span>
1036
+ <span class="p">&lt;</span><span class="nt">p</span><span class="p">&gt;</span>This is a statement[p. 23]<span class="p">&lt;</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;citation&quot;</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">&quot;Doe:2006&quot;</span><span class="p">&gt;</span>(Doe:2006)<span class="p">&lt;/</span><span class="nt">span</span><span class="p">&gt;</span>.<span class="p">&lt;/</span><span class="nt">p</span><span class="p">&gt;</span>
1037
+ </pre>
1038
+ </div>
879
1039
 
880
1040
  <h3 id="mmark-syntax">
881
- mmark Syntax
1041
+ mmark&nbsp;Syntax
882
1042
  </h3>
883
1043
 
884
1044
  <p>
@@ -886,43 +1046,53 @@ See @doe99, pp. 33-35 and <span class="ge">*passim*</span>.
886
1046
  </p>
887
1047
 
888
1048
  <p>
889
- <strong> Basic citation:</strong>
1049
+ <strong>Basic citation:</strong>
890
1050
  </p>
891
1051
 
892
- <pre><code class="highlight language-markdown">This references [@RFC2535].
893
- </code></pre>
1052
+ <div class="highlight">
1053
+ <pre><span></span>This references [@RFC2535].
1054
+ </pre>
1055
+ </div>
894
1056
 
895
1057
  <p>
896
- <strong> Normative citation:</strong>
1058
+ <strong>Normative citation:</strong>
897
1059
  </p>
898
1060
 
899
- <pre><code class="highlight language-markdown">This references [@!RFC1034] (normative).
900
- </code></pre>
1061
+ <div class="highlight">
1062
+ <pre><span></span>This references [@!RFC1034] (normative).
1063
+ </pre>
1064
+ </div>
901
1065
 
902
1066
  <p>
903
- <strong> Multiple citations:</strong>
1067
+ <strong>Multiple citations:</strong>
904
1068
  </p>
905
1069
 
906
- <pre><code class="highlight language-markdown">Multiple citations: [@RFC1034;@RFC1035].
907
- </code></pre>
1070
+ <div class="highlight">
1071
+ <pre><span></span>Multiple citations: [@RFC1034;@RFC1035].
1072
+ </pre>
1073
+ </div>
908
1074
 
909
1075
  <p>
910
- <strong> Combined reference:</strong>
1076
+ <strong>Combined reference:</strong>
911
1077
  </p>
912
1078
 
913
- <pre><code class="highlight language-markdown">Combined reference: [@RFC1034@STD3].
914
- </code></pre>
1079
+ <div class="highlight">
1080
+ <pre><span></span>Combined reference: [@RFC1034@STD3].
1081
+ </pre>
1082
+ </div>
915
1083
 
916
1084
  <p>
917
- <strong> Output:</strong>
1085
+ <strong>Output:</strong>
918
1086
  </p>
919
1087
 
920
- <pre><code class="highlight language-html"><span class="nt">&lt;p&gt;</span>This references <span class="nt">&lt;span</span> <span class="na">class=</span><span class="s">"citation"</span> <span class="na">data-cites=</span><span class="s">"RFC2535"</span><span class="nt">&gt;</span>(RFC2535)<span class="nt">&lt;/span&gt;</span>.<span class="nt">&lt;/p&gt;</span>
921
- <span class="nt">&lt;p&gt;</span>Multiple citations: <span class="nt">&lt;span</span> <span class="na">class=</span><span class="s">"citation"</span> <span class="na">data-cites=</span><span class="s">"RFC1034"</span><span class="nt">&gt;</span>(RFC1034)<span class="nt">&lt;/span&gt;</span>;<span class="nt">&lt;span</span> <span class="na">class=</span><span class="s">"citation"</span> <span class="na">data-cites=</span><span class="s">"RFC1035"</span><span class="nt">&gt;</span>(RFC1035)<span class="nt">&lt;/span&gt;</span>.<span class="nt">&lt;/p&gt;</span>
922
- </code></pre>
1088
+ <div class="highlight">
1089
+ <pre><span></span><span class="p">&lt;</span><span class="nt">p</span><span class="p">&gt;</span>This references <span class="p">&lt;</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;citation&quot;</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">&quot;RFC2535&quot;</span><span class="p">&gt;</span>(RFC2535)<span class="p">&lt;/</span><span class="nt">span</span><span class="p">&gt;</span>.<span class="p">&lt;/</span><span class="nt">p</span><span class="p">&gt;</span>
1090
+ <span class="p">&lt;</span><span class="nt">p</span><span class="p">&gt;</span>Multiple citations: <span class="p">&lt;</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;citation&quot;</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">&quot;RFC1034&quot;</span><span class="p">&gt;</span>(RFC1034)<span class="p">&lt;/</span><span class="nt">span</span><span class="p">&gt;</span>;<span class="p">&lt;</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;citation&quot;</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">&quot;RFC1035&quot;</span><span class="p">&gt;</span>(RFC1035)<span class="p">&lt;/</span><span class="nt">span</span><span class="p">&gt;</span>.<span class="p">&lt;/</span><span class="nt">p</span><span class="p">&gt;</span>
1091
+ </pre>
1092
+ </div>
923
1093
 
924
1094
  <h2 id="bibliography-formats">
925
- Bibliography Formats
1095
+ Bibliography&nbsp;Formats
926
1096
  </h2>
927
1097
 
928
1098
  <p>
@@ -930,198 +1100,222 @@ See @doe99, pp. 33-35 and <span class="ge">*passim*</span>.
930
1100
  </p>
931
1101
 
932
1102
  <h3 id="bibtex-bib">
933
- BibTeX (<code>.bib</code>)
1103
+ BibTeX&nbsp;(<code>.bib</code>)
934
1104
  </h3>
935
1105
 
936
1106
  <p>
937
1107
  Standard BibTeX format:
938
1108
  </p>
939
1109
 
940
- <pre><code class="highlight language-bibtex"><span class="nc">@article</span><span class="p">{</span><span class="nl">doe99</span><span class="p">,</span>
941
- <span class="na">author</span> <span class="p">=</span> <span class="s">{Doe, John}</span><span class="p">,</span>
942
- <span class="na">title</span> <span class="p">=</span> <span class="s">{Article Title}</span><span class="p">,</span>
943
- <span class="na">journal</span> <span class="p">=</span> <span class="s">{Journal Name}</span><span class="p">,</span>
944
- <span class="na">year</span> <span class="p">=</span> <span class="s">{1999}</span><span class="p">,</span>
945
- <span class="na">volume</span> <span class="p">=</span> <span class="s">{1}</span><span class="p">,</span>
946
- <span class="na">pages</span> <span class="p">=</span> <span class="s">{1--10}</span>
1110
+ <div class="highlight">
1111
+ <pre><span></span><span class="nc">@article</span><span class="p">{</span><span class="nl">doe99</span><span class="p">,</span>
1112
+ <span class="w"> </span><span class="na">author</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{Doe, John}</span><span class="p">,</span>
1113
+ <span class="w"> </span><span class="na">title</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{Article Title}</span><span class="p">,</span>
1114
+ <span class="w"> </span><span class="na">journal</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{Journal Name}</span><span class="p">,</span>
1115
+ <span class="w"> </span><span class="na">year</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{1999}</span><span class="p">,</span>
1116
+ <span class="w"> </span><span class="na">volume</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{1}</span><span class="p">,</span>
1117
+ <span class="w"> </span><span class="na">pages</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{1--10}</span>
947
1118
  <span class="p">}</span>
948
1119
 
949
1120
  <span class="nc">@book</span><span class="p">{</span><span class="nl">smith2000</span><span class="p">,</span>
950
- <span class="na">author</span> <span class="p">=</span> <span class="s">{Smith, Jane}</span><span class="p">,</span>
951
- <span class="na">title</span> <span class="p">=</span> <span class="s">{Book Title}</span><span class="p">,</span>
952
- <span class="na">publisher</span> <span class="p">=</span> <span class="s">{Publisher}</span><span class="p">,</span>
953
- <span class="na">year</span> <span class="p">=</span> <span class="s">{2000}</span>
1121
+ <span class="w"> </span><span class="na">author</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{Smith, Jane}</span><span class="p">,</span>
1122
+ <span class="w"> </span><span class="na">title</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{Book Title}</span><span class="p">,</span>
1123
+ <span class="w"> </span><span class="na">publisher</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{Publisher}</span><span class="p">,</span>
1124
+ <span class="w"> </span><span class="na">year</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s">{2000}</span>
954
1125
  <span class="p">}</span>
955
- </code></pre>
1126
+ </pre>
1127
+ </div>
956
1128
 
957
1129
  <h3 id="csl-json-json">
958
- CSL JSON (<code>.json</code>)
1130
+ CSL JSON&nbsp;(<code>.json</code>)
959
1131
  </h3>
960
1132
 
961
1133
  <p>
962
1134
  Citation Style Language JSON format:
963
1135
  </p>
964
1136
 
965
- <pre><code class="highlight language-json"><span class="p">[</span><span class="w">
966
- </span><span class="p">{</span><span class="w">
967
- </span><span class="nl">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"doe99"</span><span class="p">,</span><span class="w">
968
- </span><span class="nl">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"article-journal"</span><span class="p">,</span><span class="w">
969
- </span><span class="nl">"title"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Article Title"</span><span class="p">,</span><span class="w">
970
- </span><span class="nl">"author"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
971
- </span><span class="p">{</span><span class="w">
972
- </span><span class="nl">"family"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Doe"</span><span class="p">,</span><span class="w">
973
- </span><span class="nl">"given"</span><span class="p">:</span><span class="w"> </span><span class="s2">"John"</span><span class="w">
974
- </span><span class="p">}</span><span class="w">
975
- </span><span class="p">],</span><span class="w">
976
- </span><span class="nl">"container-title"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Journal Name"</span><span class="p">,</span><span class="w">
977
- </span><span class="nl">"issued"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
978
- </span><span class="nl">"date-parts"</span><span class="p">:</span><span class="w"> </span><span class="p">[[</span><span class="mi">1999</span><span class="p">]]</span><span class="w">
979
- </span><span class="p">},</span><span class="w">
980
- </span><span class="nl">"volume"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1"</span><span class="p">,</span><span class="w">
981
- </span><span class="nl">"page"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1-10"</span><span class="w">
982
- </span><span class="p">}</span><span class="w">
983
- </span><span class="p">]</span><span class="w">
984
- </span></code></pre>
1137
+ <div class="highlight">
1138
+ <pre><span></span><span class="p">[</span>
1139
+ <span class="w"> </span><span class="p">{</span>
1140
+ <span class="w"> </span><span class="nt">&quot;id&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;doe99&quot;</span><span class="p">,</span>
1141
+ <span class="w"> </span><span class="nt">&quot;type&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;article-journal&quot;</span><span class="p">,</span>
1142
+ <span class="w"> </span><span class="nt">&quot;title&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Article Title&quot;</span><span class="p">,</span>
1143
+ <span class="w"> </span><span class="nt">&quot;author&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
1144
+ <span class="w"> </span><span class="p">{</span>
1145
+ <span class="w"> </span><span class="nt">&quot;family&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Doe&quot;</span><span class="p">,</span>
1146
+ <span class="w"> </span><span class="nt">&quot;given&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;John&quot;</span>
1147
+ <span class="w"> </span><span class="p">}</span>
1148
+ <span class="w"> </span><span class="p">],</span>
1149
+ <span class="w"> </span><span class="nt">&quot;container-title&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Journal Name&quot;</span><span class="p">,</span>
1150
+ <span class="w"> </span><span class="nt">&quot;issued&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
1151
+ <span class="w"> </span><span class="nt">&quot;date-parts&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[[</span><span class="mi">1999</span><span class="p">]]</span>
1152
+ <span class="w"> </span><span class="p">},</span>
1153
+ <span class="w"> </span><span class="nt">&quot;volume&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;1&quot;</span><span class="p">,</span>
1154
+ <span class="w"> </span><span class="nt">&quot;page&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;1-10&quot;</span>
1155
+ <span class="w"> </span><span class="p">}</span>
1156
+ <span class="p">]</span>
1157
+ </pre>
1158
+ </div>
985
1159
 
986
1160
  <h3 id="csl-yaml-yml-yaml">
987
- CSL YAML (<code>.yml</code>, <code>.yaml</code>)
1161
+ CSL YAML (<code>.yml</code>,&nbsp;<code>.yaml</code>)
988
1162
  </h3>
989
1163
 
990
1164
  <p>
991
1165
  Citation Style Language YAML format:
992
1166
  </p>
993
1167
 
994
- <pre><code class="highlight language-yaml"><span class="pi">-</span> <span class="na">id</span><span class="pi">:</span> <span class="s">doe99</span>
995
- <span class="na">type</span><span class="pi">:</span> <span class="s">article-journal</span>
996
- <span class="na">title</span><span class="pi">:</span> <span class="s">Article Title</span>
997
- <span class="na">author</span><span class="pi">:</span>
998
- <span class="pi">-</span> <span class="na">family</span><span class="pi">:</span> <span class="s">Doe</span>
999
- <span class="na">given</span><span class="pi">:</span> <span class="s">John</span>
1000
- <span class="na">container-title</span><span class="pi">:</span> <span class="s">Journal Name</span>
1001
- <span class="na">issued</span><span class="pi">:</span>
1002
- <span class="na">date-parts</span><span class="pi">:</span>
1003
- <span class="pi">-</span> <span class="pi">-</span> <span class="m">1999</span>
1004
- <span class="na">volume</span><span class="pi">:</span> <span class="m">1</span>
1005
- <span class="na">page</span><span class="pi">:</span> <span class="s">1-10</span>
1006
- </code></pre>
1168
+ <div class="highlight">
1169
+ <pre><span></span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">id</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">doe99</span>
1170
+ <span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">article-journal</span>
1171
+ <span class="w"> </span><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Article Title</span>
1172
+ <span class="w"> </span><span class="nt">author</span><span class="p">:</span>
1173
+ <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">family</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Doe</span>
1174
+ <span class="w"> </span><span class="nt">given</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">John</span>
1175
+ <span class="w"> </span><span class="nt">container-title</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Journal Name</span>
1176
+ <span class="w"> </span><span class="nt">issued</span><span class="p">:</span>
1177
+ <span class="w"> </span><span class="nt">date-parts</span><span class="p">:</span>
1178
+ <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1999</span>
1179
+ <span class="w"> </span><span class="nt">volume</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
1180
+ <span class="w"> </span><span class="nt">page</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1-10</span>
1181
+ </pre>
1182
+ </div>
1007
1183
 
1008
1184
  <h2 id="specifying-bibliography">
1009
1185
  Specifying Bibliography
1010
1186
  </h2>
1011
1187
 
1012
1188
  <h3 id="command-line">
1013
- Command Line
1189
+ Command&nbsp;Line
1014
1190
  </h3>
1015
1191
 
1016
- <pre><code class="highlight language-bash"><span class="c"># Single file</span>
1017
- apex document.md <span class="nt">--bibliography</span> references.bib
1192
+ <div class="highlight">
1193
+ <pre><span></span><span class="c1"># Single file</span>
1194
+ apex<span class="w"> </span>document.md<span class="w"> </span>--bibliography<span class="w"> </span>references.bib
1018
1195
 
1019
- <span class="c"># Multiple files</span>
1020
- apex document.md <span class="nt">--bibliography</span> refs1.bib <span class="nt">--bibliography</span> refs2.bib
1196
+ <span class="c1"># Multiple files</span>
1197
+ apex<span class="w"> </span>document.md<span class="w"> </span>--bibliography<span class="w"> </span>refs1.bib<span class="w"> </span>--bibliography<span class="w"> </span>refs2.bib
1021
1198
 
1022
- <span class="c"># With base directory</span>
1023
- apex document.md <span class="nt">--bibliography</span> refs.bib <span class="nt">--base-dir</span> /path/to/docs
1024
- </code></pre>
1199
+ <span class="c1"># With base directory</span>
1200
+ apex<span class="w"> </span>document.md<span class="w"> </span>--bibliography<span class="w"> </span>refs.bib<span class="w"> </span>--base-dir<span class="w"> </span>/path/to/docs
1201
+ </pre>
1202
+ </div>
1025
1203
 
1026
1204
  <h3 id="document-metadata">
1027
- Document Metadata
1205
+ Document&nbsp;Metadata
1028
1206
  </h3>
1029
1207
 
1030
1208
  <p>
1031
- <strong> YAML front matter:</strong>
1209
+ <strong>YAML front matter:</strong>
1032
1210
  </p>
1033
1211
 
1034
- <pre><code class="highlight language-markdown"><span class="nn">---</span>
1035
- <span class="na">bibliography</span><span class="pi">:</span> <span class="s">references.bib</span>
1036
- <span class="nn">---</span>
1212
+ <div class="highlight">
1213
+ <pre><span></span>---
1214
+ <span class="gu">bibliography: references.bib</span>
1215
+ <span class="gu">---</span>
1037
1216
 
1038
1217
  See [@doe99] for details.
1039
- </code></pre>
1218
+ </pre>
1219
+ </div>
1040
1220
 
1041
1221
  <p>
1042
- <strong> Multiple files:</strong>
1222
+ <strong>Multiple files:</strong>
1043
1223
  </p>
1044
1224
 
1045
- <pre><code class="highlight language-markdown"><span class="nn">---</span>
1046
- <span class="na">bibliography</span><span class="pi">:</span>
1047
- <span class="pi">-</span> <span class="s">refs1.bib</span>
1048
- <span class="pi">-</span> <span class="s">refs2.bib</span>
1049
- <span class="nn">---</span>
1225
+ <div class="highlight">
1226
+ <pre><span></span>---
1227
+ bibliography:
1228
+ <span class="w"> </span><span class="k">-</span><span class="w"> </span>refs1.bib
1229
+ <span class="gu"> - refs2.bib</span>
1230
+ <span class="gu">---</span>
1050
1231
 
1051
1232
  See [@doe99] for details.
1052
- </code></pre>
1233
+ </pre>
1234
+ </div>
1053
1235
 
1054
1236
  <p>
1055
- <strong> MultiMarkdown metadata:</strong>
1237
+ <strong>MultiMarkdown metadata:</strong>
1056
1238
  </p>
1057
1239
 
1058
- <pre><code class="highlight language-markdown">Bibliography: references.bib
1240
+ <div class="highlight">
1241
+ <pre><span></span>Bibliography: references.bib
1059
1242
 
1060
1243
  See [@doe99] for details.
1061
- </code></pre>
1244
+ </pre>
1245
+ </div>
1062
1246
 
1063
1247
  <p>
1064
- <strong> Pandoc title block:</strong>
1248
+ <strong>Pandoc title block:</strong>
1065
1249
  </p>
1066
1250
 
1067
- <pre><code class="highlight language-markdown">% Bibliography: references.bib
1251
+ <div class="highlight">
1252
+ <pre><span></span>% Bibliography: references.bib
1068
1253
 
1069
1254
  See [@doe99] for details.
1070
- </code></pre>
1255
+ </pre>
1256
+ </div>
1071
1257
 
1072
1258
  <h2 id="bibliography-generation">
1073
- Bibliography Generation
1259
+ Bibliography&nbsp;Generation
1074
1260
  </h2>
1075
1261
 
1076
1262
  <p>
1077
1263
  Bibliography is automatically generated from all cited entries and inserted at the <code>&lt;!-- REFERENCES --&gt;</code> marker:
1078
1264
  </p>
1079
1265
 
1080
- <pre><code class="highlight language-markdown">See [@doe99] and [@smith2000] for details.
1266
+ <div class="highlight">
1267
+ <pre><span></span>See [@doe99] and [@smith2000] for details.
1081
1268
 
1082
1269
  <span class="gu">## References</span>
1083
1270
 
1084
- <span class="c">&lt;!-- REFERENCES --&gt;</span>
1085
- </code></pre>
1271
+ &lt;!-- REFERENCES --&gt;
1272
+ </pre>
1273
+ </div>
1086
1274
 
1087
1275
  <p>
1088
- <strong> Output:</strong>
1276
+ <strong>Output:</strong>
1089
1277
  </p>
1090
1278
 
1091
- <pre><code class="highlight language-html"><span class="nt">&lt;p&gt;</span>See <span class="nt">&lt;span</span> <span class="na">class=</span><span class="s">"citation"</span> <span class="na">data-cites=</span><span class="s">"doe99"</span><span class="nt">&gt;</span>(Doe, John 1999)<span class="nt">&lt;/span&gt;</span> and <span class="nt">&lt;span</span> <span class="na">class=</span><span class="s">"citation"</span> <span class="na">data-cites=</span><span class="s">"smith2000"</span><span class="nt">&gt;</span>(Smith, Jane 2000)<span class="nt">&lt;/span&gt;</span> for details.<span class="nt">&lt;/p&gt;</span>
1279
+ <div class="highlight">
1280
+ <pre><span></span><span class="p">&lt;</span><span class="nt">p</span><span class="p">&gt;</span>See <span class="p">&lt;</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;citation&quot;</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">&quot;doe99&quot;</span><span class="p">&gt;</span>(Doe, John 1999)<span class="p">&lt;/</span><span class="nt">span</span><span class="p">&gt;</span> and <span class="p">&lt;</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;citation&quot;</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">&quot;smith2000&quot;</span><span class="p">&gt;</span>(Smith, Jane 2000)<span class="p">&lt;/</span><span class="nt">span</span><span class="p">&gt;</span> for details.<span class="p">&lt;/</span><span class="nt">p</span><span class="p">&gt;</span>
1092
1281
 
1093
- <span class="nt">&lt;h2&gt;</span>References<span class="nt">&lt;/h2&gt;</span>
1094
- <span class="nt">&lt;div</span> <span class="na">id=</span><span class="s">"refs"</span> <span class="na">class=</span><span class="s">"references csl-bib-body"</span><span class="nt">&gt;</span>
1095
- <span class="nt">&lt;div</span> <span class="na">id=</span><span class="s">"ref-doe99"</span> <span class="na">class=</span><span class="s">"csl-entry"</span><span class="nt">&gt;</span>Doe, John 1999. <span class="nt">&lt;em&gt;</span>Article Title<span class="nt">&lt;/em&gt;</span>. <span class="nt">&lt;em&gt;</span>Journal Name<span class="nt">&lt;/em&gt;</span> 1: 1--10<span class="nt">&lt;/div&gt;</span>
1096
- <span class="nt">&lt;div</span> <span class="na">id=</span><span class="s">"ref-smith2000"</span> <span class="na">class=</span><span class="s">"csl-entry"</span><span class="nt">&gt;</span>Smith, Jane 2000. <span class="nt">&lt;em&gt;</span>Book Title<span class="nt">&lt;/em&gt;</span>. Publisher<span class="nt">&lt;/div&gt;</span>
1097
- <span class="nt">&lt;/div&gt;</span>
1098
- </code></pre>
1282
+ <span class="p">&lt;</span><span class="nt">h2</span><span class="p">&gt;</span>References<span class="p">&lt;/</span><span class="nt">h2</span><span class="p">&gt;</span>
1283
+ <span class="p">&lt;</span><span class="nt">div</span> <span class="na">id</span><span class="o">=</span><span class="s">&quot;refs&quot;</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;references csl-bib-body&quot;</span><span class="p">&gt;</span>
1284
+ <span class="p">&lt;</span><span class="nt">div</span> <span class="na">id</span><span class="o">=</span><span class="s">&quot;ref-doe99&quot;</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;csl-entry&quot;</span><span class="p">&gt;</span>Doe, John 1999. <span class="p">&lt;</span><span class="nt">em</span><span class="p">&gt;</span>Article Title<span class="p">&lt;/</span><span class="nt">em</span><span class="p">&gt;</span>. <span class="p">&lt;</span><span class="nt">em</span><span class="p">&gt;</span>Journal Name<span class="p">&lt;/</span><span class="nt">em</span><span class="p">&gt;</span> 1: 1--10<span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
1285
+ <span class="p">&lt;</span><span class="nt">div</span> <span class="na">id</span><span class="o">=</span><span class="s">&quot;ref-smith2000&quot;</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;csl-entry&quot;</span><span class="p">&gt;</span>Smith, Jane 2000. <span class="p">&lt;</span><span class="nt">em</span><span class="p">&gt;</span>Book Title<span class="p">&lt;/</span><span class="nt">em</span><span class="p">&gt;</span>. Publisher<span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
1286
+ <span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
1287
+ </pre>
1288
+ </div>
1099
1289
 
1100
1290
  <p>
1101
1291
  If no <code>&lt;!-- REFERENCES --&gt;</code> marker is found, the bibliography is appended to the end of the document.
1102
1292
  </p>
1103
1293
 
1104
1294
  <h2 id="citation-options">
1105
- Citation Options
1295
+ Citation&nbsp;Options
1106
1296
  </h2>
1107
1297
 
1108
1298
  <h3 id="link-citations">
1109
- Link Citations
1299
+ Link&nbsp;Citations
1110
1300
  </h3>
1111
1301
 
1112
1302
  <p>
1113
1303
  Use <code>--link-citations</code> to make citations link to their bibliography entries:
1114
1304
  </p>
1115
1305
 
1116
- <pre><code class="highlight language-bash">apex document.md <span class="nt">--bibliography</span> refs.bib <span class="nt">--link-citations</span>
1117
- </code></pre>
1306
+ <div class="highlight">
1307
+ <pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--bibliography<span class="w"> </span>refs.bib<span class="w"> </span>--link-citations
1308
+ </pre>
1309
+ </div>
1118
1310
 
1119
1311
  <p>
1120
- <strong> Output:</strong>
1312
+ <strong>Output:</strong>
1121
1313
  </p>
1122
1314
 
1123
- <pre><code class="highlight language-html"><span class="nt">&lt;p&gt;</span>See <span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"#ref-doe99"</span> <span class="na">class=</span><span class="s">"citation"</span> <span class="na">data-cites=</span><span class="s">"doe99"</span><span class="nt">&gt;</span>(Doe, John 1999)<span class="nt">&lt;/a&gt;</span> for details.<span class="nt">&lt;/p&gt;</span>
1124
- </code></pre>
1315
+ <div class="highlight">
1316
+ <pre><span></span><span class="p">&lt;</span><span class="nt">p</span><span class="p">&gt;</span>See <span class="p">&lt;</span><span class="nt">a</span> <span class="na">href</span><span class="o">=</span><span class="s">&quot;#ref-doe99&quot;</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;citation&quot;</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">&quot;doe99&quot;</span><span class="p">&gt;</span>(Doe, John 1999)<span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span> for details.<span class="p">&lt;/</span><span class="nt">p</span><span class="p">&gt;</span>
1317
+ </pre>
1318
+ </div>
1125
1319
 
1126
1320
  <h3 id="suppress-bibliography">
1127
1321
  Suppress Bibliography
@@ -1131,36 +1325,42 @@ See [@doe99] for details.
1131
1325
  Use <code>--no-bibliography</code> to suppress bibliography output while still processing citations:
1132
1326
  </p>
1133
1327
 
1134
- <pre><code class="highlight language-bash">apex document.md <span class="nt">--bibliography</span> refs.bib <span class="nt">--no-bibliography</span>
1135
- </code></pre>
1328
+ <div class="highlight">
1329
+ <pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--bibliography<span class="w"> </span>refs.bib<span class="w"> </span>--no-bibliography
1330
+ </pre>
1331
+ </div>
1136
1332
 
1137
1333
  <h3 id="citation-style-csl">
1138
- Citation Style (CSL)
1334
+ Citation Style&nbsp;(CSL)
1139
1335
  </h3>
1140
1336
 
1141
1337
  <p>
1142
1338
  Specify a Citation Style Language file to control citation and bibliography formatting:
1143
1339
  </p>
1144
1340
 
1145
- <pre><code class="highlight language-bash">apex document.md <span class="nt">--bibliography</span> refs.bib <span class="nt">--csl</span> apa.csl
1146
- </code></pre>
1341
+ <div class="highlight">
1342
+ <pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--bibliography<span class="w"> </span>refs.bib<span class="w"> </span>--csl<span class="w"> </span>apa.csl
1343
+ </pre>
1344
+ </div>
1147
1345
 
1148
1346
  <p>
1149
1347
  CSL files can also be specified in metadata:
1150
1348
  </p>
1151
1349
 
1152
- <pre><code class="highlight language-markdown"><span class="nn">---</span>
1153
- <span class="na">bibliography</span><span class="pi">:</span> <span class="s">refs.bib</span>
1154
- <span class="na">csl</span><span class="pi">:</span> <span class="s">apa.csl</span>
1155
- <span class="nn">---</span>
1156
- </code></pre>
1350
+ <div class="highlight">
1351
+ <pre><span></span>---
1352
+ bibliography: refs.bib
1353
+ <span class="gu">csl: apa.csl</span>
1354
+ <span class="gu">---</span>
1355
+ </pre>
1356
+ </div>
1157
1357
 
1158
1358
  <h2 id="mode-support">
1159
- Mode Support
1359
+ Mode&nbsp;Support
1160
1360
  </h2>
1161
1361
 
1162
1362
  <p>
1163
- <strong> Unified mode:</strong>
1363
+ <strong>Unified mode:</strong>
1164
1364
  </p>
1165
1365
 
1166
1366
  <ul>
@@ -1180,7 +1380,7 @@ See [@doe99] for details.
1180
1380
  </ul>
1181
1381
 
1182
1382
  <p>
1183
- <strong> MultiMarkdown mode:</strong>
1383
+ <strong>MultiMarkdown mode:</strong>
1184
1384
  </p>
1185
1385
 
1186
1386
  <ul>
@@ -1200,7 +1400,7 @@ See [@doe99] for details.
1200
1400
  </ul>
1201
1401
 
1202
1402
  <p>
1203
- <strong> CommonMark/GFM modes:</strong>
1403
+ <strong>CommonMark/GFM modes:</strong>
1204
1404
  </p>
1205
1405
 
1206
1406
  <ul>
@@ -1212,7 +1412,7 @@ See [@doe99] for details.
1212
1412
  </ul>
1213
1413
 
1214
1414
  <p>
1215
- <strong> Kramdown mode:</strong>
1415
+ <strong>Kramdown mode:</strong>
1216
1416
  </p>
1217
1417
 
1218
1418
  <ul>
@@ -1238,15 +1438,15 @@ See [@doe99] for details.
1238
1438
  <ul>
1239
1439
 
1240
1440
  <li>
1241
- <a href="Command-Line-Options.html"> Command Line Options</a> - Citation-related CLI flags
1441
+ <a href="Command-Line-Options.html">Command Line Options</a> - Citation-related CLI flags
1242
1442
  </li>
1243
1443
 
1244
1444
  <li>
1245
- <a href="Syntax.html"> Syntax</a> - Citation syntax reference
1445
+ <a href="Syntax.html">Syntax</a> - Citation syntax reference
1246
1446
  </li>
1247
1447
 
1248
1448
  <li>
1249
- <a href="Modes.html"> Modes</a> - Mode-specific citation support
1449
+ <a href="Modes.html">Modes</a> - Mode-specific citation support
1250
1450
  </li>
1251
1451
 
1252
1452
  </ul>