{"id":13671077,"url":"https://github.com/huhu/juice","last_synced_at":"2026-02-06T18:05:05.041Z","repository":{"id":46955614,"uuid":"273856581","full_name":"huhu/juice","owner":"huhu","description":"🍹 An intuitive, elegant, and responsive Zola theme for product sites.","archived":false,"fork":false,"pushed_at":"2024-06-01T07:33:12.000Z","size":2972,"stargazers_count":181,"open_issues_count":2,"forks_count":38,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-01-04T01:35:41.258Z","etag":null,"topics":["product-site","zola","zola-theme"],"latest_commit_sha":null,"homepage":"https://juice.huhu.io","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/huhu.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}},"created_at":"2020-06-21T07:31:57.000Z","updated_at":"2024-12-25T23:56:58.000Z","dependencies_parsed_at":"2024-06-01T08:28:05.872Z","dependency_job_id":"5aaa25de-73c1-4e7b-8a03-ebecc3021477","html_url":"https://github.com/huhu/juice","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huhu%2Fjuice","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huhu%2Fjuice/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huhu%2Fjuice/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huhu%2Fjuice/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/huhu","download_url":"https://codeload.github.com/huhu/juice/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240254182,"owners_count":19772386,"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":["product-site","zola","zola-theme"],"created_at":"2024-08-02T09:00:58.182Z","updated_at":"2026-02-06T18:05:00.016Z","avatar_url":"https://github.com/huhu.png","language":"HTML","funding_links":[],"categories":["HTML","others"],"sub_categories":[],"readme":"# Juice\n\n\u003cimg align=\"right\" width=\"150\" height=\"150\" src=\"/content/juice.svg\"\u003e\n\n**Juice** is an intuitive, elegant, and responsive Zola theme for product sites.\n\n- Build for product sites\n- Simple and intuitive structure\n- Clean and elegant design\n- Responsive and mobile device compatible\n- Customize and extend friendly\n\nhttps://juice.huhu.io\n\n# Installation\n\nFirst download this theme to your `themes` directory:\n\n```bash\n$ cd themes\n$ git clone https://github.com/huhu/juice.git\n```\n\nor add as a submodule\n```bash\n$ git submodule add https://github.com/huhu/juice  themes/juice\n```\n\nand then enable it in your `config.toml`:\n\n```toml\ntheme = \"juice\"\n```\n\n# Structure\n\n### Hero\n\n**Juice** is designed for product websites, hence we let **hero** part fills whole of screen.\nYou can customize your **hero** by using `hero` block in the `templates/index.html`.\n\n```html\n{% extends \"juice/templates/index.html\" %}\n{% block hero %}\n    \u003cdiv\u003e\n        Your cool hero html...\n    \u003c/div\u003e\n{% endblock hero %}\n```\n\n### Page\n\nEvery markdown file located in `content` directory will become a **Page**. There also will display as\na navigate link on the top-right corner.\nYou can change the frontmatter's `weight` value to sort the order (ascending order).\n\n```\n+++\ntitle = \"Changelog\"\ndescription = \"Changelog\"\nweight = 2\n+++\n\n```\n\n### CSS variables\n\nYou can override theme variable by creating a file named `_variables.html` in your `templates` directory.\n\nSee the default value [here](./templates/_variables.html)\n\n### Favicon\nThe same way as changing the `hero` block in the `templates/index.html`, you can change the **favicon**.\n\n```html\n{% extends \"juice/templates/index.html\" %}\n{% block favicon %}\n    \u003clink rel=\"icon\" type=\"image/png\" href=\"/favicon.ico\"\u003e\n{% endblock favicon %}\n```\n\n### Fonts\nIf you changed the `--xy-font-family`-variable in `_variables.html`, you have to load the mentioned fonts in the `templates/index.html`.\n\n```html\n{% extends \"juice/templates/index.html\" %}\n{% block fonts %}\n    \u003clink href=\"https://cdn.jsdelivr.net/npm/fork-awesome@1.2.0/css/fork-awesome.min.css\" rel=\"stylesheet\" crossorigin=\"anonymous\"\u003e\n    \u003clink href=\"https://fonts.googleapis.com/css2?family=Babylonica\u0026display=swap\" rel=\"stylesheet\"\u003e\n{% endblock fonts %}\n```\n\n# Configuration\n\nYou can customize some builtin property in `config.toml` file:\n\n```toml\n[extra]\njuice_logo_name = \"Juice\"\njuice_logo_path = \"juice.svg\"\njuice_extra_menu = [\n    { title = \"Github\", link = \"https://github.com/huhu/juice\"}\n]\njuice_exclude_menu = [\n    \"exclude_from_nav\"\n]\nrepository_url = \"https://github.com/huhu/juice\"\n```\n\n# Shortcodes\n\n**Juice** have some builtin shortcodes available in `templates/shortcodes` directory.\n\n- `issue(id)` - A shortcode to render issue url, e.g. `issue(id=1)` would render to the link `https://github.com/huhu/juice/issue/1`.\n  \n\u003e The `repository_url` is required.\n\n# Showcases\n\nPlease see the [showcases page](https://juice.huhu.io/showcases).\n\n# Contributing\n\nThank you very much for considering contributing to this project!\n\nWe appreciate any form of contribution:\n\n- New issues (feature requests, bug reports, questions, ideas, ...)\n- Pull requests (documentation improvements, code improvements, new features, ...)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuhu%2Fjuice","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhuhu%2Fjuice","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuhu%2Fjuice/lists"}