Question

我想在我的电子阅读器上阅读neo4j手册（特别是对于cypher）作为epub。我该如何创建该文档？鉴于文档是用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文件

Answer 1

我建议你在完整的回购中尝试这个版本：

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

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

这应该会给你一个docbook文件： Neo4j的/手动/目标/ Neo4j的手动-shortinfo.xml 这是PDF构建的那个。请注意，在转换过程中会包含更多文件，因此在处理文件时必须使用xinclude。

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

如何创建neo4j手册作为epub？

1 个答案: