Skip to content

GCCR/GCCR.github.io

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Sep 10, 2023
b406a3e · Sep 10, 2023
Aug 3, 2023
May 24, 2022
Sep 10, 2023
Jun 21, 2022
Apr 23, 2020
Jun 23, 2021
Jun 5, 2022
Jun 21, 2022
Jul 19, 2022
May 17, 2020
Jun 29, 2020
Jun 9, 2021
Oct 11, 2021
Mar 30, 2020
Aug 3, 2023
Aug 3, 2023
Mar 27, 2020
Jun 2, 2022
Apr 23, 2020
Sep 10, 2023
Jun 6, 2021
Aug 3, 2023
Apr 21, 2020
Dec 17, 2020
Dec 12, 2020
Oct 11, 2021
Sep 13, 2020
May 27, 2022
Apr 23, 2020
Oct 11, 2021

Repository files navigation

GitHub Pages build status

~ Official website of the GCCR ~

Contributing to the website

👉 To add new survey links, edit _data/survey-links.yml and be careful with the indentation !

For developers

  1. Setting up the environment

Start by installing Jekyll and its dependencies by following the instructions here

We recommend you to update Ruby Gems and the bundler after that:

gem update --system
bundle update --bundler
  1. Cloning the repository
git clone https://github.com/GCCR/GCCR.github.io.git
cd GCCR.github.io

The master branch is used to build the website. Modifications on this branch will directly affect the website so push commits on this branch only after testing them locally.

When making big changes, you should push your commits to a new branch, then open a pull-request so that it can be reviewed by others. Once approved, your branch will be merged with the master branch which will automatically trigger an update of the website.

A few reminders about git:

  • To identify which branch you're working on, use git branch.
  • To switch between branches, use the git checkout command.
  • If you realize too late that you've started working on the master branch instead of a new branch, you can move your changes to a new branch with the git switch -c my-new-branch command.
  • To push your changes from a branch new-branch to GitHub, use git push -u origin new-branch.
  1. Running the website locally

You'll need to install a few plugins first

bundle install

You're done ! To run the server locally, type bundle exec jekyll serve and the default address should be http://localhost:4000/

I heavily suggest that you quickly go through Jekyll's tutorial to understand how Jekyll works.

  1. Organization of the repo
  • surveys folder: all the translations for the surveys pages are located here
  • _data folder These files should NOT be modified manually, except:
  • _includes folder: all the repetitive HTML code (navigation bar, footer, contact form...etc.) is gathered here
  • _layouts folder: contains templates for the website pages (a default layout shared by every page, and a template for blog posts which inherits from the default one)
  • _posts folder: where blog/news posts will be located. ⚠️ All files in this folder should be named YYYY-MM-DD-short-title.md. The format used by these files is Markdown, but you can also use plain HTML if you're comfortable with it. The front-matter at the begining of each .md file is used to specify the author and the title (and maybe more things later). You can use a custom alias for the author name by creating a new entry in _data/authors.yml. If you don't want to create an entry, simply type you full name, and it will use the default GCCR avatar and link the GCCR Twitter instead of your own.
  • _sass folder: contains custom SCSS files.
  • _scripts folder: scripts to automatically generate some files (for now, the members map and listing)
  • assets folder: all images, javascript resources, css stylesheets...etc. are located here
  • news folder: contains the front page for the blog/news section.
  • _config.yml file: the configuration file read by Jekyll. This is where you configure the default layouts used by each page, permalinks, plugins for SEO...etc. You can access the value of any variable in this file through {{ site.my_variable }} in your HTML code.