cssbristol.co.uk

cssbristol.co.uk

Source code for the UoB Computer Science Society web portal

Computer Science Society - University of Bristol

Overview

This repository contains the code for the University of Bristol Computer Science Society website, cssbristol.co.uk.

The site is built using Jekyll, a static site generator. If you want to get Jekyll running locally, GitHub provides some instructions.

When a commit is made to master, GitHub will automatically rebuild the site and the updated version will start being served to users.

If you have comments or questions, there are lots of ways to get in touch:

Contributing

Blog posts and tutorials

We would love to add your content to the site! If you think you can contribute a tutorial or a blog post, have a read of the instructions and submit a pull request with your content.

New features

We're all ears for any ideas that you might have. If you want to write it yourself, let us know and we'll see if we can help out. If you just want to submit a feature request or idea, create an issue.

Build & Run

Pre-requisites

  • Install Git.
  • Install Ruby.
  • Install Bundler by running gem install bundler.

Acquiring and building the project

  • Fork the project on GitHub.
  • Clone your fork, e.g. git clone https://github.com/<username>/cssbristol.github.io
  • bundle install to install all dependencies (Ruby gems).
  • bundle exec jekyll build to build the site.
  • bundle exec jekyll serve, then view site at http://localhost:4000/

Roadmap

  • Add a jobs section
  • Add outreach information
  • Add sports information
  • Add sponsorship tiers
  • Write some more tutorials!
  • Add alumni profiles
  • Add information for freshers
  • Links to related societies
  • Add committee meeting minutes
  • Add society history

Contributors

Developers

The initial version of the current site was designed and written by Julian Laval, the 2015-16 webmaster.

The site was ported to Jekyll by Ross Gardiner, the 2016-17 webmaster.

The site was then maintained by: Louis Heath and then Sibela Chinareva

The site is currently maintained and updated by Daniel Jones

Authors

Ben Marshall - wellbeing

License

The code and contents of this website are freely available under the MIT License.

Jekyll, and any parts of the Jekyll default template are also available under the MIT License.

ViewerJS is licensed under the AGPL 3.0.

FontAwesome icons are licensed under the SIL Open Font License 1.1.