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
|
@@ -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
|
|
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
|
-
|
|
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
|
-
|
|
60
|
-
|
|
61
|
-
|
|
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:
|
|
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
|
|
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
|
|
838
|
+
Citations and Bibliography
|
|
709
839
|
</h1>
|
|
710
|
-
<nav class="page-toc" id="page-toc-top"><ul><li><a href="#citations-and-bibliography">Citations and
|
|
840
|
+
<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>
|
|
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
|
|
847
|
+
Quick Start
|
|
718
848
|
</h2>
|
|
719
849
|
|
|
720
850
|
<p>
|
|
721
|
-
<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
|
-
<
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
|
|
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
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
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
|
-
</
|
|
874
|
+
</pre>
|
|
875
|
+
</div>
|
|
744
876
|
|
|
745
877
|
<p>
|
|
746
|
-
<strong>
|
|
878
|
+
<strong>2. Add citations to your document:</strong>
|
|
747
879
|
</p>
|
|
748
880
|
|
|
749
|
-
<
|
|
750
|
-
<
|
|
751
|
-
<span class="
|
|
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
|
-
|
|
758
|
-
</
|
|
890
|
+
<!-- REFERENCES -->
|
|
891
|
+
</pre>
|
|
892
|
+
</div>
|
|
759
893
|
|
|
760
894
|
<p>
|
|
761
|
-
<strong>
|
|
895
|
+
<strong>3. Process with Apex:</strong>
|
|
762
896
|
</p>
|
|
763
897
|
|
|
764
|
-
<
|
|
765
|
-
|
|
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
|
-
<
|
|
772
|
-
|
|
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
|
|
913
|
+
Citation 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
|
|
921
|
+
Pandoc 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>
|
|
929
|
+
<strong>Basic citation:</strong>
|
|
792
930
|
</p>
|
|
793
931
|
|
|
794
|
-
<
|
|
795
|
-
|
|
932
|
+
<div class="highlight">
|
|
933
|
+
<pre><span></span>See [@doe99] for details.
|
|
934
|
+
</pre>
|
|
935
|
+
</div>
|
|
796
936
|
|
|
797
937
|
<p>
|
|
798
|
-
<strong>
|
|
938
|
+
<strong>Multiple citations:</strong>
|
|
799
939
|
</p>
|
|
800
940
|
|
|
801
|
-
<
|
|
802
|
-
|
|
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>
|
|
947
|
+
<strong>Author in text:</strong>
|
|
806
948
|
</p>
|
|
807
949
|
|
|
808
|
-
<
|
|
809
|
-
</
|
|
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>
|
|
956
|
+
<strong>Author suppressed (year only):</strong>
|
|
813
957
|
</p>
|
|
814
958
|
|
|
815
|
-
<
|
|
816
|
-
|
|
959
|
+
<div class="highlight">
|
|
960
|
+
<pre><span></span>Smith says blah [-@smith04].
|
|
961
|
+
</pre>
|
|
962
|
+
</div>
|
|
817
963
|
|
|
818
964
|
<p>
|
|
819
|
-
<strong>
|
|
965
|
+
<strong>With locator (page numbers):</strong>
|
|
820
966
|
</p>
|
|
821
967
|
|
|
822
|
-
<
|
|
823
|
-
|
|
824
|
-
</
|
|
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>
|
|
975
|
+
<strong>Output:</strong>
|
|
828
976
|
</p>
|
|
829
977
|
|
|
830
|
-
<
|
|
831
|
-
<span class="
|
|
832
|
-
<span class="
|
|
833
|
-
<span class="
|
|
834
|
-
</
|
|
978
|
+
<div class="highlight">
|
|
979
|
+
<pre><span></span><span class="p"><</span><span class="nt">p</span><span class="p">></span>See <span class="p"><</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">"citation"</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">"doe99"</span><span class="p">></span>(Doe, John 1999)<span class="p"></</span><span class="nt">span</span><span class="p">></span> for details.<span class="p"></</span><span class="nt">p</span><span class="p">></span>
|
|
980
|
+
<span class="p"><</span><span class="nt">p</span><span class="p">></span>See <span class="p"><</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">"citation"</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">"doe99 smith2000 smith2004"</span><span class="p">></span>(Doe, John 1999; Smith, Jane 2000, 2004)<span class="p"></</span><span class="nt">span</span><span class="p">></span> for more information.<span class="p"></</span><span class="nt">p</span><span class="p">></span>
|
|
981
|
+
<span class="p"><</span><span class="nt">p</span><span class="p">><</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">"citation"</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">"smith04"</span><span class="p">></span>Smith, John (2004)<span class="p"></</span><span class="nt">span</span><span class="p">></span> says blah.<span class="p"></</span><span class="nt">p</span><span class="p">></span>
|
|
982
|
+
<span class="p"><</span><span class="nt">p</span><span class="p">></span>Smith says blah <span class="p"><</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">"citation"</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">"smith04"</span><span class="p">></span>(2004)<span class="p"></</span><span class="nt">span</span><span class="p">></span>.<span class="p"></</span><span class="nt">p</span><span class="p">></span>
|
|
983
|
+
</pre>
|
|
984
|
+
</div>
|
|
835
985
|
|
|
836
986
|
<h3 id="multimarkdown-syntax">
|
|
837
|
-
MultiMarkdown
|
|
987
|
+
MultiMarkdown 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>
|
|
995
|
+
<strong>Basic citation:</strong>
|
|
846
996
|
</p>
|
|
847
997
|
|
|
848
|
-
<
|
|
849
|
-
|
|
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>
|
|
1004
|
+
<strong>With locator:</strong>
|
|
853
1005
|
</p>
|
|
854
1006
|
|
|
855
|
-
<
|
|
856
|
-
|
|
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>
|
|
1013
|
+
<strong>Empty locator:</strong>
|
|
860
1014
|
</p>
|
|
861
1015
|
|
|
862
|
-
<
|
|
863
|
-
|
|
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>
|
|
1022
|
+
<strong>Inline citation:</strong>
|
|
867
1023
|
</p>
|
|
868
1024
|
|
|
869
|
-
<
|
|
870
|
-
|
|
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>
|
|
1031
|
+
<strong>Output:</strong>
|
|
874
1032
|
</p>
|
|
875
1033
|
|
|
876
|
-
<
|
|
877
|
-
<span class="
|
|
878
|
-
</
|
|
1034
|
+
<div class="highlight">
|
|
1035
|
+
<pre><span></span><span class="p"><</span><span class="nt">p</span><span class="p">></span>This is a statement<span class="p"><</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">"citation"</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">"Doe:2006"</span><span class="p">></span>(Doe:2006)<span class="p"></</span><span class="nt">span</span><span class="p">></span>.<span class="p"></</span><span class="nt">p</span><span class="p">></span>
|
|
1036
|
+
<span class="p"><</span><span class="nt">p</span><span class="p">></span>This is a statement[p. 23]<span class="p"><</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">"citation"</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">"Doe:2006"</span><span class="p">></span>(Doe:2006)<span class="p"></</span><span class="nt">span</span><span class="p">></span>.<span class="p"></</span><span class="nt">p</span><span class="p">></span>
|
|
1037
|
+
</pre>
|
|
1038
|
+
</div>
|
|
879
1039
|
|
|
880
1040
|
<h3 id="mmark-syntax">
|
|
881
|
-
mmark
|
|
1041
|
+
mmark 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>
|
|
1049
|
+
<strong>Basic citation:</strong>
|
|
890
1050
|
</p>
|
|
891
1051
|
|
|
892
|
-
<
|
|
893
|
-
|
|
1052
|
+
<div class="highlight">
|
|
1053
|
+
<pre><span></span>This references [@RFC2535].
|
|
1054
|
+
</pre>
|
|
1055
|
+
</div>
|
|
894
1056
|
|
|
895
1057
|
<p>
|
|
896
|
-
<strong>
|
|
1058
|
+
<strong>Normative citation:</strong>
|
|
897
1059
|
</p>
|
|
898
1060
|
|
|
899
|
-
<
|
|
900
|
-
|
|
1061
|
+
<div class="highlight">
|
|
1062
|
+
<pre><span></span>This references [@!RFC1034] (normative).
|
|
1063
|
+
</pre>
|
|
1064
|
+
</div>
|
|
901
1065
|
|
|
902
1066
|
<p>
|
|
903
|
-
<strong>
|
|
1067
|
+
<strong>Multiple citations:</strong>
|
|
904
1068
|
</p>
|
|
905
1069
|
|
|
906
|
-
<
|
|
907
|
-
|
|
1070
|
+
<div class="highlight">
|
|
1071
|
+
<pre><span></span>Multiple citations: [@RFC1034;@RFC1035].
|
|
1072
|
+
</pre>
|
|
1073
|
+
</div>
|
|
908
1074
|
|
|
909
1075
|
<p>
|
|
910
|
-
<strong>
|
|
1076
|
+
<strong>Combined reference:</strong>
|
|
911
1077
|
</p>
|
|
912
1078
|
|
|
913
|
-
<
|
|
914
|
-
|
|
1079
|
+
<div class="highlight">
|
|
1080
|
+
<pre><span></span>Combined reference: [@RFC1034@STD3].
|
|
1081
|
+
</pre>
|
|
1082
|
+
</div>
|
|
915
1083
|
|
|
916
1084
|
<p>
|
|
917
|
-
<strong>
|
|
1085
|
+
<strong>Output:</strong>
|
|
918
1086
|
</p>
|
|
919
1087
|
|
|
920
|
-
<
|
|
921
|
-
<span class="
|
|
922
|
-
</
|
|
1088
|
+
<div class="highlight">
|
|
1089
|
+
<pre><span></span><span class="p"><</span><span class="nt">p</span><span class="p">></span>This references <span class="p"><</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">"citation"</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">"RFC2535"</span><span class="p">></span>(RFC2535)<span class="p"></</span><span class="nt">span</span><span class="p">></span>.<span class="p"></</span><span class="nt">p</span><span class="p">></span>
|
|
1090
|
+
<span class="p"><</span><span class="nt">p</span><span class="p">></span>Multiple citations: <span class="p"><</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">"citation"</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">"RFC1034"</span><span class="p">></span>(RFC1034)<span class="p"></</span><span class="nt">span</span><span class="p">></span>;<span class="p"><</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">"citation"</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">"RFC1035"</span><span class="p">></span>(RFC1035)<span class="p"></</span><span class="nt">span</span><span class="p">></span>.<span class="p"></</span><span class="nt">p</span><span class="p">></span>
|
|
1091
|
+
</pre>
|
|
1092
|
+
</div>
|
|
923
1093
|
|
|
924
1094
|
<h2 id="bibliography-formats">
|
|
925
|
-
Bibliography
|
|
1095
|
+
Bibliography 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
|
|
1103
|
+
BibTeX (<code>.bib</code>)
|
|
934
1104
|
</h3>
|
|
935
1105
|
|
|
936
1106
|
<p>
|
|
937
1107
|
Standard BibTeX format:
|
|
938
1108
|
</p>
|
|
939
1109
|
|
|
940
|
-
<
|
|
941
|
-
|
|
942
|
-
|
|
943
|
-
|
|
944
|
-
|
|
945
|
-
|
|
946
|
-
|
|
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
|
-
|
|
951
|
-
|
|
952
|
-
|
|
953
|
-
|
|
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
|
-
</
|
|
1126
|
+
</pre>
|
|
1127
|
+
</div>
|
|
956
1128
|
|
|
957
1129
|
<h3 id="csl-json-json">
|
|
958
|
-
CSL JSON
|
|
1130
|
+
CSL JSON (<code>.json</code>)
|
|
959
1131
|
</h3>
|
|
960
1132
|
|
|
961
1133
|
<p>
|
|
962
1134
|
Citation Style Language JSON format:
|
|
963
1135
|
</p>
|
|
964
1136
|
|
|
965
|
-
<
|
|
966
|
-
|
|
967
|
-
|
|
968
|
-
</span><span class="
|
|
969
|
-
</span><span class="
|
|
970
|
-
</span><span class="
|
|
971
|
-
|
|
972
|
-
|
|
973
|
-
</span><span class="
|
|
974
|
-
|
|
975
|
-
|
|
976
|
-
|
|
977
|
-
</span><span class="
|
|
978
|
-
|
|
979
|
-
|
|
980
|
-
|
|
981
|
-
</span><span class="
|
|
982
|
-
|
|
983
|
-
|
|
984
|
-
</span
|
|
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">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"doe99"</span><span class="p">,</span>
|
|
1141
|
+
<span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"article-journal"</span><span class="p">,</span>
|
|
1142
|
+
<span class="w"> </span><span class="nt">"title"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Article Title"</span><span class="p">,</span>
|
|
1143
|
+
<span class="w"> </span><span class="nt">"author"</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">"family"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Doe"</span><span class="p">,</span>
|
|
1146
|
+
<span class="w"> </span><span class="nt">"given"</span><span class="p">:</span><span class="w"> </span><span class="s2">"John"</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">"container-title"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Journal Name"</span><span class="p">,</span>
|
|
1150
|
+
<span class="w"> </span><span class="nt">"issued"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
1151
|
+
<span class="w"> </span><span class="nt">"date-parts"</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">"volume"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1"</span><span class="p">,</span>
|
|
1154
|
+
<span class="w"> </span><span class="nt">"page"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1-10"</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
|
|
1161
|
+
CSL YAML (<code>.yml</code>, <code>.yaml</code>)
|
|
988
1162
|
</h3>
|
|
989
1163
|
|
|
990
1164
|
<p>
|
|
991
1165
|
Citation Style Language YAML format:
|
|
992
1166
|
</p>
|
|
993
1167
|
|
|
994
|
-
<
|
|
995
|
-
|
|
996
|
-
|
|
997
|
-
|
|
998
|
-
|
|
999
|
-
|
|
1000
|
-
|
|
1001
|
-
|
|
1002
|
-
|
|
1003
|
-
|
|
1004
|
-
|
|
1005
|
-
|
|
1006
|
-
</
|
|
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
|
|
1189
|
+
Command Line
|
|
1014
1190
|
</h3>
|
|
1015
1191
|
|
|
1016
|
-
<
|
|
1017
|
-
|
|
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="
|
|
1020
|
-
apex document.md
|
|
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="
|
|
1023
|
-
apex document.md
|
|
1024
|
-
</
|
|
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
|
|
1205
|
+
Document Metadata
|
|
1028
1206
|
</h3>
|
|
1029
1207
|
|
|
1030
1208
|
<p>
|
|
1031
|
-
<strong>
|
|
1209
|
+
<strong>YAML front matter:</strong>
|
|
1032
1210
|
</p>
|
|
1033
1211
|
|
|
1034
|
-
<
|
|
1035
|
-
<
|
|
1036
|
-
<span class="
|
|
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
|
-
</
|
|
1218
|
+
</pre>
|
|
1219
|
+
</div>
|
|
1040
1220
|
|
|
1041
1221
|
<p>
|
|
1042
|
-
<strong>
|
|
1222
|
+
<strong>Multiple files:</strong>
|
|
1043
1223
|
</p>
|
|
1044
1224
|
|
|
1045
|
-
<
|
|
1046
|
-
<
|
|
1047
|
-
|
|
1048
|
-
|
|
1049
|
-
<span class="
|
|
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
|
-
</
|
|
1233
|
+
</pre>
|
|
1234
|
+
</div>
|
|
1053
1235
|
|
|
1054
1236
|
<p>
|
|
1055
|
-
<strong>
|
|
1237
|
+
<strong>MultiMarkdown metadata:</strong>
|
|
1056
1238
|
</p>
|
|
1057
1239
|
|
|
1058
|
-
<
|
|
1240
|
+
<div class="highlight">
|
|
1241
|
+
<pre><span></span>Bibliography: references.bib
|
|
1059
1242
|
|
|
1060
1243
|
See [@doe99] for details.
|
|
1061
|
-
</
|
|
1244
|
+
</pre>
|
|
1245
|
+
</div>
|
|
1062
1246
|
|
|
1063
1247
|
<p>
|
|
1064
|
-
<strong>
|
|
1248
|
+
<strong>Pandoc title block:</strong>
|
|
1065
1249
|
</p>
|
|
1066
1250
|
|
|
1067
|
-
<
|
|
1251
|
+
<div class="highlight">
|
|
1252
|
+
<pre><span></span>% Bibliography: references.bib
|
|
1068
1253
|
|
|
1069
1254
|
See [@doe99] for details.
|
|
1070
|
-
</
|
|
1255
|
+
</pre>
|
|
1256
|
+
</div>
|
|
1071
1257
|
|
|
1072
1258
|
<h2 id="bibliography-generation">
|
|
1073
|
-
Bibliography
|
|
1259
|
+
Bibliography Generation
|
|
1074
1260
|
</h2>
|
|
1075
1261
|
|
|
1076
1262
|
<p>
|
|
1077
1263
|
Bibliography is automatically generated from all cited entries and inserted at the <code><!-- REFERENCES --></code> marker:
|
|
1078
1264
|
</p>
|
|
1079
1265
|
|
|
1080
|
-
<
|
|
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
|
-
|
|
1085
|
-
</
|
|
1271
|
+
<!-- REFERENCES -->
|
|
1272
|
+
</pre>
|
|
1273
|
+
</div>
|
|
1086
1274
|
|
|
1087
1275
|
<p>
|
|
1088
|
-
<strong>
|
|
1276
|
+
<strong>Output:</strong>
|
|
1089
1277
|
</p>
|
|
1090
1278
|
|
|
1091
|
-
<
|
|
1279
|
+
<div class="highlight">
|
|
1280
|
+
<pre><span></span><span class="p"><</span><span class="nt">p</span><span class="p">></span>See <span class="p"><</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">"citation"</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">"doe99"</span><span class="p">></span>(Doe, John 1999)<span class="p"></</span><span class="nt">span</span><span class="p">></span> and <span class="p"><</span><span class="nt">span</span> <span class="na">class</span><span class="o">=</span><span class="s">"citation"</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">"smith2000"</span><span class="p">></span>(Smith, Jane 2000)<span class="p"></</span><span class="nt">span</span><span class="p">></span> for details.<span class="p"></</span><span class="nt">p</span><span class="p">></span>
|
|
1092
1281
|
|
|
1093
|
-
<span class="
|
|
1094
|
-
<span class="
|
|
1095
|
-
<span class="
|
|
1096
|
-
<span class="
|
|
1097
|
-
<span class="
|
|
1098
|
-
</
|
|
1282
|
+
<span class="p"><</span><span class="nt">h2</span><span class="p">></span>References<span class="p"></</span><span class="nt">h2</span><span class="p">></span>
|
|
1283
|
+
<span class="p"><</span><span class="nt">div</span> <span class="na">id</span><span class="o">=</span><span class="s">"refs"</span> <span class="na">class</span><span class="o">=</span><span class="s">"references csl-bib-body"</span><span class="p">></span>
|
|
1284
|
+
<span class="p"><</span><span class="nt">div</span> <span class="na">id</span><span class="o">=</span><span class="s">"ref-doe99"</span> <span class="na">class</span><span class="o">=</span><span class="s">"csl-entry"</span><span class="p">></span>Doe, John 1999. <span class="p"><</span><span class="nt">em</span><span class="p">></span>Article Title<span class="p"></</span><span class="nt">em</span><span class="p">></span>. <span class="p"><</span><span class="nt">em</span><span class="p">></span>Journal Name<span class="p"></</span><span class="nt">em</span><span class="p">></span> 1: 1--10<span class="p"></</span><span class="nt">div</span><span class="p">></span>
|
|
1285
|
+
<span class="p"><</span><span class="nt">div</span> <span class="na">id</span><span class="o">=</span><span class="s">"ref-smith2000"</span> <span class="na">class</span><span class="o">=</span><span class="s">"csl-entry"</span><span class="p">></span>Smith, Jane 2000. <span class="p"><</span><span class="nt">em</span><span class="p">></span>Book Title<span class="p"></</span><span class="nt">em</span><span class="p">></span>. Publisher<span class="p"></</span><span class="nt">div</span><span class="p">></span>
|
|
1286
|
+
<span class="p"></</span><span class="nt">div</span><span class="p">></span>
|
|
1287
|
+
</pre>
|
|
1288
|
+
</div>
|
|
1099
1289
|
|
|
1100
1290
|
<p>
|
|
1101
1291
|
If no <code><!-- REFERENCES --></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
|
|
1295
|
+
Citation Options
|
|
1106
1296
|
</h2>
|
|
1107
1297
|
|
|
1108
1298
|
<h3 id="link-citations">
|
|
1109
|
-
Link
|
|
1299
|
+
Link 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
|
-
<
|
|
1117
|
-
|
|
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>
|
|
1312
|
+
<strong>Output:</strong>
|
|
1121
1313
|
</p>
|
|
1122
1314
|
|
|
1123
|
-
<
|
|
1124
|
-
|
|
1315
|
+
<div class="highlight">
|
|
1316
|
+
<pre><span></span><span class="p"><</span><span class="nt">p</span><span class="p">></span>See <span class="p"><</span><span class="nt">a</span> <span class="na">href</span><span class="o">=</span><span class="s">"#ref-doe99"</span> <span class="na">class</span><span class="o">=</span><span class="s">"citation"</span> <span class="na">data-cites</span><span class="o">=</span><span class="s">"doe99"</span><span class="p">></span>(Doe, John 1999)<span class="p"></</span><span class="nt">a</span><span class="p">></span> for details.<span class="p"></</span><span class="nt">p</span><span class="p">></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
|
-
<
|
|
1135
|
-
|
|
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
|
|
1334
|
+
Citation Style (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
|
-
<
|
|
1146
|
-
|
|
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
|
-
<
|
|
1153
|
-
<
|
|
1154
|
-
|
|
1155
|
-
<span class="
|
|
1156
|
-
|
|
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
|
|
1359
|
+
Mode Support
|
|
1160
1360
|
</h2>
|
|
1161
1361
|
|
|
1162
1362
|
<p>
|
|
1163
|
-
<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>
|
|
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>
|
|
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>
|
|
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">
|
|
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">
|
|
1445
|
+
<a href="Syntax.html">Syntax</a> - Citation syntax reference
|
|
1246
1446
|
</li>
|
|
1247
1447
|
|
|
1248
1448
|
<li>
|
|
1249
|
-
<a href="Modes.html">
|
|
1449
|
+
<a href="Modes.html">Modes</a> - Mode-specific citation support
|
|
1250
1450
|
</li>
|
|
1251
1451
|
|
|
1252
1452
|
</ul>
|