Permit code-block-bg: true and code-block-border-left: true

Additionally, document these options for pdf / html

Author: dragonstyle

src/resources/editor/tools/vs-code.mjs

@@ -10938,6 +10938,44 @@ var require_yaml_intelligence_resources = __commonJS({
             long: "Include a code tools menu (for hiding and showing code).\nUse `true` or `false` to enable or disable the standard code \ntools menu. Specify sub-properties `source`, `toggle`, and\n`caption` to customize the behavior and appearnce of code tools.\n"
           }
         },
+        {
+          name: "code-block-border-left",
+          tags: {
+            formats: [
+              "$html-doc",
+              "$pdf-all"
+            ]
+          },
+          schema: {
+            anyOf: [
+              "string",
+              "boolean"
+            ]
+          },
+          description: {
+            short: "Show a thick left border on code blocks.",
+            long: "Specifies to apply a left border on code blocks. Provide a hex color to specify that the border is\nenabled as well as the color of the border.=\n"
+          }
+        },
+        {
+          name: "code-block-bg",
+          tags: {
+            formats: [
+              "$html-doc",
+              "$pdf-all"
+            ]
+          },
+          schema: {
+            anyOf: [
+              "string",
+              "boolean"
+            ]
+          },
+          description: {
+            short: "Show a background color for code blocks.",
+            long: "Specifies to apply a background color on code blocks. Provide a hex color to specify that the background color is\nenabled as well as the color of the background.\n"
+          }
+        },
         {
           name: "highlight-style",
           tags: {
@@ -17491,6 +17529,7 @@ var require_yaml_intelligence_resources = __commonJS({
         "The family name.",
         "The given name.",
         "Abstract of the item (e.g. the abstract of a journal article)",
+        "A url to the abstract for this item.",
         "Date the item has been accessed.",
         {
           short: "Short markup, decoration, or annotation to the item (e.g., to\nindicate items included in a review).",
@@ -17550,6 +17589,7 @@ var require_yaml_intelligence_resources = __commonJS({
           short: "Number of a preceding note containing the first reference to the\nitem.",
           long: "Number of a preceding note containing the first reference to the\nitem\nAssigned by the CSL processor; Empty in non-note-based styles or when\nthe item hasn\u2019t been cited in any preceding notes in a document"
         },
+        "A url to the full text for this item.",
         {
           short: "Type, class, or subtype of the item",
           long: "Type, class, or subtype of the item (e.g. \u201CDoctoral dissertation\u201D for\na PhD thesis; \u201CNIH Publication\u201D for an NIH technical report);\nDo not use for topical descriptions or categories (e.g. \u201Cadventure\u201D\nfor an adventure movie)"
@@ -17607,6 +17647,7 @@ var require_yaml_intelligence_resources = __commonJS({
         "PubMed reference number.",
         "Printing number of the item or container holding the item.",
         "Producer (e.g. of a television or radio broadcast).",
+        "A public url for this item.",
         "The publisher of the item.",
         "The geographic location of the publisher.",
         "Recipient (e.g. of a letter).",
@@ -17862,6 +17903,14 @@ var require_yaml_intelligence_resources = __commonJS({
           short: "Include a code tools menu (for hiding and showing code).",
           long: "Include a code tools menu (for hiding and showing code). Use\n<code>true</code> or <code>false</code> to enable or disable the\nstandard code tools menu. Specify sub-properties <code>source</code>,\n<code>toggle</code>, and <code>caption</code> to customize the behavior\nand appearnce of code tools."
         },
+        {
+          short: "Show a thick left border on code blocks.",
+          long: "Specifies to apply a left border on code blocks. Provide a hex color\nto specify that the border is enabled as well as the color of the\nborder.="
+        },
+        {
+          short: "Show a background color for code blocks.",
+          long: "Specifies to apply a background color on code blocks. Provide a hex\ncolor to specify that the background color is enabled as well as the\ncolor of the background."
+        },
         {
           short: "Specifies the coloring style to be used in highlighted source\ncode.",
           long: "Specifies the coloring style to be used in highlighted source\ncode.\nInstead of a <em>STYLE</em> name, a JSON file with extension\n<code>.theme</code> may be supplied. This will be parsed as a KDE syntax\nhighlighting theme and (if valid) used as the highlighting style."

src/resources/editor/tools/yaml/web-worker.js

@@ -3917,6 +3917,44 @@
         "long": "Include a code tools menu (for hiding and showing code).\nUse `true` or `false` to enable or disable the standard code \ntools menu. Specify sub-properties `source`, `toggle`, and\n`caption` to customize the behavior and appearnce of code tools.\n"
       }
     },
+    {
+      "name": "code-block-border-left",
+      "tags": {
+        "formats": [
+          "$html-doc",
+          "$pdf-all"
+        ]
+      },
+      "schema": {
+        "anyOf": [
+          "string",
+          "boolean"
+        ]
+      },
+      "description": {
+        "short": "Show a thick left border on code blocks.",
+        "long": "Specifies to apply a left border on code blocks. Provide a hex color to specify that the border is\nenabled as well as the color of the border.=\n"
+      }
+    },
+    {
+      "name": "code-block-bg",
+      "tags": {
+        "formats": [
+          "$html-doc",
+          "$pdf-all"
+        ]
+      },
+      "schema": {
+        "anyOf": [
+          "string",
+          "boolean"
+        ]
+      },
+      "description": {
+        "short": "Show a background color for code blocks.",
+        "long": "Specifies to apply a background color on code blocks. Provide a hex color to specify that the background color is\nenabled as well as the color of the background.\n"
+      }
+    },
     {
       "name": "highlight-style",
       "tags": {
@@ -10470,6 +10508,7 @@
     "The family name.",
     "The given name.",
     "Abstract of the item (e.g. the abstract of a journal article)",
+    "A url to the abstract for this item.",
     "Date the item has been accessed.",
     {
       "short": "Short markup, decoration, or annotation to the item (e.g., to\nindicate items included in a review).",
@@ -10529,6 +10568,7 @@
       "short": "Number of a preceding note containing the first reference to the\nitem.",
       "long": "Number of a preceding note containing the first reference to the\nitem\nAssigned by the CSL processor; Empty in non-note-based styles or when\nthe item hasn’t been cited in any preceding notes in a document"
     },
+    "A url to the full text for this item.",
     {
       "short": "Type, class, or subtype of the item",
       "long": "Type, class, or subtype of the item (e.g. “Doctoral dissertation” for\na PhD thesis; “NIH Publication” for an NIH technical report);\nDo not use for topical descriptions or categories (e.g. “adventure”\nfor an adventure movie)"
@@ -10586,6 +10626,7 @@
     "PubMed reference number.",
     "Printing number of the item or container holding the item.",
     "Producer (e.g. of a television or radio broadcast).",
+    "A public url for this item.",
     "The publisher of the item.",
     "The geographic location of the publisher.",
     "Recipient (e.g. of a letter).",
@@ -10841,6 +10882,14 @@
       "short": "Include a code tools menu (for hiding and showing code).",
       "long": "Include a code tools menu (for hiding and showing code). Use\n<code>true</code> or <code>false</code> to enable or disable the\nstandard code tools menu. Specify sub-properties <code>source</code>,\n<code>toggle</code>, and <code>caption</code> to customize the behavior\nand appearnce of code tools."
     },
+    {
+      "short": "Show a thick left border on code blocks.",
+      "long": "Specifies to apply a left border on code blocks. Provide a hex color\nto specify that the border is enabled as well as the color of the\nborder.="
+    },
+    {
+      "short": "Show a background color for code blocks.",
+      "long": "Specifies to apply a background color on code blocks. Provide a hex\ncolor to specify that the background color is enabled as well as the\ncolor of the background."
+    },
     {
       "short": "Specifies the coloring style to be used in highlighted source\ncode.",
       "long": "Specifies the coloring style to be used in highlighted source\ncode.\nInstead of a <em>STYLE</em> name, a JSON file with extension\n<code>.theme</code> may be supplied. This will be parsed as a KDE syntax\nhighlighting theme and (if valid) used as the highlighting style."

src/resources/editor/tools/yaml/yaml-intelligence-resources.json

@@ -44,9 +44,9 @@ function layoutMetaInject()
 
         -- figure out the shadecolor
         local shadeColor = nil
-        if useCodeBlockBorder and meta[kCodeBlockBorderLeft] then
+        if useCodeBlockBorder and meta[kCodeBlockBorderLeft] and type(meta[kCodeBlockBorderLeft]) ~= "boolean" then
           shadeColor = latexXColor(meta[kCodeBlockBorderLeft])
-        elseif useCodeBlockBg and meta[kCodeBlockBackground] then
+        elseif useCodeBlockBg and meta[kCodeBlockBackground] and type(meta[kCodeBlockBackground]) ~= "boolean"  then
           shadeColor = latexXColor(meta[kCodeBlockBackground])
         end
 

src/resources/filters/layout/meta.lua

@@ -54,7 +54,30 @@
       Use `true` or `false` to enable or disable the standard code 
       tools menu. Specify sub-properties `source`, `toggle`, and
       `caption` to customize the behavior and appearnce of code tools.
-
+- name: code-block-border-left
+  tags:
+    formats: [$html-doc, $pdf-all]
+  schema:
+    anyOf:
+      - string
+      - boolean
+  description:
+    short: "Show a thick left border on code blocks."
+    long: |
+      Specifies to apply a left border on code blocks. Provide a hex color to specify that the border is
+      enabled as well as the color of the border.=
+- name: code-block-bg
+  tags:
+    formats: [$html-doc, $pdf-all]
+  schema:
+    anyOf:
+      - string
+      - boolean
+  description:
+    short: "Show a background color for code blocks."
+    long: |
+      Specifies to apply a background color on code blocks. Provide a hex color to specify that the background color is
+      enabled as well as the color of the background.
 - name: highlight-style
   tags:
     formats: [$html-all, docx, ms, $pdf-all]