/epic-guide.github.io

Guidebook for IC PhD life at EPFL

Primary LanguageHTMLMIT LicenseMIT

EPIC Guide

Guidebook for IC PhD life at EPFL. Visit the guide here!

This guide is put together by EDIC PhD students of all years and from different labs, to help you navigate through your research career at EPFL.

We try to keep the guide up to date, but if you notice any inconsistencies please tell us at epic@groupes.epfl.ch, or make a pull request to this repository. For the guide to grow and stay current over time, we need you to contribute!

How to contribute via pull requests

Where to write

This site is built with Jekyll and GitHub Pages. The main contents are located in the CATEGORY/_posts/ directory, where CATEGORY is one of the followings:

  • first (First Year Guide)
  • middle (Middle Years Guide)
  • last (Last Year Guide)
  • life (Life in Lausanne)

If you want to modify some contents of an existing article, locate its corresponding markdown file by observing its permalink: The article with permalink https://epic-guide.github.io/CATEGORY/YYYY/MM/DD/NAME.html locates at CATEGORY/_posts/YYYY-MM-DD-NAME.md.

If you want to write a new article, add a new file in the corresponding CATEGORY/_posts/ directory with file name YYYY-MM-DD-NAME.md, where YYYY-MM-DD is the created date of the article and NAME is a short name of it.

Note: Please avoid changing the names of existing articles as this will change its permalink.

Article header (YML front matter)

In the first few lines of each article, please remember to include/update the following fields:

  • layout: post (Just keep it like this)
  • title: "Candidacy exam" (The full title of the article)
  • date: 2021-08-09 (Last updated date, in YYYY-MM-DD format. This can be different from the date in its file name!)
  • category: first (Category as described in the previous section)
  • order: 1 (Order of the article in the category. Articles are sorted in ascending order on the guide index page.)

How to write markdown

The content of the articles can be written in markdown and/or HTML.

Here are some basic markdown syntax if you are not familiar with it.

Here is a page demonstrating many formatting possibilities you can do with markdown; it's source code is here.

Note: As the h1 heading is reserved for the article title, please use h2 (two hashtags in markdown ##) or smaller headings within the article.

How to make a pull request

To make a pull request, first fork this repository, make changes and commit to your fork, and come back here and click on "compare & pull request".

Remember to add yourself in the contributor list

Edit index.md to include your name!

Testing locally

If you would like to build the webpage locally to preview the changes:

  1. Check (and install if not fulfilled) the prerequisites: Ruby >= 2.5.0 with Dev headers, RubyGems, GCC and Make.
  2. Install Jeykll following the steps according to your operating system.
  3. Change to the root directory of this repo, run first bundle install, and then bundle exec jekyll serve.
  4. Open a browser and go to http://localhost:4000.