This text is a work in progress—highly subject to change—and may not accurately describe any released version of the Apache™ Subversion® software. Bookmarking or otherwise referring others to this page is probably not such a smart idea. Please visit http://www.svnbook.com/ for stable versions of this book.

Part I. Nhận Biết Subversion

Table of Contents

1. Những Khái Niệm Cơ Bản
Căn Bản Kiểm Soát Phiên Bản
Kho lưu trữ
Bản sao làm việc
Mô hình phiên bản
Vấn đề của việc chia sẽ tập tin
Giải pháp khoá-sửa đổi-mở khoá
Giải pháp sao chép-sửa đổi-hợp nhất
Kiểm Soát Phiên Bản Theo Cách Của Subversion
Kho lưu trữ Subversion
Phiên bản
Địa chỉ kho lưu trữ
Bản sao làm việc Subversion
Bản sao làm việc hoạt động như thế nào
Tương tác cơ bản trên bảo sao làm việc
Bản sao làm việc phiên-bản-hỗn-hợp
Tóm Tắt
2. Cách Sử Dụng Cơ Bản
Trợ Giúp!
Đưa Dữ Liệu Vào Trong Kho Lưu Trữ Của Bạn
Nhập tập tin và thư mục
Khuyến nghị cách bố trí kho lưu trữ
Tên gọi nói lên điều gì?
Tạo Bản Sao Làm Việc
Chu Kỳ Làm Việc Cơ Bản
Cập nhật bản sao làm việc của bạn
Thực hiện thay đổi của bạn
Xem lại thay đổi của bạn
Xem tổng quan về những thay đổi của bạn
Kiểm tra chi tiết những thay đổi trên bản sao cục bộ của bạn
Sửa lỗi của bạn
Giải quyết xung đột
Xem sự khác biệt trên xung đột một cách tương tác
Giải quyết xung đột một cách tương tác
Hoãn giải quyết xung đột
Giải quyết thủ công xung đột
Huỷ bỏ những thay đổi của bạn và sử dụng phiên bản mới được lấy về
Đặt cược: sử dụng svn revert
Chuyển giao những thay đổi của bạn
Xem Xét Lịch Sử
Xem xét chi tiết của những thay đổi trong lịch sử
Xem xét những thay đổi cục bộ
So sánh bản sao làm việc với kho lưu trữ
So sánh nhưng phiên bản trên kho lưu trữ
Tạo ra một danh sách các thay đổi lịch sử
Duyệt kho lưu trữ
Hiển thị nội dung tập tin
Hiển thị thuộc tính thay đổi theo-từng-dòng
Liệt kê danh sách những thư mục được định phiên bản
Lấy lại những phiên bản cũ trên kho lưu trữ
Đôi Khi Bạn Chỉ Cần Dọn Dẹp
Hủy bỏ bản sao làm việc
Phục hồi từ gián đoạn
Xử Lý Xung Đột Về Cấu Trúc
Một ví dụ xung đột cấu trúc cây
Tóm Lược
3. Chủ Đề Nâng Cao
Chỉ Định Phiên Bản
Từ khoá Phiên bản
Ngày Phiên bản
Peg and Operative Revisions
Properties
Why Properties?
Manipulating Properties
Properties and the Subversion Workflow
Inherited Properties
Automatic Property Setting
Subversion's Reserved Properties
Versioned properties
Unversioned properties
File Portability
File Content Type
File Executability
End-of-Line Character Sequences
Ignoring Unversioned Items
Keyword Substitution
Sparse Directories
Locking
Creating Locks
Discovering Locks
Breaking and Stealing Locks
Lock Communication
Externals Definitions
Changelists
Creating and Modifying Changelists
Changelists As Operation Filters
Changelist Limitations
Network Model
Requests and Responses
Client Credentials
Caching credentials
Disabling password caching
Removing cached credentials
Command-line authentication
Authentication wrap-up
Working Without a Working Copy
Remote command-line client operations
Using svnmucc
Summary
4. Branching and Merging
What's a Branch?
Using Branches
Creating a Branch
Working with Your Branch
The Key Concepts Behind Branching
Basic Merging
Changesets
Keeping a Branch in Sync
Reintegrating a Branch
Mergeinfo and Previews
Undoing Changes
Resurrecting Deleted Items
Advanced Merging
Cherrypicking
Merge Syntax: Full Disclosure
Merges Without Mergeinfo
More on Merge Conflicts
Blocking Changes
Merge-Sensitive Logs and Annotations
Noticing or Ignoring Ancestry
Merges and Moves
Blocking Merge Tracking Unaware Clients
The Final Word on Merge Tracking
Traversing Branches
Tags
Creating a Simple Tag
Creating a Complex Tag
Branch Maintenance
Repository Layout
Data Lifetimes
Common Branching Patterns
Release Branches
Feature Branches
Vendor Branches
General Vendor Branch Management Procedure
Vendor Branches from Foreign Repositories
Vendor Branches from Mirrored Sources
To Branch or Not to Branch?
Summary
5. Repository Administration
The Subversion Repository, Defined
Strategies for Repository Deployment
Planning Your Repository Organization
Deciding Where and How to Host Your Repository
Controlling Access to Your Repository
Creating and Configuring Your Repository
Creating the Repository
Implementing Repository Hooks
Hook script environment configuration
Common uses for hook scripts
Finding hook scripts or rolling your own
FSFS Configuration
Repository Maintenance
An Administrator's Toolkit
svnadmin
svnlook
svndumpfilter
svnrdump
svnsync
fsfs-reshard.py
Commit Log Message Correction
Managing Disk Space
How Subversion saves disk space
Removing dead transactions
Packing FSFS filesystems
Migrating Repository Data Elsewhere
Repository data migration using svnadmin
Repository data migration using svnrdump
Filtering Repository History
Repository Replication
Replication with svnsync
Partial replication with svnsync
A quick trick for mirror creation
Replication wrap-up
Repository Backup
Managing Repository UUIDs
Moving and Removing Repositories
Summary
6. Server Configuration
Overview
Choosing a Server Configuration
The svnserve Server
svnserve over SSH
The Apache HTTP Server
Recommendations
svnserve, a Custom Server
Invoking the Server
svnserve as daemon
svnserve via inetd
svnserve via xinetd
svnserve over a tunnel
svnserve as a Windows service
svnserve as a launchd job
Built-in Authentication and Authorization
Create a users file and realm
Set access controls
Using svnserve with SASL
Authenticating with SASL
SASL encryption
Tunneling over SSH
SSH Configuration Tricks
Initial setup
Controlling the invoked command
svnserve Configuration Reference
General configuration
Cyrus SASL configuration
httpd, the Apache HTTP Server
Prerequisites
Basic Apache Configuration
Authentication Options
Basic authentication
Digest authentication
Authorization Options
Blanket access control
Per-directory access control
Disabling path-based checks
Versioned in repository access files
Protecting network traffic with SSL
Subversion server SSL certificate configuration
Subversion client SSL certificate management
Tuning for Performance
KeepAlive
Bulk updates
Extra Goodies
Repository browsing
Apache logging
Write-through proxying
Other Apache features
Subversion Apache HTTP Server Configuration Reference
mod_dav_svn configuration directives
mod_authz_svn configuration directives
Path-Based Authorization
Getting Started with Path-Based Access Control
Access Control Groups
Username Aliases
Advanced Access Control Features
Some Gotchas with Access Control
High-level Logging
Server Optimization
Data Caching
Network Compression of Data
Supporting Multiple Repository Access Methods
7. Customizing Your Subversion Experience
Runtime Configuration Area
Configuration Area Layout
Configuration and the Windows Registry
Runtime Configuration Options
General configuration
Per-server configuration
Localization
Understanding Locales
Subversion's Use of Locales
Using External Editors
Using External Differencing and Merge Tools
External diff
External diff3
External merge
Summary
8. Embedding Subversion
Layered Library Design
Repository Layer
Repository Access Layer
Client Layer
Using the APIs
The Apache Portable Runtime Library
Functions and Batons
URL and Path Requirements
Using Languages Other Than C and C++
Code Samples
Summary