GTN Metadata

Authors: orcid logoAvatarHelena Rasche
Overview
Questions:
  • What metadata is required or possible to set in a Tutorial, Slide, Topic, or FAQ

Objectives:
  • Know where to find all of the available metadata, so you can reference it later.

Time estimation: 10 minutes
Supporting Materials:
Last modification: Sep 23, 2022
License: Tutorial Content is licensed under Creative Commons Attribution 4.0 International License The GTN Framework is licensed under MIT
A dictionary/map

layout
Free Text

This must be set to tutorial_hands_on

Possible Values:

  • tutorial_hands_on

Example(s)

layout: "tutorial_hands_on"

title
Free Text

Title of the tutorial (it will appear on the tutorial page and the topic page)

Example(s)

title: Clustering in Machine Learning
title: Breve introducción a Galaxy - en español
title: Pangeo ecosystem 101 for everyone - Introduction to Xarray Galaxy Tools

contributions
A dictionary/map

List of tutorial contributors. Here we break them down into several broad categories to help contributors identify how they contributed to a specific tutorial.

Example(s)

contributions:
    authorship:
        - shiltemann
        - bebatut
    editing:
        - hexylena
        - bebatut
        - natefoo
    testing:
        - bebatut
    infrastructure:
        - natefoo
    translation:
        - shiltemann
    funding:
        - erasmusplus

List of Items

These entities wrote the bulk of the training material, they may have done the analysis, built the workflow, and wrote the text themselves.

List of Items

These entities edited the text, either for spelling and grammar, flow, GTN-fit, or other similar editing categories

List of Items

These entities provided funding support for the development of this resource

List of Items

These entities managed and provided infrastructure to the GTN or for training purposes

List of Items

These entities tested the tutorial to ensure it works correctly for students, or reported issues with the tutorial.

List of Items

These entities did translation and localisation work on this resource

List of Items

These entities contributed UX or Design improvements to this tutorial or the GTN as a whole

time_estimation
Free Text

An estimation of the time needed to complete the hands-on.

Example(s)

time_estimation: 10M
time_estimation: 1H30M

Required Pattern: Must match the following regular expression

/^(?:([0-9]*)[Hh])*(?:([0-9]*)[Mm])*(?:([0-9.]*)[Ss])*$/

A dictionary/map

A dictionary of abbreviations and their expansions.

Example(s)

abbreviations:
    SQL: Structured Query Language
    API: Application Programming Interface

Free Text

The expansion of the abbreviated term.

List of Items

List of tutorial contributors. Please use contributions instead as it provides more detailed accounting of tutorial history.

Example(s)

contributors:
- hexylena
- shiltemann

Free Text

An edam ontology id that describes the topic or tutorial.

Example(s)

edam_ontology: topic_3173

Required Pattern: Must match the following regular expression

/^topic_[0-9]+$/

Boolean

false to hide your tutorial from the topic page (optional). This is useful if you need a tutorial for a workshop, but have not finished making it up to GTN standards.

List of Items

list of resources that the reader of the material could follow at the end of the tutorial

Example(s)

follow_up_training:
- type: internal
  topic_name: statistics
  tutorials:
      - age-prediction-with-ml
  
- type: external
  title: The Unix Shell
  link: "http://swcarpentry.github.io/shell-novice/"
  
- type: none
  title: "A VM with at least 2 vCPUs and 4 GB RAM, preferably running Ubuntu 18.04 - 20.04."
  

Sequence Value (List of items)
A dictionary/map

type
Free Text

the type of link

Possible Values:

  • internal
  • external
  • none

Example(s)

type: "internal"
type: "external"
type: "none"

Free Text

URL of the external resource

Free Text

Title of the external resource

Free Text

[Internal Only] The name of the topic

List of Items

[Internal Only] List of required tutorials inside that topic

Decimal Number

Currently unused.

Free Text

Link to a gitter channel that is more relevant for the tutorial than the default. E.g. a single cell tutorial could use Galaxy-Training-Network/galaxy-single-cell to link to their specific chat room.

Example(s)

gitter: Galaxy-Training-Network/galaxy-single-cell
gitter: galaxy-genome-annotation/Lobby

List of Items

List of take-home messages. This information will appear at the end of the tutorial. These should really be a key point, something that should stick in their mind; what you want them to take home from the tutorial.

Example(s)

key_points:
- Pangeo ecosystem enables big data analysis in geosciences
- The MiModD suite of tools bundles most of the functionality required to perform mapping-by-sequencing analyses with Galaxy
- It can drastically simplify management of large numbers of VMs

Free Text

The document language.

Possible Values:

  • es
  • en

Example(s)

lang: "es"
lang: "en"

Free Text

Here give a feeling of what level the material is at.

Possible Values:

  • Introductory
  • Intermediate
  • Advanced

Example(s)

level: "Introductory"
level: "Intermediate"
level: "Advanced"

Free Text

An SPDX identifier for the alternative license that is used for that particular material. This is only relevant for materials which have been imported from an external source and were originally licensed under another license. For new materials we strongly encourage contributors to not use this key as materials are CC-BY, by default.

Example(s)

license: MIT

A dictionary/map

Example(s)

notebook:
    language: python
    pyolite: true

notebook:
    language: python
    snippet: topics/climate/tutorials/pangeo-notebook/preamble.md

language
Free Text

Possible Values:

  • python
  • bash
  • r
  • sql

Example(s)

language: "python"
language: "bash"
language: "r"
language: "sql"

Boolean

The GTN has support for JupyterLite and the Pyodide kernel which runs Python in the browser via webassembly/javascript. This comes with some restrictions:

  • Python only
  • No filesystem access (so no wget prep steps)
  • Little to no cell magic

However, it means we can run a lot of our Python training directly in the GTN! And in the future, hopefully, we will be able to embed individual cells of the notebook directly in the Python training, so the user doesn’t even need to switch pages.

Enabling this field will enable pyolite links for this notebook.

Free Text

If you have an alternative preamble for your notebook that students should know before following (e.g. they must load X datasets in their history), it can be listed here.

This text will be shown in the GTN tutorial, but it will not be included in the notebook, giving you a bit better control over mixing setup content which is relevant for Galaxy, with notebook content that can be easy to run for students.

Example(s)

snippet: topics/climate/tutorials/pangeo-notebook/preamble.md

List of Items

list of learning objectives for the tutorial

A learning objective is a single sentence describing what a learner will be able to do once they have done the tutorial. Generally it is best to follow a 2C or 3C learning objective such as:

  • Compute (Skill)
  • multiple whole genome assemblies (Objective)
  • in such a way to develop big data processing skills (Result)

Example(s)

objectives:
- Understand the basic concepts behind phylogenetic trees, as applied to *Mycobacterium tuberculosis*
- Explore Biodiversity data with taxonomic, temporal and geographical informations
- Generate a DotPlot emulating the original paper using a different analysis tool

Integer Number

This field allows ordering tutorials within the tutorial list. Tutorials with lower numbered priority come before tutorials with higher numbers.

Example(s)

List of Items

list of questions that will be addressed in the tutorial

Example(s)

questions:
- How does Genome assembly work?
- How do I change Galaxy configs?
- How to detect and quantify differentially abundant proteins in a HEK-Ecoli Benchmark DIA datatset?
- What kinds of data do programs store?

List of Items

If a tutorial is renamed to a new location, use this field to list prior locations from which this tutorial was accessible.

Example(s)

redirect_from:
- /topics/sequence-analysis/tutorials/de-novo-rad-seq/tutorial

List of Items

List of resources that the reader of the material should be familiar with before starting this training. The structure is identical to follow_up_training.

Example(s)

requirements:
- type: internal
  topic_name: statistics
  tutorials:
      - age-prediction-with-ml
  
- type: external
  title: The Unix Shell
  link: "http://swcarpentry.github.io/shell-novice/"
  
- type: none
  title: "A VM with at least 2 vCPUs and 4 GB RAM, preferably running Ubuntu 18.04 - 20.04."
  

Sequence Value (List of items)
A dictionary/map

type
Free Text

the type of link

Possible Values:

  • internal
  • external
  • none

Example(s)

type: "internal"
type: "external"
type: "none"

Free Text

URL of the external resource

Free Text

Title of the external resource

Free Text

[Internal Only] The name of the topic

List of Items

[Internal Only] List of required tutorials inside that topic

Free Text

if the topic has multiple subtopics defined, you can assign your tutorial to one of those subtopics here. Without this, the tutorial will appear in the “Other tutorials” section on the topic page.

Example(s)

subtopic: single-cell

List of Items

A free form list of tags that are relevant for your tutorial.

Example(s)

tags:
- covid-19
- git-gat

List of Items

If alternative translations of a material are available, then use this key to indicate which languages have been manually translated.

Example(s)

translations:
- en

A dictionary/map

For materials which are automatically converted into videos via the available mechanisms, this field declares which voice should be used. If this field is not declared, a random voice will be chosen from a list of the best available voices from AWS Polly.

Example(s)

voice:
    id: Lupe
    lang: es-US
    neural: true

id
Free Text

lang
Free Text

neural
Boolean

Free Text

link on Zenodo to the input data for the tutorial

Example(s)

zenodo_link: https://zenodo.org/record/3706539

A dictionary/map

Example(s)

hexylena:
    name: Helena
    twitter: hexylena
    bio: I wrote this documentation! I do super cool things.

A dictionary/map

This ideally is your GitHub handle. If you do not have, or do not wish to provide a GitHub username, you may make up another identifier here, but then you must set github: false as described below.

name
Free Text

Your preferred name. If you prefer an alias or another name, this is welcome, it does not need to be your legal name.

Example(s)

name: 张三
name: Alice
name: Jane Doe
name: Madame Tout-le-Monde
name: Γιάννης Παπαδόπουλος

joined
Free Text

The year and month in which you joined

Example(s)

joined: 2020-01

Required Pattern: Must match the following regular expression

/[0-9]{4,}-[0-9]{2}/

Free Text

Free Text

A short biography of yourself, if you wish to add additional details or context.

Example(s)

bio: Research at the [South African National Bioinformatics Institute](https://www.sanbi.ac.za/)

Free Text

The 2 letter code identifying the ELIXIR node to which you are a member or are associated with. If you are from norway, you will need to quote your value, "no", unlike everyone else, due to the Norway Problem with YAML

Possible Values:

  • au
  • be
  • ch
  • cz
  • de
  • dk
  • ee
  • es
  • fi
  • fr
  • gr
  • hu
  • ie
  • il
  • it
  • lu
  • nl
  • no
  • pt
  • se
  • si
  • uk

Example(s)

elixir_node: "au"
elixir_node: "be"
elixir_node: "ch"
elixir_node: "cz"
elixir_node: "de"
elixir_node: "dk"
elixir_node: "ee"
elixir_node: "es"
elixir_node: "fi"
elixir_node: "fr"
elixir_node: "gr"
elixir_node: "hu"
elixir_node: "ie"
elixir_node: "il"
elixir_node: "it"
elixir_node: "lu"
elixir_node: "nl"
elixir_node: "no"
elixir_node: "pt"
elixir_node: "se"
elixir_node: "si"
elixir_node: "uk"

Free Text

Your email address, if you wish to provide it.

Example(s)

email: jane.doe@gmail.com

Required Pattern: Must match the following regular expression

/@/

Boolean

Set this to true if this entity is a funding agency.

Free Text

The short identifier for your grant.

Example(s)

funding_id: 2020-1-NL01-KA203-064717

Free Text

A short statement about the funder, markdown is supported.

Example(s)

funding_statement: This project ([`2020-1-NL01-KA203-064717`](https://ec.europa.eu/programmes/erasmus-plus/projects/eplus-project-details/#project/2020-1-NL01-KA203-064717)) is funded with the support of the Erasmus+ programme of the European Union. Their funding has supported a large number of tutorials within the GTN across a wide array of topics.

Boolean

If your identifier in this file is not a GitHub account (or not your account), then this must be set to true, so we do not link to that account.

Free Text

Your gitter

Example(s)

gitter: hexylena

Required Pattern: Must match the following regular expression

/[0-9a-zA-Z]+/

Free Text

Set this to no if you would like to be excluded from the hall of fame.

Possible Values:

  • no

Example(s)

halloffame: "no"

Free Text

If this community member is deceased, you can use this field to write a small in memoriam section that will display in their Hall of Fame profile.

Free Text

Required Pattern: Must match the following regular expression

/[0-9a-zA-Z]+/

Free Text

Preferred contact method

Free Text

Your matrix identifier

Example(s)

matrix: @hexylena:matrix.org

Required Pattern: Must match the following regular expression

/@[0-9a-zA-Z]+:.*/

Free Text

Your identifier at orcid.org

Example(s)

orcid: 0000-0001-9760-8992

Required Pattern: Must match the following regular expression

/[0-9A-Z]{4}-[0-9A-Z]{4}-[0-9A-Z]{4}-[0-9A-Z]{4}/

Free Text

Your twitter handle, without the @

Example(s)

twitter: gxytraining

Required Pattern: Must match the following regular expression

/[0-9a-zA-Z]+/

A dictionary/map

layout
Free Text

The layout to use. Generally you should use tutorial_slides and no other value.

Possible Values:

  • base_slides
  • tutorial_slides
  • introduction_slides

Example(s)

layout: "base_slides"
layout: "tutorial_slides"
layout: "introduction_slides"

title
Free Text

Title of the slides (it will appear on the slides and the topic listing)

Example(s)

title: Introduction to CRISPR screen analysis
title: High Performance Computing for Pairwise Genome Comparison
title: Circos

contributions
A dictionary/map

List of slide contributors. Here we break them down into several broad categories to help contributors identify how they contributed to a specific tutorial.

Example(s)

contributions:
    authorship:
        - shiltemann
        - bebatut
    editing:
        - hexylena
        - bebatut
        - natefoo
    testing:
        - bebatut
    infrastructure:
        - natefoo
    translation:
        - shiltemann
    funding:
        - erasmusplus

List of Items

These entities wrote the bulk of the training material, they may have done the analysis, built the workflow, and wrote the text themselves.

List of Items

These entities edited the text, either for spelling and grammar, flow, GTN-fit, or other similar editing categories

List of Items

These entities provided funding support for the development of this resource

List of Items

These entities managed and provided infrastructure to the GTN or for training purposes

List of Items

These entities tested the tutorial to ensure it works correctly for students, or reported issues with the tutorial.

List of Items

These entities did translation and localisation work on this resource

List of Items

These entities contributed UX or Design improvements to this tutorial or the GTN as a whole

logo
Free Text

A logo identifier (e.g. GTN) should be used by default, but may be swapped out for special logos from the assets folder.

Possible Values:

  • GTN
  • assets/images/gat.png
  • assets/images/gga.png
  • assets/images/ncbi.png
  • /assets/images/elixir-uk.png

Example(s)

logo: "GTN"
logo: "assets/images/gat.png"
logo: "assets/images/gga.png"
logo: "assets/images/ncbi.png"
logo: "/assets/images/elixir-uk.png"

Free Text

A default CSS class applied to slides

List of Items

List of tutorial contributors. Please use contributions instead as it provides more detailed accounting of tutorial history.

Example(s)

contributors:
- hexylena
- shiltemann

Free Text

An edam ontology id that describes the tutorial.

Example(s)

edam_ontology: topic_3173

Required Pattern: Must match the following regular expression

/^topic_[0-9]+$/

Boolean

false to hide your tutorial from the topic page (optional). This is useful if you need a tutorial for a workshop, but have not finished making it up to GTN standards.

List of Items

list of resources that the reader of the material could follow at the end of the tutorial

Example(s)

follow_up_training:
- type: internal
  topic_name: statistics
  tutorials:
      - age-prediction-with-ml
  
- type: external
  title: The Unix Shell
  link: "http://swcarpentry.github.io/shell-novice/"
  
- type: none
  title: "A VM with at least 2 vCPUs and 4 GB RAM, preferably running Ubuntu 18.04 - 20.04."
  

Sequence Value (List of items)
A dictionary/map

type
Free Text

the type of link

Possible Values:

  • internal
  • external
  • none

Example(s)

type: "internal"
type: "external"
type: "none"

Free Text

URL of the external resource

Free Text

Title of the external resource

Free Text

[Internal Only] The name of the topic

List of Items

[Internal Only] List of required tutorials inside that topic

Free Text

Possible Values:

  • external

Example(s)

hands_on: "external"

Free Text

List of Items

List of take-home messages. This information will appear at the end of the slides. These should really be a key point, something that should stick in their mind; what you want them to take home from the slides.

Example(s)

key_points:
- Pangeo is an inclusive community promoting open, reproducible and scalable science.
- Balanced batches and replicates allow bioinformatic batch correction
- Galaxy workflows can download images from the IDR, selecting specific channels, time points, z-stack positions and crop the image in different ways.

Free Text

The document language.

Possible Values:

  • es
  • en

Example(s)

lang: "es"
lang: "en"

Free Text

Here give a feeling of what level the material is at.

Possible Values:

  • Introductory
  • Intermediate
  • Advanced

Example(s)

level: "Introductory"
level: "Intermediate"
level: "Advanced"

List of Items

list of learning objectives for the tutorial

A learning objective is a single sentence describing what a learner will be able to do once they have done the tutorial. Generally it is best to follow a 2C or 3C learning objective such as:

  • Compute (Skill)
  • multiple whole genome assemblies (Objective)
  • in such a way to develop big data processing skills (Result)

Example(s)

objectives:
- Understand the basic concepts behind phylogenetic trees, as applied to *Mycobacterium tuberculosis*
- Explore Biodiversity data with taxonomic, temporal and geographical informations
- Generate a DotPlot emulating the original paper using a different analysis tool

Integer Number

This field allows ordering resources within the topic list. Learning resources with lower numbered priority come before those with higher numbers.

Example(s)

List of Items

list of questions that will be addressed in the slides

Example(s)

questions:
- What is ATAC-Seq?
- What are Galaxy Interactive Environments (GIEs)?
- How to visualize your genome after automated annotations have been performed?

List of Items

If a tutorial is renamed to a new location, use this field to list prior locations from which this tutorial was accessible.

Example(s)

redirect_from:
- /topics/sequence-analysis/tutorials/de-novo-rad-seq/tutorial

List of Items

List of resources that the reader of the material should be familiar with before starting this training. The structure is identical to follow_up_training.

Example(s)

requirements:
- type: internal
  topic_name: statistics
  tutorials:
      - age-prediction-with-ml
  
- type: external
  title: The Unix Shell
  link: "http://swcarpentry.github.io/shell-novice/"
  
- type: none
  title: "A VM with at least 2 vCPUs and 4 GB RAM, preferably running Ubuntu 18.04 - 20.04."
  

Sequence Value (List of items)
A dictionary/map

type
Free Text

the type of link

Possible Values:

  • internal
  • external
  • none

Example(s)

type: "internal"
type: "external"
type: "none"

Free Text

URL of the external resource

Free Text

Title of the external resource

Free Text

[Internal Only] The name of the topic

List of Items

[Internal Only] List of required tutorials inside that topic

Free Text

if the topic has multiple subtopics defined, you can assign your tutorial to one of those subtopics here. Without this, the tutorial will appear in the “Other tutorials” section on the topic page.

Example(s)

subtopic: single-cell

List of Items

A free form list of tags that are relevant for your tutorial.

Example(s)

tags:
- covid-19
- git-gat

Free Text

An estimation of the time needed to complete the hands-on. It should look like 10M or 1H30M

Required Pattern: Must match the following regular expression

/^(?:([0-9]*)[Hh])*(?:([0-9]*)[Mm])*(?:([0-9.]*)[Ss])*$/

List of Items

If alternative translations of a material are available, then use this key to indicate which languages have been manually translated.

Example(s)

translations:
- en

Boolean

This enables automatic slide-to-video conversion. See the documentation of that feature for more information about this feature. If enabled, you must provide good speaker notes for every single slide.

A dictionary/map

For materials which are automatically converted into videos via the available mechanisms, this field declares which voice should be used. If this field is not declared, a random voice will be chosen from a list of the best available voices from AWS Polly.

Example(s)

voice:
    id: Lupe
    lang: es-US
    neural: true

id
Free Text

lang
Free Text

neural
Boolean

Decimal Number

Decimal Number

Free Text

link on Zenodo to the input data for the tutorial

Example(s)

zenodo_link: https://zenodo.org/record/3706539

A dictionary/map

layout
Free Text

This must be set to faq

Possible Values:

  • faq

Example(s)

layout: "faq"

title
Free Text

Title of the FAQ

Example(s)

title: How does the GTN implement the 'Ten simple rules for collaborative lesson development'
title: How can I give feedback?
title: Ways to use Galaxy

box_type
Free Text

The type of box that should be used when rendering this FAQ. Use none if it should not be in a box, but just plain text.

Possible Values:

  • tip
  • hands_on
  • question
  • comment
  • warning
  • details
  • none

Example(s)

box_type: "tip"
box_type: "hands_on"
box_type: "question"
box_type: "comment"
box_type: "warning"
box_type: "details"
box_type: "none"

contributors
List of Items

Who contributed to this FAQ

Example(s)

contributors:
- shiltemann
- hexylena

Free Text

A text key used for sorting related FAQs together in the visual interface for users.

Example(s)

area: contributors
area: learners
area: features

Free Text

A short, one line description to provide additional context of the FAQ

Example(s)

description: Galaxy may have several reference genomes built-in, but you can also create your own.
description: Quickly learn what the identifiers are in any **BAM** dataset that is the result from mapping
description: Finding and Correcting Metadata

List of Items

If a tutorial is renamed to a new location, use this field to list prior locations from which this tutorial was accessible.

Example(s)

redirect_from:
- /topics/sequence-analysis/tutorials/de-novo-rad-seq/tutorial

A dictionary/map

name
Free Text

The internal identifier for a topic, it should be the same as the folder name.

Example(s)

name: epigenetics
name: sequence-analysis
name: admin

Required Pattern: Must match the following regular expression

/^[a-z0-9_-]+$/

type
Free Text

The type of topic, some have subtly different behaviours.

admin-dev
should be used for admin and developer topics that are not scientifically focused.
basics
Only used for galaxy-interface type topics
data-science
Topics which are not necessarily Galaxy focused but expand into broader communities
use
These topics use galaxy for some analysis
instructors
Specific to topics related to instruction of Galaxy

Possible Values:

  • admin-dev
  • basics
  • data-science
  • use
  • instructors

Example(s)

type: "admin-dev"
type: "basics"
type: "data-science"
type: "use"
type: "instructors"

title
Free Text

Title of the topic, this is displayed for users to see.

Example(s)

title: Proteomics
title: Variant Analysis

summary
Free Text

A longer description of the contents of this topic

Example(s)

summary: Statistical Analyses for omics data and machine learning using Galaxy tools

maintainers
List of Items

Free Text

The image ID for an image which contains all of the tools and data for this topic.

Example(s)

docker_image: quay.io/galaxy/sequence-analysis-training

Free Text

An edam ontology id that describes the topic.

Example(s)

edam_ontology: topic_3173

Required Pattern: Must match the following regular expression

/^topic_[0-9]+$/

Boolean

false to hide your topic from the production GTN. This is useful if you need a topic for a workshop, but have not finished making it up to GTN standards.

Free Text

Link to a gitter channel that is more relevant for this topic than the default. E.g. a single cell topic, you could use Galaxy-Training-Network/galaxy-single-cell to link to their specific chat room in all of the child tutorials by default.

Example(s)

gitter: Galaxy-Training-Network/galaxy-single-cell
gitter: galaxy-genome-annotation/Lobby

List of Items

Example(s)

references:
- - |
    authors: "Vaudel M, et al."
    title: "Shedding light on black boxes in protein identification."
    link: "https://www.ncbi.nlm.nih.gov/pubmed/24678044"
    summary: "An extensive tutorial for peptide and protein identification, available at http://compomics.com/bioinformatics-for-proteomics. The material is completely based on freely available and open-source tools."
  

Sequence Value (List of items)
A dictionary/map

authors
Free Text

title
Free Text

link
Free Text

Free Text

List of Items

List of resources that the reader of the material should be familiar with before starting this training. The structure is identical to follow_up_training.

Example(s)

requirements:
- type: internal
  topic_name: statistics
  tutorials:
      - age-prediction-with-ml
  

Sequence Value (List of items)
A dictionary/map

type
Free Text

the type of link

Possible Values:

  • internal

Example(s)

type: "internal"

Free Text

The name of the topic

List of Items

List of required tutorials inside that topic

List of Items

For large topics, we can define subtopics and create multiple tutorial lists, which separates the tutorials to help users find content that interests them more quickly.

A dictionary/map

id
Free Text

Subtopic ID, this should match what is used in tutorials.

Example(s)

id: single-cell

Required Pattern: Must match the following regular expression

/^[A-Za-z0-9_-]+$/

title
Free Text

Subtopic title, which is displayed for users to see.

Example(s)

title: Maintaining a Production Galaxy
title: Single-cell RNA-seq

description
Free Text

A human readable textual description of a subtopic.

Example(s)

description: - "Start here if you are new to RNA-Seq analysis in Galaxy"
- "These tutorials take you from raw sequencing reads to pathway analysis"
- "Tutorials about analysis of single-cell RNA-seq data"
- "Tutorials using a single published single-cell RNA-seq dataset for a variety of analyses"

Boolean

false to hide your topic from the production GTN. This is useful if you need a topic for a workshop, but have not finished making it up to GTN standards.

Boolean

If this is a synthetic tag based topic (no tutorials of it’s own) then you must set this flag to indicate it as such, otherwise you will find yourself with an empty topic page.

A dictionary/map

title
Free Text

Title of the Quiz

Example(s)

title: Diagnostic Assessment
title: SQL Basics Recap

contributors
List of Items

Who contributed to this FAQ

Example(s)

contributors:
- shiltemann
- hexylena

questions
List of Items

The questions that are part of the quiz

A dictionary/map

title
Free Text

The question title, displayed on the teacher and student screens simultaneously

Example(s)

title: How you could collect information from learners at the beginning of a course or lesson and how you can use it?
title: What keyword do you use to retrieve data in SQL

timeout
Integer Number

How long the students have to answer the question

type
Free Text

What type of question to display.

Possible Values:

  • choose-1
  • choose-many
  • free-text
  • poll

Example(s)

type: "choose-1"
type: "choose-many"
type: "free-text"
type: "poll"

List of Items

The possible answers to the question you’ve asked. Consider including common wrong answers, or answers based on common mistakes to help students identify where they went wrong.

Example(s)

answers:
- OBTAIN
- SELECT
- RETRIEVE
- RETURN

The correct answer, it MUST be part of the answers list. It can be a list of correct answers if it is a choose-many question

Example(s)

correct: SELECT
correct: AB

Free Text

Path to an image, if you’d like to include one along with the question. Should be the full path starting with /

Example(s)

image: /training-material/topics/data-science/images/carpentries-sql/sql-join-structure.svg

Boolean

Used ONLY with the poll type questions to enable displaying the results as they come in. Great for polling audiences for how they’re feeling.

Frequently Asked Questions

Have questions about this tutorial? Check out the FAQ page for the Contributing to the Galaxy Training Material topic to see if your question is listed there. If not, please ask your question on the GTN Gitter Channel or the Galaxy Help Forum

Feedback

Did you use this material as an instructor? Feel free to give us feedback on how it went.
Did you use this material as a learner or student? Click the form below to leave feedback.

Click here to load Google feedback frame

Citing this Tutorial

  1. Helena Rasche, GTN Metadata (Galaxy Training Materials). https://training.galaxyproject.org/training-material/topics/contributing/tutorials/schemas/tutorial.html Online; accessed TODAY
  2. Batut et al., 2018 Community-Driven Data Analysis Training for Biology Cell Systems 10.1016/j.cels.2018.05.012



@misc{contributing-schemas,
author = "Helena Rasche",
title = "GTN Metadata (Galaxy Training Materials)",
year = "",
month = "",
day = ""
url = "\url{https://training.galaxyproject.org/training-material/topics/contributing/tutorials/schemas/tutorial.html}",
note = "[Online; accessed TODAY]"
}
@article{Hiltemann_2023,
	doi = {10.1371/journal.pcbi.1010752},
	url = {https://doi.org/10.1371%2Fjournal.pcbi.1010752},
	year = 2023,
	month = {jan},
	publisher = {Public Library of Science ({PLoS})},
	volume = {19},
	number = {1},
	pages = {e1010752},
	author = {Saskia Hiltemann and Helena Rasche and Simon Gladman and Hans-Rudolf Hotz and Delphine Larivi{\`{e}}re and Daniel Blankenberg and Pratik D. Jagtap and Thomas Wollmann and Anthony Bretaudeau and Nadia Gou{\'{e}} and Timothy J. Griffin and Coline Royaux and Yvan Le Bras and Subina Mehta and Anna Syme and Frederik Coppens and Bert Droesbeke and Nicola Soranzo and Wendi Bacon and Fotis Psomopoulos and Crist{\'{o}}bal Gallardo-Alba and John Davis and Melanie Christine Föll and Matthias Fahrner and Maria A. Doyle and Beatriz Serrano-Solano and Anne Claire Fouilloux and Peter van Heusden and Wolfgang Maier and Dave Clements and Florian Heyl and Björn Grüning and B{\'{e}}r{\'{e}}nice Batut and},
	editor = {Francis Ouellette},
	title = {Galaxy Training: A powerful framework for teaching!},
	journal = {PLoS Comput Biol} Computational Biology}
}

                   

Congratulations on successfully completing this tutorial!
Developing GTN training material
This tutorial is part of a series to develop GTN training material, feel free to also look at:
  1. Creating a new tutorial
  2. Contributing with GitHub via command-line
  3. Overview of the Galaxy Training Material
  4. Creating Slides
  5. Creating content in Markdown
  6. Adding Quizzes to your Tutorial
  7. Principles of learning and how they apply to training and teaching
  8. Design and plan session, course, materials
  9. Including a new topic
  10. Contributing with GitHub via its interface
  11. Teaching Python
  12. Creating Interactive Galaxy Tours
  13. Updating diffs in admin training
  14. GTN Metadata
  15. Tools, Data, and Workflows for tutorials
  16. Running the GTN website online using GitPod
  17. Running the GTN website locally
  18. Adding auto-generated video to your slides
  19. Generating PDF artefacts of the website