nitrc:Future User Guide - Upload/Download

From NITRC Wiki

Users: Getting Started | Browse | Search | Compare | Upload/Download | Personalize | Features

Administrators: Getting Started | Registration | Administration | Other Features

Tool/Resource Files

Tools/Resources may release files that are available for you to download. For a particular tool/resource, files can easily be downloaded from its Summary page or its Downloads page. On the Summary page, in the Download box, select the file you want to download and click "Download Now" or the arrow icon. To download a file listed on the Downloads page, click the file name or URL name. Depending on your browser and the file type, the file may display in your browser window, download and display with an appropriate application, or invoke the download dialog box. You may be presented with one or two intermediate pages before the selected file is downloaded:

1. If you have not set your preference for receiving followup email for tools/resources that you download, you will be asked to set your preference before the file is downloaded.
2. If the file has an associated license agreement or the tool/resource administrator requires data collection to download the file, you must first agree to accept the terms of the license agreement and/or the data collection agreement before the file is downloaded.

For more information on file releases, including how to monitor packages, please refer to the Tool/Resource Feature: Downloads section of this User Guide.

Snippets

The Code Snippet Library can be accessed by clicking the Download Code Snippets sub-menu link below the "Tools & Resources" main menu link. The Snippet Library function of NITRC allows users to collect all types of knowledge and information about incomplete fragments of code that are usually difficult to organize and share. Examples include sophisticated shell commands, javascript functions, perl one-liners, SQL expressions that perform special queries, algorithms, etc. Only registered users can add new snippets and create snippet packages.

Adding a New Snippet

You can add a new snippet by clicking the Submit New Snippet link at the top of the snippet library pages. A form is displayed, where the following information must be entered:

Required Fields—indicated by a red asterisk (*)

Title: Enter the title of the snippet. This will be displayed in the list of the snippets.

Description: Enter the description of the snippet.

Type: Select the type of the snippet: function, full script, sample code (HOWTO), README, class.

Language: Select the language of the snippet (if it is language dependent).

Category: Classify your snippet in the category tree.

Version: You must enter here the version of the snippet. For a new snippet, enter 1.0.

Code: Paste the code of the snippet.

Optional Fields

License: Select the license you want to use for your snippet.

Modifying a Snippet

You cannot modify an existing snippet, but you can add a new version of the snippet by clicking the "Submit a new version" link toward the bottom of the detail page for that snippet. Adding a new version does not delete the old version; all previous versions will be available. If you do wish to delete a version, you may click on the trash can under the Delete column for that snippet version on the detail page.

Creating a Package

You can add a new snippet package by clicking the Create Snippet Package link at the top of the snippet library pages. A form is displayed, where the following information must be entered:

Required Fields—indicated by a red asterisk (*)

Title: Enter the title of the package. This will be displayed in the list of the snippets.

Description: Enter the description of the package.

Language: Select the language of the package (if it is language dependent).

Category: Classify your package in the category tree.

Version: You must enter here the version of the package. For a new package, enter 1.0.

After the package has been successfully submitted, you will need to add the snippets to the package. Click the "Add Snippets to Package" link. Select the snippet from the drop down list, and click the "Submit" button. Continue doing this until all desired snippets are included in the package.

Modifying a Package

You cannot remove snippets from a package, but you can add more snippets to an existing package by clicking on the pencil under the Edit/Del column for that package on the detail page. The Add Snippets to Package page is displayed for you to select and submit the snippets to include with the package. You can also submit a new version of the package by clicking the "Submit a new version" link toward the bottom of the detail page for that package. Adding a new version does not delete the old version; all previous versions will be available. If you do wish to delete a package, you may click on the trash can under the Edit/Del column for that package on the detail page.