How to update your profile

This page explains how to update or create a profile/”floating head” as e.g. shown on the training community page.

Basics

Your profile corresponds to a text file in the _profiles directory (view on github).

If you don’t have a profile yet

Simply copy the template at the bottom of this page and modify it to include your information. You can then either

send it to the conveners via email, or
(preferred) fork the github repository, put your profile in the _profiles directory as first_name_last_name.md (don’t worry about the exact form of the name) and open a pull request.

If you want to change your profile

Either

Find your profile on github (first_name_last_name.md), copy it to a text file, make your modifications and send your new version to the conveners via email
(preferred) fork the github repository, update your information in _profiles/first_name_last_name.md and open a pull request

The template

---
# Required:
title: "Your Name"     # first (middle) last
country:               # your country of residence (2 capital letters, e.g. US, GB, DE)

# Optional (please add github or gravatar for your picture)
github:       # your github ID (not full url)
gravatar:     # your gravatar ID (the hex hash of your email, something like 123ef...123)
homepage:     # your personal homepage (full url)
twitter:      # your twitter ID (not full URL, no leading '@')
gitlab:       # your gitlab ID (not full URL)
bitbucket:    # your bitbucket ID (not full URL)
orcid:        # your orcid ID (not full URL)
linkedin:     # your linkedin ID (not full url, i.e. the last bit of the url to your profile)
email:

# Training WG
training_roles: []              # subset of [instructor, mentor, facilitator, author], can stay empty ([])
training_years: []              # in which years did you help out? (e.g. [2020, 2019])

# Don't modify the following setting
layout: educator
---

<!-- Optional: Write something about yourself below this comment. Markdown styling is supported. -->

Notes

If you have specified your gravatar (a free service for global avatar synchornization), we will take your profile picture from there. Else, the profile picture will be taken from your github profile (if specified). If the latter is not specified either, you will have a blank profile picture showing an octocat.
If you don’t know your gravatar email hash, you can use this page (or look here for more background information about the hashing)

Activity Area specific settings

To be listed as “educator” on the training community page or the educators page:
- Set the training_roles field: Zero or more of instructor, mentor, facilitator, author. The first three training_roles are explained here. You are an author if you’ve made not-completely-trivial contributions to our training material. Valid examples: [], [instructor, mentor]. Invalid: mentor (no brackets).
- Set the training_years field: This should be a list of years that you were actively contributing to the HSF Training efforts. Valid examples: [2012] , [2012, 2014]. Invalid: ["2012"].

Example

---
title: Kilian Lieret
country: DE
training_roles:
- instructor
- mentor
- facilitator
- author
training_years:
- 2020
- 2021
- 2022
- 2023
github: klieret
homepage: https://lieret.net
gitlab: klieret
bitbucket: klieret
orcid: 0000-0003-2792-7511
linkedin: kilian-lieret-0b0667104
layout: educator
---
Hi, I'm Kilian. I just finished my PhD with the Belle II experiment and recently joined IRIS-HEP and Princeton university.

If you want to include a specific selection of people on your page

Use this:

{% assign persons = "Kilian Lieret, Sudhir Malik, Sam Meehan" | split: ", " %}
{% include list_of_selected_profiles.html %}

FAQ

I’ve added my profile, but it doesn’t appear on the webpage

The webpage takes a couple of minutes to update
If you don’t find yourself on the list of educators/training people, make sure that the training_years information is correct and includes at least one year. Valid examples: [2020, 2019]. Invalid: ["2020"], 2020, []

My profile picture doesn’t show up

Make sure that your github link works or that you’ve added your gravatar ID.

I want to add/update my profile with git, but I’m stuck. Help?

Perhaps one of these links might help you:

If it doesn’t, don’t hesitate to ask us :)

My file contained some (syntax) errors and destroyed the community page

Cool, that never happened before. But no worries, just write to the convenors, who apparently did a bad job at checking your file (if you can fix it quickly, a pull request would also be nice of course).