bookcover-core

中文文档
0.24.0发布于 2026/11/03MIT-0TypeScriptES Module

部分 封套 一代系统。

中文使用文档
文档目录8 节
  1. 打印/尺寸
  2. 标题
  3. 副标题
  4. 作者
  5. 简介(后面板)
  6. 脊柱
  7. 背景
  8. 其他

书封面-核心-模式参考

部分 封套 一代系统。

这是核心生成器包-不直接使用。安装 bookcover-node 为Node.js或 bookcover-web 对于浏览器。 本文档描述了两者接受的模式。

所有颜色必须是HSL字符串的格式 hsl(200deg, 50%, 30%).

打印/尺寸

场类型笔记
service_idstring印刷服务: kdp, lulu, officeworks, vistaprint_au, ctrlprint
binding_typestring如。 paperback, hardcover -视乎服务而定
size_idstring?如。 us_trade, a5 -省略如果使用自定义尺寸
page_countnumber?使用时需要 size_id
ink_typestring?如。 bw, color -某些服务需要
paper_typestring?如。 white, cream -某些服务需要
custom_unitstring?mm 或者 in -用于自定义尺寸
custom_trim_widthnumber?内剪宽度 custom_unit
custom_trim_heightnumber?纵倾高度 custom_unit
custom_bleednumber?流血的 custom_unit
custom_spinenumber?脊宽 custom_unit
margin_frontnumber?前面板文本边距为装饰高度的%
margin_backnumber?后面板文本边距为装饰高度的%

标题

三个标题行(title1, title2, title3)每个人都有相同的一组选项。 title1 是主标题。

场类型笔记
title1string主标题(默认) '')
title1_font{family: string}?在Typst中使用的字体族名称
title1_sizenumber?相对大小乘数(默认1.0)
title1_weightnumber?css样式的权重100-900(默认为700)
title1_italicboolean?
title1_colorhsl?默认为对比色vs bg_color
title_alignmentcenter|left|right?
title_positiontop|middle|bottom要求
title_spacingnumber?标题行之间的间距占装饰高度的%
title_margin_topnumber?上边距为装饰高度的%
title_margin_bottomnumber?底部边距为装饰高度的%

title2 和 title3 拥有相同的 _font, _size, _weight, _italic, _color 字段; title2/title3 颜色默认为 title1_color.

副标题

场类型笔记
subtitlestring(默认 '')
subtitle_font{family: string}?
subtitle_sizenumber?
subtitle_weightnumber?100 - 900
subtitle_italicboolean?
subtitle_colorhsl?
subtitle_alignmentcenter|left|right?
subtitle_positiontop|middle|bottom要求
subtitle_spacingnumber?副标题行之间的间距占裁边高度的%
subtitle_margin_topnumber?
subtitle_margin_bottomnumber?

作者

场类型笔记
authorstring(默认 '')
author_font{family: string}?
author_sizenumber?
author_weightnumber?100 - 900
author_italicboolean?
author_colorhsl?
author_alignmentcenter|left|right?
author_positiontop|middle|bottom要求
author_margin_topnumber?
author_margin_bottomnumber?

简介(后面板)

场类型笔记
blurbstring封底文字(默认) '')
blurb_font{family: string}?
blurb_sizenumber?
blurb_colorhsl?
blurb_bg_colorhsl|null?undefined 源自于 bg_color; null =透明
blurb_alignmentcenter|left|right|justified?
blurb_paddingnumber?填充为装饰高度的%
blurb_widthnumber?宽度为面宽的%
blurb_spacingnumber?行间距倍增器(1 =默认Typst前导)

脊柱

如果没有设置,脊柱文本默认为前标题和作者。通过 '' 显式地 压制书脊文字。

场类型笔记
spine_titlestring?省略派生自 title1; '' 抑制
spine_title_font{family: string}?
spine_title_sizenumber?
spine_title_weightnumber?
spine_title_italicboolean?
spine_title_colorhsl?
spine_authorstring?省略派生自 author; '' 抑制
spine_author_font{family: string}?
spine_author_sizenumber?
spine_author_weightnumber?
spine_author_italicboolean?
spine_author_colorhsl?
spine_colorhsl|null?null =没有单独的spine颜色(使用primary bg)

背景

场类型笔记
bg_colorhsl?原色背景色
bg_color_gradientboolean?背景渐变
bg_image_coveragefull|front|painted|feature|front_partial?背景图像是如何放置的
icon_idstring?图标化ID(例如: game-icons:sailboat)或原始SVG
icon_modecenter|offset|echo|background?
icon_sizenumber?相对大小倍增器,范围0.25-4
icon_colorstring?
icon_spineboolean?显示脊柱上的图标
patternstring?原始SVG字符串平铺作为背景图案
pattern_tile_mmnumber?图案瓦片大小(mm)(默认80)
pattern_colorstring?

其他

场类型笔记
isbnstringISBN-13;在封底上生成条形码(默认) '')

版本与发布记录

bookcover-core 共发布 28 个版本,首次发布于 2026/07/16;过去 12 个月发布了 28 个版本。

版本发布日期距今
0.24.0latest2026/11/03今天
0.23.02026/10/267 天前
0.22.32026/10/2311 天前
0.22.22026/10/2212 天前
0.22.12026/10/2212 天前
0.22.02026/10/2212 天前

关于 bookcover-core 的常见问题

bookcover-core 是什么?

部分 封套 一代系统。

如何安装 bookcover-core?

在项目目录运行 npm install bookcover-core,或使用 pnpm add / yarn add / bun add。

bookcover-core 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

bookcover-core 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

bookcover-core 可以商用吗?

bookcover-core 使用 MIT-0 许可。声明的许可为 MIT-0,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

bookcover-core 还在维护吗?

最新版本 0.24.0 发布于 2026/11/03(今天);至今共发布 28 个版本,其中过去 12 个月发布了 28 个;首次发布于 2026/07/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。