hexo-component-inferno 4.0.0 → 4.2.0

package/lib/hexo/generator/manifest.js

@@ -38,6 +38,12 @@ module.exports = function (hexo) {
     if (!manifest.start_url) {
       manifest.start_url = url_for('/index.html');
     }
+    if (Array.isArray(manifest.icons)) {
+      // Resolve the icons against the root of the site, like start_url
+      manifest.icons = manifest.icons.map(icon => icon && icon.src ? Object.assign({}, icon, {
+        src: url_for(icon.src)
+      }) : icon);
+    }
     return {
       path: '/manifest.json',
       data: JSON.stringify(manifest)

package/lib/hexo/helper/cdn.js

@@ -59,13 +59,18 @@ const UNPKG_FIXTURES = {
  * cdn('jquery', '3.3.1', 'dist/jquery.min.js');
  * // -> https://cdn.jsdelivr.net/npm/jquery@3.3.1/dist/jquery.min.js
  *
+ * // Set providers.cdn_overrides, e.g., { jquery: 'unpkg' }, to use a different CDN provider or URL
+ * // template for some packages
+ * cdn('jquery', '3.3.1', 'dist/jquery.min.js');
+ * // -> https://unpkg.com/jquery@3.3.1/dist/jquery.min.js
+ *
  * // Use the function below to resolve the CDN URL web font files
  * fontcdn('Ubuntu:400,600|Source+Code+Pro', 'css');
  * // -> https://fonts.googleapis.com/css?family=Ubuntu:400,600|Source+Code+Pro
  *
  * // Use the function below to insert FontAwesome icon font CSS URL.
  * iconcdn();
- * // -> https://use.fontawesome.com/releases/v5.15.2/css/all.css
+ * // -> https://use.fontawesome.com/releases/v6.0.0/css/all.css
  */
 module.exports = function (hexo) {
   function applyFixture(fixture, _package, version, filename) {
@@ -80,9 +85,12 @@ module.exports = function (hexo) {
     return [_package, version, filename];
   }
   hexo.extend.helper.register('cdn', function (_package, version, filename) {
+    const providers = typeof this.config.providers === 'object' ? this.config.providers : {};
     const {
-      cdn = 'jsdelivr'
-    } = typeof this.config.providers === 'object' ? this.config.providers : {};
+      cdn_overrides: overrides
+    } = providers;
+    // A package can use a different provider or URL than the rest in providers.cdn_overrides
+    const cdn = typeof overrides === 'object' && overrides !== null && overrides[_package] ? overrides[_package] : providers.cdn || 'jsdelivr';
     let _cdn = cdn;
     if (_cdn in PROVIDERS.LIBRARY) {
       _cdn = PROVIDERS.LIBRARY[_cdn];

package/lib/hexo/tag/message.js

@@ -3,6 +3,16 @@
  * @module hexo/tag/message
  */
 
+/**
+ * Split a tag option at its first colon, so that the value can contain colons, as in
+ * <code>'title:Step 1: Install'</code>.
+ * @private
+ */
+function splitOption(option) {
+  const index = option.indexOf(':');
+  return index === -1 ? [option] : [option.slice(0, index), option.slice(index + 1)];
+}
+
 /**
  * Register custom Hexo tag {% message %}.
  * <p>
@@ -53,7 +63,7 @@ module.exports = function (hexo) {
     let classes = '';
     let header = '';
     for (const option of options) {
-      const [key, value] = option.split(':');
+      const [key, value] = splitOption(option);
       switch (key) {
         case 'size':
           classes += ` is-${value}`;

package/lib/hexo/tag/tabs.js

@@ -3,6 +3,16 @@
  * @module hexo/tag/tabs
  */
 
+/**
+ * Split a tag option at its first colon, so that the value can contain colons, as in
+ * <code>'title:Step 1: Install'</code>.
+ * @private
+ */
+function splitOption(option) {
+  const index = option.indexOf(':');
+  return index === -1 ? [option] : [option.slice(0, index), option.slice(index + 1)];
+}
+
 /**
  * Register custom Hexo tag {% tabs %}.
  * <p>
@@ -151,10 +161,11 @@ module.exports = function (hexo) {
     }
     return options;
   }
+  let tabCount = 0;
   function processTag(options, content) {
     let classes = '';
     for (const option of options) {
-      const [key, value] = option.split(':');
+      const [key, value] = splitOption(option);
       switch (key) {
         case 'align':
           classes += ` is-${value}`;
@@ -176,12 +187,14 @@ module.exports = function (hexo) {
     let contentElements = '';
     while ((match = pattern.exec(content)) !== null) {
       const [, tabOptions, tabContent] = match;
-      let id = 'tab-' + Date.now() + (Math.random() * 1000 | 0);
+
+      // A counter, as random numbers in the same millisecond could be the same
+      let id = 'tab-' + Date.now() + '-' + tabCount++;
       let icon = '';
       let title = '';
       let active = false;
       for (const option of splitTabOptions(tabOptions)) {
-        const [key, value] = option.split(':');
+        const [key, value] = splitOption(option);
         switch (key) {
           case 'id':
             id = value;
@@ -228,7 +241,12 @@ module.exports = function (hexo) {
             return;
           }
 
-          const id = '#' + CSS.escape(location.hash.substring(1));
+          let hash = location.hash.substring(1);
+          try {
+            // Non-ASCII IDs are percent-encoded in the URL
+            hash = decodeURIComponent(hash);
+          } catch (e) {}
+          const id = '#' + CSS.escape(hash);
           const $tabMenu = document.querySelector(\`.tabs a[href="\${id}"]\`);
           if (!$tabMenu) {
             return;
@@ -248,7 +266,12 @@ module.exports = function (hexo) {
               $activeTab.classList.remove('is-hidden');
           }
       }
-      switchTab();
+      // The script is in <head>, so wait for the tabs to switch to the tab in the URL
+      if (document.readyState === 'loading') {
+          document.addEventListener('DOMContentLoaded', switchTab);
+      } else {
+          switchTab();
+      }
       window.addEventListener('hashchange', switchTab, false);
   })();
   </script>`;

package/lib/schema/comment/artalk.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/comment/artalk.json",
+  "description": "Artalk comment plugin configurations\nhttps://artalk.js.org/guide/frontend/config.html",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "const": "artalk"
+    },
+    "server": {
+      "type": "string",
+      "description": "URL of your Artalk server"
+    },
+    "site": {
+      "type": "string",
+      "description": "Name of the site on the Artalk server",
+      "nullable": true
+    },
+    "page_key": {
+      "type": "string",
+      "description": "Unique identifier of the page. Uses the path of the page if not set",
+      "nullable": true
+    },
+    "locale": {
+      "type": "string",
+      "description": "Language of Artalk, e.g., en, zh-CN, or auto",
+      "nullable": true
+    },
+    "dark_mode": {
+      "type": ["boolean", "string"],
+      "description": "Dark mode: true, false, or 'auto' to follow the system color scheme. Follows the appearance of the theme (the data-appearance attribute of <html>) if not set",
+      "nullable": true
+    }
+  },
+  "required": ["type", "server"]
+}

package/lib/schema/comment/beaudar.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/comment/beaudar.json",
+  "description": "Beaudar comment plugin configurations\nhttps://github.com/beaudar/beaudar",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "const": "beaudar"
+    },
+    "repo": {
+      "type": "string",
+      "description": "Name of the GitHub repository for the comments, e.g., user/repo"
+    },
+    "branch": {
+      "type": "string",
+      "description": "Branch of the repository that has beaudar.json",
+      "nullable": true
+    },
+    "label": {
+      "type": "string",
+      "description": "Label of the issues created by Beaudar",
+      "nullable": true
+    },
+    "theme": {
+      "type": "string",
+      "description": "Beaudar look and feel when the page looks light, e.g., github-light, github-dark, or preferred-color-scheme",
+      "default": "github-light",
+      "nullable": true
+    },
+    "dark_theme": {
+      "type": "string",
+      "description": "Beaudar look and feel when the page looks dark, e.g., with the dark or auto appearance of the theme. For example github-dark, github-dark-orange, classic-dark, dark-blue, icy-dark, or photon-dark",
+      "default": "github-dark",
+      "nullable": true
+    }
+  },
+  "required": ["type", "repo"],
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "issue_term": {
+          "type": "string",
+          "description": "The mapping between blog posts and GitHub issues, e.g., pathname, url, or title",
+          "default": "pathname"
+        }
+      },
+      "required": ["issue_term"]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "issue_number": {
+          "type": "integer",
+          "description": "Configure Beaudar to load a specific issue by number"
+        }
+      },
+      "required": ["issue_number"]
+    }
+  ]
+}

package/lib/schema/comment/cusdis.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/comment/cusdis.json",
+  "description": "Cusdis comment plugin configurations\nhttps://cusdis.com/doc",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "const": "cusdis"
+    },
+    "app_id": {
+      "type": "string",
+      "description": "App ID of the website in the embed code from the Cusdis dashboard"
+    },
+    "host": {
+      "type": "string",
+      "description": "URL of your Cusdis server if you host it yourself",
+      "default": "https://cusdis.com",
+      "nullable": true
+    },
+    "theme": {
+      "type": "string",
+      "description": "Theme of Cusdis: light, dark, or auto to follow the system color scheme. Follows the appearance of the theme (the data-appearance attribute of <html>) if not set",
+      "enum": ["light", "dark", "auto"],
+      "nullable": true
+    },
+    "lang": {
+      "type": "string",
+      "description": "Language of Cusdis, e.g., zh-cn, zh-tw, es, or fi. Uses English if not set",
+      "nullable": true
+    }
+  },
+  "required": ["type", "app_id"]
+}

package/lib/schema/comment/giscus.json

@@ -33,6 +33,11 @@
       "default": "pathname",
       "nullable": true
     },
+    "term": {
+      "type": ["string", "number"],
+      "description": "The search term of the discussion when mapping is specific, or the discussion number when mapping is number",
+      "nullable": true
+    },
     "strict": {
       "type": "boolean",
       "description": "Avoid mismatches due to GitHub's fuzzy searching method when there are multiple discussions with similar titles",
@@ -60,7 +65,7 @@
     },
     "theme": {
       "type": "string",
-      "description": "Giscus look and feel",
+      "description": "Giscus look and feel when the page looks light",
       "enum": [
         "light",
         "light_high_contrast",
@@ -83,6 +88,12 @@
       "default": "noborder_light",
       "nullable": true
     },
+    "darkTheme": {
+      "type": "string",
+      "description": "Giscus look and feel when the page looks dark, e.g., with the dark or auto appearance of the theme. Not used when theme is custom",
+      "default": "noborder_dark",
+      "nullable": true
+    },
     "customThemeCss": {
       "type": "string",
       "description": "The url of custom Giscus theme css, only affect when theme is set to custom",

package/lib/schema/comment/gitment.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "/comment/gitment.json",
-  "description": "Gitment comment plugin configurations",
+  "description": "Gitment comment plugin configurations\nDEPRECATED: Gitment is no longer maintained, and the GitHub sign-in proxy it uses no longer works. Use Giscus, Utterances or Gitalk instead.",
   "type": "object",
   "properties": {
     "type": {

package/lib/schema/comment/utterances.json

@@ -19,7 +19,7 @@
     },
     "theme": {
       "type": "string",
-      "description": "Utterances look and feel",
+      "description": "Utterances look and feel when the page looks light",
       "enum": [
         "github-light",
         "github-dark",
@@ -30,6 +30,20 @@
       ],
       "default": "github-light",
       "nullable": true
+    },
+    "dark_theme": {
+      "type": "string",
+      "description": "Utterances look and feel when the page looks dark, e.g., with the dark or auto appearance of the theme",
+      "enum": [
+        "github-light",
+        "github-dark",
+        "github-dark-orange",
+        "icy-dark",
+        "dark-blue",
+        "photon-dark"
+      ],
+      "default": "github-dark",
+      "nullable": true
     }
   },
   "required": ["type", "repo"],

package/lib/schema/comment/valine.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "/comment/valine.json",
-  "description": "Valine comment plugin configurations\nWARNING: Valine saves comments, including the commenters' email addresses, in a LeanCloud class that anyone with your public app ID and key can read. Consider Waline or another comment system instead.",
+  "description": "Valine comment plugin configurations\nDEPRECATED: LeanCloud, where Valine stores the comments, shuts down on January 12, 2027. Use Waline, Twikoo or another comment system instead.\nWARNING: Valine saves comments, including the commenters' email addresses, in a LeanCloud class that anyone with your public app ID and key can read. Consider Waline or another comment system instead.",
   "type": "object",
   "properties": {
     "type": {

package/lib/schema/comment/waline.json

@@ -14,7 +14,7 @@
     },
     "path": {
       "type": "string",
-      "description": "Article path id."
+      "description": "Article path id. A path, such as /posts/hello/, or a JavaScript expression, such as window.location.pathname, which is the default."
     },
     "lang": {
       "type": "string",
@@ -77,7 +77,7 @@
     },
     "dark": {
       "type": ["string", "boolean"],
-      "description": "Darkmode support.",
+      "description": "Darkmode support. Can be true, false, 'auto' to follow the system color scheme, or a CSS selector that enables the dark mode when it matches an ancestor of Waline. Follows the appearance of the theme (the data-appearance attribute of <html>) if not set",
       "nullable": true
     },
     "meta": {

package/lib/schema/misc/open_graph.json

@@ -12,7 +12,6 @@
     "type": {
       "type": "string",
       "description": "Page type (og:type) (optional)\nYou should leave this blank for most of the time",
-      "default": "blog",
       "nullable": true
     },
     "url": {

package/lib/schema/plugin/waline_pageview.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/plugin/waline_pageview.json",
+  "description": "Waline page view counter, true to use the server of the Waline comments. Do not also enable the pageview option of the Waline comments, which would count the views twice\nhttps://waline.js.org/en/guide/features/pageview.html",
+  "type": ["boolean", "object"],
+  "properties": {
+    "server_url": {
+      "type": "string",
+      "description": "URL of the Waline server. Uses the server of the Waline comments if not set",
+      "nullable": true
+    }
+  },
+  "default": false
+}

package/lib/schema/share/addthis.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "/share/addthis.json",
-  "description": "Enable AddThis share buttons\nhttps://www.addthis.com/",
+  "description": "Enable AddThis share buttons\nDEPRECATED: AddThis shut down on May 31, 2023. Use AddToAny or ShareThis instead.",
   "type": "object",
   "properties": {
     "type": {

package/lib/schema/widget/archives.json

@@ -7,6 +7,34 @@
     "type": {
       "type": "string",
       "const": "archives"
+    },
+    "amount": {
+      "type": "integer",
+      "description": "Amount of archives to show, with a link to the archive page for the rest. Will show all if not set",
+      "nullable": true
+    },
+    "group_by": {
+      "type": "string",
+      "enum": ["monthly", "yearly"],
+      "description": "Whether to group the archives by month or by year. Groups by month if not set",
+      "nullable": true
+    },
+    "order": {
+      "type": "integer",
+      "enum": [1, -1],
+      "description": "1 to show the oldest archives first, or -1 to show the newest first. Shows the newest first if not set",
+      "nullable": true
+    },
+    "format": {
+      "type": "string",
+      "description": "Moment.js format of the archive names, such as 'MMMM YYYY' (by month) or 'YYYY' (by year), which are used if not set",
+      "nullable": true
+    },
+    "show_count": {
+      "type": "boolean",
+      "default": true,
+      "description": "Whether to show the number of posts of each archive",
+      "nullable": true
     }
   },
   "required": ["type"]

package/lib/schema/widget/categories.json

@@ -7,6 +7,38 @@
     "type": {
       "type": "string",
       "const": "categories"
+    },
+    "amount": {
+      "type": "integer",
+      "description": "Amount of top-level categories to show, with a link to the category page for the rest. Will show all if not set",
+      "nullable": true
+    },
+    "order_by": {
+      "type": "string",
+      "description": "How to order the categories. For example 'name' to order by name, and 'length' to order by number of posts. Orders by name if not set",
+      "nullable": true
+    },
+    "order": {
+      "type": "integer",
+      "enum": [1, -1],
+      "description": "1 for ascending order, or -1 for descending order. Ascending if not set",
+      "nullable": true
+    },
+    "depth": {
+      "type": "integer",
+      "description": "Levels of categories to show, for example 1 for the top-level categories only. Shows all levels if not set or 0",
+      "nullable": true
+    },
+    "show_current": {
+      "type": "boolean",
+      "description": "Whether to highlight the categories of the current post",
+      "nullable": true
+    },
+    "show_count": {
+      "type": "boolean",
+      "default": true,
+      "description": "Whether to show the number of posts of each category",
+      "nullable": true
     }
   },
   "required": ["type"]

package/lib/schema/widget/recent_posts.json

@@ -7,6 +7,11 @@
     "type": {
       "type": "string",
       "const": "recent_posts"
+    },
+    "limit": {
+      "type": "integer",
+      "description": "Number of recent posts to show. Shows 5 if not set",
+      "nullable": true
     }
   },
   "required": ["type"]

package/lib/schema/widget/subscribe_email.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "/widget/subscribe_email.json",
-  "description": "Google FeedBurner email subscription widget configurations",
+  "description": "Google FeedBurner email subscription widget configurations\nDEPRECATED: Google FeedBurner stopped email subscriptions in July 2021. Use the follow.it widget instead.",
   "type": "object",
   "properties": {
     "type": {

package/lib/schema/widget/tags.json

@@ -16,7 +16,7 @@
     },
     "amount": {
       "type": "integer",
-      "description": "Amount of tags to show. Will show all if not set.",
+      "description": "Amount of tags to show, with a link to the tag page for the rest. Will show all if not set.",
       "nullable": true
     },
     "show_count": {

package/lib/util/appearance.js

@@ -0,0 +1,40 @@
+/**
+ * Utility functions for inline scripts that follow the appearance of the page.
+ * @module util/appearance
+ */
+
+/**
+ * Get a JavaScript expression that is true when the page looks dark.
+ * <p>
+ * A theme can set the appearance of a page with the <code>data-appearance</code> attribute of
+ * <code>&lt;html&gt;</code>: <code>dark</code> always looks dark, <code>auto</code> looks dark when
+ * the system prefers a dark color scheme, and any other value, or no attribute, looks light.
+ *
+ * @returns {string} The JavaScript expression.
+ *
+ * @example
+ * const js = `var theme = ${isDark()} ? 'dark' : 'light';`;
+ */
+function isDark() {
+  return `(function (appearance) {
+    return appearance === 'dark' || (appearance === 'auto' && !!window.matchMedia &&
+      window.matchMedia('(prefers-color-scheme: dark)').matches);
+  })(document.documentElement.getAttribute('data-appearance'))`;
+}
+
+/**
+ * Get a JavaScript expression for the appearance of the page: <code>'dark'</code>,
+ * <code>'auto'</code>, or <code>'light'</code>.
+ *
+ * @returns {string} The JavaScript expression.
+ * @see module:util/appearance.isDark
+ */
+function getAppearance() {
+  return `(function (appearance) {
+    return appearance === 'dark' || appearance === 'auto' ? appearance : 'light';
+  })(document.documentElement.getAttribute('data-appearance'))`;
+}
+module.exports = {
+  isDark,
+  getAppearance
+};

package/lib/util/classname.js

@@ -19,7 +19,7 @@ module.exports = function (classname) {
   if (Array.isArray(classname)) {
     return classname.join(' ');
   }
-  if (typeof classname === 'object') {
+  if (classname !== null && typeof classname === 'object') {
     return Object.keys(classname).filter(key => !!classname[key]).join(' ');
   }
   throw new Error('Cannot process class name ' + JSON.stringify(classname));

package/lib/util/deprecate.js

@@ -0,0 +1,28 @@
+/**
+ * Utility functions for warning about deprecated components.
+ * @module util/deprecate
+ */
+
+const warned = new Set();
+
+/**
+ * Print a warning about a deprecated component, once per component.
+ * <p>
+ * Components are rendered for every page, so the warning is only printed the first time.
+ *
+ * @param {string} name Name of the component, such as <code>share.addthis</code>.
+ * @param {string} message Why the component is deprecated, and what to use instead.
+ * @example
+ * deprecate('share.addthis', 'AddThis shut down on May 31, 2023. Use AddToAny or ShareThis instead.');
+ */
+function deprecate(name, message) {
+  if (warned.has(name)) {
+    return;
+  }
+  warned.add(name);
+  // eslint-disable-next-line no-console
+  console.warn(`hexo-component-inferno: ${name} is deprecated. ${message}`);
+}
+module.exports = {
+  deprecate
+};

package/lib/util/html.js

@@ -0,0 +1,51 @@
+/**
+ * Utility functions for HTML text.
+ * @module util/html
+ */
+const {
+  stripHTML
+} = require('hexo-util');
+const ENTITIES = {
+  amp: '&',
+  lt: '<',
+  gt: '>',
+  quot: '"',
+  apos: "'",
+  nbsp: ' '
+};
+
+/**
+ * Decode the character references in HTML text, such as <code>&amp;amp;</code>,
+ * <code>&amp;#39;</code> and <code>&amp;#x1F600;</code>.
+ * <p>
+ * Numeric references and the named ones that Markdown renderers output are decoded. Other named
+ * references are kept as they are.
+ *
+ * @param {string} str HTML text.
+ * @returns {string} The text.
+ */
+function decodeHTML(str) {
+  return str.replace(/&(#x[\da-f]+|#\d+|[a-z]+);/gi, (match, entity) => {
+    if (entity[0] === '#') {
+      const code = entity[1] === 'x' || entity[1] === 'X' ? parseInt(entity.slice(2), 16) : parseInt(entity.slice(1), 10);
+      return code <= 0x10ffff ? String.fromCodePoint(code) : match;
+    }
+    const char = ENTITIES[entity.toLowerCase()];
+    return char === undefined ? match : char;
+  });
+}
+
+/**
+ * Convert HTML to plain text on one line, for example to index or describe a page.
+ *
+ * @param {string} html HTML.
+ * @returns {string} The text, with the tags removed, the character references decoded, and the
+ * whitespace collapsed.
+ */
+function toPlainText(html) {
+  return decodeHTML(stripHTML(html || '')).replace(/\s+/g, ' ').trim();
+}
+module.exports = {
+  decodeHTML,
+  toPlainText
+};