No description
Find a file
2021-05-14 17:44:32 +02:00
.bundle update to ruby 3.0.0 2021-01-06 00:24:20 +01:00
.github/workflows Add ilinks check to GH Actions 2021-04-06 14:59:28 +02:00
commands Add command for event 2020-08-12 15:52:04 +02:00
content offline regels 2021-05-14 17:36:20 +02:00
data Thanks Charlotte! 2021-05-06 22:46:00 +02:00
drive@4a68374555 fix some mobile css and balance out the site a bit more 2021-03-18 15:02:08 +01:00
layouts typography and L A T E X 2021-03-21 10:26:24 +01:00
lib remove redundant map 2021-05-05 12:03:30 +02:00
templates Maybe fix Latex 2020-11-17 09:11:57 +01:00
.codeclimate.yml Use latest rubocop in codeclimate 2020-02-02 17:19:32 +01:00
.gitignore update to ruby 3.0.0 2021-01-06 00:24:20 +01:00
.gitmodules Let submodule track master instead of a single commit 2018-12-29 17:50:23 +01:00
.mdlrc fix some markdown linting 2017-05-22 03:29:42 +02:00
.ruby-version update to ruby 3.0.0 2021-01-06 00:24:20 +01:00
.travis.yml pls travis pls 2021-04-06 09:54:42 +02:00
Checks disable html check 2017-05-01 23:56:38 +02:00
comment.sh Removed comment 2019-03-08 02:47:07 +01:00
deploy.sh try travis PR comments 2018-10-16 21:28:15 +02:00
Gemfile use bundix for nixos-shell 2021-04-03 13:59:39 +02:00
Gemfile.lock use bundix for nixos-shell 2021-04-03 13:59:39 +02:00
gemset.nix use bundix for nixos-shell 2021-04-03 13:59:39 +02:00
Guardfile fix typos ..and a few other things 2017-06-14 09:09:37 +02:00
id_rsa.enc add encrypted ssh key 2016-07-18 13:31:59 +02:00
LICENSE Create LICENSE 2018-03-23 00:22:07 +01:00
nanoc.yaml fix some mobile css and balance out the site a bit more 2021-03-18 15:02:08 +01:00
package.json fix some mobile css and balance out the site a bit more 2021-03-18 15:02:08 +01:00
README.md Change travis badge to new url 2021-02-28 15:14:00 +01:00
Rules use preprocessor 2021-05-05 12:01:06 +02:00
shell.nix remove terminal-notifier 2021-04-04 21:59:42 +02:00
yarn.lock fix some mobile css and balance out the site a bit more 2021-03-18 15:02:08 +01:00

zeus.ugent.be

Build Status Code Climate PageSpeed PageSpeed

This repository contains the source code for zeus.ugent.be, the website of Zeus WPI, the official student association of Informatics at Ghent University. The site is developed using nanoc, which is actively developed by ex-Zeus member ddfreyne. The CSS framework used is Bulma. We primarily focus on using markdown for blogposts and events. Feel free to make a Pull Request with a blog post if you feel inspired and need an outlet!

Please check the Wiki for questions about structure.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

You will need Ruby (gem), yarn and pandoc (optional). Installation instructions are listed below.

Installing

If bundler is not yet installed on your system, make sure to install it using the following command:

gem install bundler

In the root directory of the project, execute following commands

bundle install
yarn install

You will (momentarily) also need pandoc and latex to compile the reports from the board meetings. Refer to your OS package manager to install these things.

These will pull in all Ruby and Node.js dependencies. If everything goes well, you should be able to execute the following.

bundle exec nanoc live

Go to http://localhost:3000 to view the site! When developing, the site gets regenerated when editing files. A simple refresh will show the new changes.

Optional: install submodules

Our official meeting reports are added as a submodule so they update automatically. For normal development, it is not required to initialize these. But if you want to deploy to production (or test the report generation), you will have to initialize the submodule.

git submodule update --init --recursive

Deploying

The latest and greatest builds on master get deployed automatically using travis.

For manual deployment, run

# Build the site for production
bundle exec nanoc --env=prod

# Run checks
bundle exec nanoc --env=prod check --deploy

# Deploy it to the server
bundle exec nanoc deploy --target public --env=prod

If you want to deploy this on your own system for whatever reason, just serve the files using a webserver like nginx or Apache.

Uploading media files

Before using mediafiles on the site, upload them via https://zeus.ugent.be/zeuswpi/, our own custom uploading service. You'll receive the server-filename which is available at the aforementioned url.

Submitting a Pull Request

Once you've submitted a PR, it will automatically be deployed to (PR#).pr.zeus.gent, for easier reviewing.

Analytics

Analytics are powered by Fathom and are available on https://stats.zeus.gent. These are only available to administrators with proper rights. These analytics are self hosted and provide only simple statistics for our information, without breaching your privacy.

Built With

  • nanoc, static site generator
  • Bulma, CSS framework

Authors

See the list of contributors who participated in this project.