我如何创建neo4j手册作为一个电子酒吧？

Question

我想在我的电子阅读器上把neo4j手册(特别是密码手册)作为一个电子酒吧来阅读。我如何创建这个文档？考虑到文档是用asciidoc编写的，这应该是可能的。

尝试使用a2x直接创建电子酒吧(8.6.8)：

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 ->

那么，有什么想法我可以创建的电子酒吧吗？

溶液

纳罗斯指出了解决办法。以下是我最后所做的：

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上包含了创建的https://baach.de/Members/jhb/neo4j-manual-as-epub文件

Answer 1

我建议你在完全回购的基础上试一试：

清洁安装-DdocsBuild -Ddebug -Dlicense.skip=true -Dlicensing.skip

-DdocsBuild将确保所有模块生成特殊的*-docs.jar。-Ddebug将使手册的构建保持在文档文件的周围。

这将在: neo4j/manual/target/neo4j-manual-shortinfo.xml中为您提供一个docbook文件，该文件是由PDF构建的。请注意，在转换过程中还有几个文件会被包括在内，所以在处理文件时必须增加xinclude。

我还没有研究过发布到epub，但上述至少应该给您一个有效的docbook文件，以供使用！