GitHub Integration

RSpace allows users to link to code stored in Github repositories. Github is a popular online code repository offering distributed version control and source code management functionalities. By integrating with Github RSpace is able to support documentation and preservation of research-related code. This is particularly important for the rapidly growing community of researchers working with large datasets, computational models or automated equipment.

Github integration currently allows browsing and linking to master branch of connected repositories.

Configuring the Github Integration

In order to use the Github integration, you must already have a Github account containing projects you wish to link to. In addition, the Github app must be made available by the system administrator.

Configuring the app is simple:

  1. Navigate to the Apps page within RSpace and click on the ‘Github’ tile. A box will open below as seen in the screenshot
  2. If the Github app is currently disabled, click the ‘Enable’ button to enable it
  3. Click the “Add Github” button
  4. You will now be asked to login to your Github account
  5. On the next page, the authorization page, click the “Authorize Application” button
  6. A screen with a list of your Github project repositories will appear, select those which you wish to integrate with RSpace
  7. Click “Save”
  8. You may disable the Github App at any time by simply clicking the ‘Disable’ button in the Apps tab
Github Integration
Having trouble with getting the app to work? Check out the apps troubleshooting section.
Currently the Github integration only allows browsing master branch of the connected repository. If your repository doesn't have the master branch, you won't be able to insert a link. Please let us know if that affects your integration scenario.

Our Github integration enables you to quickly add links to content on Github from within the RSpace environment. Even if the documents are exported from RSpace via PDF or HTML, the links will continue to work.

Adding a Github link to an RSpace document is simple:

  1. Open the document you wish to add the Github link to and ensure it is in “Edit” mode
  2. Within the tinyMCE panel (the panel above the text area) there is a Github button as shown in the screenshot
  3. Click on the Github button
  4. A window containing a Treeview of your RSpace-integrated Github projects, folders and files will appear. Select the file you wish to link to.
  5. The Github link will be added in the document as shown
  6. Clicking on the link when the document is in “View” mode will open the relevant Github file in a new tab

 

Github Integration(1)
Having trouble with getting the app to work? Check out the apps troubleshooting section.


How did we do?


Powered by HelpDocs (opens in a new tab)