Changes between Version 2 and Version 3 of BitBucket

Timestamp:

Oct 9, 2010, 8:48:58 PM (14 years ago)

Author:

Itamar Ostricher

Comment:

added some tips for Windows users

BitBucket

@@ -15 +15 @@
 
 Note that we maintain an official Mercurial mirror of the SubversionRepository there, see [http://bitbucket.org/edgewall/trac edgewall/trac].
+
+== Windows Tips
+First thing, you will need a Mercurial client.
+- The "raw" command-line client can be downloaded here: http://mercurial.selenic.com/
+- A GUI client also exists, surprisingly named [http://tortoisehg.bitbucket.org/ TortoiseHG]
+
+It is considered Good Practice to first get things working with command-line, before moving to GUI-based solutions.
+
+=== Basic configuration
+You will need to create a configuration file:
+- On Windows XP and earlier, create `C:\Documents and Settings\USERNAME\Mercurial.ini`
+- On Windows Vista and newer, create `C:\Users\USERNAME\Mercurial.ini`
+
+Important settings for working with the Trac Mercurial mirror:
+{{{
+#!ini
+[extensions]
+convert =
+eol =
+graphlog = 
+; See below concerning external extensions
+hgsvnutils = \path\to\HgExts\HgSvnUtils\HgSvnUtils.py
+
+[diff]
+git = true
+}}}
+
+=== Mercurial Extensions
+For details on the concept of extensions see http://mercurial.selenic.com/wiki/UsingExtensions
+
+An important external extensions for Trac development with Mercurial is the [http://rc.c-space.org/hg/HgSvnUtils HgSvnUtils] extension (maintained by RemyBlank).
+
+To install it, go to some local directory and run (from command-line)
+{{{
+hg clone http://rc.c-space.org/hg/HgSvnUtils
+}}}
+and then set the `hgsvnutils` option mentioned above to the checked-out location.
+
+=== Working with BitBucket
+Once you installed Mercurial command-line client, you can `hg clone http://bitbucket.org/edgewall/trac` (or any other public repository).
+
+After creating an account and a repository (or Trac-fork), you will also be able to push & pull changes against the remote repository:
+- Using `https://USERNAME@bitbucket.org/USERNAME/reponame` over SSL (built-in support in the Mercurial client); or
+- Using `ssh://hg@bitbucket.org/USERNAME/reponame` over SSH (note that this uses `hg` as username!)[[BR]]
+  For this you will need `ssh` client, which is not native to Windows, as well as setting up SSH keys and uploading the public key to your BitBucket account. You may obtain a `ssh` client for Windows (like `plink.exe`), but why bother..?