Skip to content

dagartall/Gouul

Repository files navigation

Indiego

Not under active development. I do want to ditch gulp & use Hugo Pipelines to simplify process. If someone else wants to have a go, please do!

Socially aware Hugo blog starter kit, with modular CSS gulp.js workflow

Indiego logo

“I just didn't add anything to make it slow.”
Taking inspiration from Phil Hawksworth

Version: 0.1.8

Requires

To get started

Deploy to Netlify

  1. Click the big button above
  2. In a terminal, git clone your new repository to your local machine
  3. Add your details to config.yml
  4. Change directory, run hugo serve
  5. In new terminal, cd themes/go/
  6. Run npm install
  7. Run gulp. A Browserync window should open.
  8. Add content. Design your theme. The world is your oyster 🐚

Full Hugo documentation at gohugo.io and Indiego documenation at www.indiego.org.uk

To add content

  • To create new blog post, from command line in top level directory, run hugo new blog/your-blog-post-name.md
  • To create new status post, run hugo new status/yourstatuspostname.md
    • So that I can search status posts by date, I add a 6-digit datestamp eg 180803-shorttitle
    • Status posts use the date as the <h1>, they don’t really have a title as such
  • To create a new page, pop a Markdown file in the content directory. Use the about.md page to crib the Frontmatter

Full documentation is on the Hugo website.

To edit the theme

  • The Indiego theme is called go. As you can see, it is incredibly minimal.
  • The organisation is based on ITCSS (Inverted Triangle CSS). All CSS, JavaScript and images are organised by modules in the go/src directory, from general to specific:
    1. Variables
    2. Base CSS
    3. Objects (site wide patterns)
    4. Components
    5. Utilities (trumping !important)
    6. Shameful
  • A simple Gulp taskrunner concatenates the individual modules into app.css, app.js and assets in the go/static directory. These are then copied to public when you run hugo serve
  • Set your own base settings in go/src/assets/css/settings
  • Create your own modules in go/src/modules
  • Keep gulp running in one terminal and hugo serve in another to preview changes automatically.

To publish changes

  • If you originally used the Deploy to Netlify button, then every time you git push, your website will be automatically deployed. Magic 🙂

Deploy to Netlify

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published