Support

This page contains instructions on how you can use www.grand-challenge.org to create your own project website. Be advised that this site is continuously developing and this ducomentation may be outdated. If you run into any problems or have suggestions, please send an email to support@grand-challenge.org.

Create a project

  • Sign in or register as a new user - you will receive a validation email to activate your account.

  • Once you have been registered, create a new project by using the button on the Create your own challenge page.

  • Once created, your project appears in the project overview. Clicking your project in the overview takes you to your (empty) project page. You can admin your project with the admin link in the right upper corner of the site menu bar at the top of the page.

Add pages

  • Open the project admin page. Either click the 'admin' button on the left of the menu bar of your project, or go to the admin page directly.

  • Click the 'add new page' button on the bottom left. You can use the inbuilt HTML editor for basic editing. In addition, there are several special tags available to render things like lists of files, and to insert html from external files. These are described further on in this guide.

Make your project appear in the projects overview

By default, new projects are hidden in the projects overview at grand-challenge.org/all_challenges/. To make your project appear in this overview

  • Go to the admin interface for your projects, open the "advanced options" section and uncheck the "Hidden" option.
  • Information on workshop date, associated conference etc. can be entered in the "Metadata" section of the admin interface.

Allow others to edit the project

To allow other people to log in to the admin interface and also edit the pages of your project, take the following steps:

  • The other person needs to be Registered to grand-challenge.org. Get the username of the other person. This is the name in the upper right corner of each page when the person is logged in.
  • Go to the admin interface of your project (click the admin button in the upper right corner)
  • Open the 'Users' bar and click 'View, Add or Remove Administrators for this project'.
  • Users added in this dialog will be granted the same rights as you, including the right to add and remove admins.

Page permissions

For each page for three levels of access:

  • All - everyone can view this content in principle also non-logged in visitors
  • Participants - Only people who have registered with the comic and have explicitly registered for your project are allowed to view this. Participants are not allowed to edit.
  • Admin - Only admins for your project can view this content. Admins for other projects can not. 

Page Styling

You can use any of the classes and features from Bootstrap 4 as this is included with the framework.

Icons

You can use any of the free icons from Font Awesome, for example:

Equations

You can use Latex or AsciiMath in your html to render Equations. See the MathJax documentation for more details.

Adding a map with participants

Include the {% allusers_statistics %} tag to display the country of residence of all participants in the Comic framework . Include the {% project_statistics %} tag to display the country of residence of all participants in a respective Challenge.

Academic Torrents

How to share data with users using Academic Torrents

Academic Torrents is a distributed system for sharing enormous datasets - for researchers, by researchers. For a detailed description we suggest to visit the Academic Torrent website at this link. In order to be able to share your data-set within Academic Torrents you need to have a working torrent client. We suggest to use Bit Torrent. You can download BitTorrent from here.

How to create a torrent file

This procedure shows how to transform the data you want to share into torrent files:

  • Open BitTorrent.
  • Click on “New Torrent”.
  • Under the field “Select Source”, you can select the files you want to share into torrent. You can select a single file or a directory containing files.
  • Under the field “Trackers” put: http://academictorrents.com/announce.php (refer to Figure 1).
  • Click on Create and Save As to save and create your torrent.

Figure 1: Procedure to create a torrent from a file using BitTorrent

How to create a collection on Academic Torrent

The suggested way to upload torrents is to create before a collection of your data-set. A collection can then be filled with data-sets. Follow these steps to create a collection:

  • Go from your profile to “My collections”. In this page you can see the list of your collections.
  • Click on “New’” to add a new collection (refer to Figure 2).

In the next page you can create your collection providing a title and some additional description (refer to Figure 3).

Figure 2: Procedure to create a new collection in Academic Torrents

Figure 3: screenshot of the page for creating a new Collection

How to upload torrent files on Academic Torrents and add them to a collection

To upload new torrents please follow these steps:

  • Click on upload from the main page of Academic Torrents.
  • Under torrent file you can add your file.
  • Under the field type, Select Dataset.
  • Click on Upload to upload your torrent.

Figure 4: Procedure to upload a data-set torrent file

Logging into your page, clicking on My torrents you can see the list of uploaded torrents.

You can add the torrent to your collection, clicking on “ADD to collection and selecting the collection from a list (refer to Figure 5).

Figure 5: Procedure to add an uploaded torrent file to an exiting collection

Google Drive

Google drive is a service which offers the possibility of having free Google online storage. The available free space is only up to 15 Gb, so that if large data-sets are involved, Google drive is not advised. If a larger cloud storage plan is required, there is the possibility of purchasing it. In order to be able to use Google Drive a Google account is necessary. The first step is to upload files / directories on Google Drive cloud. The following step is to share these contents with users. Contents can be shared with users by providing them with the link to access shared files. This tutorial shows the procedure for uploading / sharing files. To add shared contents to your Challenge the usual "link" tool can be used while editing the respective Challenge page.