{"id":13621378,"url":"https://github.com/joeroe/risotto","last_synced_at":"2025-04-14T20:54:16.737Z","repository":{"id":39569819,"uuid":"344763910","full_name":"joeroe/risotto","owner":"joeroe","description":"A minimalist, responsive hugo theme inspired by terminal ricing aesthetics.","archived":false,"fork":false,"pushed_at":"2024-10-25T12:10:52.000Z","size":1370,"stargazers_count":420,"open_issues_count":19,"forks_count":111,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-10-29T17:26:37.895Z","etag":null,"topics":["hugo-theme"],"latest_commit_sha":null,"homepage":"https://risotto.joeroe.io","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joeroe.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-03-05T09:45:15.000Z","updated_at":"2024-10-29T02:57:36.000Z","dependencies_parsed_at":"2023-01-17T16:15:22.635Z","dependency_job_id":"effcdfaa-70b9-4a4b-81f2-4bbc1e4c47d6","html_url":"https://github.com/joeroe/risotto","commit_stats":{"total_commits":102,"total_committers":21,"mean_commits":4.857142857142857,"dds":0.6470588235294117,"last_synced_commit":"00d8fab5951bf85a6904cb5f78bfefd4b94417d9"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joeroe%2Frisotto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joeroe%2Frisotto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joeroe%2Frisotto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joeroe%2Frisotto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joeroe","download_url":"https://codeload.github.com/joeroe/risotto/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248961085,"owners_count":21189990,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hugo-theme"],"created_at":"2024-08-01T21:01:05.289Z","updated_at":"2025-04-14T20:54:16.717Z","avatar_url":"https://github.com/joeroe.png","language":"CSS","funding_links":[],"categories":["CSS"],"sub_categories":[],"readme":"# 🍚 risotto\n\nrisotto is a minimalist, responsive [hugo](https://gohugo.io) theme inspired by terminal ricing aesthetics.\n\n[![Hugo Themes](https://img.shields.io/badge/Hugo_Themes-risotto-blue?logo=hugo)](https://themes.gohugo.io/themes/risotto/)\n[![Version](https://img.shields.io/badge/semver-v0.4.0-blue)](https://semver.org)\n![hugo build status](https://github.com/joeroe/risotto/actions/workflows/hugo-build-exampleSite.yml/badge.svg)\n[![W3C Validation](https://img.shields.io/w3c-validation/html?targetUrl=https%3A%2F%2Frisotto.joeroe.io)](https://validator.nu/?doc=https%3A%2F%2Frisotto.joeroe.io)\n![Code size](https://img.shields.io/github/languages/code-size/joeroe/risotto)\n\n![Screenshot of the risotto theme](https://raw.githubusercontent.com/joeroe/risotto/master/images/screenshot.png)\n\n## Features\n\n* Plain, semantic HTML with no Javascript\n* Plain CSS – no frameworks, no preprocessors, just simple and easy-to-customise stylesheets\n* Uses [CSS Grid](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_grid_layout) for native responsive behaviour without arbitrary breakpoints\n* Comes with [16 built-in colour schemes](#colour-schemes) based on popular terminal themes plus the ability to use custom themes using the [base16 system](https://github.com/monicfenga/base16-styles)\n\n## Install\n\nThe easiest way to install the theme is to [download the latest release](https://github.com/joeroe/risotto/releases) and extract it to your project's `themes/` directory.\nYou can also clone this repository into your site's `themes` directory and checkout the latest release:\n\n```shell\ngit clone https://github.com/joeroe/risotto themes/risotto \u0026\u0026 cd themes/risotto\ngit checkout $(git tag -l | grep '^v[0-9.]*$' | sort -V | tail -n 1)\n```\n\nNote that this will not work if your site is itself a git repository.\nIn that case, you can add the theme as a [git submodule](https://git-scm.com/book/en/v2/Git-Tools-Submodules), but this is not recommended due to the difficulty of tracking a specific release.\n\n## Update\n\nIf you installed the theme using `git clone`, pull the repository to get the latest version:\n\n```shell\ncd themes/risotto\ngit pull\n```\n\nOtherwise, simply [download the latest release](https://github.com/joeroe/risotto/releases) and extract it to your project's `themes/` directory, replacing the old version.\n\n## Configure\n\nTo use the theme, add `theme = 'risotto'` to your site's `hugo.toml`, or `theme: risotto` to your `hugo.yaml`.\n\nSee `exampleSite/config.toml` for the theme-specific parameters you need to add to your site's `hugo.toml` or `hugo.yaml` to configure the theme.\n\n### Colour schemes\n\nrisotto uses the [base16 framework](https://github.com/chriskempson/base16) to define colour schemes that can be used with the `theme.palette` parameter.\nA selection of 16 palettes (10 dark, 6 light) are bundled with the theme: `apprentice`, `base16-dark`, `base16-light`, `dracula`, `gruvbox-dark`, `gruvbox-light`, `material`, `papercolor-dark`, `papercolor-light`, `solarized-dark`, `solarized-light`, `tender`, `tokyo-night-dark`, `tokyo-night-light`, `windows-95` and `windows-95-light`.\nThe default is `base16-dark`.\n\n\u003c!-- TODO: add screenshots of default themes --\u003e\n\nThe easiest way to use other base16 styles is to place .css file from https://github.com/monicfenga/base16-styles/tree/master/css-variables and place it in your `static/css/palettes` directory.\n\nOr to define a wholly custom theme, you will need to define the following CSS variables for the following base16 colours (see [base16-dark.css](blob/main/static/css/palettes/base16-dark.css) for an example):\n\n| Base | Default colour                             | Used for            | Examples                             |\n| ---- | ------------------------------------------ | ------------------- | ------------------------------------ |\n| 00   | \u003cspan class=\"base00\"\u003eDark\u003c/span\u003e           | Background          | Page background                      |\n| 01   | \u003cspan class=\"base01\"\u003e│\u003c/span\u003e              | Alt. background     | Content background                   |\n| 02   | \u003cspan class=\"base02\"\u003e│\u003c/span\u003e              | In-text backgrounds | `\u003cpre\u003e`, `\u003ccode\u003e`, `\u003ckbd\u003e`, `\u003csamp\u003e` |\n| 03   | \u003cspan class=\"base03\"\u003e│\u003c/span\u003e              | Muted text          | `:before` \u0026 `:marker` symbols        |\n| 04   | \u003cspan class=\"base04\"\u003e│\u003c/span\u003e              | Alt. foreground     | Aside text                           |\n| 05   | \u003cspan class=\"base05\"\u003e│\u003c/span\u003e              | Foreground          | Content text                         |\n| 06   | \u003cspan class=\"base06\"\u003e│\u003c/span\u003e              |                     |                                      |\n| 07   | \u003cspan class=\"base07\"\u003eLight\u003c/span\u003e          |                     |                                      |\n| 08   | \u003cspan class=\"base08\"\u003eRed\u003c/span\u003e            |                     |                                      |\n| 09   | \u003cspan class=\"base09\"\u003eOrange\u003c/span\u003e         |                     |                                      |\n| 0A   | \u003cspan class=\"base0A\"\u003eYellow\u003c/span\u003e         | Highlights          | Selected text, `\u003cmark\u003e`              |\n| 0B   | \u003cspan class=\"base0B\"\u003eGreen\u003c/span\u003e          | Primary accent      | Logo                                 |\n| 0C   | \u003cspan class=\"base0C\"\u003eCyan\u003c/span\u003e           | Active links        | `a:active`, `a:hover`                |\n| 0D   | \u003cspan class=\"base0D\"\u003eBlue\u003c/span\u003e           | Links               | `a:link`, `a:visited`                |\n| 0E   | \u003cspan class=\"base0E\"\u003eMagenta\u003c/span\u003e        |                     |                                      |\n| 0F   | \u003cspan class=\"base0F\"\u003eBrown\u003c/span\u003e          |                     |                                      |\n\nFor light mode palettes, the sequence of 00–07 should be reversed (light to dark, not dark to light).\nNote that not all colours are currently used in the theme.\n\nYou you use these colours directly in content using the convenience classes `.baseXX` and `.bg-baseXX`.\nFor example:\n\n```html\n\u003cspan class=\"base0A\"\u003eYellow text\u003c/span\u003e\n\u003cmark class=\"bg-base0D\"\u003eText highlighted in green\u003c/mark\u003e\n```\n\n## Favicon\n\nrisotto will automatically use favicons placed in the `static/` directory.\nThe following files will be detected and included in your site's `\u003chead\u003e` section:\n\n* `favicon.ico`\n* `favicon-16x16.png`\n* `favicon-32x32.png`\n* `apple-touch-icon.png`\n* `site.webmanifest`\n\nYou can generate these from an image or emoji using [favicon.io](https://favicon.io/) or a similar service.\nThey must be placed directly under your site's `static/` directory, i.e. not in in a subdirectory or `themes/risotto/static/`.\n\n## Acknowledgements\n\nThe 'cooked rice' emoji used as a favicon for the example site was created by the [Twemoji project](https://twemoji.twitter.com/) and is licensed under [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoeroe%2Frisotto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoeroe%2Frisotto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoeroe%2Frisotto/lists"}