Author: lyalyakin
Date: Tue Nov 14 17:09:09 2017
New Revision: 1815234
URL: http://svn.apache.org/viewvc?rev=1815234&view=rev
Log:
Add to Quick Start a section about setting up a local repository and
converting and existing project to a new working copy. The section on this
topic was in the previous version of the Quick Start page.
* staging/quick-start.html
(#setting-up-a-local-repo): New section.
Modified:
subversion/site/staging/quick-start.html
Modified: subversion/site/staging/quick-start.html
URL:
http://svn.apache.org/viewvc/subversion/site/staging/quick-start.html?rev=1815234&r1=1815233&r2=1815234&view=diff
==============================================================================
--- subversion/site/staging/quick-start.html (original)
+++ subversion/site/staging/quick-start.html Tue Nov 14 17:09:09 2017
@@ -404,6 +404,80 @@ $ svn copy https://example.com/MyRepo/tr
</div> <!-- #basic-tasks -->
+<div class="h2" id="setting-up-a-local-repo">
+<h2>Setting up a local repository
+ <a class="sectionlink" href="#setting-up-a-local-repo"
+ title="Link to this section">¶</a>
+</h2>
+
+<p>You can create a Subversion repository on your computer and use
+<tt>file://</tt> schema to interact with it locally. This approach can help
+you use Subversion locally to track personal files and single-person
+projects.</p>
+
+<p>The following procedure creates a minimal environment for an an existing
+project. It converts a directory with a project into a working copy of a
+newly-created local Subversion repository. As result you can modify the files
+in the working copy and track the changes in your local repository.</p>
+
+<p>On Unix:</p>
+ <ol>
+ <li>Create a parent directory <tt>.svnrepos</tt> where you will place
+ your SVN repositories:
+ <pre>$ mkdir -p $HOME/.svnrepos/</pre></li>
+ <li>Create a new repository MyRepo under <tt>.svnrepos</tt>:
+ <pre>$ svnadmin create ~/.svnrepos/MyRepo</pre></li>
+ <li>Create a recommended project layout in the new repository:
+ <pre>$ svn mkdir -m "Create directory structure." \
+ file://$HOME/.svnrepos/MyRepo/trunk \
+ file://$HOME/.svnrepos/MyRepo/branches \
+ file://$HOME/.svnrepos/MyRepo/tags</pre></li>
+ <li>Change directory to <tt>./MyProject</tt> where your unvesioned
+ project is located:
+ <pre>$ cd $HOME/MyProject</pre></li>
+ <li>Convert the current directory into a working copy of the trunk/ in
+ the repository:
+ <pre>$ svn checkout file://$HOME/.svnrepos/MyRepo/trunk ./</pre></li>
+ <li>Schedule your project's files to be added to the repository:
+ <pre>$ svn add --force ./</pre></li>
+ <li>Commit the project's files:
+ <pre>$ svn commit -m "Initial import."</pre></li>
+ <li>Update your working copy:
+ <pre>$ svn update</pre></li>
+ </ol>
+
+<p>On Windows:</p>
+ <ol>
+ <li>Create a parent directory <tt>C:\Repositories</tt> where you will place
+ your SVN repositories:
+ <pre>mkdir C:\Repositories</pre></li>
+ <li>Create a new repository MyRepo under <tt>C:\Repositories</tt>:
+ <pre>svnadmin create C:\Repositories\MyRepo</pre></li>
+ <li>Create a recommended project layout in the new repository:
+ <pre>svn mkdir -m "Create directory structure." ^
+ file:///C:/Repositories/MyRepo/trunk ^
+ file:///C:/Repositories/MyRepo/branches ^
+ file:///C:/Repositories/MyRepo/tags </pre></li>
+ <li>Change directory to <tt>C:\MyProject</tt> where your unvesioned
+ project is located:
+ <pre>cd C:\MyProject</pre></li>
+ <li>Convert the current directory into a working copy of the trunk/ in
+ the repository:
+ <pre>svn checkout file:///C:/Repositories/MyRepo/trunk .</pre></li>
+ <li>Schedule your project's files to be added to the repository:
+ <pre>svn add --force ./</pre></li>
+ <li>Commit the project's files:
+ <pre>svn commit -m "Initial import."</pre></li>
+ <li>Update your working copy:
+ <pre>svn update</pre></li>
+ </ol>
+
+<p>See also the
+<a href="http://svnbook.red-bean.com/nightly/en/svn.intro.quickstart.html";
+>Quick Start instructions in The Subversion Book</a>.</p>
+
+</div> <!-- #setting-up-a-local-repo -->
+
<div class="h2" id="more-help">
<h2>Getting more help
<a class="sectionlink" href="#more-help"
