bradlug.github.io

bradlug.github.io

Bradford Linux User Group website and public documents.

Bradford GNU/Linux Users Group

A self-help group for GNU/Linux, Open Source and Free Software users in and around the Bradford District, West Yorkshire

How to run this locally

First time installation of jekyll and dependencies

gem install bundler
bundle install

From the main folder you may use 'bundle exec' to run jekyll like so

bundle exec rake build

Run a server to test the output locally

bundle exec rake

Test the site, complain about badly formed html etc

bundle exec rake test

If you already have Docker and docker-compose installed, and don't do much Ruby work, you might find it easier to use the Docker way of running the site locally. Run docker-compose up to launch the site in a container and after it has installed dependencies you can browse to http://127.0.0.1:4000/.

Things change

If the above instructions are not working for you, don't worry - you might have to update / upgrade and do the following things listed in the Installing Ruby section.

https://gorails.com/setup/ubuntu/ Make sure you pick the right version of Ubuntu

Then install dependencies

bundle install

Build

bundle exec rake build    

Serve

bundle exec rake

Browse http://0.0.0.0:4000/

Website Plan

While under development we can see the site at: https://bradlug.github.io/

Planning documents:

Actions and Decisions

  • Old site still available at http://old.bradlug.co.uk server has become rather flakey and requires a little nudge occasionally to keep it available, once we're happy I'll kill the old site for good, but for now it can be used for reference purposes.
  • We need to export the current site from Wordpress. See Wordpress to Jekyll N.B. we may need to the command line options of the plugin to run the export
  • Comments - we don't need to worry about saving comments, or having comments
  • We should end up with same URLs
  • We can ditch some existing content e.g. CVS articles - and we won't about redirects
  • IT Stuff content - shi will export that to IT Stuff website.
  • IRC - is anyone using it? We don't think they are. Should we replace it? Gitter could be an option. We can wait and see on this
  • If we want site search we'd need to embed a google search, or jekyll plugin
  • If we want the calendar we can do a javascript/iframe thing
  • We will ditch some content e.g. CVS articles- don't worry about redirects
  • Later we will need to re-point the domain.

Contributing to the website

We now have a Github organization "Bradlug". If you are or have been a member and would like to contribute, get in touch by creating a new issue.

When someone goes rogue?

Just roll back.