Code Monkey home page Code Monkey logo

bare-hugo-theme's Introduction

Bare

Netlify Status

Preview: https://hugo-bare-theme.netlify.com/

A speed-focused, minimalist Hugo blog theme based on Bulma.io. Looks great on mobile and loads in a flash.

Homepage Post Mobile

How to use:

Install the theme:

git submodule add https://github.com/orf/bare-hugo-theme.git themes/bare
# This is required:
git submodule update --init --recursive

If using Netlify, add the following to your netlify.toml file:

[build]
command = "git submodule update --init --recursive --depth=1 && hugo --minify --ignoreCache"

[context.deploy-preview]
command = "git submodule update --init --recursive --depth=1 && hugo -b $DEPLOY_PRIME_URL --minify --ignoreCache"

Configuring the theme

Example configuration:

[params]
mainSections = ["posts"]
author = "Tom Forbes"
email = "[email protected]"
description = 'Python developer living and working in Lisbon'
postcss = true
# Include the author name in the <title> of articles
includeAuthorInTitle = true
# Can be any colour here: https://bulma.io/documentation/layout/hero/#colors
# e.g "warning" or "danger" for yellow or red.
hero_colour = "info"

The theme will pull posts from the content sections you define in mainSections. In the example above all posts from content/posts will be included in the homepage.

PostCSS

You can use postcss to strip out all the unused Bulma CSS rules. This brings the CSS bundle down from 180kb to 10kb.

To enable this set params.postcss to true in your config.toml. Then, copy the package.json and the postcss.config.js into your repository and run npm install.

Social buttons

Social buttons can be configured by adding a params.social array. Icons come from https://materialdesignicons.com/:

[[params.social]]
icon = "github-circle"
url = "https://github.com/my-github-user/"

[[params.social]]
icon = "linkedin"
url = "https://linkedin.com/in/my-username"

Hiding the theme link

I get it, you might not want to have a link to this repo on the footer of your blog. Add disableAttribution to your site parameters and it will be hidden.

bare-hugo-theme's People

Contributors

orf avatar dependabot-preview[bot] avatar dependabot[bot] avatar eine avatar imlauera avatar deining avatar imgbotapp avatar wamuir avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.