2

我想在我的电子阅读器上以 epub 形式阅读 neo4j 手册（尤其是 cypher 手册）。如何创建该文档？鉴于文档是用 asciidoc 编写的，它应该是可能的。

尝试使用 a2x (8.6.8) 直接创建 epub：

cd manuals/src
a2x -fepub -dbook neo4j-manual.asciidoc

结果是：

a2x: ERROR: "xmllint" --nonet --noout --valid "/home/joerg/projects/neo4j/tmp/neo4j/manual/src/neo4j-manual.xml" returned non-zero exit status 1

即使只是创建文档（在构建 neo4j 之后）对我来说也失败了：

git clone git@github.com:neo4j/neo4j.git
cd neo4j/manual
mvn clean install

给我：

ERROR] Failed to execute goal org.neo4j.build.plugins:license-maven-plugin:3:check (check-licenses) on project neo4j-manual: Some files do not have the expected license header ->

那么，有什么想法可以创建 epub 吗？

解决方案

nawroth 指出了解决方案。这是我最后所做的：

apt-get install dbtoepub
git clone https://github.com/neo4j/neo4j.git
cd neo4j
mvn clean install -DdocsBuild -Ddebug -Dlicense.skip=true -Dlicensing.skip
cd manual/cd target/
ln -s src/images .
dbtoepub neo4j-manual-shortinfo.xml

我在https://baach.de/Members/jhb/neo4j-manual-as-epub上包含了创建的 neo4j.epub 文件

4

1 回答 1

1

我建议你在完整的 repo 上尝试这个构建：

mvn clean install -DdocsBuild -Ddebug -Dlicense.skip=true -Dlicensing.skip

-DdocsBuild 将确保所有模块都生成特殊的 *-docs.jar。-Ddebug 将使手册的构建保留 docbook 文件。

这应该为您提供一个 docbook 文件： neo4j/manual/target/neo4j-manual-shortinfo.xml ，这是构建 PDF 的文件。请注意，在转换过程中还会包含更多文件，因此在处理文件时必须启用 xinclude。

我还没有考虑发布到 epub，但上面至少应该给你一个有效的 docbook 文件来玩！

于 2013-08-06T13:33:47.353 回答