hexo-adsense 1.0.21 → 1.0.25

package/packages/hexo-extend-injector2/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

package/packages/hexo-extend-injector2/README-ZH.md

@@ -0,0 +1,189 @@
+# hexo-extend-injector2
+
+为插件或者主题提供扩展，能将代码注入到指定位置（如果主题提供相应的注入点）
+
+![npm](https://img.shields.io/npm/v/hexo-extend-injector2.svg)
+
+这个插件的功能借鉴了原生injector的设计，但由于其无法兼容原本的NexT插件方案，重新设计以提供更多扩展能力，详细见[这个PR](https://github.com/jiangtj/hexo-theme-cake/pull/39)
+
+## Install
+
+```bash
+yarn add hexo-extend-injector2
+```
+
+## Usage
+
+首先，你需要获取injector实例通过require，下面的API中injector都是这样获取
+
+```js
+const injector = require('hexo-extend-injector2')(hexo);
+```
+
+### 注册
+
+injector 有两种注册的写法
+
+```js
+injector.register(entry, value, predicate, priority, isRun);
+injector.register(entry, {
+  value: value,
+  predicate: predicate,
+  priority: priority,
+  isRun: true/false
+});
+```
+
+#### 参数
+
+|  属性名   | 类型  | 描述  | 默认值  |
+|  :-----  | :----- | :-----  | :-----  |
+| entry  | String | 注入点，它忽略大小写以及` ` `-` `_`，即 'bodybegin' = 'bodyBegin' = 'body-begin' = 'body_begin' | - |
+| value  | String/Function  | 注入的内容，如果是函数，会传递上下文及配置参数 | - |
+| predicate  | String/Function  | 生效条件，详见例子 | `() => true` |
+| priority  | Number  | 优先级 | 10 |
+| isRun  | Boolean  | 特别定义的参数，hexo部分内容在文件更改之后重新加载，重新加载时会清空isRun为true的内容，避免重复加载 | false |
+
+
+#### 例子
+
+1. 最简单的使用，在你的站点的head中添加fontawesome css，下面三种写法是等效的
+```js
+injector.register('head-end', '<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5.11.2/css/all.min.css" crossorigin="anonymous">');
+injector.register('head-end', () => '<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5.11.2/css/all.min.css" crossorigin="anonymous">');
+injector.register('head-end', {
+  value: '<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5.11.2/css/all.min.css" crossorigin="anonymous">'
+});
+```
+
+2. Predicate的使用
+```js
+// 当你需要在特定的页面注入内容时，需要用到Predicate，分为两种写法
+
+// 与官方一样的，指定布局类型，如下，将在特定的music布局中添加APlayer
+injector.register('head_end', () => {
+  return css('https://cdn.jsdelivr.net/npm/aplayer@1.10.1/dist/APlayer.min.css');
+}, 'music');
+injector.register('body_end', '<script src="https://cdn.jsdelivr.net/npm/aplayer@1.10.1/dist/APlayer.min.js">', 'music');
+// 等价于 使用了 injector.is('home', 'category', ...)，可以传递多个布局，同时生效
+injector.register('body_end', '<script src="https://cdn.jsdelivr.net/npm/aplayer@1.10.1/dist/APlayer.min.js">', injector.is('music'));
+
+// 依据上下文或者配置选项判断
+injector.register('head-end', {
+  predicate: (ctx, options) => {
+    // ctx 在不同情况下，传入的值可能不同，options 在 injector.get() 时传入
+    return ctx.page['music'];
+  },
+  value: () => {
+    return css('https://cdn.jsdelivr.net/npm/aplayer@1.10.1/dist/APlayer.min.css');
+  }
+});
+```
+
+### 获取
+
+默认情况下，只提供四个注入点 `head-begin` `head-end` `body-begin` `body-end`，你可以设置`disable_injector2_default_point`为true禁用
+
+其他情况，需要开发者提供JS API或者Hexo Helper两种途径获取存储在injector的内容，自行处理它
+
+#### API
+
+```js
+const result = injector.get(entry, options);
+```
+
+- result.list(): 获取该注入点的所有注入对象
+- result.rendered(): 获取并渲染该注入点的所有注入对象（如果value是函数，将执行转化为String）
+- result.text(): 将该注入点的所有注入内容渲染拼接后返回
+
+例子
+
+```js
+// 在bundler中，通过添加env来判断是否是需要的css内容
+injector.get('css', {env: 'dark'});
+// 覆盖默认的ctx
+injector.get('point', {context: this});
+```
+
+#### Helper
+
+injector helper 与 injector.get() 十分相似，但context替换为了hexo的本地变量
+
+```ejs
+<!DOCTYPE html>
+<html>
+<head>
+  <%- injector('head-begin').text() -%>
+  ...
+  <%- injector('head-end').text() -%>
+</head>
+<body>
+  <%- injector('body-begin').text() -%>
+  ...
+  <%- injector('body-end').text() -%>
+</body>
+</html>
+```
+
+### bundler
+
+该插件提供了js与css的bundler，你可以很方便的将js与css添加至主题中
+
+#### config
+
+下面是bundler的默认配置
+
+```yml
+injector2:
+  js:
+    enable: true
+    path: js/injector.js
+    options: {}
+  css:
+    enable: true
+    path:
+      default:
+        # 在 head 中添加 <link rel="stylesheet" type="text/css" href="${url_for(file.path)}" />
+        link: load
+        path: css/injector/main.css
+      dark:
+        # 在 head 中添加 <link rel="preload" as="style" href="${url_for(file.path)}" />
+        link: preload
+        path: css/injector/dark.css
+      light:
+        link: preload
+        path: css/injector/light.css
+    options: {}
+```
+
+#### API/Example
+
+```js
+injector.register('js or css', 'content');
+
+// Example
+injector.register('js', 'function log1() {console.log("bar");}');
+injector.register('css', '.book{font-size:2rem}');
+
+// CSS spec
+// 额外添加了env的选择，如果env不同，那么会打包到不同的css文件下
+// 你需要提前进行配置，默认情况下配置了default、dark和light，如果不设置为default
+injector.register('css', {value: '.book{font-size:2rem}', env: 'dark'});
+
+// CSS 别名
+injector.register('variable', 'css content');
+//=> injector.register('css', {value: 'css content', priority: injector.order.REGISTER_VARIABLE});
+injector.register('style', 'css content');
+//=> injector.register('css', {value: 'css content', priority: injector.order.REGISTER_STYLE});
+```
+
+### NexT plugin
+
+如果你希望在你的主题中使用NexT主题的插件，启用以下配置（默认启用），如果存在不兼容的插件，可以提交issue
+
+```yml
+injector:
+  load_next_plugin: true
+```
+
+除此外，主题需要提供与[NexT类似的注入点](lib/next-point.js)，如[Cake](https://github.com/jiangtj/hexo-theme-cake)主题已经添加，但如果是其它主题，你可能需要自己添加它

package/packages/hexo-extend-injector2/README.md

@@ -0,0 +1,191 @@
+# hexo-extend-injector2
+
+Provide extensions for plugins or themes to inject code to specified locations (if the theme provides corresponding injection points)
+
+![npm](https://img.shields.io/npm/v/hexo-extend-injector2.svg)
+
+[中文文档](README-ZH.md)
+
+The function of this plugin refers to the design of the native injector, but because it cannot be compatible with the original next plugin scheme, it is redesigned to provide more extension capabilities. For details, see [this PR](https://github.com/jiangtj/hexo-theme-cake/pull/39)
+
+## Install
+
+```bash
+yarn add hexo-extend-injector2
+```
+
+## Usage
+
+First of all, you need to obtain the injector instance through require. The injectors in the following API are all obtained like this
+
+```js
+const injector = require('hexo-extend-injector2')(hexo);
+```
+
+### Register
+
+There are two ways to write
+
+```js
+injector.register(entry, value, predicate, priority, isRun);
+injector.register(entry, {
+  value: value,
+  predicate: predicate,
+  priority: priority,
+  isRun: true/false
+});
+```
+
+#### Params
+
+|  attribute   | type  | description  | default  |
+|  :-----  | :----- | :-----  | :-----  |
+| entry  | String | injection position, it ignores case and ` ` `-` `_`, e.g. 'bodybegin' = 'bodyBegin' = 'body-begin' = 'body_begin' | - |
+| value  | String/Function  | injected content, if it is a function, will pass the context and options parameters | - |
+| predicate  | String/Function  | effective conditions, see example for details | `() => true` |
+| priority  | Number  | priority | 10 |
+| isRun  | Boolean  | Part of the content of hexo is reloaded after the file is changed. When reloading, the content of isRun will be cleared to avoid repeated loading. | false |
+
+
+#### Example
+
+1. This is simplest demo, add fontawesome CSS to the head of your site. The following three methods are equivalent
+```js
+injector.register('head-end', '<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5.11.2/css/all.min.css" crossorigin="anonymous">');
+injector.register('head-end', () => '<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5.11.2/css/all.min.css" crossorigin="anonymous">');
+injector.register('head-end', {
+  value: '<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5.11.2/css/all.min.css" crossorigin="anonymous">'
+});
+```
+
+2. Use of Predicate
+```js
+// When you need to inject content on a specific page, you need to use Predicate, which is divided into two ways of writing
+
+// Like the official, specify the layout type, as follows, APlayer will be added to the specific music layout
+injector.register('head_end', () => {
+  return css('https://cdn.jsdelivr.net/npm/aplayer@1.10.1/dist/APlayer.min.css');
+}, 'music');
+injector.register('body_end', '<script src="https://cdn.jsdelivr.net/npm/aplayer@1.10.1/dist/APlayer.min.js">', 'music');
+// Equivalent to using injector.is('home','category', ...), multiple layouts can be passed, and they will take effect at the same time
+injector.register('body_end', '<script src="https://cdn.jsdelivr.net/npm/aplayer@1.10.1/dist/APlayer.min.js">', injector.is('music'));
+
+// Judging by context or options
+injector.register('head-end', {
+  predicate: (ctx, options) => {
+    // ctx in different situations, the value passed in may be different, 
+    return ctx.page['music'];
+  },
+  value: () => {
+    return css('https://cdn.jsdelivr.net/npm/aplayer@1.10.1/dist/APlayer.min.css');
+  }
+});
+```
+
+### Get
+
+By default, only four injection points are provided `head-begin` `head-end` `body-begin` `body-end`, you can set `disable_injector2_default_point` to true to disable
+
+In other cases, developers need to use JS API or Hexo Helper to obtain the content stored in the injector, and process it by yourself
+
+#### API
+
+```js
+const result = injector.get(entry, options);
+```
+
+- result.list(): Get all injection objects of this injection point
+- result.rendered(): get and render all injection objects of this injection point (if value is a function, it will be converted to String)
+- result.text(): render and merge all the injected content of this injection point
+
+Example
+
+```js
+// In bundler, by adding env to determine whether it is the required css content
+injector.get('css', {env: 'dark'});
+// Override the default ctx
+injector.get('point', {context: this});
+```
+
+#### Helper
+
+The injector helper is very similar to injector.get(), but the context is replaced with the local variables of hexo
+
+```ejs
+<!DOCTYPE html>
+<html>
+<head>
+  <%- injector('head-begin').text() -%>
+  ...
+  <%- injector('head-end').text() -%>
+</head>
+<body>
+  <%- injector('body-begin').text() -%>
+  ...
+  <%- injector('body-end').text() -%>
+</body>
+</html>
+```
+
+### bundler
+
+The plug-in provides the bundler of JS and CSS, which can be easily added to the theme
+
+#### config
+
+The following is the default configuration of the bundler
+
+```yml
+injector2:
+  js:
+    enable: true
+    path: js/injector.js
+    options: {}
+  css:
+    enable: true
+    path:
+      default:
+        # Add <link rel="stylesheet" type="text/css" href="${url_for(file.path)}" /> in the head
+        link: load
+        path: css/injector/main.css
+      dark:
+        # Add <link rel="preload" as="style" href="${url_for(file.path)}" /> in the head
+        link: preload
+        path: css/injector/dark.css
+      light:
+        link: preload
+        path: css/injector/light.css
+    options: {}
+```
+
+#### API/Example
+
+```js
+injector.register('js or css', 'content or file path');
+
+// Example
+injector.register('js', 'function log1() {console.log("bar");}');
+injector.register('css', '.book{font-size:2rem}');
+
+// CSS spec
+// Additional env options are added. If the env is different, it will be packaged into a different CSS file
+// But you need to configure it in advance. default dark and light are set by default, if not set, it will be default
+injector.register('css', {value: '.book{font-size:2rem}', env: 'dark'});
+
+// CSS alias
+injector.register('variable', 'css content');
+//=> injector.register('css', {value: 'css content', priority: injector.order.REGISTER_VARIABLE});
+injector.register('style', 'css content');
+//=> injector.register('css', {value: 'css content', priority: injector.order.REGISTER_STYLE});
+```
+
+### NexT plugin
+
+If you want to use next theme plug-ins in your theme, enable the following configuration (enabled by default). If there are incompatible plug-ins, you can submit the issue
+
+```yml
+injector:
+  load_next_plugin: true
+```
+
+In addition, theme need to provide the injection point similar to [next](lib/next-point.js), such as [cake](https://github.com/jiangtj/hexo-theme-cake) has been added, but if it's another theme, you may need to add it by yourself.

package/packages/hexo-extend-injector2/USAGE.md

@@ -0,0 +1,38 @@
+```js
+const injector = require('../hexo/_inject/index')(hexo); // will make it as plugin
+injector.register(entry, value, predicate, priority, isRun);
+injector.register(entry, {
+  value: value,
+  predicate: predicate,
+  priority: priority,
+  isRun: true/false
+});
+
+entry = 'bodybegin' = 'bodyBegin' = 'body-begin' = 'body_begin'
+
+value = 'String'
+value = ctx => `${ctx.page.path}`
+
+predicate = 'home'
+predicate = injector.is('home', 'category', ...)
+predicate = ctx => ctx.is_post()
+
+// example
+injector.register('body-Begin', '------------');
+injector.register('bodyBegin', 'AAAA', 'home', 11);
+injector.register('bodyBegin', 'BBBB', injector.is('home', 'category'));
+injector.register('bodyBegin', 'CCCC', ctx => ctx.is_post());
+injector.register('bodyBegin', {
+  value    : 'DDDD',
+  predicate: ctx => ctx.is_post(),
+  priority : 1
+});
+// if use it in `before_generate` filter, set `isRun` to true
+hexo.extend.filter.register('before_generate', () => {
+  injector.register('bodyBegin', {
+    value    : 'isRun',
+    predicate: ctx => ctx.is_post(),
+    isRun: true
+  });
+});
+```

package/packages/hexo-extend-injector2/index.js

@@ -0,0 +1,13 @@
+'use strict';
+
+const { resolve } = require('path');
+
+module.exports = ctx => {
+  // If initialized, return the result
+  if (ctx.extend.injector2) {
+    return ctx.extend.injector2;
+  }
+  // If not in the main plugin directory, relocate to the main plugin directory
+  const load = require(resolve(ctx.plugin_dir, 'hexo-extend-injector2/lib/load'));
+  return load(ctx);
+};

package/packages/hexo-extend-injector2/lib/bundle/css-bundle.js

@@ -0,0 +1,79 @@
+'use strict';
+
+const handleDataPre = require('./handle-data-pre');
+const cssGenerator = require('./css-generator');
+
+
+const loadCss = (ctx, injector, config) => {
+  const { generator } = ctx.extend;
+  const { options, file, env } = config;
+  const { REGISTER_CSS } = injector.order;
+
+  const url_for = require('hexo-util').url_for.bind(ctx);
+  if (file.link === 'preload') {
+    injector.register('head-end', {
+      value: `<link rel="preload" as="style" href="${url_for(file.path)}" />`,
+      priority: REGISTER_CSS
+    });
+  }
+  if (file.link === 'load') {
+    injector.register('head-end', {
+      value: `<link rel="stylesheet" type="text/css" href="${url_for(file.path)}" />`,
+      priority: REGISTER_CSS
+    });
+  }
+
+  generator.register(`css-bundler-${env}`, () => {
+    return {
+      path: file.path,
+      data: cssGenerator(injector, env, options)
+    };
+  });
+
+};
+
+module.exports = (ctx, injector) => {
+
+  const config = injector.config.css;
+
+  if (!config.enable) return;
+
+  const { filter } = ctx.extend;
+
+  const { REGISTER_VARIABLE, REGISTER_STYLE } = injector.order;
+
+  filter.register('injector2:register-variable', data => {
+    data.priority = REGISTER_VARIABLE;
+    injector.register('css', data);
+  });
+  filter.register('injector2:register-style', data => {
+    data.priority = REGISTER_STYLE;
+    injector.register('css', data);
+  });
+
+  if (typeof config.path === 'string') {
+    const { path } = config;
+    config.path = {
+      default: {
+        path,
+        link: 'load'
+      }
+    };
+  }
+
+  const isLoadCss = {};
+
+  filter.register('injector2:register-css', data => {
+    const env = data.env || 'default';
+    data.env = env;
+    const file = config.path[env];
+    const options = config.options;
+    if (file && !isLoadCss[env]) {
+      loadCss(ctx, injector, {options, env, file});
+      isLoadCss[env] = true;
+    }
+    handleDataPre(ctx, data, ['.css', '.sass', '.styl']);
+    data.predicate = (ctx, options) => options.env === env;
+  });
+
+};

package/packages/hexo-extend-injector2/lib/bundle/css-generator.js

@@ -0,0 +1,13 @@
+'use strict';
+
+const CleanCSS = require('clean-css');
+
+module.exports = (injector, env, options) => () => {
+  return Promise.all(injector.get('css', { env }).toPromise())
+    .then(values => values.join('\n'))
+    .then(source => {
+      const output = new CleanCSS(options).minify(source);
+      if (output.error) throw output.error;
+      return output.styles;
+    });
+};