序言

您好。 这是bookbuilderpy软件工具套件提供的所有特性的最小工作示例。 bookbuilderpy在pypi上以Python包的形式提供。 bookbuilderpy也可以作为docker镜像提供，其中已经安装了所有必要的库。

你可以用这个例子作为你自己制作书的蓝图。

作为引用的例子，我引用了我的旧书[1]。 该引用随后被解析为文件bibliography.bib中的BibTeX记录。 您后可子看章1。

1 弟子章

欢迎欢迎，弟子章来了。

1.1 这是第一章的第一节

使用#，你可以开始一个章节的标题，例如在章1。 使用##，你可以开始一个节的标题，例如在章1.1。 ###开始一个分段，依此类推。

先看图1.1把。

现在看方程式1.1把。 我们也可以直接在文本中包含数学公式。 我们也可写。

表1.1有好多的意思。 定义也可以包含在文本中并从文本中引用。 例如，请看下面的定义 1。

def log(message):
    print(f"{datetime.datetime.now()}: {message}")

def log(message: str) -> None:
    """
    Write a message to the log.

    :param str message: the message
    """
    print(f"{datetime.datetime.now()}: {message}")

源代码1.1是一个本地代码文件。 此文件与本章的markdown文件在同一个文件夹中。 源代码1.2这是一个来自GitHub的文件。 该文件来自元数据中声明的Git存储库bb。

你可以通过命令meta访问元数据。 下面我们来举几个例子：

1. 关于书本身的元数据：
   • 这本书的标题（title）：中文书
   • 这本书的作者（author）：Thomas Weise
   • 书的关键词（keywords）：中文,书
2. 关于当前日期和时间的元数据：
   • 时间（time）：2022‑11‑01 05:29 UTC
   • 日期（date）：2022‑11‑01
   • 年（year）：2022
3. 语言：
   • lang：zh
   • locale：zh_CN
   • lang.name：中文
4. 只有当本书被写成git仓库时，与仓库相关的元数据才可用:
   • repo.name：thomasWeise/bookbuilderpy-mwe
   • repo.url：https://github.com/thomasWeise/bookbuilderpy-mwe
   • repo.commit：b24990965fbefa9228db4f26bee1f0e7fe6dd8cd
   • repo.date：2022‑11‑01 13:27 UTC+08:00
5. 使用存储库键和存储库信息查询，可以通过命令repo访问外部存储库信息¹：
   • 密钥bb的repo.name：thomasWeise/bookbuilderpy-mwe
   • 密钥bb的repo.commit：b24990965fbefa9228db4f26bee1f0e7fe6dd8cd
   • 密钥bb的repo.date：2022‑11‑01 13:27 UTC+08:00

参考文献