我想在我的电子阅读器上阅读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
上添加了创建的neo4j.epub文件
答案 0 :(得分: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文件来玩!