Difference between revisions of "Using GitHub"

From GeeklogWiki
Jump to: navigation, search
(Installing Git)
(Setup)
 
(One intermediate revision by the same user not shown)
Line 20: Line 20:
 
This repository was converted from the Mercurial repository soon after the release of [https://www.geeklog.net/article.php/geeklog-2-1-1 Geeklog 2.1.1].
 
This repository was converted from the Mercurial repository soon after the release of [https://www.geeklog.net/article.php/geeklog-2-1-1 Geeklog 2.1.1].
  
To create a copy of that repository, simply do
+
A large number of Geeklog Plugins (Forum, Captcha, Ban, etc.) are also available at the GitHub organization called [https://github.com/Geeklog-Plugins Geeklog-Plugins].
  
<pre>hg clone http://project.geeklog.net/cgi-bin/hgwebdir.cgi/geeklog/ geeklog</pre>
+
The easiest way to create a copy of the Geeklog repository on your computer, is to first create an account on [https://github.com/ GitHub] if you don't already have one. Then install GitHub Desktop. Once you have logged into GitHub visit the [https://github.com/Geeklog-Core/geeklog Geeklog Repository] and click on the download to desktop icon. This will start the process of retrieving the files from the Geeklog hosted repository and saving them in your local repository.
  
Where the last "geeklog" is just a directory name for the local copy (and can be changed at will). This will give you a fully working local repository that you can commit changes to.
+
For Windows users with GitHub Desktop installed, you can enter the link below into your internet browser to retrieve the Geeklog Repository from GitHub:
  
'''Note:''' The same URL can also be used to browse the repository online. Simply visit that URL with your web browser.
+
<pre>github-windows://openRepo/https://github.com/Geeklog-Core/geeklog</pre>

Latest revision as of 20:39, 8 January 2016

Introduction

GitHub is an online hosting service which uses the Git distributed version control system (DVCS). The differences to a "traditional" centralized VCS (like CVS or Subversion) include:

  • Users get a self-contained repository that they can commit changes to, even when being offline.
  • Changes can be pushed back to the parent repository or even to other repositories.

Having used CVS since its inception (2001), Geeklog switched to Mercurial after the release of Geeklog 1.5.1. This switch was preceded by a successful experiment using Mercurial during the 2008 Google Summer of Code. After Geeklog 2.1.1 was released in December of 2015 a decision was made to switch to using Git and having our net Git repositories hosted on GitHub.

Installing Git

There are a number of GUI Clients available for Git. The one we recommend for Windows and Mac operating systems is GitHub Desktop since it is the native client for GitHub (it also comes with Git Shell). Download links and instructions for installing and using this software is found on the GitHub Desktop website. There is no official GitHub Desktop for Linux. You will have use another Git GUI like SmartGitHg. It runs on Windows and Linux and supports not only Git but SVN and Mercurial as well. For other Linux Git GUI Clients please visit the Git website for suggestions.

Setup

An organization called Geeklog-Core was setup on GitHub to house all repositories for the Geeklog CMS. This includes Geeklog itself, the required pear libraries, tools, artwork, plugin toolkit, and the test framework. The Geeklog's Git repository is available from this URL:

https://github.com/Geeklog-Core/geeklog

This repository was converted from the Mercurial repository soon after the release of Geeklog 2.1.1.

A large number of Geeklog Plugins (Forum, Captcha, Ban, etc.) are also available at the GitHub organization called Geeklog-Plugins.

The easiest way to create a copy of the Geeklog repository on your computer, is to first create an account on GitHub if you don't already have one. Then install GitHub Desktop. Once you have logged into GitHub visit the Geeklog Repository and click on the download to desktop icon. This will start the process of retrieving the files from the Geeklog hosted repository and saving them in your local repository.

For Windows users with GitHub Desktop installed, you can enter the link below into your internet browser to retrieve the Geeklog Repository from GitHub:

github-windows://openRepo/https://github.com/Geeklog-Core/geeklog