Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The DevRoadmaps Clarion The ClarionMag Library (DCLCML) is available by download from GitHub

There are several ways you can get the library, but the two easiest are to clone the repository using GitHub for Windows or download the library as a zip file:

Image RemovedImage Added

Downloading the zip

...

At that point you can go to the DCL CML page at https://github.com/devroadmapsclarionmag/DevroadmapsClarionLibraryClarionMagLibrary and click on the Clone in Windows button. GHfW will clone the DCL CML repository, and you should see something like this in GHfW:

Image RemovedImage Added

You may want to check out the June 8 2012 ClarionLive webinar recording, where I went through the process with Arnold and Lisa.   NOTE: At that time this site was still called DevRoadmaps and the library was the DevRoadmaps Clarion Library (DCL), so be sure you download the current ClarionMag Library (CML) instead.

About repositories

So here's the thing about Git repositories. Git is a distributed version control system, meaning that there doesn't have to be just one repository somewhere that everyone uses. Git is capable of synchronizing between repositories. 

When you clone the DCL CML you get the repository with all of its history. There's a good chance that will be a one-way street - when the DCL CML gets updated, you'll use GHfW to synchronize your copy with the GitHub repository. But you can also make changes to your own code, commit those changes to your local repository, and take advantage of Git's ability to merge the GitHub changes with your local repository commits. 

Getting

...

CML updates

Getting library updates is easy. Just run GHfW and bring up the DCL CML repository. This screen shot shows a blue sync button indicating I have a pending update on GitHub - John has committed some new files. If I hover my mouse over the sync button I'll get a tooltip telling me my local repository is behind by one commit. 

Image Removed

After I click on sync and update my repository, the button changes to indicate my local repository is in sync with the one on GitHub. 

Image RemovedIf there are pending updates the sync button will be enabled - click on it to bring your local copy up to date. 

Image Added

Moving the repository

Chances are GHfW has put DCL CML under your documents folder, and you probably want to move it to somewhere more Clarion-friendly. 

To move a repository just move the entire DevRoadmapsClarionLibrary ClarionMagLibrary folder tree to its new location. GHfW will notice that it can no longer find the files. Using Windows Explorer, drag and drop the DevRoadmapsClarionLibrary folder the ClarionMagLibrary folder onto the GHfW application. That's all you need to do. 

Using the library

Once you have the DCL CML where you want it, you're ready to start using it

...