Docutils 版本库¶
- Author
Lea Wiemann, Docutils developers
- Contact
- Revision
$Revision$
- Date
$Date$
- Copyright
This document has been placed in the public domain.
快速说明
要想通过 SVN 获得 Docutils 源码树(含沙盒)的签出,请输入
svn checkout http://svn.code.sf.net/p/docutils/code/trunk docutils-code
Git 的用户可以通过以下方式克隆 docutils 仓库的一个镜像
git clone git://repo.or.cz/docutils.git
如果你要向版本库提交修改,请阅读 整个文档,特别是 开发人员信息 部分!
Docutils 使用位于 docutils.svn.sourceforge.net
的 Subversion (SVN)仓库。
虽然 Unix 和 Mac OS X 用户可能更喜欢标准的 Subversion 命令行界面,但 Windows 用户可能想试试 TortoiseSVN,一个方便的资源管理器扩展。说明也是类似的。
在 http://repo.or.cz/docutils.git,有一个 Git 镜像,提供 网络访问 和 创建本地 Git 克隆 的基础。1
关于版本库使用的项目政策(签入要求、分支等),请参见 Docutils 项目政策。
访问存储库¶
网络访问¶
资料库可以通过网络浏览和检查,网址是 http://sourceforge.net/p/docutils/code。
或者,使用网页界面,http://repo.or.cz/docutils.git 。1
- 1(1,2)
GitHub 上也有第三方镜像和分叉,其中一些是 orphaned。在写这篇文章的时候(2021-11-03),https://github.com/live-clones/docutils/tree/master/docutils ,提供每小时更新一次的克隆。
存储库访问方法¶
要获得签出,首先要根据你的首选协议确定版本库的根:
- 匿名访问:(只读)
Subversion:
http://svn.code.sf.net/p/docutils/code
Git:
git://repo.or.cz/docutils.git
- 开发者访问: (读与写)
svn+ssh://<USERNAME>@svn.code.sf.net/p/docutils/code
检查存储库¶
Git 用户可以通过以下方式克隆 docutils 仓库的一个镜像
git clone git://repo.or.cz/docutils.git
并根据 Git 文档 进行。开发者可以通过 git svn 进行访问(读和写)。
Subversion 用户可以使用以下命令(用你喜欢的版本库根目录代替 ROOT):
要想只查看 Docutils 当前的主源码树,请输入
svn checkout ROOT/trunk/docutils
要查看所有内容(main 树、沙盒、网站和并行项目),请输入
svn checkout ROOT/trunk docutils
这将在一个名为
docutils
的新目录中创建整个主干的工作副本。
请注意,你可能不想检查 ROOT 本身(不包括 “/trunk”),因为那样的话,你就会为每一个分支和标签一次又一次地获取整个 Docutils 树。
以后要更新你的工作副本,cd
进入工作副本,然后输入
svn update
切换版本库根目录¶
如果你改变了主意,想使用不同的版本库根目录,cd
进入你的工作拷贝,然后输入
svn switch --relocate OLDROOT NEWROOT
开发者信息¶
如果你想拥有对版本库的写入权限,请在 SourceForge.net 注册,并将你的 SourceForge.net 用户名发送到 docutils-develop@lists.sourceforge.net。(注意,在你可以向版本库提交修改之前,可能会有几个小时的延迟。)
Sourceforge SVN的访问记录在 这里
为开发设置你的 Subversion 客户端¶
在提交修改到版本库之前,请确保在你的本地 ~/.subversion/config 文件中包含(并取消注释)以下几行,以便在添加新文件时设置正确的属性
[miscellany]
# For your convenience:
global-ignores = ... *.pyc ...
# For correct properties:
enable-auto-props = yes
[auto-props]
*.py = svn:eol-style=native;svn:keywords=Author Date Id Revision
*.txt = svn:eol-style=native;svn:keywords=Author Date Id Revision
*.html = svn:eol-style=native;svn:keywords=Author Date Id Revision
*.xml = svn:eol-style=native;svn:keywords=Author Date Id Revision
*.tex = svn:eol-style=native;svn:keywords=Author Date Id Revision
*.css = svn:eol-style=native;svn:keywords=Author Date Id Revision
*.patch = svn:eol-style=native
*.sh = svn:eol-style=native;svn:executable;svn:keywords=Author Date Id Revision
*.png = svn:mime-type=image/png
*.jpg = svn:mime-type=image/jpeg
*.gif = svn:mime-type=image/gif
存储库的布局¶
下面的树显示了存储库的布局
docutils/
|-- branches/
| |-- branch1/
| | |-- docutils/
| | |-- sandbox/
| | `-- web/
| `-- branch2/
| |-- docutils/
| |-- sandbox/
| `-- web/
|-- tags/
| |-- tag1/
| | |-- docutils/
| | |-- sandbox/
| | `-- web/
| `-- tag2/
| |-- docutils/
| |-- sandbox/
| `-- web/
`-- trunk/
|-- docutils/
|-- sandbox/
`-- web/
main 源树位于 docutils/trunk/docutils/
,旁边是沙盒(docutils/trunk/sandbox/
)和网站文件(docutils/trunk/web/
)。
docutils/branches/
和 docutils/tags/
包含整个主干或只有主源树(docutils/trunk/docutils
)的(浅)副本。