{"id":13594074,"url":"https://github.com/pawroman/zola-theme-terminimal","last_synced_at":"2025-08-27T01:34:22.928Z","repository":{"id":40394575,"uuid":"169245400","full_name":"pawroman/zola-theme-terminimal","owner":"pawroman","description":"A simple, minimal retro theme for Zola","archived":false,"fork":false,"pushed_at":"2024-08-18T21:53:31.000Z","size":1441,"stargazers_count":377,"open_issues_count":12,"forks_count":87,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-11-06T15:48:43.438Z","etag":null,"topics":["blog-theme","no-javascript","zola","zola-theme"],"latest_commit_sha":null,"homepage":"https://pawroman.github.io/zola-theme-terminimal/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pawroman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-Hack.md","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":"2019-02-05T13:27:07.000Z","updated_at":"2024-11-05T17:38:36.000Z","dependencies_parsed_at":"2023-12-14T09:28:12.061Z","dependency_job_id":"aca9271d-c3ed-40df-be5a-19b25c5f967d","html_url":"https://github.com/pawroman/zola-theme-terminimal","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pawroman%2Fzola-theme-terminimal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pawroman%2Fzola-theme-terminimal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pawroman%2Fzola-theme-terminimal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pawroman%2Fzola-theme-terminimal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pawroman","download_url":"https://codeload.github.com/pawroman/zola-theme-terminimal/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240672824,"owners_count":19838930,"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":["blog-theme","no-javascript","zola","zola-theme"],"created_at":"2024-08-01T16:01:28.388Z","updated_at":"2025-02-25T12:53:18.311Z","avatar_url":"https://github.com/pawroman.png","language":"HTML","funding_links":[],"categories":["HTML","CSS","others"],"sub_categories":[],"readme":"# Terminimal\n\n[![Build Status](https://github.com/pawroman/zola-theme-terminimal/actions/workflows/pages/pages-build-deployment/badge.svg)](https://github.com/pawroman/zola-theme-terminimal/actions/workflows/pages/pages-build-deployment)\n![No JavaScript](https://img.shields.io/badge/JavaScript-none-brightgreen.svg)\n\n![Screenshot](../master/screenshot.png?raw=true)\n\nSee the live demo (of the default configuration) here:\nhttps://pawroman.github.io/zola-theme-terminimal/\n\nTested with Zola v0.19.2.\n\nPlease note that earlier (and older) versions might not work because of breaking changes across Zola versions.\n\n#### Fork disclaimer\n\nThis theme is a fork (not a port) of \"Terminal\" Hugo theme\nby Radosław Kozieł (aka. panr):\nhttps://github.com/panr/hugo-theme-terminal\n\nMany thanks for that outstanding original theme, Radek!\n\nFor more information about this fork and the differences to the original theme, please see:\n[Changes compared to the original theme](#changes-compared-to-the-original-theme) below.\n\n## Versioning\n\nThis theme used to be non-versioned, e.g. you'd pull the master branch, and occasionally new features or fixes would\nbe released.\n\nStarting from version v1.0.0, the project adopted [Semantic Versioning](https://semver.org/).\n\nPlease check the [GitHub releases](https://github.com/pawroman/zola-theme-terminimal/releases) to see a change log\nand work out if there's any breaking changes.\n\n## How to start\n\nOption A: clone the theme directly into your Zola site folder:\n\n```\n$ git clone https://github.com/pawroman/zola-theme-terminimal.git themes/terminimal\n```\n\nOption B: include it as a git submodule (it's better if you plan to use CI builders):\n\n```\n$ git submodule add https://github.com/pawroman/zola-theme-terminimal.git themes/terminimal\n```\n\nThen in your `config.toml` set:\n\n```toml\ntheme = \"terminimal\"\n\n# Sass compilation is required\ncompile_sass = true\n```\n\nAlso see the Zola documentation on using themes:\nhttps://www.getzola.org/documentation/themes/installing-and-using-themes/\n\n## Shortcodes\n\nThe theme adds two custom shortcodes related to image handling.\n\n### `image`\n\nUsed to show images.\n\nRequired arguments:\n\n- **`src`**\n\nOptional arguments:\n\n- **`alt`**\n- **`position`** (center \\[default\\] | left | right)\n- **`style`**\n\nExample:\n\n```\n{{ image(src=\"/img/hello.png\", alt=\"Hello Friend\",\n         position=\"left\", style=\"border-radius: 8px;\") }}\n```\n  \n### `figure`\n\nSame as `image`, but with a few extra optional arguments:\n\n- **`caption`** (supports markdown)\n- **`caption_position`** (center \\[default\\] | left | right)\n- **`caption_style`**\n\nExample:\n\n```\n{{ figure(src=\"http://rustacean.net/assets/rustacean-flat-gesture.png\",\n          style=\"width: 25%;\",\n          position=\"right\",\n          caption_position=\"left\",\n          caption=\"**Ferris**, the (unofficial) Rust mascot\",\n          caption_style=\"font-style: italic;\") }}\n```\n\n## OpenGraph\n\nTo add an image to a post, set the `og_image` extra option to the desired image\nin the same directory of the markdown file:\n\n```toml\n[extra]\nog_image = \"colocated_image.png\"\n```\n\nAdditionally, for the section pages and for posts to have a fallback image, add\n`default_og_image` to the `[extra]` section:\n\n```toml\n[extra]\ndefault_og_image = \"static/ocean.jpg\"\n```\n\n## Configuration\n\n### Only show the post's description\n\nOn each post you can specify the following:\n\n```toml\ndescription = \"test description\"\n\n[extra]\nshow_only_description = true\n```\n\nThis will render `test description` under this\nparticular post on the homepage instead of a summary.\n\n### Colors\n\nBoth the accent colors and background colors are\nconfigurable.\n\nBy default, both accent and background are set\nto `blue`.\n\nTo configure menu, add this in `[extra]` section\nof your `config.toml`:\n\n```toml\n[extra]\n\n# One of: blue, green, orange, pink, red.\n# Defaults to blue.\n# Append -light for light themes, e.g. blue-light\n# Or append -auto, e.g. blue-auto\naccent_color = \"green\"\n\n# One of: blue, dark, green, orange, pink, red, light, auto\n# Enabling dark background will also modify primary font color to be darker.\n# Defaults to accent color (or, if not accent color specified, to blue).\nbackground_color = \"dark\"\n```\n\n### Logo text and link\n\nYou can set the \"logo\" text and what it links to,\nby modifying `config.toml` like so:\n\n```toml\n[extra]\n\n# The logo text - defaults to \"Terminimal theme\"\nlogo_text = \"My blog\"\n\n# The logo link - defaults to base_url.\nlogo_home_link = \"/take/me/away!\"\n```\n\n### Author and copyright\n\nYou can set the footer's copyright author name like this:\n\n```toml\n[extra]\n\n# Author name: when specified, modifies the default\n# copyright text. Apart from author, it will\n# contain current year and a link to the theme.\nauthor = \"My Name\"\n``` \n\nIf you don't like the default copyright text,\nyou can set it to completely custom HTML:\n\n```toml\n[extra]\n\n# Copyright text in HTML format. If specified,\n# entirely replaces default copyright and author.\ncopyright_html = \"My custom\u0026nbsp;\u003cb\u003ecopyright\u003c/b\u003e\"\n```\n\n### Menu\n\nThe menu is optional, static (all items are always shown,\nno matter what the screen size) and fully user-configurable.\n\nTo configure menu, add this in `[extra]` section\nof your `config.toml`:\n\n```toml\n[extra]\n\n# menu is enabled by adding menu_items (optional)\nmenu_items = [\n    # each of these is optional, name and url are required\n    # $BASE_URL is going to be substituted by base_url from configuration\n    {name = \"blog\", url = \"$BASE_URL\"},\n    \n    # tags should only be enabled if you have \"tags\" taxonomy\n    # see documentation below for more details\n    {name = \"tags\", url = \"$BASE_URL/tags\"},\n    {name = \"archive\", url = \"$BASE_URL/archive\"},\n    {name = \"about me\", url = \"$BASE_URL/about\"},\n    \n    # set newtab to true to make the link open in new tab\n    {name = \"github\", url = \"url-to-your-github\", newtab = true},\n]\n```\n\n### Tags\n\nThe theme optionally supports tags. To enable them, create\na \"tags\" taxonomy in your `config.toml`:\n\n```toml\ntaxonomies = [\n    {name = \"tags\"},\n]\n```\n\nEnabling tags will create a new `/tags` page, and \ncause them to show up in `archive` section. Note\nthat you still need to create a menu link to the tags\npage manually.\n\n### Pagination\n\nPagination is fully supported for post list (main site)\nand intra-post (you can navigate to earlier and later posts).\n\nTo make sure pagination works properly, you must first configure\nit in `content/_index.md`:\n\n```\n+++\n# number of pages to paginate by\npaginate_by = 2\n\n# sorting order for pagination\nsort_by = \"date\"\n+++\n```\n\nThen, tweak the theme's pagination config in `config.toml`:\n\n```toml\n[extra]\n\n# Whether to show links to earlier and later posts\n# on each post page (defaults to true).\nenable_post_view_navigation = true\n\n# The text shown at the bottom of a post,\n# before earlier/later post links.\n# Defaults to \"Thanks for reading! Read other posts?\"\npost_view_navigation_prompt = \"Read more\"\n```\n\n### Language code\n\nInternationalization / translation is not supported\nbut you can set the HTML language code for your\nsite:\n\n```toml\ndefault_language = \"en\"\n```\n\n### Hack font subset\n\nBy default, the theme uses a mixed subset of the Hack font.\nNormal weight font uses full character set\n(for Unicode icons and special symbols), but all others\n(bold, italic etc) use a limited subset.\n\nThis results in much smaller transfer sizes, but the subset\nmight not contain all the Unicode characters you need.\n\nYou can enable full unicode support in `config.toml`:\n\n```toml\n[extra]\n\n# Use full Hack character set, not just a subset.\n# Switch this to true if you need full unicode support.\n# Defaults to false.\nuse_full_hack_font = true\n```\n\nAlso see [Hack's docs](https://github.com/source-foundry/Hack/blob/master/docs/WEBFONT_USAGE.md).\n\n### Favicon\n\nThe theme supports adding a global favicon (applies to\nall pages) to the site:\n\n```toml\n# Optional: Global favicon URL and mimetype.\n#           Mimetype defaults to \"image/x-icon\".\n#           The URL should point at a file located\n#           in your site's \"static\" directory.\nfavicon = \"/favicon.png\"\nfavicon_mimetype = \"image/png\"\n```\n\n### Page titles\n\nThe theme allows you to configure how the page titles (the `\u003ctitle\u003e` elements) are rendered.\n\nUse `\"combined\"` to render titles as `\"Page title | Main title\"`.\n\n```toml\n# Optional: Set how \u003ctitle\u003e elements are rendered.\n# Values:\n# - \"main_only\" -- only the main title (`config.title`) is rendered.\n# - \"page_only\" -- only the page title (if defined) is rendered,\n#                  falling back to `config.title` if not defined or empty.\n# - \"combined\" -- combine like so: \"page_title | main_title\",\n#                 or if page_title is not defined or empty, fall back to `main_title`\n#\n# Note that the main (index) page only has the main title.\npage_titles = \"combined\"\n```\n\nAll the configuration options are also described in\n[`config.toml`](../master/config.toml).\n\n## Extending\n\nEach of the templates defines named blocks, so\nit should be quite easy to customize the most common things.\n\nFor example, if you want to add extra `\u003cmeta\u003e` tags to the\nbase template, `index.html`, create file like this in `templates/index.html`:\n\n```html\n{% extends \"terminimal/templates/index.html\" %}\n\n{% block extra_head %}\n    \u003cmeta name=\"description\" content=\"My awesome website\"/\u003e\n    \u003cmeta name=\"keywords\" content=\"Hacking,Programming,Ranting\"/\u003e\n{% endblock %}\n```\n\n## How to contribute\n\nIf you spot any bugs or wish to contribute new features, please create a new\n[Pull Request](https://github.com/pawroman/zola-theme-terminimal/pulls).\n\n## Changes compared to the original theme\n\nThis theme has been forked from https://github.com/panr/hugo-theme-terminal\n\n- Slight changes in the layout and styling.\n  - Content has been centered (instead of left-aligned).\n  - The header stripes have been spaced out.\n  - Tweaks to pagination, especially on mobile (small screens).\n  - The post title underline is dashed instead of doubly-dotted.\n  - All links are underlined, as per\n    [Brutalist Web Design Guidelines](https://www.brutalist-web.design/).\n  - Tweaks to header font sizes.\n  - Minor footer tweaks.\n\n- Absolutely **no JavaScript**.\n  - No JavaScript needed to pre-process anything.\n    Zola with its Sass pre-processor is the only dependency.\n  - There's no menu trigger.\n  - Things load crazy fast, as it's all static content.\n  - Prism.js syntax highlighting is not supported (you can use\n    [Zola's](https://www.getzola.org/documentation/content/syntax-highlighting/)).\n\n- All references to social media (e.g. Twitter) have been removed.\n\n- All references to external URLs (e.g. Google CDN) have been removed.\n  This theme's static assets are meant to be served from where it's hosted.\n\n- [Hack](https://github.com/source-foundry/Hack) is the default font.\n\n- The default color theme is blue (original uses orange).\n\n### New features\n\n- You can pick the accent color as well as background color.\n  There's a new `dark` background. See [Configuration](#configuration)\n  below for details.\n- Active \"section\" links will change color indicating the\n  active section. This is all static, done at template level.\n\n### Features retained from the original\n\n- 5 color themes, depending on your preference:\n  blue (default), green, orange, pink, red.\n- The shortcodes `image` and `figure` (See [Shortcodes](#shortcodes)).\n- Fully responsive.\n\n## License\n\nCopyright © 2019 Paweł Romanowski (pawroman)\n\nOriginal theme: Copyright © 2019 Radosław Kozieł ([@panr](https://twitter.com/panr))\n\nThe theme is released under the MIT License.\nCheck the [license file](../master/LICENSE.md)\nfor more information.\n\nThe license for Hack fonts used is included in\n[LICENSE-Hack.md](../master/LICENSE-Hack.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpawroman%2Fzola-theme-terminimal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpawroman%2Fzola-theme-terminimal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpawroman%2Fzola-theme-terminimal/lists"}