UK SKA Regional Centre user guide

The webpage is created using Jekyll theme Minimal Mistakes guide. The pages are written in markdown. A guide for using markdown in github. This affects how the page is formatted (fonts, tables, links etc).

• Minimal mistakes formatting sheet
• https://www.markdownguide.org/getting-started/
• https://www.markdownguide.org/cheat-sheet/
• https://pages.github.com/
• Youtube tutorial : Jekyll - Static Site Generator

• Adding Events and News

1. Open _posts folder

2. Create new file

• Create a new file
• Name the file using the following convention: YYYY-MM-DD-meaningful-title.md
• If you want the post to be published at a later time point, use XXX instead of the date.

3. Add front matter markdown file (.md)

• copy and update (e.g. new title) the Front matter from an existing _post into the top of the new _post file. This is the text between the --- is not rendered on the webpage. The front matter allows page-specific variables to be included at the top of a page.
• 
• Learn more : https://mmistakes.github.io/minimal-mistakes/docs/posts/

4. Add the main content to the page

• using markdown syntext add the main content to the page
• include who, what, where and how in the news and article and how it relates to UKSRC (e.g. team member contributing to the teaching, someone presenting, using our hpc resources).

5. Publish the page

• Press commit changes (green button)

Adding and updating main webpages

1. Open _pages folder

2. To edit a page click on the pencil icon

• 

3. Create new file

• Create a new file
• give it a "meaninful-title.md"
• Add front matter to the _page. This can be copied from an existing page in the folder.
  • 

4. Publish the page

• Press commit changes (green button)