这是一个创建于 3789 天前的主题，其中的信息可能已经有所发展或是发生改变。
首先一点是我并没有写过'教材'的经验
近期内打算与老师为 '数字系统设计' 这门课编写一套 '教材'
原因是老师想一改以前那种教学方式 所以想尝试编写一套 '教材' 并且设计配套的硬件来学习
*这门课中需要用到大量的verilog语言 并且有硬件要学生实际操作
\
所以这个教材编写我想有以下问题：
1. 有什么软件推荐? 实在不想使用word来写(因为代码高亮有点难实现?)
2. 使用markdown语言写不知道合不合适(因为实际上和写编程语言的教程差不多)
3. 有想过用farbox的wiki功能
4. 可能有数名编写者 该如何实现合作编写?
5. 应该会印刷少量的教材作为本校课程使用 不过排斥使用非实体书的形式做'教材'
*不知道大家有没有什么idea可以推荐(我自己有一些想法但是更想听听大家的idea)
//或者大家顺便可以讨论一下:"如果你要给一门编程语言写教程 你会怎么实现"
大家随意讨论，先谢谢大家!
近期内打算与老师为 '数字系统设计' 这门课编写一套 '教材'
原因是老师想一改以前那种教学方式 所以想尝试编写一套 '教材' 并且设计配套的硬件来学习
*这门课中需要用到大量的verilog语言 并且有硬件要学生实际操作
\
所以这个教材编写我想有以下问题：
1. 有什么软件推荐? 实在不想使用word来写(因为代码高亮有点难实现?)
2. 使用markdown语言写不知道合不合适(因为实际上和写编程语言的教程差不多)
3. 有想过用farbox的wiki功能
4. 可能有数名编写者 该如何实现合作编写?
5. 应该会印刷少量的教材作为本校课程使用 不过排斥使用非实体书的形式做'教材'
*不知道大家有没有什么idea可以推荐(我自己有一些想法但是更想听听大家的idea)
//或者大家顺便可以讨论一下:"如果你要给一门编程语言写教程 你会怎么实现"
大家随意讨论，先谢谢大家!
 |
1
multiple1902 2014-07-10 12:17:00 +08:00  1
reStructuredText 标记语言可以配合 Python 里面的 Sphinx 编写书，它由一个个 reST 的源文件组织起来。可以直接生成 HTML 网页、HTML 网页们以及通过 LaTeX 生成 PDF。对了，涉及中文的 PDF 应该会需要你做一些字体方面的设定，毕竟中文字体没有 universal 的 LaTeX 设置方法。
提到合作，如果大家都会版本控制的话是最好，否则可能就得做好分工上的隔离。对了，reST 是可以做 include 的，也就是说你们写的内容可以弄得更细。 加油。 |
 |
2
sennes OP |
 |
3
forrestchang 2014-07-10 12:21:48 +08:00 1
Scrivener,可以去了解一下，很强大的写作软件，可以多人协作。
|
|
4
multiple1902 2014-07-10 12:24:27 +08:00 1
Python 的官方文档就是用 reST 写的源文件，然后用 Sphinx 组织起来并且生成了整个 HTML 网站。你们的教材也可以这样生成类似的网站，我想这是个很好的形式。
reST 语言本身还是相当强大的，插图、插源代码、插数学公式、插链接、插引用甚至直接插 HTML 和 LaTeX 源代码都没什么问题（尽管不推荐）。插表格方面应该说功能很强大，但是无论什么标记语言做表格都是很痛苦的，一定要预先想清楚这点。 |
 |
5
stackpop 2014-07-10 12:48:33 +08:00 1
是要出版的书还是线上的，要出版的话还是latex吧
|
Select Language