Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mjpieters/mjpieters.github.com

Personal homepage, GitHub style
https://github.com/mjpieters/mjpieters.github.com

Last synced: about 1 month ago
JSON representation

Personal homepage, GitHub style

Awesome Lists containing this project

README

        

# Zopatista's personal site

My personal site, stripped down to something I'll actually maintain.

The projects folder only exists to support legacy URLs; the contents redirect
to pypi mostly, except for the python distribution files, for which proper
redirects would otherwise be too cumbersome to support.

## Setup

Install rbenv from homebrew, activate it, and install a [supported Ruby version](https://github.com/ruby/setup-ruby), from the `rbenv` local pin file:

```shell
$ brew install rbenv
$ rbenv init
$ rbenv install -s $(cat .ruby-version)
```

You'll need to [add rbenv to `.zshrc`](https://github.com/rbenv/rbenv#how-rbenv-hooks-into-your-shell).

I should periodically update the ruby version used to follow GitHub.

Once the ruby environment has been set up, make sure [bundler](https://bundler.io/) is installed:

```shell
$ gem install bundler
```

then install all dependencies

```shell
$ bundle install
```

For more info, see the [GitHub pages documentation](https://help.github.com/articles/using-jekyll-with-pages).

The local `bin/` directory contains binstubs for the requisite gems, and
there's a [direnv](https://github.com/zimbatm/direnv) `.envrc` file in the root
that adds that directory to your PATH when entering this directory. Please
tell direnv to allow this to work with:

```shell
$ direnv allow .
```

## Running locally

Keep the local toolchain up-to-date with:

```shell
$ bundle update
```

Run a local server to preview posts with:

```shell
$ rake serve
```

If you *don't* use direnv and have given direnv permission to run the local `.envrc` settings, then use `bin/rake`, so bundle dependencies can be found.

## Theme setup

I am using [Minimal Mistakes](https://github.com/mmistakes/minimal-mistakes) as the theme.

* The style is customised purely in `_config.yml`.
* The jekyll-redirect-to `redirect.html` layout was customised to add Google analytics.

## Link integrity checking

I've set up htmlproofer to check for link rot, run periodically with:

```shell
$ rake test
```