Re: [問題]DocBook 寫中文內容的存檔編
※ 引述《ahtwang@kkcity.com.tw (Alex_W)》之銘言：
> ※ 引述《chinsan.bbs@bbs.sayya.org (淡)》之銘言：
> > 聽說把錯誤訊息拿去問 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
討論串 (同標題文章)
完整討論串 (本文為第 2 之 2 篇)：
FreeBSD 近期熱門文章
PTT數位生活區 即時熱門文章
