如何以epub創建neo4j手冊？

我想在我的電子閱讀器上閱讀neo4j手冊（尤其是cypher）作爲epub。我如何創建文檔？鑑於文檔是用asciidoc編寫的，它應該是可能的。如何以epub創建neo4j手冊？

試圖直接與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 [email protected]: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

來源

2013-08-05 Joerg Baach

創建neo4j.epub文件我建議你嘗試在全回購此版本：

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

-DdocsBuild將確保所有模塊生成特殊的* -docs.jar。 -Ddebug將使該手冊的內部版本保持docbook文件。

這應該給你一個DocBook文件： 的Neo4j /手動/目標/的Neo4j-手動shortinfo.xml 這是一個PDF從建造。請注意，轉換過程中會包含更多的文件，因此在處理文件時xinclude必須是enbled。

我還沒有研究出版的又EPUB，但上面至少應該給你一個有效的DocBook文件一起玩！

來源

2013-08-06 13:33:47 nawroth

thx，會嘗試。 –

這很棒！非常感謝。將更新我的問題以包含解決方案。 –

還有的是文檔的相當量的修復的最後日子裏，你可能想建立自己新的手冊。下面是我們渲染PDF時的docbook的應用額外的定製層：https://github.com/neo4j/doctools/blob/master/src/main/resources/conf/fo.xsl 具體來說，它會刪除一些元素僅用於html：也許我可以讓他們走出一個不同的步驟，必須考慮到這一點。 – nawroth

如何以epub創建neo4j手冊？

回答

相關問題