Step-by-step Setup TortoiseHg for gitHub


This is a step-by-step instruction to setup TortoiseHg (A GUI shell extension  for Mercurial SCM) to use with github (Online project hosting using git Version Control System).

Introduction


There are few articles around the web with the same topics. 
http://jamesmckay.net/2010/06/tortoisehg-as-a-github-client-on-windows/
https://gist.github.com/1568668

I was able to setup my TortoiseHg to work with github using the instruction written by James McKay. The document is very informative, but some of the steps are not written in details.
Thus, I decided to write this documents to include some steps with additional screen shots.

Instruction

 

1. Install TortoiseHg

 

 2. Install hg-git

hg-git can be download by cloning the repository directly.
  • Start TortoiseHg workbench.
  • Select File > Clone Repository...
Clone Repository
  • Configure clone repository dialog box. (#1)
    • Source       : http://bitbucket.org/durin42/hg-git
    • Destination: c:\hg-git
hg-git Clone Configuration
  • Click OK to start cloning.
  • Wait until repository cloning finished. 
Cloning Finished

 

3.Configure hg-git

The following steps had to be done by direct editing mercurial.ini file. 

  • This file can be access from File > Settings
  • Click "Edit File" button in "Global Settings" tab.
Global Settings - Edit mercurial.ini
  • Add the following lines to your configuration file:
 
[extensions]
bookmarks=
hggit = C:\hg-git\hggit

[ui]
ssh = "C:\Program Files\TortoiseHg\TortoisePlink.exe"

 

4. Create github account

 

Create new account at github (if you don't have an account yet), else skip this step.

 

5. Create SSH public and private keys

 

github required a SSH key in order to push repository to github.

To generate public and private SSH keys, you will need the PuTTYgen from the PuTTY package.
You can get PuTTY from http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html.
You may choose to download either PuTTYgen.exe or the entire PuTTY package (zip)

  • Execute PuTTYgen.exe
PuTTY Generator
  • Click "Generate" to generate new key (1). (Note: Move mouse in application window to generate random values.)
  • Create password for your key (2). (Optional)
  • Save your private key. (3)
  • Save your public key. (4)
Now, you have your own pair of SSH private and public keys pair. Next, you will need to tell github your SSH public key.

6. Register SSH public key to github

  • Login to github
  • Select account settings.
github Account settings
  • Select "SSH Keys"
github Menu
  • Click "Add SSH Key"
github Add SSH Key
  • Copy SSH public key from PuTTYgen (5) then paste to Key in github. Give your key a title.
We are now ready to upload our repository to github.

 

7. Create new repository in github

Before we can push our repository to github, the repository must be created.
Click "Create new Repo" in github page to create new repository.

8. Upload repository from TortoiseHg to github

  • Start Pageant in C:\Program Files\TortoiseHg\Pageant.exe
  • To load your SSH private key, right key at Peageant taskbar icon.
  • Click "Add Key" then select your SSH private key file.
    Note: you will be prompt for password if password is defined.

  • Select "synchronize"tab for repository that you wish to upload to github in Tortoise Hg Workbench.
  • With remote repository settings set to "local", type in the following command. (1)
 
  git+ssh://git@github.com:<User Name>/MSChartExtension.git
  • Push repository from TortoiseHg to github using the push button. (2).
  • Use pull  incoming changes to update repository from github. (3)

 That's all. Happy coding.


Version History

 

29/04/2012     Created

Popular posts from this blog

(AGauge) WinForms Gauge Control - Discontinued

Image
Introduction   Original AGauge control AGauge is a gauge control for WinForms create by A.J.Bauer using GDI+. Original code was published in " Code Project - A fast and performing gauge " The version that I published here is an improved version of AGauge which contains the following changes. Download from GitHub   WinForm Gauge - Released 2021     Looking for more gauge control? Check out this high performance .NET Windows Form gauge for info-graphics and real-time dashboard.Find out more  at https://winformgauge.codearteng.com/   NOTE: We no longer actively maintaining AGauge. The development of this package is taken over by nutdotnet . Refer to his GitHub and NuGet page for details.   Improvements   Dynamic Gauge Label and Gauge Range Properties for gauge label (previously known as CapText ) and range are grouped into GaugeRanges and GaugeLabels which allow us to create any number of range and
Read more

WinForms Controls

Image
Description Collection of .NET Windows Forms controls for WinForms application. Named as CodeArtEng.Controls.dll Download GitHub NuGet Features  Command Line Helper Labeled Text Box Hinted Text Box Multi-Line Button Status Label Open File Panel and Folder Browse Panel MRU (Most Recent Used File List) File Explorer Control Quick Access List Rich Text Box Editor Features Description Command Macro Editor Input editing dialog inspired by Visual Studio "Edit Pre-Build" and "Edit Post-Build" Dialog... ( Learn More... ) Command Line Helper Generate and parse command line with command line helper. ( Learn More... ) Labeled Text Box  Text box with label and hint, derived from Hinted Text Box. Hinted Text Box  Enhanced version of WinForms TextBox with capability to show hint in gray color text. Multi-Line Button  Button control with optional image and 2 lines of text, main and sub title. Each line can be configured using d
Read more

C# DSP Simulation - DSP Lab

Image
Introduction DSP Lab  is a digital signal processing simulation application created to simulate and visualize process of sampling and filtering analog signal using DSP system. This application is created to provide as a tool for educator and student to have a better understanding how DSP system works. DSP Lab allow you to view and listen to output from (Data Acquisition Unit) DAQ and digital filters. DSP Toolbox is the core of DSP Lab application which is a .NET assembly written in C#. The library is released under MIT license. You can use this library to jump start your own DSP powered application. DSP System DSP Lab is built using the system as shown above. Settings for each components are configurable. In PREMIUM  version, a 3 channels mixer system is available for more fun and signal combinations.
Read more