https://github.com/harrison-broadbent/personal_site

code for my personal website
https://github.com/harrison-broadbent/personal_site

Last synced: 3 months ago
JSON representation

code for my personal website

• Host: GitHub
• URL: https://github.com/harrison-broadbent/personal_site
• Owner: harrison-broadbent
• Created: 2020-03-03T02:57:51.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2024-08-13T21:50:00.000Z (5 months ago)
• Last Synced: 2024-08-14T00:43:30.466Z (5 months ago)
• Language: CSS
• Homepage: https://www.harrisonbroadbent.com
• Size: 102 MB
• Stars: 2
• Watchers: 3
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Ruby Middleman Tailwind Starter Blog

A Middleman blog template configured with TailwindCSS, markdown parsing, code highlighting, a sitemap.xml and more. It perfect for lightweight blogging or a personal website. Ruby knowledge is helpful, but not necessary.

## Features

- Middleman v4.5,

- TailwindCSS v3.4.3,

- Markdown support (via `kramdown`),

- Blogging support (via `middleman-blog`),

- Syntax highlighting support (via `middleman-syntax`),

- Live-reloading (via `middleman-livereload`) and `bin/dev` script,

- Automatic `sitemap.xml` generation,

- SEO-friendly automatic meta tags for `title` and `description`,

- Perfect [100/100 PageSpeed score](https://pagespeed.web.dev/analysis/https-main--ruby-middleman-tailwind-starter-blog-netlify-app/o3pfqkngtp?form_factor=desktop) (near perfect for mobile)

- Github Action for image compression (see `compress_images.yml`).

Visit the [live template demo](https://main--ruby-middleman-tailwind-starter-blog.netlify.app/) for a preview of how it looks (although of course, you can customize it yourself).

I've used [Middleman](https://middlemanapp.com/) for years to build my personal website, and this template is a consolidation of everything I've learned.

## Getting started

Before you get started, make sure you've got Ruby installed. Currently, this template uses Ruby `v3.3.0`.

Clone this template, then install the required packages and start the server:

```sh

bundle   # install packages

bin/dev  # start dev server

```

## Deploying

This template is easy to deploy. Any static site host should work; I personally use Netlify and I've included the Netlify + Vercel "Deploy" buttons below.

|         |                                                                                                                                                                                                   |

| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

| Netlify | [![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/harrison-broadbent/ruby-middleman-tailwind-starter-blog) |

| Vercel  | [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fharrison-broadbent%2Fruby-middleman-tailwind-starter-blog)              |