page2pdf_server 1.0.0 → 1.0.2

package/ecosystem.config.js

@@ -1,41 +1,41 @@
-module.exports = {
-  apps: [
-    {
-      name: '<app-name>',
-      script: 'dist/src/index.js',
-      // Options reference: https://pm2.keymetrics.io/docs/usage/application-declaration/
-      exec_mode: 'cluster',
-      instances: 2,
-      kill_timeout: 5000,
-      autorestart: true,
-      max_restarts: 10,
-      watch: true,
-      watch_options: {
-        followSymlinks: false,
-      },
-      max_memory_restart: '1G',
-      env: {
-        NODE_ENV: 'development',
-      },
-      env_production: {
-        NODE_ENV: 'production',
-        port: 8080,
-      },
-      merge_logs: true,
-      log_date_format: 'YYYY-MM-DDTHH:mm:ss.sssZ',
-    },
-  ],
-  // https://pm2.keymetrics.io/docs/usage/deployment/
-  deploy: {
-    production: {
-      key: process.env.EC2_PEM_PATH,
-      host: process.env.EC2_HOST,
-      user: 'ubuntu',
-      ref: 'origin/main',
-      repo: 'git@github.com:<username>/<repo-name>.git',
-      path: '/home/ubuntu',
-      'post-deploy':
-        'yarn && yarn clean && yarn build && pm2 startOrRestart ecosystem.config.js --env production && pm2 set pm2:autodump true && pm2 save',
-    },
-  },
-};
+module.exports = {
+  apps: [
+    {
+      name: '<app-name>',
+      script: 'dist/src/index.js',
+      // Options reference: https://pm2.keymetrics.io/docs/usage/application-declaration/
+      exec_mode: 'cluster',
+      instances: 2,
+      kill_timeout: 5000,
+      autorestart: true,
+      max_restarts: 10,
+      watch: true,
+      watch_options: {
+        followSymlinks: false,
+      },
+      max_memory_restart: '1G',
+      env: {
+        NODE_ENV: 'development',
+      },
+      env_production: {
+        NODE_ENV: 'production',
+        port: 8080,
+      },
+      merge_logs: true,
+      log_date_format: 'YYYY-MM-DDTHH:mm:ss.sssZ',
+    },
+  ],
+  // https://pm2.keymetrics.io/docs/usage/deployment/
+  deploy: {
+    production: {
+      key: process.env.EC2_PEM_PATH,
+      host: process.env.EC2_HOST,
+      user: 'ubuntu',
+      ref: 'origin/main',
+      repo: 'git@github.com:<username>/<repo-name>.git',
+      path: '/home/ubuntu',
+      'post-deploy':
+        'yarn && yarn clean && yarn build && pm2 startOrRestart ecosystem.config.js --env production && pm2 set pm2:autodump true && pm2 save',
+    },
+  },
+};

package/jest.config.js

@@ -1,35 +1,35 @@
-const { defaults: tsjPreset } = require("ts-jest/presets");
-
-module.exports = {
-  preset: "ts-jest",
-  moduleFileExtensions: ["ts", "js", "json"],
-  transform: {
-    "^.+\\.(ts|tsx)$": [
-      "ts-jest",
-      {
-        tsconfig: "tsconfig.json",
-        diagnostics: false,
-      },
-    ],
-    ...tsjPreset.transform,
-  },
-  testPathIgnorePatterns: ["dist"],
-  testMatch: ["**/__tests__/**/*.test.(ts|js)"],
-  testEnvironment: "node",
-  moduleNameMapper: {
-    "@/(.*)": "<rootDir>/src/$1",
-  },
-  watchPlugins: [
-    "jest-watch-typeahead/filename",
-    "jest-watch-typeahead/testname",
-  ],
-  coverageThreshold: {
-    global: {
-      branches: 1,
-      functions: 1,
-      lines: 1,
-      statements: 1,
-    },
-  },
-  coverageReporters: ["json", "lcov", "text", "clover"],
-};
+const { defaults: tsjPreset } = require("ts-jest/presets");
+
+module.exports = {
+  preset: "ts-jest",
+  moduleFileExtensions: ["ts", "js", "json"],
+  transform: {
+    "^.+\\.(ts|tsx)$": [
+      "ts-jest",
+      {
+        tsconfig: "tsconfig.json",
+        diagnostics: false,
+      },
+    ],
+    ...tsjPreset.transform,
+  },
+  testPathIgnorePatterns: ["dist"],
+  testMatch: ["**/__tests__/**/*.test.(ts|js)"],
+  testEnvironment: "node",
+  moduleNameMapper: {
+    "@/(.*)": "<rootDir>/src/$1",
+  },
+  watchPlugins: [
+    "jest-watch-typeahead/filename",
+    "jest-watch-typeahead/testname",
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 1,
+      functions: 1,
+      lines: 1,
+      statements: 1,
+    },
+  },
+  coverageReporters: ["json", "lcov", "text", "clover"],
+};

package/nodemon.json

@@ -1,6 +1,6 @@
-{
-  "watch": ["src/**/*.ts", ".env"],
-  "ext": "ts,js,.env",
-  "verbose": false,
-  "exec": "ts-node -r tsconfig-paths/register --files src/index.ts"
-}
+{
+  "watch": ["src/**/*.ts", ".env"],
+  "ext": "ts,js,.env",
+  "verbose": false,
+  "exec": "ts-node -r tsconfig-paths/register --files src/index.ts"
+}

package/package.json

@@ -1,105 +1,104 @@
-{
-  "name": "page2pdf_server",
-  "version": "1.0.0",
-  "description": "文书打印转换器",
-  "private": false,
-  "authors": "herzhang",
-  "repository": "https://gitee.com/heerzhang/page2pdf-server",
-  "license": "MIT",
-  "scripts": {
-    "yarn": "yarn",
-    "yarn命令行": "yarn add nodemon -D",
-    "注意2": "运行prettify来修复代码，免去到处是标记红色的，太严格了",
-    "prettify": "prettier --write \"src/**/*.{ts,js,json}\" \"__tests__/**/*.{ts,js,json}\"",
-    "start": "NODE_ENV=development run-s prettify lint & nodemon",
-    "build": "cross-env NODE_ENV=production run-s prettify clean transpile",
-    "lint": "eslint 'src/**/*.{ts,js}' '__tests__/**/*.{ts,js}'",
-    "lint:fix": "eslint --fix 'src/**/*.{ts,js}' '__tests__/**/*.{ts,js}' --quiet",
-    "有些隐藏错误": "需要运行watch才发现",
-    "watch": "tsc --watch",
-    "clean": "rimraf dist",
-    "test": "cross-env NODE_ENV=test jest --coverage --runInBand --detectOpenHandles",
-    "单步调试": "不必运行test，直接到__test__目录文件直接挑选修改测试项并调试",
-    "test:watchAll": "cross-env NODE_ENV=test jest --watchAll --runInBand --detectOpenHandles",
-    "transpile": "tsc",
-    "service:start": "pm2 start ecosystem.config.js",
-    "service:reload": "pm2 reload ecosystem.config.js",
-    "service:startup": "pm2 startup",
-    "service:stop": "pm2 stop ecosystem.config.js",
-    "service:list": "pm2 list ecosystem.config.js",
-    "service:delete": "pm2 delete ecosystem.config.js",
-    "service:logs": "pm2 logs",
-    "hook主动运行": "操作系统缘故，将单引号改成双引号，加转义符，提交代码会自动执行;git提交给它勾掉吧,yarn会自动运行prepare",
-    "prepare": "husky install"
-  },
-  "keywords": [
-    "dynamic page pdf generator",
-    "html to pdf",
-    "app url to pdf",
-    "pdf generation",
-    "node.js",
-    "express",
-    "print",
-    "server"
-  ],
-  "dependencies": {
-    "bcrypt": "^5.1.0",
-    "chrome-remote-interface": "^0.32.2",
-    "config": "^3.3.9",
-    "connect-timeout": "^1.9.0",
-    "cors": "^2.8.5",
-    "cross-env": "^7.0.3",
-    "dotenv": "^16.3.1",
-    "express": "^4.18.2",
-    "express-pino-logger": "^7.0.0",
-    "express-validator": "^7.0.1",
-    "helmet": "^7.0.0",
-    "http-status": "^1.6.2",
-    "jsonwebtoken": "^9.0.0",
-    "lodash-es": "^4.17.21",
-    "morgan": "^1.10.0",
-    "pdf-lib": "^1.17.1",
-    "pino-http": "^8.3.3",
-    "pino-pretty": "^10.0.0",
-    "rimraf": "^5.0.1",
-    "save-dev": "^0.0.1-security"
-  },
-  "devDependencies": {
-    "@babel/preset-env": "^7.22.5",
-    "@babel/preset-typescript": "^7.22.5",
-    "@types/bcrypt": "^5.0.0",
-    "@types/connect-timeout": "^0.0.37",
-    "@types/cors": "^2.8.13",
-    "@types/express": "^4.17.17",
-    "@types/express-pino-logger": "^4.0.3",
-    "@types/jest": "^29.5.2",
-    "@types/jsonwebtoken": "^9.0.2",
-    "@types/lodash-es": "^4.17.7",
-    "@types/module-alias": "^2.0.1",
-    "@types/morgan": "^1.9.4",
-    "@types/node": "^20.3.1",
-    "@types/supertest": "^2.0.12",
-    "@typescript-eslint/eslint-plugin": "^5.59.11",
-    "@typescript-eslint/parser": "^5.59.11",
-    "eslint": "^8.43.0",
-    "eslint-config-prettier": "^8.8.0",
-    "eslint-plugin-import": "^2.27.5",
-    "eslint-plugin-prettier": "^4.2.1",
-    "husky": "^8.0.3",
-    "jest": "^29.5.0",
-    "jest-watch-typeahead": "^2.2.2",
-    "module-alias": "^2.2.3",
-    "nodemon": "^3.0.1",
-    "npm-run-all": "^4.1.5",
-    "pm2": "^5.3.0",
-    "prettier": "^2.8.8",
-    "supertest": "^6.3.3",
-    "ts-jest": "^29.1.0",
-    "ts-node": "^10.9.1",
-    "tsconfig-paths": "^4.2.0",
-    "typescript": "^5.1.6"
-  },
-  "engines": {
-    "node": ">= 18.0.0"
-  }
-}
+{
+  "name": "page2pdf_server",
+  "version": "1.0.2",
+  "description": "文书打印转换器",
+  "private": false,
+  "authors": "herzhang",
+  "repository": "https://gitee.com/heerzhang/page2pdf-server",
+  "license": "MIT",
+  "scripts": {
+    "yarn": "yarn",
+    "yarn命令行": "yarn add nodemon -D",
+    "注意2": "运行prettify来修复代码，免去到处是标记红色的，太严格了",
+    "prettify": "prettier --write \"src/**/*.{ts,js,json}\" \"__tests__/**/*.{ts,js,json}\"",
+    "start": "NODE_ENV=development run-s prettify lint & nodemon",
+    "build": "cross-env NODE_ENV=production run-s prettify clean transpile",
+    "lint": "eslint 'src/**/*.{ts,js}' '__tests__/**/*.{ts,js}'",
+    "lint:fix": "eslint --fix 'src/**/*.{ts,js}' '__tests__/**/*.{ts,js}' --quiet",
+    "有些隐藏错误": "需要运行watch才发现",
+    "watch": "tsc --watch",
+    "clean": "rimraf dist",
+    "test": "cross-env NODE_ENV=test jest --coverage --runInBand --detectOpenHandles",
+    "单步调试": "不必运行test，直接到__test__目录文件直接挑选修改测试项并调试",
+    "test:watchAll": "cross-env NODE_ENV=test jest --watchAll --runInBand --detectOpenHandles",
+    "transpile": "tsc",
+    "service:start": "pm2 start ecosystem.config.js",
+    "service:reload": "pm2 reload ecosystem.config.js",
+    "service:startup": "pm2 startup",
+    "service:stop": "pm2 stop ecosystem.config.js",
+    "service:list": "pm2 list ecosystem.config.js",
+    "service:delete": "pm2 delete ecosystem.config.js",
+    "service:logs": "pm2 logs",
+    "hook主动运行": "操作系统缘故，将单引号改成双引号，加转义符，提交代码会自动执行;git提交给它勾掉吧,yarn会自动运行prepare",
+    "prepare": "husky install"
+  },
+  "keywords": [
+    "dynamic page pdf generator",
+    "html to pdf",
+    "app url to pdf",
+    "pdf generation",
+    "node.js",
+    "express",
+    "print",
+    "server"
+  ],
+  "dependencies": {
+    "chrome-remote-interface": "^0.32.2",
+    "config": "^3.3.9",
+    "connect-timeout": "^1.9.0",
+    "cors": "^2.8.5",
+    "cross-env": "^7.0.3",
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2",
+    "express-pino-logger": "^7.0.0",
+    "express-validator": "^7.0.1",
+    "helmet": "^7.0.0",
+    "http-status": "^1.6.2",
+    "jsonwebtoken": "^9.0.0",
+    "lodash-es": "^4.17.21",
+    "morgan": "^1.10.0",
+    "pdf-lib": "^1.17.1",
+    "pino-http": "^8.3.3",
+    "pino-pretty": "^10.0.0",
+    "rimraf": "^5.0.1",
+    "save-dev": "^0.0.1-security"
+  },
+  "devDependencies": {
+    "@babel/preset-env": "^7.22.5",
+    "@babel/preset-typescript": "^7.22.5",
+    "@types/bcrypt": "^5.0.0",
+    "@types/connect-timeout": "^0.0.37",
+    "@types/cors": "^2.8.13",
+    "@types/express": "^4.17.17",
+    "@types/express-pino-logger": "^4.0.3",
+    "@types/jest": "^29.5.2",
+    "@types/jsonwebtoken": "^9.0.2",
+    "@types/lodash-es": "^4.17.7",
+    "@types/module-alias": "^2.0.1",
+    "@types/morgan": "^1.9.4",
+    "@types/node": "^20.3.1",
+    "@types/supertest": "^2.0.12",
+    "@typescript-eslint/eslint-plugin": "^5.59.11",
+    "@typescript-eslint/parser": "^5.59.11",
+    "eslint": "^8.43.0",
+    "eslint-config-prettier": "^8.8.0",
+    "eslint-plugin-import": "^2.27.5",
+    "eslint-plugin-prettier": "^4.2.1",
+    "husky": "^8.0.3",
+    "jest": "^29.5.0",
+    "jest-watch-typeahead": "^2.2.2",
+    "module-alias": "^2.2.3",
+    "nodemon": "^3.0.1",
+    "npm-run-all": "^4.1.5",
+    "pm2": "^5.3.0",
+    "prettier": "^2.8.8",
+    "supertest": "^6.3.3",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.1",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.1.6"
+  },
+  "engines": {
+    "node": ">= 18.0.0"
+  }
+}

package/src/app.ts

@@ -39,3 +39,5 @@ export const createApp = (): express.Application => {
 
   return app;
 };
+
+//【CDP文档】  https://chromedevtools.github.io/devtools-protocol/tot/Target/

package/src/components/home/pdfController.ts

@@ -1,5 +1,5 @@
 import { OK } from "http-status/lib";
-import { ConfigRoot, FileTransform, HeadFooter } from "@/types/request/home";
+import { ConfigRoot, FileTransform, HeadFooter } from "@/types/request/config";
 import { apiResponse } from "@/helpers/apiResponse";
 import { RenderPDF } from "@/utils/pdfgen";
 import CONFIG from "@/configEnv";

package/src/components/home/splitController.ts

@@ -1,6 +1,6 @@
 import fs from "fs";
 import { OK } from "http-status/lib";
-import { ConfigRoot, FileTransform, HeadFooter } from "@/types/request/home";
+import { ConfigRoot, FileTransform, HeadFooter } from "@/types/request/config";
 import { apiResponse } from "@/helpers/apiResponse";
 
 import { RenderPDF } from "@/utils/pdfgen";

package/src/types/request/config.ts

@@ -0,0 +1,160 @@
+/**一次作业的模型配置；
+ * 若本对象为空{}的话：默认是按照修改时间的顺序简易模式地合并当前工作目录的所有pdf文件。
+ * 若某个URL不正常的，很可能无法触发页面加载完成，导致作业一致无法继续下去，大大超出预期执行时间。URL对应网页若不是一次性加载完成还会陆陆续续修改内容的就是这种情况造成死等长时间没结果。
+ * */
+export interface ConfigRoot<T> {
+  //是否生成合并的pdf：正常情况下， 默认=true进行files输出pdf全部做合并的。 除非files[]也是空的情形。
+  //但若需对任一个URL叠加新页眉页脚的，merge就不能=false的。
+  merge?: boolean;
+  //重定义 合并的pdf文件名, 否则默认名。不需要加 .pdf结尾的
+  name: string;
+  //双面打印的合并输出pdf， 默认=true, 表示合并输出的pdf考虑到双面打印的页眉页脚的布局差异化情况了。
+  doubleSide?: boolean;
+  //统一一整份应该用的页眉页脚
+  //假如files[]里面有些url自己也定义了lay{localSumNo=false}的页眉页脚输出配置，只能忽略掉它们，页码总数不算他们的，页码连续编号也不算它们的占坑:最好都挪到最后面。
+  lay?: HeadFooter;
+  //每一个独立的pdf生成：
+  files: [T];
+
+  //共用一个浏览器窗口 默认=true
+  singleTab?: boolean;
+  //自动关闭浏览器窗口 默认=false
+  closeTab?: boolean;
+
+  //下面这5个参数不是前端配置发送过来的，而是lay{}对象预先进行转换后保存的汇总页眉页脚，只能内部使用，并非外部接口参数！Page.printToPDF需要的。
+  headerTemplate?: string;
+  footerTemplate?: string;
+  headerTemplateL?: string;
+  footerTemplateL?: string;
+  //第二阶段页眉页脚生成的浏览器执行窗口的targetId,不可配置。
+  CDPtab?: string;
+}
+
+/**等待输出的每个独立文件:URL，这些文件可能要合并。
+ * @前提条件 是：每个url独立文件生成的PDF，它的纸张大小必须保证同一个大小尺寸， size: 必须唯一，但是纸张方向在某些约束条件中可以横屏竖屏混合的。
+ * 物理打印机：纸张适配，横竖方向还好能自动调节，size 真实打印纸张尺寸就不好自动处理, 不一样的尺寸?最好拆解pdf。
+ * 标准纸张大小的：静态html内CSS定义横竖纸张方向混合的：用reverseRanges参数设置部分纸张反转纸张方向，pageRanges=''的前提下：配置比如'1-5, 8, 11-13'和landscape参数设置相反方向。
+ * */
+export interface FileTransform {
+  //[必须配置的] 特殊的前缀是 http:// https:// 没有这俩个的都是本地工作目录的文件全名(含文件类型后缀 *.pdf *.*)。
+  //任意的本地文件类型，只要可以被Chrome装载并能够支持打印预览的都可以。http打头的网页必须确保已经登录了，也就是遗留cockies token,不能要求交互登录。本地文件不能要求输入口令。
+  //不支持*.xls *.doc文件；不支持的格式实际在浏览器拖拽窗口后会蜕变成了下载形式的。被加密的文件必须提前解密,网站登录需提前解决。
+  //【特殊问题】若URL网页动态化太离谱，周期性地不间断地更新页面,没法触发加载结束事件的，只能手动在浏览器查看打印另存pdf，然后把手动生成pdf合并进来。Tab切换会主动刷新的也不触发。
+  url: string;
+  //输出本地工作目录的文件名， 不需要加 .pdf结尾的 【注意】如果out为空表示url是pdf的没必要转换的要直接进入合并步骤。
+  //【特别】必须配置唯一性 的本地 工作目录的文件名，同名的被直接覆盖了。
+  out: string;
+
+  //是否汇总合并阶段省略本url，不合并进去，那就是单独独立的pdf输出了。默认=true是合并进去。 和是否打印页眉页脚或页眉统计页数没有绝对关系的。
+  merge?: boolean;
+
+  //默认取值都是=true; 第一阶段不会生成页眉页脚的，汇总第二阶段这个参数才会生效！
+  //这里配置displayHeaderFooter优先级最高。
+  //页眉页脚如何分开控制是否打印的： 可以把lay{head，foot}其中一个配置串给设置为null,null就代表不输出。例如head=null就不输出页眉，但是页脚照旧打印的。本url的配置优先于汇总pdf配置。
+  //若ConfigRoot<T>.merge=false那么必然导致FileTransform.merge强制=false，每个独立pdf页码独立的独立都从1开始编号吗还需要打印吗，页眉页脚需要打印吗？这个情况页眉页脚打印的默认值改成false;
+  displayHeaderFooter: boolean;
+
+  //【特别注意】frNo 可能和 headFrom 配置矛盾。
+  //本url打印：从第几页才开始页眉页脚的打印，#页码同样也是在这之后才可能计数和编号!。默认值headFrom=1：就是第一页就开始打印页眉页脚的。
+  //书本封面页情况的。这个参数有最高优先级。 【注意】和frNo设置相互影响, 没有页眉页脚就失去页码意义了。若真的违反了可能页码不能连续输出的，被隐藏了页码缘故。
+  headFrom?: number;
+  //本url打印后，从本URL输出的第几页开始才进行的页码序号的顺序输出的，前面几页不打印页码(但是页眉页脚要打印)。默认值=1全部都打页码。若frNo=0全部不打页码的。
+  //假如displayHeaderFooter=false也即页码无法显示出来的情况：请申明frNo=0; 不然默认是连续页码的，不打印的也有占用页码的隐藏的连续数字啊。
+  //注意若有配置 headFrom 的要协调好。
+  frNo?: number;
+
+  //是否对页码支持连续编号：  Continuous numbering 是跟随汇总合并的页码 基数合计。【注意】本配置单个url范围，单个url不能混合本地页码和全局页面两种！
+  //统计页数是否本URL独立自己范围之内进行的汇总计数。比如书本目录有多页的可以独立统计页码序号以及总页数的。默认=false;
+  localSumNo?: boolean;
+  //本url对应的部分应该用的页眉页脚，覆盖掉合并pdf的相对应设置。页面上只能支持输出一次页眉页脚，不重叠做输出。
+  //若lay{localSumNo=false}只能固定支持本url自己内部的页码统计顺序编号，不考虑合并pdf总页数带来的影响的。 还是？预设其它部分的页数统计总数之后？再做偏移页码编写？
+  lay: PartHeadFooter;
+  //前端声明本url在第一阶段打印输出后，生成的pdf应该有几页。 count没有设置的救不会做异常检查的。不是第二阶段的计数：双面情况可能增加空白页
+  count?: number;
+  //双面打印的 默认=true, 表示独立分开输出的pdf文件的：考虑到双面打印的页眉页脚的布局差异化情况了。
+  //合并输出merge=true的情况：该参数无效，要看汇总配置的哪一个 # ConfigRoot<T>{ doubleSide： }字段。
+  doubleSide: boolean;
+  //双面打印的情形：必须确保本URL的第一个页是正好右手边(书本翻页的奇数号页码)开始的位置页。正常第一个URL首页面就是双面打印的右手边位置页；默认值=false不必确保.
+  rightHand: boolean;
+
+  //页码是罗马数字；论文目录需要的；默认=false阿拉伯数字。"I","II","III","IV","V","VI","VII","VIII","IX" "X"XI"XII"表盘符号
+  //roman只能针对本URL启用；数字转换范围最大支持1到12，超过了便改阿拉伯数字，且只针对pageNumber有效, totalPages不会采用。
+  roman?: boolean;
+
+  //下面这5个参数不是前端配置发送过来的，而是lay{}对象预先进行转换后保存的汇总页眉页脚，只能内部使用，并非外部接口参数！Page.printToPDF需要的。
+  headerTemplate?: string;
+  footerTemplate?: string;
+  headerTemplateL?: string;
+  footerTemplateL?: string;
+  //第一阶段Url转pdf的浏览器执行窗口的targetId,不可配置。
+  CDPtab?: string;
+}
+
+/*看 Page.printToPDF（）文档说明的： 可以使用的注入参数:
+  date: formatted print date
+  title: document title
+  url: document location
+  pageNumber: current page number
+  totalPages: total pages in the document
+  For example, <span class=title></span> would generate span containing the title.
+*/
+
+/**页眉页脚声明；前提条件是页眉页脚htm描述里面：不应该把-NOT_DISPLAY- ${pageNumber} ${totalPages}这三个保留字字符串当作普通文字输出的。
+ * 前端发送数据包时刻，页眉页脚的脚本需要在 HTML转JSON 工具网站 进行转换处理后的；网站地址  https://uutool.cn/html2json/ 转换htm模板后是数组[string]
+ * 实际上也就进行拆分多行字符串拼接数组，还有把html语法中的 ""引号 进行转义 style="position: 变成 style=\\\"position: 处置的。
+ * */
+export interface HeadFooter {
+  //每一个URL独立设置的 页眉 的 : 若是配置值=null  表示不要打印本页眉: 针对本url。
+  //双面打印：右手边位置的,或单面打印使用
+  head?: string | string[] | null;
+  //每一个页 页脚的
+  //每一个URL独立设置的 页脚的 : 若是配置值=null  表示不要打印本页脚的， 针对本url。
+  //双面打印：右手边位置的,或单面打印使用
+  foot?: string | string[] | null; //实际前端发过来却是[string]的也可以啊。
+  /**可注入3个参数"特殊标记字符串"如下： 服务端依据参数来对注入的html进行修改的。
+   * ${pageNumber}
+   * ${totalPages}
+   * -NOT_DISPLAY-
+   * 这三个分别代表 页码 总页数 以及页码<div style=""></div>中的可替代占位位置。-NOT_DISPLAY-在后端要直接替代成display:none;的CSS标记字符串！其它2个替换成数字号码。
+   * */
+  //双面打印：左手边位置的
+  headL?: string | string[] | null;
+  //双面打印：左手边位置的
+  footL?: string | string[] | null;
+}
+
+/**实际在第二步骤也即汇总阶段：页眉页脚的生成底下的参数size，landscape，reverseRanges,marginLeft,marginRight几个都不会涉及到了。
+ * */
+export interface PartHeadFooter extends HeadFooter {
+  //纸张大小: 纸张大小尺寸+布局方向是自定义系列的：
+  //a5 a4 a3 b5 b4  jis-b5  jis-b4 letter legal ledger auto 等常见的名字， 默认是 "a4 portrait"
+  //中国：默认值改成是 a4 portrait
+  size: string;
+  //W3C标准纸张大小，横着的吗; 但是非标准尺寸的#自定义的没有这个选择参数的！。 默认是 "portrait"
+  landscape: boolean;
+  //背景， 默认 =false
+  printBackground: boolean;
+
+  //底下的这四个参数默认都=1cm (~0.4 inches)； 若要做配置的必须是英寸为单位的数字, 【单位 注意】
+  marginTop?: number;
+  marginBottom?: number;
+  //就算纸张是横屏的：Chrome生成页眉页脚的位置实际也没牵涉到marginLeft,marginRight;
+  marginLeft?: number;
+  marginRight?: number;
+  //默认全部打印的，#可自定义部分页面输出的。 Paper ranges to print, one based, e.g., '1-5, 8, 11-13'.
+  pageRanges?: string;
+}
+
+/**配置自定义地非标准纸张尺寸， 横竖纸张要独立配置。
+ * */
+export interface MyPaperSize {
+  //自定义的尺寸名称 ,前端发送数据包时用这个名字 替换通常的 a4 a5 a3等，纸张横的竖的要定义两个标签。
+  name: string;
+  //W3C @page size{}语境中配的描述串。 如下："4in 6in", 前面4英寸宽度的纸张。
+  //{"name":"D8", "css": "4in 6in","w": 4,"h": 6},
+  css: string;
+  //纸张 4 英寸宽度 "w": 4,
+  w: number;
+  //纸张高度： 英寸单位的，必须和css参数确保一致性。
+  h: number;
+}