如何获得 Subversion 版本控制系统的账号,成为 Whodo 的贡献者?
注册账号
在用户管理中心:https://www.worldhello.net/members,注册和管理自己的账号。
上传自己的文档,以下任何一种方式均可:
通过 Wiki 系统上传
通过 http://whodo.worldhello.net/wiki/Special:Upload 页面上传文档;
接受的上传文档格式有: *.mm, *.xml, *.gz, *.zip, *.rar 等;
通过 论坛 系统上传
撰写一篇 Wiki 页面
每个文档对应一个 Wiki 页面,包含文档链接。
创建一个页面(页面名称最好为英文,简洁但不失文章主题)。
新创建的页面中除了包含文档名称,提交者,提交时间等信息外,还包括如下内容:
指向刚刚上传的文档链接,或外部文档链接。 通过 Wiki 上传的文档链接为 [[Media:上传文档名]]。如 [[Media:Curl.mm]]。
在页面最前面插入模板: {{草稿}}。模板{{草稿}},会自动将文档归于 Doc 和草稿分类,并有醒目标识,提醒管理员注意有新用户提交新文档。如: http://whodo.worldhello.net/wiki/Curl_howto。
获取 SVN 提交账号
在 Whodo 网站注册,已经获得了 SVN 只读账号。
要想获取 SVN 提交账号,需要向管理员申请提升权限。可以在 Wiki 上通过 http://whodo.worldhello.net/wiki/Special:Emailuser/admin 给管理员发送邮件。管理员受到邮件后,会阅读用户上传的文档,根据是否符合 whodo 文档精神,批准或否决账号申请。
用 subversion 账号提交文档
一旦 SVN 权限提升为可读写权限,就可以提交文档。Whodo 文档提交到 Whodo subversion 路径: http://svn.worldhello.net/svn/whodo/trunk/doc 的子目录下。 DocBook 格式文档的首页文档名为 index.xml;FreeMind 文档的文件名和子目录名同名,扩展名为 .mm。
提交文档,要设定文件的 svn:mime-type 或者 svn:eol-style 属性,还要写 commit log,否则会触发 subversion hooks,导致提交被退回。具体参见附录关于 SVN 的说明。
subversion 除了 /trunk/doc 外,其他目录暂时只读,如果需要修改其他目录,请和管理员联系。
Whodo 管理员/robot 至少每天编译一次文档,并更新网站
网站更新后,文档才能够在网站中出现。
文档在网站的链接: http://www.worldhello.net/doc。同时 http://whodo.worldhello.net/doc 还存在一份拷贝, 主要是由于 Whodo Wiki 和 WorldHello.net 分属不同主机,用户如果在 Wiki 页面中中嵌入 FreeMind 文档,只能嵌入本地文档。
修改 Wiki 页面
之前建立的 Wiki 页面为草稿。在提交文档到版本控制系统之后,需要更新文档中的链接。
Wiki 页面中要包含 文档的作者,提交时间,文档的分类等信息。文档的分类可以是以下分类的组合:[[Category:doc]],[[Category:db]],[[Category:mm]]。
Wiki 页面中要嵌入文档链接(使用 <whodo> 标签建立链接)。例如:
id 和 type 属性 # 如果提交文档的名称符合规范,可以采用 id, type 属性显示文档链接 <whodo id="email_howto" type="html"/> <whodo id="docbook_howto" type="htmls"/> <whodo id="bug_tracking" type="htmlz"/> <whodo id="bcp" type="htmlsz"/> <whodo id="bcp" type="chmz"/> <whodo id="bcp" type="pdfz"/> <whodo id="bcp" type="rtfz"/> <whodo id="bcp" type="txtz"/> <whodo id="bcp" type="xml"/> <whodo id="bcp" type="svn" /> # 如果文档名不符规范,可以使用 file 属性,显示文档链接 <whodo file="docbook_howto/mindmap/docbook.mm" type="mm"/> <whodo file="计算机应用能力考试/index.mm" name="全国专业技术人员计算机应用能力考试" type="svn" text='yes'/>
Copyright © 2006 WorldHello 开放文档之源 计划 |