About
This ELIXIR SCO Community website is hosted by Github and follows the Github Pages using Jekyll. With a few exceptions, most pages can be created using simple markdown text, just like this page itself. You can download this page markdown and edit it locally via git clone or directly on Github.
Virtually all pages can be edited directly on the SCO GH-repo for the SCO repository. You simply just need to go to the file you want to modify and click on “Edit”. This is particularly useful in case of editing small bugs or editing a Markdown file from an Event, for example.
The easiest way to contribute with hands-on designs is to:
git clone to your own machinedocs folder and run the bash jekyll.shhttp://0.0.0.0/4000 and voilà!Once you are happy with the changes made, you can now create a pull request (PR) to the main page like so:
git add ..git commit -m 'SHORT MESSAGE OF WHAT YOU CHANGED'.git push to upload your modifications to Github.contribute to the main repository via pull request."SHORT MESSAGE OF WHAT YOU CHANGED") and click on the green button to create the pull request.In these page sections, you can add information and lists of resources:
You can list News and Upcoming events to the this file: /docs/pages/news/new_and_events.csv. There, you should simply add a new line and fill the information for all columns.
If you would like to create an SCO Community event, you need to do these ### steps:
/docs/pages/news/events. Please use this naming convention: “YYYYMMDD_Event_Title.md”, where “YYYY-MM-DD” is the 1st day of the event incase of multiple days.20230321_SCO_trainer_workshop.md event as a template as inspiration. In your event, you should add the relevant sections, i.e.:
- Brief introduction (please polish to maximum 100 words)
- Dates and city/country
- Venue details, including Travel information and Accommodation
- Online Attendance options
- Participating institution logos/names
- Footnotes/References./docs/pages/news/new_and_events.csv.There are 2 major HTML layout files can be found in the docs/_layouts folder:
default.html: this layout is filled with boxes and links to the different webpage functionalities. The main webpage uses this layout.
markdown.html: this layout is formatted to display markdown text, such as events news and other information in text format.
In addition to the main layouts, the source files used by the webpage sections are found in these four files, in the the docs/_includes folder
header.html: this is a invisible section, used to load the CSS styles, scripts and other functions.
topnav.html:
tertiary_content.html
footer.html: this is the last visible dark blue section at the bottom of the page, and it is used to display information about the webpage itself and load-and-run additional scripts that need to be executed after the content is loaded (eg. the script to create the side table of contents).
All website scripts and custom functions are found in the docs/css folder.
All website scripts and custom functions are found in the docs/javascript folder.
When creating a markdown file, please make sure to include this header in the beginning so it can be rendered with the correct template markdown and with the correct group (one of the following: About, News, Events, Data, Tools, Training). For example:
---
transparentnav: false
fixednav: true
logosnav: true
layout: markdown
group: Events
---
In case of event pages that require a time-sensitive button for application, that can be achieved by setting 2 things. First, make sure that in you YAML header you include the application_open and application_close values to a date in “YYYY-MM-DD” format.
---
transparentnav: false
fixednav: true
logosnav: true
layout: markdown
application_open: 2023-01-20
application_close: 2023-03-12
group: Events
---
Second, you can now add the following code just below your event header to add an automatic button that will become active or inactive when application has passed.
`<button id="apply_button" class="" open="" close="" onclick=""></button>`
This HTML above use those variables application_open and application_close to decide when to activate and when to close the applications, simply by re-styling the button.
All other markdown tools and formatting options will be rendered as usual, and the table of contents (TOC) sidebar will be updated automatically using a javascript. So please
<p style="color: #f47d21">About</p> (IGNORED THE TOC)
# Title 1 (IGNORED THE TOC)
## Title 2
### Title 3
#### Title 4
##### Title 5
###### Title 6
<br> //To add some extra blank line
Some text in **bold** and *italics* and as a [clickable link](https://www.czarnewski.com).
The line <p style="color: #f47d21">About</p> automatically adds the page group from the YAML header
Syntax highlighting styles stolen from github-pages-leap-day theme generated by rouge, original base16 by Chris Kempson.
git add .
for i in 1..10
do
echo $i
done
.
