# PowerBook

**Repository Path**: PowerXLab/power-book

## Basic Information

- **Project Name**: PowerBook
- **Description**: 一个高质量的出版水准的理工科书籍模板。山东大学张恒旭编制。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-06
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PowerBook

## 项目简介

PowerBook 是由山东大学电力系统宽频感知与稳定控制团队编制的理工科书籍 LaTeX 模板，面向教材、学术专著、技术报告和科研成果整理等场景。

当前仓库提供了一套可直接编译的样稿工程，包含封面、扉页、前言、目录、图表目录、算法目录、参考文献、术语表和索引等书籍常见组成部分，可作为新项目的起点模板。

## 仓库地址

- 开源地址：https://gitee.com/PowerXLab/power-book.git

## 联系方式

- 联系人：张恒旭
- 邮箱：zhanghx@sdu.edu.cn

## 模板结构

- `powerbook.cls`：模板类文件，定义整体版式、封面样式和书籍组件。
- `powerbook.tex`：主入口文件，用于设置书名、作者、封面信息并组织各章节内容。
- `preamble/powerbook-setup.tex`：导言区配置，集中放置宏包、定理环境、术语和参考文献等设置。
- `chapters/`：章节内容示例。
- `images/`：封面和正文插图资源。
- `reference.bib`：参考文献数据库文件。
- `build-powerbook.bat`：Windows 环境下一键编译脚本。

## 环境要求

- 建议安装完整的 TeX Live 或 MiKTeX。
- 需要确保以下命令可在终端直接使用：`xelatex`、`biber`、`makeindex`。
- 如使用 VS Code，建议安装 LaTeX Workshop 扩展以获得保存自动编译、配方管理和 PDF 预览能力。

## 编译方式

### 方法一：使用批处理脚本

在仓库根目录执行：

```bat
build-powerbook.bat
```

该脚本会按以下顺序完成编译：

1. XeLaTeX 第 1 轮。
2. Biber 处理参考文献。
3. 如存在索引或术语表，自动调用 MakeIndex。
4. XeLaTeX 第 2 轮和第 3 轮，用于刷新交叉引用、目录和页码。

编译成功后会在根目录生成 `powerbook.pdf`。

### 方法二：使用 VS Code

仓库已提供 LaTeX Workshop 的工作区设置。打开项目后，以 `powerbook.tex` 作为主文档保存编译，或手动选择以下配方：

- `xelatex`
- `xelatex -> biber -> xelatex*2`

## 使用说明

1. 在 `powerbook.tex` 中修改书名、作者、机构、出版社、封面图片等元数据。
2. 在 `chapters/` 目录中编写或新增章节，并通过 `\include{...}` 将章节纳入主文档。
3. 在 `preamble/powerbook-setup.tex` 中维护导言区设置，如公式、定理、术语和参考文献样式。
4. 将封面图、Logo 和正文插图放入 `images/` 目录，并在文档中引用。
5. 在 `reference.bib` 中维护文献条目，编译时由 Biber 自动处理。

## 适用说明

- 模板当前以中文理工类图书样稿为基础进行设计和演示。
- 仓库中的内容既可用于直接试编，也可作为后续项目二次定制的基础。
- 如需扩展封面风格、版芯参数或章节样式，可在 `powerbook.cls` 中进一步调整。

## 参与贡献

欢迎围绕模板功能、排版细节、样稿内容和文档说明提出 issue 或改进建议；如需协作维护，也可以基于仓库自行 fork 后提交修改。