V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
V2EX 提问指南
sennes
V2EX  ›  问与答

求写'教材'方案推荐

  •  
  •   sennes · 2014-07-10 11:43:04 +08:00 · 2240 次点击
    这是一个创建于 3821 天前的主题,其中的信息可能已经有所发展或是发生改变。
    首先一点是我并没有写过'教材'的经验

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

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

    大家随意讨论,先谢谢大家!
    6 条回复    2014-07-10 13:13:12 +08:00
    multiple1902
        1
    multiple1902  
       2014-07-10 12:17:00 +08:00   ❤️ 1
    reStructuredText 标记语言可以配合 Python 里面的 Sphinx 编写书,它由一个个 reST 的源文件组织起来。可以直接生成 HTML 网页、HTML 网页们以及通过 LaTeX 生成 PDF。对了,涉及中文的 PDF 应该会需要你做一些字体方面的设定,毕竟中文字体没有 universal 的 LaTeX 设置方法。

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

    加油。
    sennes
        2
    sennes  
    OP
       2014-07-10 12:20:18 +08:00
    @multiple1902
    感谢你的diea 谢谢你的鼓励
    我马上去了解一下你提到的 reStructuredText
    forrestchang
        3
    forrestchang  
       2014-07-10 12:21:48 +08:00   ❤️ 1
    Scrivener,可以去了解一下,很强大的写作软件,可以多人协作。
    multiple1902
        4
    multiple1902  
       2014-07-10 12:24:27 +08:00   ❤️ 1
    Python 的官方文档就是用 reST 写的源文件,然后用 Sphinx 组织起来并且生成了整个 HTML 网站。你们的教材也可以这样生成类似的网站,我想这是个很好的形式。

    reST 语言本身还是相当强大的,插图、插源代码、插数学公式、插链接、插引用甚至直接插 HTML 和 LaTeX 源代码都没什么问题(尽管不推荐)。插表格方面应该说功能很强大,但是无论什么标记语言做表格都是很痛苦的,一定要预先想清楚这点。
    stackpop
        5
    stackpop  
       2014-07-10 12:48:33 +08:00   ❤️ 1
    是要出版的书还是线上的,要出版的话还是latex吧
    sennes
        6
    sennes  
    OP
       2014-07-10 13:13:12 +08:00
    @stackpop 目前只打算在校内推广,作为那个老师上课的教材 以后也许会出版普及到各大高校。
    感谢你的建议!
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   3752 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 29ms · UTC 00:13 · PVG 08:13 · LAX 16:13 · JFK 19:13
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.