Giter VIP home page Giter VIP logo

hugo-digital-garden-theme's Introduction

GitHub issues GitHub forks GitHub stars license

Digital Garden Theme for Hugo

A simple Hugo theme for your digital garden, inspired by Maggie Appleton website

DEMO

This theme includes:

  • a digital garden / blog
  • a projects portfolio
  • library notes

Home

Getting started

  1. Install hugo and create a new website: https://gohugo.io/getting-started/quick-start/

  2. Add the theme to your website
    You can either use git submodule or clone the repo in your theme folder

    git submodule add https://github.com/paulmartins/hugo-digital-garden-theme.git themes/hugo-digital-garden-theme
    cd themes
    git clone https://github.com/paulmartins/hugo-digital-garden-theme.git
  3. Customize your site in your config.toml. An example is given in the theme folder: themes/digital-garden/exampleSite/config.toml

  4. Run the server and check your localhost:1313

    hugo server

Extra tips

You will write the content for your website in a content folder, for example in content/garden/evergreen_example.md. If you want to have your content folder in your root directory, you can copy that from the exampleSite folder to your root directory. In the root directory's config.toml you will need to change the themesdir to have themesdir = "./themes". You now run hugo server in the root directory of your project, and Hugo will start your website locally on an available port.

If you want to compare the website from this to the example site, you can start hugo server in the exampleSite directory too. Hugo will use different ports for each server, so you can compare the rendered pages with each other.

To create custom styling, you can create ./static/css/my_style.css. The CSS styling in here will override the theme's default styling. Here is an example custom CSS file from a user's blog, and here is one of their published pages looks. You can see the custom table formatting: custom header row colour, alternating row backgrounds, custom fonts, etc.

Update to the latest version of the theme

If you used git submodule to add the theme (see Getting started) do

git submodule update --remote --rebase

If you clone the theme, just go in the theme folder and pull

cd themes/hugo-digital-garden-theme
git pull

Twitter

hugo-digital-garden-theme's People

Contributors

heroboria avatar james-s-w-clark avatar nanqunchen avatar not-napoleon avatar paulmartins 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.