Pipeline für das Schreiben eines Buches für Programmierer in einer Zusammenarbeit

Question

Ich bin Mitglied einer Gruppe von Enthusiasten Schriftsteller, die beschlossen, an einem Kochbuch-Stil Buch für eine der Programmiersprachen zusammenzuarbeiten.

Wir versuchen, eine Pipeline für die Zusammenarbeit auszuwählen.

Ich mag, wie ProGit gemacht wird.

Das ist Markdown + einige benutzerdefinierte Vorverarbeitung, von Pandoc verarbeitet. Aber ich mache mir Sorgen, dass Markdown für unseren Fall zu einfach ist. Ich sehe Sphinx, aber ich habe keine Erfahrung damit.

Ich weiß, dass LaTeX funktionieren würde - aber ich befürchte, dass es die Mitwirkenden abschrecken wird. Es kann auch zu mächtig und zu einfach sein, um eine byzantinische Pipeline aufzubauen, wenn Sie nicht die nötige Erfahrung haben (was ich nicht kann).

Bitte verwenden Sie keine Lösungen vorschlagen, wo eine Person haben XML von Hand zu schreiben oder müssen verwenden, um einige spezifische GUI (optional erhältlich GUIs sind gut, natürlich). Kommerzielle und nicht-plattformübergreifende Lösungen sind ebenfalls keine Option.

Answer 1

Es ist schwer zu sagen, ob pandocs erweiterte Version von Markdown zu einfach für Ihren Fall wäre, wenn Sie nicht sagen, welche Funktionen Sie benötigen. Beachten Sie auch, dass Sie, wenn Sie ein wenig einfaches Haskell-Scripting ausführen können, die Funktionen pandoc API zum Hinzufügen von Features verwenden können.