※ 引述《[email protected] (Alex_W)》之铭言： > ※ 引述《[email protected] (淡)》之铭言： > > 听说把错误讯息拿去问 Google 通常会有答案 :p > 我碰到的是 "non sgml character number"，这个好像是个很笼统的错误(?) 好像是 :p 不过我是拿 Docbook UTF-8 去搜寻的 > 二十几个小时，如果还是学生时代，那随便发呆也就过去了，可是现在不同， > 二十个小时是很珍贵的。XD Time is Money 我也知道，我也不是学生了.. :p > 嗯，我看到的是〈DocBook Demystification HOWTO〉： > http://tldp.org/HOWTO/DocBook-Demystification-HOWTO/ > The DSSSL toolchain is, as far as new development goes, > effectively dead. The XSLT toolchain has reached production > status in mid-2002; a working version shipped in Red Hat 7.3. > It's where DocBook developers are putting almost all of their > effort. > 不过这是 2002 年写的东西，不知道这几年有什麽改变吗？ > > http://www.freebsd.org/doc/zh_TW/books/fdp-primer/ > 说说我看 FDP Primer 的过程好了。XD > 一开始当然是什麽都不知道，不过既然有在跑 FreeBSD，当然是 cvsup 有了。 > 可是其实我不知道 cvsup 和 cvs 究竟是哪一类的关系。(笑) CVSup 跟 CVS 的关系..，好吧，讲一段故事好了...有讲错的话，请跟我说一下 XD CVS 是套版本控制系统(VCS)，一开始是从 RCS 演进，後来 CVS team 又觉得有所不足， 所以又产生了近年来比较流行 SVN(Subversion)， 之後 SVN 还是有 repo 集中等天生缺憾， 所以 clkao 长辈一怒之下又产生新利器 SVK, 最近 clkao 的新力作是 pushmi (可针对 SVN repository replication tool) 啊，扯远了... FreeBSD Porject 主要对外公开的是这个， 内部的 VCS 随着不同子专案还有 perforce, git, svn 等 repository, 不过内部这应该知道的人就会知道了 :p 可是众多皆知，一般要从 CVS Server 取出新版(这动作叫做 checkout), 就会很久很慢 (比如 OpenBSD anoncvs... =.=")，而且也会造成 CVS Server 很大负担， 通常一个 anoncvs client 连进来 实际上一般纯粹 client 在进行 src, ports, doc, www 等 tree 更新与升级时， 是不必包含那些 VCS 讯息的就可以成功更新、升级。 所以，有这样子的需求(简单、快速、不必 commit、不需 VCS 资料) 就有了简化版的出现 CVSup CVSup 简单讲只是协助 CVS Server mirror(CVSup Server角色) 来分担 cvs-master 的角色与流量，以及让 client 得以透过 csup, cvsup 方式来轻易由各地的 cvsup mirror site 更新相关 src, ports, doc, www 等 tree 以及 gnat db 相关说明可参阅 http://www.cvsup.org/ 以及 The SUP Software Upgrade Protocol, S. A. Shafer, CMU Com-puter Science Department, 1985. > 再来第一步自然是装了 textproc/docproj-nojadetex 了。这一步很简单。 > 辅助工具没有装，因为我是打算用 Vim 来写，也不打算做 PDF。 > 再来就看着这个 Quick Start，第二步就突然要猜谜了。 > 嗯，下载 doc tree，不论用 CSup 还是 CVSup checkout 模式都行？ > 这 cvsup 我用过，可是 checkout 模式是什麽？不管了，总之翻翻 那，我还是省略一些过杂的资讯好了...不然可能新手比较难以适应，或者要讲的太多。 > 手册。啊，范例里面有个 doc-all 的。试试看──成功了！不错嘛， > 不过这 checkout 模式是在讲什麽？……算了反正 doc 拿下来了， > 都丢在 /usr/doc 里面了。 > 然後同一个步骤突然又说要做个 local repository，用 checkout： > cvs checkout doc/share > cvs checkout doc/en_US.ISO8859-1/share > 嗯？不行啊！他说 cannot find module 'doc/share' - ignored。 其实，这是 en_US 的 typo(?) 或许可以考虑 send-pr ? XD zh_TW 部分我可以修掉，但 en_US 我得先问过 mentor 以及 doceng@ 意见同意才可 XD > 翻了好几篇 CVS 教学，还要做 group……然後就因为没时间了，先放着。XD > 我是希望 FDP Primer 连这些步骤也都写进去，让想参与的人直接照着做， > 而不必到处再去翻教学自己慢慢拼凑详细步骤。 可以啊 :p > > 如果不熟 CVS or SVN 的话，也没关系，可以直接寄信给我 > > (嗯...我 email 你打 cd /usr/ports ; make search key=chinsan 应该会有才是) > 我是有想过，只是总觉得 Primer 里写轻描淡写，我却一直做不出来， > 会不会是我根本不适合搞这种东西呢？一种适者生存的淘汰机制吧？(笑) 想太多了。。 > FDP Primer 我也有在看，只是他说是 Primer 不如说是 Outline 吧。 > 不过 BSD/Linux 界的文件本来就是这样，重叠少，要做什麽常常得东找西找， > 自己拼凑东西。平常做起来会很有成就感，花很久还是七零八落就只能乾笑了。 > 或许再来个一年，我也终於能够顺利照 FDP Primer 里说的把东西搞好吧。 > 毕竟不是学生了，搞这种东西已经是还要排在闲暇发呆时间之後了。(笑) > 啊──牢骚发完了，下次有时间再继续试吧，浪费各位的时间真是抱歉 (泪) 其实，你回的当天我有看到，只是当晚要搬机房，所以没精神、时间回， 怕回太草率会被批 XD (我也不是学生，咳...有在业界的，应该知道我目前在哪任职 XD) -- 我我...我只是小小新手啊 什麽都不懂的，请多见谅包涵 >_<" -- ※ Origin: SayYA 资讯站 <bbs.sayya.org> ◆ From: 61-63-0-host123.kbtelecom.net.tw