Skip to content

Latest commit

 

History

History
489 lines (418 loc) · 17.2 KB

index.md

File metadata and controls

489 lines (418 loc) · 17.2 KB
layout venue address country language latitude longitude humandate humantime startdate enddate instructor helper email collaborative_notes eventbrite
workshop
FIXME
FIXME
FIXME
FIXME
45
-1
FIXME
FIXME
FIXME
FIXME
instructor one
instructor two
helper one
helper two

{% comment %} See instructions in the comments below for how to edit specific sections of this workshop template. {% endcomment %}

{% comment %} HEADER

Edit the values in the block above to be appropriate for your workshop. If the value is not 'true', 'false', 'null', or a number, please use double quotation marks around the value, unless specified otherwise. And run 'make workshop-check' before committing to make sure that changes are good. {% endcomment %}

{% comment %} 8< ============= For a workshop delete from here ============= For a workshop please delete the following block until the next dashed-line {% endcomment %}

{% comment %} Assign first row in data file as info to access workshop data {% endcomment %} {% assign info = site.data.data[0] %}

{% comment %} Assign value in eventbrite file as eventbrite to access the code {% endcomment %} {% assign eventbrite = site.data.eventbrite %}

{% comment %}

This is the workshop template. Delete these lines and use it to customize your own website. If you are running a self-organized workshop or have not put in a workshop request yet, please also fill in this workshop request form to let us know about your workshop and our administrator may contact you if we need any extra information. If this is a pilot workshop for a new lesson, remember to uncomment the `pilot_lesson_site` field in `_config.yml`
{% endcomment %}

{% comment %} 8< ============================= until here ================== {% endcomment %}

{% comment %} Check carpentry {% endcomment %}

{% if info.carpentry == "FIXME" %}

It looks like you are setting up a website for a workshop but you haven't specified the carpentry type in the _data/data.csv file (current value in _data/data.csv: "{{ info.carpentry }}", possible values: swc, dc, lc, cp, ds, or pilot). After editing this file, you need to run make serve again to see the changes reflected.
{% endif %}

{% comment %} Read correct lesson meta from esciencecenter-digital-skills/workshop-metadata {% endcomment %}

{% if info.flavor and info.flavor != 'NA' %} {% capture lesson_meta %}https://raw.githubusercontent.com/esciencecenter-digital-skills/workshop-metadata/main/{{info.curriculum}}-{{info.flavor}}{% endcapture %} {% else %} {% capture lesson_meta %}https://raw.githubusercontent.com/esciencecenter-digital-skills/workshop-metadata/main/{{info.curriculum}}{% endcapture %} {% endif %}

{% comment %} Check DC curriculum {% endcomment %}

{% comment %} EVENTBRITE

This block includes the Eventbrite registration widget if 'eventbrite' has been set in the header. You can delete it if you are not using Eventbrite, or leave it in, since it will not be displayed if the 'eventbrite' field in the header is not set. {% endcomment %} {% if eventbrite %} Some adblockers block the registration window. If you do not see the registration box below, please check your adblocker settings.

<iframe src="https://www.eventbrite.com/tickets-external?eid={{eventbrite}}&ref=etckt" frameborder="0" width="100%" height="400px" scrolling="auto"> </iframe> {% endif %}

General Information

{% comment %} INTRODUCTION

Edit the general explanatory paragraph below if you want to change the pitch. {% endcomment %} {% if info.carpentry == "swc" %} {% include swc/intro.html %} {% elsif info.carpentry == "dc" %} {% include dc/intro.html %} {% elsif info.carpentry == "lc" %} {% include lc/intro.html %} {% elsif info.carpentry == "ds" %} {% include ds/intro.md %} {% remote_include {{lesson_meta}}/description.md %} {% endif %}

{% comment %} AUDIENCE

Explain who your audience is. (In particular, tell readers if the workshop is only open to people from a particular institution. {% endcomment %} {% if info.carpentry == "swc" %} {% include swc/who.html %} {% elsif info.carpentry == "dc" %} {% include dc/who.html %} {% elsif info.carpentry == "lc" %} {% include lc/who.html %} {% elsif info.carpentry == "ds" %}

Who: 
{% remote_include {{lesson_meta}}/who.md %}
{% endif %}

{% comment %} LOCATION

This block displays the address and links to maps showing directions if the latitude and longitude of the workshop have been set. You can use https://itouchmap.com/latlong.html to find the lat/long of an address. {% endcomment %} {% assign begin_address = info.address | slice: 0, 4 | downcase %} {% if info.address == "online" %} {% assign online = "true_private" %} {% elsif begin_address contains "http" %} {% assign online = "true_public" %} {% else %} {% assign online = "false" %} {% endif %} {% if info.latitude and info.longitude and online == "false" %}

Where: {{info.address}}. Get directions with OpenStreetMap or Google Maps.

{% elsif online == "true_public" %}

Where: online at {{info.address}}. If you need a password or other information to access the training, the instructor will pass it on to you before the workshop.

{% elsif online == "true_private" %}

Where: This training will take place online. The instructors will provide you with the information you will need to connect to this meeting.

{% endif %}

{% comment %} DATE

This block displays the date and time. {% endcomment %} {% if info.humandate %}

When: {% if info.humantime %} {{info.humandate}}, {{info.humantime}}. {% else %} {{info.humandate}}. {% endif %}

{% endif %}

{% comment %} SPECIAL REQUIREMENTS

Modify the block below if there are any special requirements. {% endcomment %}

Requirements: {% if online == "false" %} Participants must bring a laptop with a Mac, Linux, or Windows operating system (not a tablet, Chromebook, etc.) that they have administrative privileges on. {% else %} Participants must have access to a computer with a Mac, Linux, or Windows operating system (not a tablet, Chromebook, etc.) that they have administrative privileges on. {% endif %} They should have a few specific software packages installed (listed below).

{% comment %} ACCESSIBILITY

Modify the block below if there are any barriers to accessibility or special instructions. {% endcomment %}

Accessibility: {% if online == "false" %} We are committed to making this workshop accessible to everybody. The workshop organizers have checked that:

  • The room is wheelchair / scooter accessible.
  • Accessible restrooms are available.

Materials will be provided in advance of the workshop and large-print handouts are available if needed by notifying the organizers in advance. If we can help making learning easier for you (e.g. sign-language interpreters, lactation facilities) please get in touch (using contact details below) and we will attempt to provide them.

{% else %} We are dedicated to providing a positive and accessible learning environment for all. Please notify the instructors in advance of the workshop if you require any accommodations or if there is anything we can do to make this workshop more accessible to you.

{% endif %}

Workshop files: You will find all slides, notebooks, archived collaborative documents, and other relevant files in the files folder of the workshop website repository after the workshop.

{% comment %} CONTACT EMAIL ADDRESS

Display the contact email address set in the configuration file. {% endcomment %}

Contact: Please email {% if site.email %} {% for email in site.email %} {% if forloop.last and site.email.size > 1 %} or {% else %} {% unless forloop.first %} , {% endunless %} {% endif %} {{email}} {% endfor %} {% else %} to-be-announced {% endif %} for more information.

{% comment %} WHO CAN ATTEND?

If you would like to specify who can attend the workshop, you can use the section below.

Move the 'endcomment' tag above the beginning of the following

tag to make this section visible.

Edit the text to match who can attend the workshop. For instance:

  • This workshop is open to affiliates to ABC university.
  • This workshop is open to the public.
  • If you are interested in attending this workshop, contact [email protected] for more information

Who can attend?: This workshop is open to ....

{% endcomment %}

{% comment%} CODE OF CONDUCT {% endcomment %}

Code of Conduct

{% if info.carpentry == "ds" %}

Participants are expected to follow these guidelines:

  • Use welcoming and inclusive language
  • Be respectful of different viewpoints and experiences
  • Gracefully accept constructive criticism
  • Focus on what is best for the community
  • Show courtesy and respect towards other community members

{% else %}

Everyone who participates in Carpentries activities is required to conform to the Code of Conduct. This document also outlines how to report an incident if needed.

Report a Code of Conduct Incident


{% endif %}

{% comment %} Collaborative Notes

If you want to use an Etherpad, go to

https://pad.carpentries.org/YYYY-MM-DD-site

where 'YYYY-MM-DD-site' is the identifier for your workshop, e.g., '2015-06-10-esu'.

Note we also have a CodiMD (the open-source version of HackMD) available at https://codimd.carpentries.org {% endcomment %} {% if page.collaborative_notes %}

Collaborative Notes

We will use this collaborative document for chatting, taking notes, and sharing URLs and bits of code.


{% endif %}

{% comment %} SCHEDULE

Show the workshop's schedule.

Small changes to the schedule can be made by modifying the schedule.html found in the _includes folder for your workshop type (swc, lc, or dc). Edit the items and times in the table to match your plans. You may also want to change 'Day 1' and 'Day 2' to be actual dates or days of the week.

For larger changes, a blank template for a 4-day workshop (useful for online teaching for instance) can be found in _includes/custom-schedule.html. Add the times, and what you will be teaching to this file. You may also want to add rows to the table if you wish to break down the schedule further. To use this custom schedule here, replace the block of code below the Schedule <h2> header below with {% include custom-schedule.html %}. {% endcomment %}

{% if info.carpentry == "ds" %}

Syllabus

{% remote_include {{lesson_meta}}/syllabus.md %} {% endif %}

Schedule

{% if info.carpentry == "swc" %} {% include swc/schedule.html %} {% elsif info.carpentry == "dc" %} {% include dc/schedule.html %} {% elsif info.carpentry == "lc" %} {% include lc/schedule.html %} {% elsif info.carpentry == "ds" %} {% remote_include {{lesson_meta}}/schedule.md %} {% elsif info.carpentry == "pilot" %} The lesson taught in this workshop is being piloted and a precise schedule is yet to be established. The workshop will include regular breaks. If you would like to know the timing of these breaks in advance, please contact the workshop organisers. For a list of lesson sections and estimated timings, [visit the lesson homepage]({{ site.lesson_site }}). {% comment %} Edit/replace the text above if you want to include a schedule table. See the contents of the _includes/custom-schedule.html file for an example of how one of these schedule tables is constructed. {% endcomment %} {% endif %}


{% comment %} SETUP

Delete irrelevant sections from the setup instructions. Each section is inside a 'div' without any classes to make the beginning and end easier to find.

This is the other place where people frequently make mistakes, so please preview your site before committing, and make sure to run 'tools/check' as well. {% endcomment %}

Setup

To participate in {% if info.carpentry == "swc" %} a Software Carpentry {% elsif info.carpentry == "dc" %} a Data Carpentry {% elsif info.carpentry == "lc" %} a Library Carpentry {% else %} this {% endif %} workshop, you will need access to software as described below. In addition, you will need an up-to-date web browser.

We maintain a list of common issues that occur during installation as a reference for instructors that may be useful on the Configuration Problems and Solutions wiki page.

{% comment %} These are the installation instructions for the tools used during the workshop. {% endcomment %}

Software setup

{% if info.carpentry == "swc" %} {% include swc/setup.html %} {% elsif info.carpentry == "dc" %} {% include dc/setup.html %} {% elsif info.carpentry == "lc" %} {% include lc/setup.html %} {% elsif info.carpentry == "ds" %} {% capture content %} {% remote_include {{lesson_meta}}/setup.md %} {% endcapture %} {% if content contains "/setup.md" %} {% capture setup %} {% remote_include https://raw.githubusercontent.com/{{content | strip}} %} {% endcapture %} {{ setup | split: "---" | last}} {% else %} {{ content }} {% endif %} {% elsif info.carpentry == "pilot" %} Please check the "Setup" page of [the lesson site]({{ site.lesson_site }}) for instructions to follow to obtain the software and data you will need to follow the lesson. {% endif %}

{% comment %} For online workshops, the section below provides:

  • installation instructions for the Zoom client
  • recommendations for setting up Learners' workspace so they can follow along the instructions and the videoconferencing

If you do not use Zoom for your online workshop, edit the file _includes/install_instructions/videoconferencing.html to include the relevant installation instrucctions. {% endcomment %} {% if online != "false" %} {% include install_instructions/videoconferencing.html %} {% endif %}