Warning: This page has not been updated in over over a year and may be outdated or deprecated.
legacy:vufind_1.x_developer_manual:subversion
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
subversion [2010/11/17 14:07] – demiankatz | legacy:vufind_1.x_developer_manual:subversion [2018/12/19 15:00] (current) – demiankatz | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Subversion ====== | ====== Subversion ====== | ||
- | [[http://subversion.tigris.org/ | + | // VuFind development |
- | + | ||
- | You can use Subversion at several levels: you can [[subversion# | + | |
- | + | ||
- | Subversion is a powerful and useful tool, and it's worth taking the time to learn about it if you expect to be doing complex customization of VuFind. | + | |
- | + | ||
- | + | ||
- | ===== Exporting from Subversion ===== | + | |
- | + | ||
- | When you want to get the latest files out of a Subversion repository without also loading all of the metadata about their history, you perform an export operation. | + | |
- | + | ||
- | The command to export VuFind' | + | |
- | + | ||
- | < | + | |
- | svn export https:// | + | |
- | </ | + | |
- | + | ||
- | Notes: | + | |
- | * " | + | |
- | * You can add a --force switch if you want to overwrite any existing files in the vufind directory. | + | |
- | + | ||
- | ===== Initial Checkout ===== | + | |
- | You check out code from a Subversion repository when you plan on changing it and want to keep track of its history. There are several popular Subversion clients that simplify the checkout process, including [[eclipse setup|Eclipse (with Subclipse)]], [[http:// | + | |
- | + | ||
- | ==== Command Line Checkout ==== | + | |
- | + | ||
- | Change to the directory where you want to work on your Vufind instance and then run this command: | + | |
- | + | ||
- | < | + | |
- | svn co https:// | + | |
- | </ | + | |
- | + | ||
- | This will check out the Vufind source into a folder named vufind. | + | |
- | + | ||
- | ===== Vendor Branching ===== | + | |
- | + | ||
- | Vendor branching is a useful strategy for merging changes | + | |
- | + | ||
- | It sounds complicated at first, but it makes more sense when you understand version control in general. | + | |
- | + | ||
- | ===== Upgrading an Old Custom VuFind Version Using Subversion ===== | + | |
- | + | ||
- | The best upgrade strategy depends on the tools you are using, the scope of the changes, and which versions of VuFind are involved. | + | |
- | + | ||
- | To get started, there two possible approaches: | + | |
- | + | ||
- | ==== Option A: Rely on Subversion ===== | + | |
- | + | ||
- | * 1.) Determine which version of VuFind you originally modified. | + | |
- | * 2.) Branch “vendor” to “trunk”. | + | |
- | * 3.) Copy your customized version of VuFind into the trunk directory, overwriting the files that were branched there by Subversion. | + | |
- | * 4.) Download the version of VuFind you wish to upgrade to into the “vendor” directory. | + | |
- | * 5.) Merge “vendor” into “trunk.” | + | |
- | + | ||
- | The problem is that step 5 may or may not be difficult, depending on how drastic your changes have been and how many versions of VuFind you are upgrading through. | + | |
- | + | ||
- | ==== Option B: Manually Reintegrate Diffs ==== | + | |
- | + | ||
- | * 1.) Determine which version of VuFind you originally modified. | + | |
- | * 2.) Use a comparison tool like [[http://winmerge.org/ | + | |
- | * 3.) Download the latest version of VuFind into a Subversion directory called “vendor” and commit it. | + | |
- | * 4.) Branch “vendor” to “trunk”. | + | |
- | * 5.) Manually reapply the changes revealed by [[http:// | + | |
- | * 6.) Commit trunk. | + | |
- | + | ||
- | This approach is better for a small number of changes or after many VuFind releases have passed. | + | |
- | + | ||
- | Regardless of which approach you take, once you are done, you are all set to begin using the [[subversion# | + | |
---- struct data ---- | ---- struct data ---- | ||
+ | properties.Page Owner : | ||
---- | ---- | ||
legacy/vufind_1.x_developer_manual/subversion.1290002843.txt.gz · Last modified: 2014/06/13 13:13 (external edit)