{"id":28724497,"url":"https://github.com/ntk148v/shibui","last_synced_at":"2025-06-15T11:01:33.352Z","repository":{"id":298877336,"uuid":"1001310004","full_name":"ntk148v/shibui","owner":"ntk148v","description":"Shibui (渋い) is a yet another minimalistic Hugo theme","archived":false,"fork":false,"pushed_at":"2025-06-13T10:45:39.000Z","size":335,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-13T11:36:49.287Z","etag":null,"topics":["hugo","hugo-theme","minimal","minimalist","shibui","simplicity"],"latest_commit_sha":null,"homepage":"https://ntk148v.github.io/shibui/","language":"HTML","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/ntk148v.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"zenodo":null},"funding":{"github":"ntk148v","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2025-06-13T07:00:06.000Z","updated_at":"2025-06-13T10:46:46.000Z","dependencies_parsed_at":"2025-06-13T11:47:38.280Z","dependency_job_id":null,"html_url":"https://github.com/ntk148v/shibui","commit_stats":null,"previous_names":["ntk148v/shibui"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ntk148v/shibui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ntk148v%2Fshibui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ntk148v%2Fshibui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ntk148v%2Fshibui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ntk148v%2Fshibui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ntk148v","download_url":"https://codeload.github.com/ntk148v/shibui/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ntk148v%2Fshibui/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259964292,"owners_count":22938718,"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","hugo-theme","minimal","minimalist","shibui","simplicity"],"created_at":"2025-06-15T11:00:44.967Z","updated_at":"2025-06-15T11:01:33.345Z","avatar_url":"https://github.com/ntk148v.png","language":"HTML","funding_links":["https://github.com/sponsors/ntk148v"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n \u003cimg src=\"./static/favicon_io/apple-icon-180x180.png\"\u003e\n \u003ch1\u003eShibui (渋い)\u003c/h1\u003e\n \u003cp\u003eA minimalist Hugo theme emphasizing simplicity and refinement\u003c/p\u003e\n \u003cp\u003e\n  \u003ca href=\"https://github.com/ntk148v/shibui/blob/master/LICENSE\"\u003e\n   \u003cimg alt=\"GitHub license\" src=\"https://img.shields.io/github/license/ntk148v/shibui?style=for-the-badge\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/ntk148v/shibui/stargazers\"\u003e\n   \u003cimg alt=\"GitHub stars\" src=\"https://img.shields.io/github/stars/ntk148v/shibui?style=for-the-badge\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://gohugo.io\"\u003e\n   \u003cimg alt=\"Hugo\" src=\"https://img.shields.io/badge/hugo-0.93.0-blue.svg?style=for-the-badge\"\u003e\n  \u003c/a\u003e\n \u003c/p\u003e\n\u003c/div\u003e\n\nTable of contents:\n- [Features](#features)\n- [Installation](#installation)\n  - [As a Git Submodule](#as-a-git-submodule)\n  - [Configuration](#configuration)\n  - [Page Configuration](#page-configuration)\n- [Color Scheme](#color-scheme)\n- [Customization](#customization)\n  - [CSS Variables](#css-variables)\n- [Contributing](#contributing)\n- [License](#license)\n- [Demo](#demo)\n- [Theme Structure](#theme-structure)\n  - [Template Organization](#template-organization)\n  - [Assets](#assets)\n  - [ExampleSite](#examplesite)\n- [Updating](#updating)\n- [Version Requirements](#version-requirements)\n- [Credits](#credits)\n\n|                                                                                                                            |                                                                                                                            |\n| -------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| \u003cimg src=\"./screenshots/1.png\" alt=\"dark\" style=\"border-radius:1%\"/\u003e | \u003cimg src=\"./screenshots/2.png\" alt=\"dark\" style=\"border-radius:1%\"/\u003e |\n| \u003cimg src=\"./screenshots/3.png\" alt=\"dark\" style=\"border-radius:1%\"/\u003e |                                                                                                                            |\n\n[Shibui](https://en.wikipedia.org/wiki/Shibui) (渋い) (adjective), shibumi (渋み) (subjective noun), or shibusa (渋さ) (objective noun) are Japanese words that refer to a particular aesthetic of simple, subtle, and unobtrusive beauty. Like other Japanese aesthetics terms, such as iki and wabi-sabi, shibui can apply to a wide variety of subjects, not just art or fashion.\n\n## Features\n\n- Minimalist design following Shibui (渋い) aesthetics\n- Terminal-inspired navigation\n- Clean typography with monospace font\n- Warm, paper-like color scheme\n- Automatic dark/light theme support\n- Nested heading counters\n- Zero JavaScript (pure CSS solutions)\n- Highly customizable through CSS variables\n- Mobile-responsive layout\n- Table of Contents support\n- Tags support\n\n## Installation\n\n### As a Git Submodule\n\n```bash\ngit submodule add https://github.com/ntk148v/shibui.git themes/shibui\ngit submodule update --init --recursive\n```\n\n### Configuration\n\nAdd the following to your `config.toml`:\n\n```toml\nbaseURL = 'http://example.org/'\nlanguageCode = 'en-us'\ntitle = 'Your Site Title'\ntheme = \"shibui\"\n\n[params]\n  author = \"Your Name\"\n  email = \"your.email@example.com\"\n\n[menu]\n  [[menu.main]]\n    name = \"Posts\"\n    url = \"/posts/\"\n    weight = 1\n  [[menu.main]]\n    name = \"About\"\n    url = \"/about/\"\n    weight = 2\n```\n\n### Page Configuration\n\nIn the front matter of your content files:\n\n```yaml\n---\ntitle: \"Your Post Title\"\ndate: 2023-06-13\ntags: [\"hugo\", \"theme\"]\n---\n```\n\n## Color Scheme\n\nThe theme uses a warm, paper-like color palette:\n\n```css\n--color-bg: #F6EEE3;      /* Light beige background */\n--color-bg-alt: #EEE7D7;  /* Slightly darker beige */\n--color-border: #E5DECF;  /* Subtle borders */\n--color-text: #000000;    /* Clear black text */\n--color-text-muted: #888; /* Subtle gray text */\n```\n\n## Customization\n\n### CSS Variables\n\nYou can customize the theme by overriding CSS variables in your `assets/css/custom.css`:\n\n```css\n:root {\n  --lh: 1.5em;          /* Line height */\n  --font-mono: \"Your Preferred Monospace Font\";\n}\n```\n\n## Contributing\n\nContributions are welcome! Primary goals are:\n\n- Maintain minimalist design principles\n- Keep it simple and efficient\n- Avoid JavaScript when CSS can solve the problem\n- Follow Shibui (渋い) aesthetics\n\n## License\n\nMIT\n\n## Demo\n\nVisit the [demo site](https://ntk148v.github.io/shibui) to see the theme in action.\n\n## Theme Structure\n\n```\nshibui/\n├── archetypes/          # Content template files\n├── assets/\n│   ├── css/            # Theme CSS files\n│   └── js/             # Theme JavaScript files\n├── layouts/            # Template files\n│   ├── _default/       # Default templates\n│   ├── _partials/      # Reusable template parts\n│   └── index.html      # Homepage template\n├── static/             # Static assets\n└── exampleSite/        # Example site for reference\n```\n\n### Template Organization\n\n- `layouts/_default/baseof.html`: Base template with common layout\n- `layouts/_default/single.html`: Template for individual pages\n- `layouts/_default/list.html`: Template for section pages\n- `layouts/_partials/`: Contains reusable components like header, footer\n- `layouts/index.html`: Homepage template\n\n### Assets\n\nThe theme uses a minimal set of assets:\n\n- CSS: Single stylesheet with CSS variables for customization\n- JS: Optional JavaScript for enhanced functionality\n- Static: Basic favicon and other static assets\n\n### ExampleSite\n\nThe `exampleSite` directory contains a complete example of a site using the theme. Use it as a reference for:\n\n- Configuration setup\n- Content organization\n- Front matter examples\n- Menu structure\n\n## Updating\n\nSince the theme is installed as a Git submodule, you can update it to the latest version with:\n\n```bash\ncd themes/shibui\ngit pull origin main\n```\n\n## Version Requirements\n\n- Hugo Extended v0.93.0 or higher\n- Go 1.18 or higher (for Hugo modules)\n\n## Credits\n\nThis theme was inspired by various minimalist designs and the Japanese concept of Shibui (渋い). Special thanks to:\n\n- [William Jansson](https://williamjansson.com)\n- The Hugo community\n- [Minimalist design principles](https://en.wikipedia.org/wiki/Minimalism_(computing))\n- Japanese aesthetics, particularly [Shibui](https://en.wikipedia.org/wiki/Shibui)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fntk148v%2Fshibui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fntk148v%2Fshibui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fntk148v%2Fshibui/lists"}