开源世界旅行手册-内部交流版 (附精美海报一张)
这是一块不折不扣的砖 show 出你货真价实的玉 (标题前有空格的章节,为没有完成的内容,欢迎同道赐稿)
下载地址:开源世界旅行手册
----订正-------------- (r0bertz) 《如何写作科技文档》中第一个例子来源于gentoowiki
(逸飞) 环境变量使用白底黄字,容易引起视觉疲劳 docbook.css文件中找到 yellow 替换成 orange
(zer4tul) 《无根的根》为《UNIX编程艺术》一书附录。原作者不详
《如何写作科技文档》 -2行:但是使用脚注 => 但是使用Calloutlist
Read More:
不错,支持!
浏览了一下,几个环境变量如$PATH显示成白底黄字,看得不舒服
抱歉抱歉……忘了改……因为出现的不多,也没有太在意……
Toy兄帮忙改下CSS文件,给改成橙色的吧^_^!!
已下载的朋友,在docbook.css文件中找到 yellow 替换成 orange ;或者其它随便什么颜色,麻烦了……
辛苦了。支持
支持啊,下来看看怎么样!
写得很好啊,这种风格很喜欢
好东西,这个要多多宣传
@Kardinal: 已改 :)
还没完成啊?等完成了再下了.
另: 海报果然很精美 :D
超赞!!! 组织,逻辑,表达手法都不错!中国人的智慧。
极好,值得Fedora借鉴!
无名的根……很经典的文章。
支持,很好的集思广益的东西
赞,好文!
您忘了在封面写上大大的“DON‘T PANIC”。
好文,支持!
建议中文和英文间加上半角空格
谢谢大家支持。请在支持的同时多提宝贵意见,帮忙找点错别字也是好的啊^^!!…… 刚才随便翻了几下,光错别字就找到N处^^!!不过忘了记下来,回头整个勘误 @LanEast:用Gimp简单处理了下……别的也不会了…… 建议兄弟还是下了吧,因为一时半会好像还完成不了……而且最近可能会歇一阵,捣鼓点其它的东东玩(当然也要看情况,如果问题太多,肯定会迅速修正的) @aaron lee:过了哈,过了……兄弟哪里人啊?^^ @gcell:Fedora没怎么用过,里面有一个介绍发行版的章节……不过我还没想好怎么写 @zer4tul:无根的根……这章我复制粘贴的,《unix编程艺术》里面的附录……好像这文章很有名的说…… 回头我会注明一下出处…… @HiugongGwok:恕我愚钝,这句话有什么深意么?封面我想保持干净,除了目录和致敬之外,不保留其它内容了……不过我正在琢磨,给每一章加一个题记,像Emacs章前面的那种 这句话作archlinux章的题记合适不? @雪梨:老兄,不好意思,说的晚了点……等找到足够多的错误,我再一块改吧^^
尔~! 这个的完成度有多少? 大略看了一下。。。好多空的。 加油~!
哈 寫得不錯,有文采,有想法,加油啊~
图很强大
从目录来看 内容的组织很不错,我会一页页地看的,不知道什么时候能出“完整”版的?我看到有些页面是空的。
原来Toy叫做徐小东啊!
支持
希望做成PDF,谢谢~
@keenan chen: 汗,原本打算作一个的,可惜做的面目全非。就不拿出来献丑了。
谢谢各位支持^^ @nsgoh:这个文档的完成度,主要取决于第二部分的完成度,这部分是相对固定的内容……因为第二部分完成的差不多了…… 其它部分的内容可能会有比较大的调整,而且过程会比较长 @konit:俺很有动力了^^ @tunpishuang:很山寨吧嘿嘿 @froons:最近可能要放一放,CTeX论坛的liyanrui版主在得知我对TeX很有兴趣后,给予热情的指导,所以我要先学习一下TeX,如果我能学得差不多,争取整理一个教程出来^^ @keenan chen & eric:是否Calloutlist在PDF中难以处理?^^!! PDF文件体积比较大,不太方便交流;而这个文档现在还不太正式…… 最近会学习一些相关知识,等教程比较完备了,会考虑发布PDF版
PS:有什么需要讨论的可以直接给我发邮件 2999am AT gmail.com
好东西,期待全本下载
看来Kardinal没看过《银河系漫游指南》: http://en.wikipedia.org/wiki/Don'tPanic(Hitchhiker'sGuidetotheGalaxy)#Don.27t_Panic
不错,支持! 建议做成chm和pdf的。。
支持!
@pptp:可能我比你更期待^^!! @ HiugongGwok :刚下载了一本,很不错的样子,有空看看…… 不过我现在对有冗长情节的读物不太感冒,除了《火影忍者》^^!!……电视剧之类的,情节长点还能接受 ……在我看来,所有带情节的东西,讲的不外是两件事:1.人性 2.结果呢? 其实我最喜欢的读物是《国家地理》之类的东东…… @Leo:chm只不过是把许多html页面打包在一起……有什么区别么?^_^!!
目录中章节编号与章节标题之间的水平距离不整齐,一会大一会小。
前面有空格的标题是没有完成的^_^!!
@Kardinal 要想看得快有电影啊,2005年的 ,imdb 6.6,名字一样。 也有电视剧,不过年代久远,不好找了。
@HiugongGwok:2005年的……现在还能下载来么?要是今天能下载下来,晚上回去看…… 多谢了^_^
最冂的一句:眼睛一亮. -_- !
明显的语言缺乏~~~
非常的不错!
我的从第一章以后显示不了具体文章内容,只有个标题和文章转向链接……
@dogfox:都说了是复制粘贴的^^!!
其实这不是语言缺乏,而是有意为之。《无根的根》是模仿著名的禅宗读物《无门之门》体式写的……类似的,尼采也写过一部格言体的小册子《查拉图斯特拉如是说》,也有一些朴拙的话一再重复,但作为哲学家和诗人的尼采,显然不能算是语言缺乏…… 可以说,能驾驭这种风格的作者,已然立于万山之颠;作为反例,看看流传最广的著作,没有以词藻的华丽而闻名的……夏多布里昂之流公认妙笔生花的作家,反而鲜为人知 @ 食古不化 :非常的感谢γ^^γ @Jarod:前面几章的内容不是最重要的……还没有完成
写得不错,支持一下,希望能早些完成,也希望更多的人参与进来!
啥也不说,先贴3个连接 http://linuxtoy.org/docs/guide/pr03.html http://www.gentoo.org/doc/zhcn/handbook/handbook-x86.xml?part=2&chap=2#docchap2 http://www.linuxsir.org/bbs/thread337466.html
希望以后再用别人的东西的时候,给别人应有的credit 现在用了的,还没有补上的,请补上,谢谢
最后,good luck to your endeavour!
http://www.linuxsir.org/bbs/showthread.php?p=1906975#post1906975
……锁贴,解锁跟贴,再锁贴……确实不敢去那个地方了^_^!! 我已按他们的要求注明出处了,见《补遗》,有一处屏幕输出的内容,等我有空了找个实例替换(现在还不是开公发布,只是内部交流) 关于pr03页内容,如果你们希望注明出处,我绝对欣然从命 PS:我会按照惯例处理这部分内容,其它的没有讨论的必要
勘误 1:第一章第 9 节的“reStructureTEXT 还是 DocBook”中“reStructureTEXT”应该是“reStructuredTEXT”吧,少了个“d”。
http://docutils.sourceforge.net/rst.html
多谢兄弟^_^ 其实我正在考虑要不要把reST这部分去掉。因为本来使用就简单,而且用的人似乎不多…… 最近在学ConTeXt,如果顺利,回头加入关于ConTeXt的介绍…… 要是兄弟有什么好的建议,可以直接给我发邮件
http://www.linuxsir.org/bbs/thread337466-5.html 我要说明的是,最后一帖不是我操作的 是发帖人重新开了一帖 然后某版主(不是我),为了版面整洁,把原来的锁贴打开,然后合并的
另外,我对“内部版可以不给出处”这一解释感到非常不解 既然都已经给人看了,何以还是内部版? 如果是我写书,如果我引用的别人的东西,我会第一时间给出脚注,就像这样 http://www.testlab.com.cn/html/qiyejisuan/20081021/1184.html 这样做,一是省得后来补记的时候找不到地方,二是可以令自己的论断更有依据,三就是可以避免类似这样的争抝
“关于pr03页内容,如果你们希望注明出处,我绝对欣然从命” 事实就是你拷贝了别人的东西,为什么需要别人希望之后,自己才去注明出处
《如何写作科技文档》中第一个例子来源于gentoowiki
错了,是gentoo中文手册 另外请加上手册地址
1 这本书很明显没有标明是以什么许可方式发布,是“保留所有权利”,还是http://creativecommons.org/licenses/by-nc-sa/2.5/cn/
2 好像删除了一些东西,莫非就因为有人提过意见? 提 GNU/Linux,哪能不提 portage 的……
@r0bertz:等下次放出的时候一起订正。编辑这个页面挺麻烦…… @shuge.lee:暂时为“署名 • 注明出处 • 非商业性使用” 不过我可以保证,如果有变动,只会比现在更为宽松^_^
因为还有一些重要章节没有完成,所以只是作为内部交流,让老手们给看看,提提意见(其实主要是面向新手的)
这个文档并不针对某一特定发行版。不过,里面有些内容是以前用ubuntu的时候写的,还没有调整……
欢迎兄弟来人来涵,随时指教:)
http://creativecommons.org/licenses/by-nc-sa/2.5/cn/ 这个页面中的许可方式不错,就用这个吧
这个得解释一下: 这个手册的前身《ubuntu教程》,并没有要求署名转载 但是有些同志有点过了,把文档的名称都改了^^!! 其中有一个PDF的版本叫作《ubuntu部落》,我比较喜欢这个名称。而且转换成PDF要费点力气,发布者还加了些命令手册之类的东西(其实是不必要的,《核心工具集》部分的内容经过仔细的整理,连命令的参数都按使用频率排列好了) (我使用《ubuntu教程》的名称,并不是因为我觉得这个名称好,而是因为这样有利于传播。对于这个名称,其实我是不满意的) 我还知道有一个版本叫作《ubuntu完全教程》……“完全”这两个字与我实际的意图是“完全”不一样的^^!! 发布者似乎没有在里面添加、修改过什么内容,而只在标题里加“完全”两个字,这种作法我没有办法恭维…… (对于《ubuntu教程》这样的名称,我已经不太满意。《完全教程》的名称,比原来的名称更加恶趣味,却不如原名更加利于传播……)
兄弟提到的这种授权方式,着眼点是保护版权不被占据 而我的根本目的是物尽其用,对于一个文档来说,被最大程度的传播阅读是最重要的 如果过于宽松的授权不能促进它被正确的使用,那么还是按照惯常的作法处理好了
@r0bertz: “关于pr03页内容,如果你们希望注明出处,我绝对欣然从命” 事实就是你拷贝了别人的东西,为什么需要别人希望之后,自己才去注明出处 ---- ……可能是我的中文水平有问题……如果你能全权代表,并且认为第一个例子是正面教材,我当然不介意加个链接 当然,只能在脚注中添加,这是底线。举例说明: QQ(深圳腾讯公司荣誉产品)我一般不用,因为我的系统是Linux(FSF&Linus荣誉出品,开源世界智慧的结晶),所以我喜欢用Gmail(伟大的奉行“不作恶”原则的互联网企业google荣誉出品)和朋友联系…… 如果你认为这样的话可以读,我也写不出来
@Kardinal: 发了第 2 个“勘误”在你的邮箱了:2999am@gmail.com。今后在阅读过程中的勘误就都发到这个邮箱去,好吧?:-)
多谢兄弟^^ 回头我在《前言》之前,弄个单独的页面,凡是找到错误的兄弟,都把名字写进去γ^^γ
发勘误 Email 效率低,可否考虑使用 wiki 方式?
@Rainux:其实我也在考虑如何协作的问题 协作中比较重要的是交流。交流有很多层面,而不只是勘误 wiki主要作用应该是版本控制吧,这方面有很多更好的选择;而且我对wiki不熟悉^^!! 主要是没有一个活动场地^^ 所以临时只能用邮件了
你这算是恐吓么? 你不妨说说你这“书”里已经有了哪几个章节? 又有哪几个章节完全是你自己从头开始写的?
@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”安装软件……也许这部分内容我可以重新从英文文档翻译,反正都是些简单的内容
有时候,稍微大家相互给点时间,或私下交换意见,效果或许更好。另,中超又群殴了……
可能是我没有讲清楚,为什么pr03页没有给出链接的原因: 那个例子讲的是写作方法,而不是技术知识 而我推崇的风格是通俗而又简洁,第一个例子显然不是这种风格 尽管我没有说那种风格不好,但还是有可能会造成点误会,使读者认为那种风格不好 因此我认为不注明出处比较好……
而后来在陈述这个原因的时候,我也继续了“简洁”的风格,可能造成了一些理解上的偏差 这是我不对,我承认
……不过兄弟随便骂两句得了……"中超"……也忒有点狠了吧^_^!!
对我这个初学者来说很好!
http://www.linuxsir.org/bbs/post1902253-72.html
可否解释一下为什么现在你的书里只有你引用的这个你认为是“反面”的不需要给出处而一度没有给出处的gentoo手册里的例子,上面连接里其他有关gentoo的内容都没有了? 好歹我也曾经给你纠正了一个理解上,至少是表达上的偏差,是吧? 难道就因为指出过你的错误了?没有配合你帮你校正了? 其实我的意思不是说你不能用,gentoo文档的许可协议你可以自己查到,只要你给了翻译者/作者赢得的credit,你想怎么用都可以
这里面可能确实有点误会,为此耽误了大家宝贵的时间,很抱歉
我会妥善处理相关的内容,并给出链接……等第一次公开发布的时候可以么?
因为对于这种规模的文档来说,通常有一个比较严格的时间表,不然根本无法进展 而且我的流程大致是: 学习(折腾) => 构思、动笔 && 排查、调整其它章节 折腾的时候是不会作其它事情的,现在我在折腾 conTeXt ,这部分完成了就公开发布,相信不会太久的