This tutorial describes how to move from SVN to Github, and does not force you to do so. Piwigo.org SVN repository is still alive and there is no plan to shut it down.

Migrate a plugin from Piwigo.org SVN to Github

Since November 2014, the plugins repository and the translation platform both support Github repositories, in addition to our Subversion repository. That mean you can use the power of Github (issues, forks, pull-requests) and seamlessly integrate with piwigo.org (no more need of manual releases and/or git/svn mirrors).

This tutorial will guide you in the process to migrate your SVN repository to Github without loosing its history. It is inspired by Atlassian tutorial for migrating to Bitbucket but cleaned and adapted for Github. It is adapted for plugins with only one branch (trunk), if you have branches and/or tags on your plugin and wish to migrate them, please refer to the original tutorial.

Prerequisites

I assume you will start with a fresh OS but you certainly have some or all of the required software. (The process was tested on Windows 7 and Ubuntu 14).

  • Java 1.7 or 1.8
  • Git
  • Subversion
  • Git SVN

Windows

You can get Java JRE on Oracle website.

Subversion binaries can be found on Apache website.

Also install mysysGit containing both core Git and Git SVN.

Ubuntu & co.

You will need these packages :

  • openjdk-7-jre (or openjdk-8-jre)
  • subversion
  • git
  • git-svn

Everyone

You will also need a little tool created by Atlassian: svn-migration-scripts.jar.

If you have several repositories to migrate you can also use this NodeJS script I (Mistic) created to migrate my 25 plugins: piwigo-svn2github.js.

Prepare

In order to get a consistent commit history on Github you will have to tell Git SVN who is who. Open a terminal where svn-migration-scripts.jar is located (Shift+Click on Windows or right-click→Git Bash Here) and enter the following command:

java -jar svn-migration-scripts.jar authors http://piwigo.org/svn/extensions/YOURPLUGIN > authors_YOURPLUGIN.txt

This will create a TXT file with the following syntax:

j.doe = j.doe <j.doe@mycompany.com> 
m.smith = m.smith <m.smith@mycompany.com>

Left part is Subversion login, right part is Github login and email.

Adapt authors' file

Now modify the right part of each line to match an actual Github accounts. The email must be one of the emails associated to the Github account.

You will certainly get TranslationTeam in this file, the SVN user used to commit language files. Complete the line as following:

TranslationTeam = Piwigo-TranslationTeam <translate-github@piwigo.org>

Also if plg or mistic100 made changes in your plugin, use theses:

plg = plegall <plg@piwigo.org>
mistic100 = mistic100 <mistic@piwigo.org>

For any other users, replace mycompany.com by piwigo.org.

And of course don't forget to specify the correct mapping for your own account!

Convert

Open your terminal on your working directory and type:

git svn clone --authors-file=authors_YOURPLUGIN.txt http://piwigo.org/svn/extensions/YOURPLUGIN

This will fetch all commits on your plugin and create locally all relevant Git commits.

Push

Now it's time to push your plugin to Github.

Create a new repository. You must leave it empty (no README.md, no LICENSE, no .gitignore).

Still in your terminal (on windows the previous command should have created a new folder /YOURPLUGIN, so redo right-click→Git Bash Here) type:

git remote add origin https://github.com/YOURLOGIN/YOURREPOSITORY
git push -u origin --all

Hooray ! Your plugin is now published to Github.

Update tools

 
Back to top
dev/extensions/svn_to_github.txt · Last modified: 2015/08/22 22:03 by flop25
 
 
github twitter facebook google+ newsletter Donate Piwigo.org © 2002-2017 · Contact