My blog (work in progress)
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
archetypes Changed the default template. Oct 21, 2017
content
future/kings
public
search
static
themes/bramp
.gitignore
Makefile
README.md
config.yaml
deploy.sh
html-minifier.conf
hugo.sh
md5ln.sh
test_urls.sh

README.md

bramp.net blog

This is a redesign of my wordpress blog, to a Hugo based static site.

New Features

  • Static site, no more Wordpress + PHP + MySQL maintance
  • Using Hugo (written in Go)
  • Hosted on GitHub's CDN. This gives speed and SSL
  • Simplier / Cleaner / Modern HTML design

Dependencies

# Install hugo (Mac)
brew install hugo@v0.31.1

# Install hugo (Linux)
sudo apt-get install hugo

# Install hugo (Other)
go get github.com/kardianos/govendor
govendor get github.com/spf13/hugo@v0.31.1

# For minifiying/linting
npm install clean-css-cli@4.1.10 uglify-js@3.2.1 html-minifier@3.5.7 purify-css@1.2.5
brew install parallel # or sudo apt-get install parallel

Build

./deploy.sh

New Article

# `make help` shows the example:
hugo new post/2017-07-15-the-title.md
nano content/post/2017-07-15-the-title.md
make watch

Optimise Images

find content static -name '*.png' | parallel --no-notice --tag zopflipng -y "{}" "{}"
find content static -name '*.gif' | parallel --no-notice --tag gifsicle -O -o "{}" "{}"

Checks

linkchecker http://localhost:1313/ > log.internal
linkchecker --check-extern http://localhost:1313/ > log.external

Font Awesome

Font Awesome contains some awesome icons, but sadly is huge! So I used icomoon to make a svg sprite of the icons I want, and use slightly different options to display them on the screen. Info: https://usolved.net/blog/post/switch-from-icon-fonts-to-svg-icons

TODO

  • Fix disqus (dsq_thread_id). Have to update URLs on disque
  • Problem parsing last link in markdown. (e.g [N] doesn't work) Fix at https://github.com/russross/blackfriday/issues/180
  • Check the links haven't changed. Write script to check all URLs on bramp.net still exist
  • Test 404
  • Center all tables
  • Ensure no broken links

TODO (nice to have)

  • Amazon code
  • Tag cloud
  • Change to a full width layout (like http://blog.gopheracademy.com/)
  • Makefile, compress html, etc
  • Add a "edit me link"
  • Test twitter card
  • Investigate facebook card
  • Minify JS/CSS
  • Report bug in hugo with tags with dots in the name. For example "last.fm" is handled incorrectly.
  • Sitemap.xml does not contain all pages (such as /opensource-project/*)
  • The Summary/Descriptions are wrong on pages using the syntax