Code Monkey home page Code Monkey logo

hugo-dead-simple's Introduction

Hugo Dead Simple

Simple hugo theme designed to be dead easy on the reader.

General idea is to stay off of enshittifying trend: no icons, less whitespace, less colors, links are blue, etc...

Features

  • Auto light and dark themes
  • Fast without bullshit - minified, minimal vanilla css, images are lazy-loaded, system fonts, no CDNs, functional without js if Katex is not used
  • Site-wide search
  • Keyboard-friendly: h to home, t to tags, i to search, Tab to navigate posts and search
  • Dynamic wiki-style table of contents
  • Katex math (inline and block)
  • Info boxes
  • Attachments
  • Info boxes
  • Columns / Tabs
  • Copy buttons on code blocks
  • Mobile-friendly

Example site, overview of features and configuration.
Example site repo.

TODO

hugo-dead-simple's People

Contributors

barklan avatar zaventh avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

hugo-dead-simple's Issues

Example site is down

I don't know if this is the right place to report this, but the link to the demo site is returning 404.

That site was a really good reference for the syntax. If it's not going to be online anymore then maybe it should be added to this repo? Some hugo themes include an exampleSite folder with the source code to the demo.

Get rid of jquery

Right now the only thing that uses jquery is dynamic toc. Rewrite it in vanilla js.

Head link urls not relative

Currently, the theme does not work in a subfolder due to the link elements not correctly using relative paths. Consider the following:

<link rel="stylesheet" href="{{ "/css/style.css" | relURL }}" />

This appears like it should work superficial, but in reality hrefs that begin with a slash do not become relative under relURL function:

As a best practice, never include a leading slash when using this function.

As such, the stylesheets and other metadata do not get loaded. The fix is to remove the leading slash.

A PR is forthcoming if you'd like to use it.

Few suggestions

This theme looks great. Here are some suggestions which I feel can make it more usable for people:

  • add an exampleSite folder, and add some sample content in it
  • you have already mentioned about deploying on Netlify. It will be nice if you can deploy your theme to Netlify or any other service and then include the link in README.md file. This will allow visitors to easily check how your theme looks like.

Image gallery

Find a way to make galleries. Requirements:

  • Should work without js
  • First parameter - folder
  • Should work with any number of images
  • Previews should be AVIF
  • Previews should be Square
  • Should accept row flag to specify number of images in one row
  • Onclick should open in new tab. Still, no js - use link or a

Remove twoimg shortcode after that.

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.