/ncshare-link-generator-webextension

Generate nbgitpuller links for NCShare CaaS from inside GitHub with this webextension (Chrome, Firefox)

Primary LanguageJavaScriptBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

NCShare Link Generator WebExtension

A browser extension to help you generate nbgitpuller links directly from GitHub which work with NCShare's container-manager service.

Install Firefox Extension

What does this do?

On the GitHub page for files, folders and repositories, it adds an 'NCShare' button.

NCShare button

On clicking this, you can enter the name of a nbgitpuller enabled container image and the application you want to use to open this file, folder or repository. Then you can just copy the URL, and share it with your students! (or open it directly to test.)

nbgitpuller popover

The container image name and application you choose are remembered, so you do not need to enter it over and over again.

Installation

On Firefox

The preferred, easy method to install and keep the extension up to date is to install it from the addons.mozilla.org.

On Chrome

The preferred, easy method to install and keep the extension up to date is to install it from the the Chrome Web Store.

Manual Installation

On Firefox

  1. Download the .zip version of the latest release of the extension. You want the file named ncshare_link_generator-<version>.zip.
  2. In your firefox, go to the about:debugging page, and select the 'This Firefox' tab on the left.
  3. Under Temporary Extensions, click Load Temporary Add-on....
  4. Navigate to the .zip file you downloaded in step 1, and select that
  5. This should enable the addon! If you go to any repo on GitHub, you should see the nbgitpuller button now!

You can find more information here.

On Google Chrome / Chromium

  1. Download the .zip version of the latest release of the extension. You want the file named ncshare_link_generator-<version>.zip.
  2. Extract the .zip file you downloaded.
  3. In your Google Chrome / Chromium, go to chrome://extensions.
  4. Enable the Developer Mode toggle in the top right. This should make a few options visible in a new toolbar.
  5. Select Load Unpacked, and select the directory into which the downloaded .zip file was extracted to. This directory should contain at least a manifest.json file that was part of the .zip file.

You can find more information here.

Building the webextension

npm install
npx webpack --mode=production
npx web-ext build -s dist/

This produces a .zip file in web-ext-artifacts/ you can use.