Arroz con Dulce (Sweet Rice)

‘Arroz con Dulce’ is a minimalist, responsive hugo theme inspired by terminal ricing aesthetics.

Hugo Themes Version GitHub release (latest SemVer) hugo build status W3C Validation Code size

Screenshot of the arrozcondulce theme

Install

The easiest way to install the theme is to add this repository as a required module in your ‘hugo.toml’ site configuration.

First initialize your Hugo site in your development environment with the commands below.

hugo mod init yoursitename
hugo mod get github.com/sonofmartinus/arrozcondulce

Then add to your hugo configuration file:

[module]
  [[module.imports]]
	path = 'github.com/sonofmartinus/arrozcondulce'
	disable = false
	ignoreConfig = false

There are other ways to install the theme:

Clone this repository into your site’s themes directory:

git clone https://github.com/sonofmartinus/arrozcondulce themes/arrozcondulce

If your site is already a git repository, you can add the theme as a submodule instead:

git submodule add https://github.com/sonofmartinus/arrozcondulce.git themes/arrozcondulce

Update

If you installed the theme using git clone, pull the repository to get the latest version:

cd themes/arrozcondulce
git pull

Or, if you added it as a git submodule:

git submodule update --remote

Configure

To use the theme, add theme = 'arrozcondulce' to your site’s hugo.toml, or theme: arrozcondulce to your hugo.yaml respectively.

See exampleSite/hugo.toml for the theme-specific parameters you need to add to your site’s hugo.toml or hugo.yaml to configure the theme.

Colour palettes

arrozcondulce uses the base16 framework to define colour schemes that can be used with the theme.palette parameter. A 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. The default is base16-dark.

The 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/base16 directory.

Or to define a wholly custom theme, you will need to define the following CSS variables for the following base16 colours (see base16-dark.css for an example):

BaseDefault colourUsed forExamples
00DarkBackgroundPage background
01│Alt. backgroundContent background
02│In-text backgrounds<pre>, <code>, <kbd>, <samp>
03│Muted text:before & :marker symbols
04│Alt. foregroundAside text
05│ForegroundContent text
06│
07Light
08Red
09Orange
0AYellowHighlightsSelected text, <mark>
0BGreenPrimary accentLogo
0CCyanActive linksa:active, a:hover
0DBlueLinksa:link, a:visited
0EMagenta
0FBrown

For light mode palettes, the sequence of 00–07 should be reversed (light to dark, not dark to light). Note that not all colours are currently used in the theme.

Favicon

arrozcondulce will automatically use favicons placed in the static/ directory. The following files will be detected and included in your site’s <head> section:

You can generate these from an image or emoji using favicon.io or a similar service. They must be placed directly under your site’s static/ directory, i.e. not in in a subdirectory or themes/arrozcondulce/static/.

Acknowledgements

The ‘cooked rice’ emoji used as a favicon for the example site was created by the Twemoji project and is licensed under CC-BY 4.0.

Arroz con Dulce

A hugo theme inspired by terminal ricing.