合作为程序员撰写书籍的管道
我是一群狂热作家中的一员，他们决定合作为一种编程语言编写一本食谱风格的书。
我们正在尝试选择合作渠道。
我喜欢 ProGit 的制作方式。
那就是Markdown+一些自定义的预处理，由Pandoc处理。但我担心 Markdown 对于我们的案例来说太简单了。
我查看了 Sphinx，但我没有使用它的经验。
我知道 LaTeX 会起作用——但我担心它会吓跑贡献者。此外，如果您没有必要的经验（我没有），那么构建拜占庭式管道可能会太强大且太容易。
请不要建议人们必须手动编写 XML 或必须使用某些特定 GUI（当然，可选的 GUI 也很好）的解决方案。商业和非跨平台解决方案也不是一个选择。
I'm a member of a group of enthusiast writers, who decided to collaborate on a cookbook-style book for one of programming languages.
We're trying to pick a pipeline for the collaboration.
I like how ProGit is made.
That is Markdown + some custom pre-processing, processed by Pandoc. But I'm concerned that Markdown is too simple for our case.
I look at Sphinx, but I have no experience using it.
I know that LaTeX would work — but I'm afraid that it will scare off the contributors. Also it may be too powerful, and too easy to build a byzantine pipeline if you don't have the necessary experience (which I do not).
Please do not suggest solutions where a person have to write XML by hand or must use some specific GUI (optionally available GUIs are good, of course). Commercial and non-crossplatform solutions are not an option as well.
如果你对这篇内容有疑问，欢迎到本站社区发帖提问 参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱，如果其他用户或者作者回复了您的评论，将不能在第一时间通知您！
发布评论
评论（1）
很难说 pandoc 的 markdown 扩展版本对于您的情况是否太简单，除非您说出您需要什么功能。另请注意，如果您能够执行一些非常简单的 Haskell 脚本，则可以使用 pandoc API 添加功能。
It's hard to say whether pandoc's extended version of markdown would be too simple for your case unless you say what features you need. Note also that, if you're able to do a bit of very simple Haskell scripting, you can use the pandoc API to add features.