Docutils 版本库

Author

Lea Wiemann, Docutils developers

Contact

docutils-develop@lists.sourceforge.net

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.netSubversion (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.git1

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)的(浅)副本。