« 求助：需要一份 /etc/default/locate 文件

HDSentinel：你的硬盘健康吗？ »

LinuxTOY 是一个致力于提供 Linux 相关资讯的专题站点。如果您发现了好用好玩的 Linux 东东并愿意发扬自由、分享的精神，可以点击顶部导航 Contact 按钮进行投稿。

Related entries

开源世界旅行手册－内部交流版 (附精美海报一张)

2008-11-09 Kardinal Posted in BooksRSS

这是一块不折不扣的砖
show 出你货真价实的玉
(标题前有空格的章节，为没有完成的内容，欢迎同道赐稿)

guide.jpg
(点击可放大)

在线阅读开源世界旅行手册

下载地址：开源世界旅行手册

—-订正————–
(r0bertz)
《如何写作科技文档》中第一个例子来源于gentoowiki

(逸飞)
环境变量使用白底黄字，容易引起视觉疲劳
docbook.css文件中找到 yellow 替换成 orange

(zer4tul)
《无根的根》为《UNIX编程艺术》一书附录。原作者不详

《如何写作科技文档》
-2行：但是使用脚注 => 但是使用Calloutlist

署名 • 注明出处 • 非商业性使用

65 Comments

  1. 1 fangvv Commented @ 2008-11-09 1:54 pmReply to this comment

    不错,支持!

  2. 2 逸飞 Commented @ 2008-11-09 2:12 pmReply to this comment

    浏览了一下，几个环境变量如$PATH显示成白底黄字，看得不舒服

  3. 3 Kardinal Commented @ 2008-11-09 2:22 pmReply to this comment

    抱歉抱歉……忘了改……因为出现的不多，也没有太在意……

    Toy兄帮忙改下CSS文件，给改成橙色的吧^_^!!

    已下载的朋友，在docbook.css文件中找到 yellow 替换成 orange ；或者其它随便什么颜色，麻烦了……

  4. 4 michael Commented @ 2008-11-09 2:27 pmReply to this comment

    辛苦了。支持

  5. 5 Christian Commented @ 2008-11-09 2:42 pmReply to this comment

    支持啊，下来看看怎么样！

  6. 6 ideal Commented @ 2008-11-09 2:50 pmReply to this comment

    写得很好啊，这种风格很喜欢

  7. 7 allbluedream Commented @ 2008-11-09 2:55 pmReply to this comment

    好东西，这个要多多宣传

  8. 8 Toy Commented @ 2008-11-09 3:03 pmReply to this comment

    @Kardinal: 已改 :)

  9. 9 LanEast Commented @ 2008-11-09 3:39 pmReply to this comment

    还没完成啊?等完成了再下了.

    另: 海报果然很精美 :D

  10. 10 aaron lee Commented @ 2008-11-09 4:26 pmReply to this comment

    超赞！！！
    组织，逻辑，表达手法都不错！中国人的智慧。

  11. 11 gcell Commented @ 2008-11-09 4:48 pmReply to this comment

    极好，值得Fedora借鉴！

  12. 12 zer4tul Commented @ 2008-11-09 5:00 pmReply to this comment

    无名的根……很经典的文章。

  13. 13 Rex Commented @ 2008-11-09 5:20 pmReply to this comment

    支持，很好的集思广益的东西

  14. 14 imagelife Commented @ 2008-11-09 5:36 pmReply to this comment

    赞，好文！

  15. 15 HiugongGwok Commented @ 2008-11-09 6:51 pmReply to this comment

    您忘了在封面写上大大的“DON‘T PANIC”。

  16. 16 YCF_name Commented @ 2008-11-09 8:24 pmReply to this comment

    好文，支持！

  17. 17 雪梨 Commented @ 2008-11-09 8:49 pmReply to this comment

    建议中文和英文间加上半角空格

  18. 18 Kardinal Commented @ 2008-11-09 9:05 pmReply to this comment

    谢谢大家支持。请在支持的同时多提宝贵意见，帮忙找点错别字也是好的啊^_^!!……
    刚才随便翻了几下，光错别字就找到N处^_^!!不过忘了记下来，回头整个勘误
    @LanEast：用Gimp简单处理了下……别的也不会了……
    建议兄弟还是下了吧，因为一时半会好像还完成不了……而且最近可能会歇一阵，捣鼓点其它的东东玩(当然也要看情况，如果问题太多，肯定会迅速修正的)
    @aaron lee：过了哈，过了……兄弟哪里人啊？^_^
    @gcell:Fedora没怎么用过，里面有一个介绍发行版的章节……不过我还没想好怎么写
    @zer4tul：无根的根……这章我复制粘贴的，《unix编程艺术》里面的附录……好像这文章很有名的说……
    回头我会注明一下出处……
    @HiugongGwok：恕我愚钝，这句话有什么深意么？封面我想保持干净，除了目录和致敬之外，不保留其它内容了……不过我正在琢磨，给每一章加一个题记，像Emacs章前面的那种
    这句话作archlinux章的题记合适不？
    @雪梨：老兄，不好意思，说的晚了点……等找到足够多的错误，我再一块改吧^_^

  19. 19 nsgoh Commented @ 2008-11-09 10:12 pmReply to this comment

    尔～！
    这个的完成度有多少？ 大略看了一下。。。好多空的。
    加油～！

  20. 20 konit Commented @ 2008-11-09 10:21 pmReply to this comment

    哈 寫得不錯，有文采，有想法，加油啊~

  21. 21 tunpishuang Commented @ 2008-11-09 10:21 pmReply to this comment

    图很强大

  22. 22 froons Commented @ 2008-11-09 10:45 pmReply to this comment

    从目录来看 内容的组织很不错，我会一页页地看的，不知道什么时候能出“完整”版的？我看到有些页面是空的。

  23. 23 tangooricha Commented @ 2008-11-09 10:58 pmReply to this comment

    原来Toy叫做徐小东啊！

  24. 24 AnThOnYhO Commented @ 2008-11-09 11:47 pmReply to this comment

    支持

  25. 25 keenan chen Commented @ 2008-11-10 12:12 amReply to this comment

    希望做成PDF，谢谢～

  26. 26 eric Commented @ 2008-11-10 5:48 amReply to this comment

    @keenan chen:
    汗，原本打算作一个的，可惜做的面目全非。就不拿出来献丑了。

  27. 27 Kardinal Commented @ 2008-11-10 11:20 amReply to this comment

    谢谢各位支持^_^
    @nsgoh：这个文档的完成度，主要取决于第二部分的完成度，这部分是相对固定的内容……因为第二部分完成的差不多了……
    其它部分的内容可能会有比较大的调整，而且过程会比较长
    @konit：俺很有动力了^_^
    @tunpishuang：很山寨吧嘿嘿
    @froons：最近可能要放一放，CTeX论坛的liyanrui版主在得知我对TeX很有兴趣后，给予热情的指导，所以我要先学习一下TeX，如果我能学得差不多，争取整理一个教程出来^_^
    @keenan chen & eric：是否Calloutlist在PDF中难以处理？^_^!!
    PDF文件体积比较大，不太方便交流；而这个文档现在还不太正式……
    最近会学习一些相关知识，等教程比较完备了，会考虑发布PDF版

  28. 28 Kardinal Commented @ 2008-11-10 11:44 amReply to this comment

    PS:有什么需要讨论的可以直接给我发邮件 2999am AT gmail.com

  29. 29 pptp Commented @ 2008-11-10 11:50 amReply to this comment

    好东西，期待全本下载

  30. 30 HiugongGwok Commented @ 2008-11-10 12:47 pmReply to this comment

    看来Kardinal没看过《银河系漫游指南》：
    http://en.wikipedia.org/wiki/Don‘t_Panic_(Hitchhiker’s_Guide_to_the_Galaxy)#Don.27t_Panic

  31. 31 Leo Commented @ 2008-11-10 12:49 pmReply to this comment

    不错，支持！
    建议做成chm和pdf的。。

  32. 32 iveney Commented @ 2008-11-10 1:01 pmReply to this comment

    支持！

  33. 33 Kardinal Commented @ 2008-11-10 1:03 pmReply to this comment

    @pptp：可能我比你更期待^_^!!
    @ HiugongGwok ：刚下载了一本，很不错的样子，有空看看……
    不过我现在对有冗长情节的读物不太感冒，除了《火影忍者》^_^!!……电视剧之类的，情节长点还能接受
    ……在我看来，所有带情节的东西，讲的不外是两件事：1.人性 2.结果呢？
    其实我最喜欢的读物是《国家地理》之类的东东……
    @Leo：chm只不过是把许多html页面打包在一起……有什么区别么？^_^!!

  34. 34 Hop Lee Commented @ 2008-11-10 1:57 pmReply to this comment

    目录中章节编号与章节标题之间的水平距离不整齐，一会大一会小。

  35. 35 Kardinal Commented @ 2008-11-10 2:10 pmReply to this comment

  36. 36 Kardinal Commented @ 2008-11-10 2:11 pmReply to this comment

    前面有空格的标题是没有完成的^_^!!

  37. 37 HiugongGwok Commented @ 2008-11-10 2:59 pmReply to this comment

    @Kardinal
    要想看得快有电影啊，2005年的 ，imdb 6.6，名字一样。
    也有电视剧，不过年代久远，不好找了。

  38. 38 Kardinal Commented @ 2008-11-10 3:14 pmReply to this comment

    @HiugongGwok：2005年的……现在还能下载来么？要是今天能下载下来，晚上回去看……
    多谢了^_^

  39. 39 dogfox Commented @ 2008-11-10 5:31 pmReply to this comment

    最冂的一句:眼睛一亮. -_- !
    明显的语言缺乏~~~

  40. 40 食古不化 Commented @ 2008-11-10 7:46 pmReply to this comment

    非常的不错！

  41. 41 Jarod Commented @ 2008-11-10 8:14 pmReply to this comment

    我的从第一章以后显示不了具体文章内容，只有个标题和文章转向链接……

  42. 42 Kardinal Commented @ 2008-11-10 10:02 pmReply to this comment

    @dogfox：都说了是复制粘贴的^_^!!
    其实这不是语言缺乏，而是有意为之。《无根的根》是模仿著名的禅宗读物《无门之门》体式写的……类似的，尼采也写过一部格言体的小册子《查拉图斯特拉如是说》，也有一些朴拙的话一再重复，但作为哲学家和诗人的尼采，显然不能算是语言缺乏……
    可以说，能驾驭这种风格的作者，已然立于万山之颠；作为反例，看看流传最广的著作，没有以词藻的华丽而闻名的……夏多布里昂之流公认妙笔生花的作家，反而鲜为人知
    @ 食古不化 ：非常的感谢γ^_^γ
    @Jarod：前面几章的内容不是最重要的……还没有完成

  43. 43 Amy Hyde Commented @ 2008-11-10 11:22 pmReply to this comment

    写得不错，支持一下，希望能早些完成，也希望更多的人参与进来!

  44. 44 r0bertz Commented @ 2008-11-11 12:51 amReply to this comment

    啥也不说，先贴3个连接
    http://linuxtoy.org/docs/guide/pr03.html
    http://www.gentoo.org/doc/zh_cn/handbook/handbook-x86.xml?part=2&chap=2#doc_chap2
    http://www.linuxsir.org/bbs/thread337466.html

    希望以后再用别人的东西的时候，给别人应有的credit
    现在用了的，还没有补上的，请补上，谢谢

    最后，good luck to your endeavour！

  45. 45 r0bertz Commented @ 2008-11-11 10:42 amReply to this comment

    http://www.linuxsir.org/bbs/showthread.php?p=1906975#post1906975

  46. 46 Kardinal Commented @ 2008-11-11 11:00 amReply to this comment

    ……锁贴，解锁跟贴，再锁贴……确实不敢去那个地方了^_^!!
    我已按他们的要求注明出处了，见《补遗》，有一处屏幕输出的内容，等我有空了找个实例替换(现在还不是开公发布，只是内部交流)
    关于pr03页内容，如果你们希望注明出处，我绝对欣然从命
    PS:我会按照惯例处理这部分内容，其它的没有讨论的必要

  47. 47 MDZ Commented @ 2008-11-11 8:54 pmReply to this comment

    勘误 1：第一章第 9 节的“reStructureTEXT 还是 DocBook”中“reStructureTEXT”应该是“reStructuredTEXT”吧，少了个“d”。

    http://docutils.sourceforge.net/rst.html

  48. 48 Kardinal Commented @ 2008-11-11 9:15 pmReply to this comment

    多谢兄弟^_^
    其实我正在考虑要不要把reST这部分去掉。因为本来使用就简单，而且用的人似乎不多……
    最近在学ConTeXt，如果顺利，回头加入关于ConTeXt的介绍……
    要是兄弟有什么好的建议，可以直接给我发邮件

  49. 49 r0bertz Commented @ 2008-11-11 11:08 pmReply to this comment

    http://www.linuxsir.org/bbs/thread337466-5.html
    我要说明的是，最后一帖不是我操作的
    是发帖人重新开了一帖
    然后某版主（不是我），为了版面整洁，把原来的锁贴打开，然后合并的

    另外，我对“内部版可以不给出处”这一解释感到非常不解
    既然都已经给人看了，何以还是内部版？
    如果是我写书，如果我引用的别人的东西，我会第一时间给出脚注，就像这样
    http://www.testlab.com.cn/html/qiyejisuan/20081021/1184.html
    这样做，一是省得后来补记的时候找不到地方，二是可以令自己的论断更有依据，三就是可以避免类似这样的争抝

    “关于pr03页内容，如果你们希望注明出处，我绝对欣然从命”
    事实就是你拷贝了别人的东西，为什么需要别人希望之后，自己才去注明出处

  50. 50 r0bertz Commented @ 2008-11-11 11:10 pmReply to this comment

    《如何写作科技文档》中第一个例子来源于gentoowiki

    错了，是gentoo中文手册
    另外请加上手册地址

  51. 51 shuge.lee Commented @ 2008-11-11 11:49 pmReply to this comment

    1 这本书很明显没有标明是以什么许可方式发布，是“保留所有权利”，还是http://creativecommons.org/licenses/by-nc-sa/2.5/cn/

    2 好像删除了一些东西，莫非就因为有人提过意见？ 提 GNU/Linux，哪能不提 portage 的……

  52. 52 Kardinal Commented @ 2008-11-12 8:21 amReply to this comment

    @r0bertz：等下次放出的时候一起订正。编辑这个页面挺麻烦……
    @shuge.lee：暂时为“署名 • 注明出处 • 非商业性使用”
    不过我可以保证，如果有变动，只会比现在更为宽松^_^

    因为还有一些重要章节没有完成，所以只是作为内部交流，让老手们给看看，提提意见(其实主要是面向新手的)

    这个文档并不针对某一特定发行版。不过，里面有些内容是以前用ubuntu的时候写的，还没有调整……

    欢迎兄弟来人来涵，随时指教：)

  53. 53 Kardinal Commented @ 2008-11-12 8:44 amReply to this comment

    http://creativecommons.org/licenses/by-nc-sa/2.5/cn/
    这个页面中的许可方式不错，就用这个吧

    这个得解释一下：
    这个手册的前身《ubuntu教程》，并没有要求署名转载
    但是有些同志有点过了，把文档的名称都改了^_^!!
    其中有一个PDF的版本叫作《ubuntu部落》，我比较喜欢这个名称。而且转换成PDF要费点力气，发布者还加了些命令手册之类的东西(其实是不必要的，《核心工具集》部分的内容经过仔细的整理，连命令的参数都按使用频率排列好了)
    (我使用《ubuntu教程》的名称，并不是因为我觉得这个名称好，而是因为这样有利于传播。对于这个名称，其实我是不满意的)
    我还知道有一个版本叫作《ubuntu完全教程》……“完全”这两个字与我实际的意图是“完全”不一样的^_^!!
    发布者似乎没有在里面添加、修改过什么内容，而只在标题里加“完全”两个字，这种作法我没有办法恭维……
    (对于《ubuntu教程》这样的名称，我已经不太满意。《完全教程》的名称，比原来的名称更加恶趣味，却不如原名更加利于传播……)

    兄弟提到的这种授权方式，着眼点是保护版权不被占据
    而我的根本目的是物尽其用，对于一个文档来说，被最大程度的传播阅读是最重要的
    如果过于宽松的授权不能促进它被正确的使用，那么还是按照惯常的作法处理好了

  54. 54 Kardinal Commented @ 2008-11-12 11:29 amReply to this comment

    @r0bertz：
    “关于pr03页内容，如果你们希望注明出处，我绝对欣然从命”
    事实就是你拷贝了别人的东西，为什么需要别人希望之后，自己才去注明出处
    －－－－
    ……可能是我的中文水平有问题……如果你能全权代表，并且认为第一个例子是正面教材，我当然不介意加个链接
    当然，只能在脚注中添加，这是底线。举例说明：
    QQ(深圳腾讯公司荣誉产品)我一般不用，因为我的系统是Linux(FSF&Linus荣誉出品，开源世界智慧的结晶)，所以我喜欢用Gmail(伟大的奉行“不作恶”原则的互联网企业google荣誉出品)和朋友联系……
    如果你认为这样的话可以读，我也写不出来

  55. 55 MDZ Commented @ 2008-11-12 12:42 pmReply to this comment

    @Kardinal: 发了第 2 个“勘误”在你的邮箱了：2999am@gmail.com。今后在阅读过程中的勘误就都发到这个邮箱去，好吧？:-)

  56. 56 Kardinal Commented @ 2008-11-12 2:14 pmReply to this comment

    多谢兄弟^_^
    回头我在《前言》之前，弄个单独的页面，凡是找到错误的兄弟，都把名字写进去γ^_^γ

  57. 57 Rainux Commented @ 2008-11-12 3:58 pmReply to this comment

    发勘误 Email 效率低，可否考虑使用 wiki 方式？

  58. 58 Kardinal Commented @ 2008-11-12 9:23 pmReply to this comment

    @Rainux：其实我也在考虑如何协作的问题
    协作中比较重要的是交流。交流有很多层面，而不只是勘误
    wiki主要作用应该是版本控制吧，这方面有很多更好的选择；而且我对wiki不熟悉^_^!!
    主要是没有一个活动场地^_^ 所以临时只能用邮件了

  59. 59 r0bertz Commented @ 2008-11-12 10:57 pmReply to this comment

    你这算是恐吓么？
    你不妨说说你这“书”里已经有了哪几个章节？
    又有哪几个章节完全是你自己从头开始写的？

  60. 60 Kardinal Commented @ 2008-11-13 8:54 amReply to this comment

    @r0bertz:这算恐吓？得，我承认我中文水平真的不行
    我的意思是，如果你觉得《如何》一文中使用的例子，能起到良好的宣传效果，我会加入链接

    哪章是从头开始写的？
    《病毒》一章中，引用了《Unix编程艺术》中的一些材料，有时间再处理这部分内容
    《无根的根》是《Unix编程艺术》一书的附录，版本应该也不属于Raymond

    地理篇第13－17章，是从《ubuntu教程》里拷贝的。但《ubuntu教程》是我写的，这样可以么？
    《图形界面》《Grub》《Vim》，也是从《ubuntu教程》里拷的，不过有大幅度的调整
    《Emacs》中大部分内容拷贝自《Emacs入门指南》……很惭愧……《入门指南》也是我写的
    上面提到的《ubuntu教程》《Emacs入门指南》可以在Ubuntu.cn论坛中找到

    地理篇的其它章节，是最近写的……似乎我不需要向你提供证据^_^!!

    《docbook》 《Emacs org mode》等章节、以及《zsh》等整合到其它章节的内容，我在linuxtoy.org上发布过初稿，整理到《开源世界旅行手册》中，你同意我这样作么？^_^!!
    这些章节，在Linuxtoy.org首页，点击Contributors中我的名字，可以找到(有一两篇由徐小东代发，我记不太清楚)

    《openbox工作环境》 《Archlinux安装》由徐小东授权改写，但是抽不出时间，暂时整理进去……这个不是我写的，莫非你要求我撤除？

    关于gentoo内容，确实有一些来自gentoo手册，不过我不能为了避嫌，就告诉读者，用“emerge -C pkg”安装软件……也许这部分内容我可以重新从英文文档翻译，反正都是些简单的内容

  61. 61 食古不化 Commented @ 2008-11-13 6:18 pmReply to this comment

    有时候，稍微大家相互给点时间，或私下交换意见，效果或许更好。另，中超又群殴了……

  62. 62 Kardinal Commented @ 2008-11-13 7:51 pmReply to this comment

    可能是我没有讲清楚，为什么pr03页没有给出链接的原因：
    那个例子讲的是写作方法，而不是技术知识
    而我推崇的风格是通俗而又简洁，第一个例子显然不是这种风格
    尽管我没有说那种风格不好，但还是有可能会造成点误会，使读者认为那种风格不好
    因此我认为不注明出处比较好……

    而后来在陈述这个原因的时候，我也继续了“简洁”的风格，可能造成了一些理解上的偏差
    这是我不对，我承认

    ……不过兄弟随便骂两句得了……”中超”……也忒有点狠了吧^_^!!

  63. 63 ice Commented @ 2008-11-15 11:27 pmReply to this comment

    对我这个初学者来说很好！

  64. 64 r0bertz Commented @ 2008-11-18 4:53 pmReply to this comment

    http://www.linuxsir.org/bbs/post1902253-72.html

    可否解释一下为什么现在你的书里只有你引用的这个你认为是“反面”的不需要给出处而一度没有给出处的gentoo手册里的例子，上面连接里其他有关gentoo的内容都没有了？
    好歹我也曾经给你纠正了一个理解上，至少是表达上的偏差，是吧？
    难道就因为指出过你的错误了？没有配合你帮你校正了？
    其实我的意思不是说你不能用，gentoo文档的许可协议你可以自己查到，只要你给了翻译者／作者赢得的credit，你想怎么用都可以

  65. 65 Kardinal Commented @ 2008-11-19 9:35 amReply to this comment

    这里面可能确实有点误会，为此耽误了大家宝贵的时间，很抱歉

    我会妥善处理相关的内容，并给出链接……等第一次公开发布的时候可以么？

    因为对于这种规模的文档来说，通常有一个比较严格的时间表，不然根本无法进展
    而且我的流程大致是： 学习(折腾) => 构思、动笔 && 排查、调整其它章节
    折腾的时候是不会作其它事情的，现在我在折腾 conTeXt ，这部分完成了就公开发布，相信不会太久的

« 求助：需要一份 /etc/default/locate 文件

HDSentinel：你的硬盘健康吗？ »