Skip to content
/ mold Public
forked from riggraz/no-style-please

πŸ„ Minimal Optimized Lightweight Design for GitHub Pages

License

Notifications You must be signed in to change notification settings

yree/mold

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

mold πŸ„

A minimal optimized lightweight design for Github Pages.

Inspired from riggraz/no-style-please.

"Simplicity is the ultimate sophistication."
-- Leonardo da Vinci

Features ✨

  • πŸ‘€ A WYWIWYS theme (What You Write Is What You See)
  • ⚑️ Fast
  • πŸŒ“ Light theme (dark theme coming soon)
  • πŸ“± Responsive
  • πŸ“– Content-first (typography optimized for maximum readability)
  • πŸ” SEO optimized (uses Jekyll SEO Tag)
  • πŸ“° RSS feed (uses Jekyll Feed)
  • πŸš€ Made for GitHub Pages

Usage πŸ› οΈ

Setup πŸ—οΈ

  • Create a github pages repo, see steps.
  • Add a _config.yml file (or copy the one from this repo), and insert below line:
    remote-theme: yree/mold
  • See site settings to further customize the theme.

Organization πŸ“‚

  • The theme operates on the WYWIWYS (wee-wee-wiz) principle.
  • The README.md at the repo root acts as the index for the GitHub Page.
  • To create more posts add .md files and folders to your repo.
  • Link these .md files across each other (refer to this repo structure).

Pro tips πŸ’‘

Site Settings

  • Customize your blog further by editing the _config.yml file.
  • Adjust the blog's name, author, theme appearance, date formatting, and more.
  • The file includes comments to guide you through each customizable field.

Dark Mode for Images

  • The theme's dark mode is achieved through CSS invert() function.
  • Images aren't inverted by default to maintain expected appearance.
  • Apply class="ioda" to specific images to force color inversion.

Development πŸ“¦

  • Run bundle install to set up your environment.
  • Start the server with bundle exec jekyll serve.
  • Modify your theme and content as needed, preview your theme at http://localhost:4000.
  • Only specific files and directories are bundled. Adjust mold.gemspec to include custom directories if necessary.

Contributing 🀝

Feel free to report bugs or send pull requests over on GitHub at yree/mold. Please adhere to the Contributor Covenant code of conduct.

License πŸ“ƒ

The theme is available as open source under the terms of the MIT License.

About

πŸ„ Minimal Optimized Lightweight Design for GitHub Pages

Topics

Resources

License

Stars

Watchers

Forks

Languages

  • HTML 45.2%
  • SCSS 38.2%
  • Ruby 16.6%