求写'教材'方案推荐

[sennes]

首先一点是我并没有写过'教材'的经验

近期内打算与老师为 '数字系统设计' 这门课编写一套 '教材'
原因是老师想一改以前那种教学方式 所以想尝试编写一套 '教材' 并且设计配套的硬件来学习
*这门课中需要用到大量的verilog语言 并且有硬件要学生实际操作
\
所以这个教材编写我想有以下问题：
1. 有什么软件推荐? 实在不想使用word来写(因为代码高亮有点难实现?)
2. 使用markdown语言写不知道合不合适(因为实际上和写编程语言的教程差不多)
3. 有想过用farbox的wiki功能
4. 可能有数名编写者 该如何实现合作编写?
5. 应该会印刷少量的教材作为本校课程使用 不过排斥使用非实体书的形式做'教材'
*不知道大家有没有什么idea可以推荐(我自己有一些想法但是更想听听大家的idea)

//或者大家顺便可以讨论一下:"如果你要给一门编程语言写教程 你会怎么实现"

大家随意讨论，先谢谢大家!

[multiple1902]

reStructuredText 标记语言可以配合 Python 里面的 Sphinx 编写书，它由一个个 reST 的源文件组织起来。可以直接生成 HTML 网页、HTML 网页们以及通过 LaTeX 生成 PDF。对了，涉及中文的 PDF 应该会需要你做一些字体方面的设定，毕竟中文字体没有 universal 的 LaTeX 设置方法。

提到合作，如果大家都会版本控制的话是最好，否则可能就得做好分工上的隔离。对了，reST 是可以做 include 的，也就是说你们写的内容可以弄得更细。

加油。

[sennes]

@multiple1902
感谢你的diea 谢谢你的鼓励
我马上去了解一下你提到的 reStructuredText

[forrestchang]

Scrivener,可以去了解一下，很强大的写作软件，可以多人协作。

[multiple1902]

Python 的官方文档就是用 reST 写的源文件，然后用 Sphinx 组织起来并且生成了整个 HTML 网站。你们的教材也可以这样生成类似的网站，我想这是个很好的形式。

reST 语言本身还是相当强大的，插图、插源代码、插数学公式、插链接、插引用甚至直接插 HTML 和 LaTeX 源代码都没什么问题（尽管不推荐）。插表格方面应该说功能很强大，但是无论什么标记语言做表格都是很痛苦的，一定要预先想清楚这点。

[stackpop]

是要出版的书还是线上的，要出版的话还是latex吧

[sennes]

@stackpop 目前只打算在校内推广，作为那个老师上课的教材 以后也许会出版普及到各大高校。
感谢你的建议!