Repository files navigation

Juice is an intuitive, elegant, and responsive Zola theme for product sites.

• Build for product sites
• Simple and intuitive structure
• Clean and elegant design
• Responsive and mobile device compatible
• Customize and extend friendly

https://juice.huhu.io

First download this theme to yourthemes directory:

$cd themes$ git clone https://github.com/huhu/juice.git

or add as a submodule

$ git submodule add https://github.com/huhu/juice  themes/juice

and then enable it in yourconfig.toml:

theme ="juice"

Juice is designed for product websites, hence we lethero part fills whole of screen.You can customize yourhero by usinghero block in thetemplates/index.html.

{% extends "juice/templates/index.html" %}{% block hero %}<div>        Your cool hero html...</div>{% endblock hero %}

Every markdown file located incontent directory will become aPage. There also will display asa navigate link on the top-right corner.You can change the frontmatter'sweight value to sort the order (ascending order).

+++title = "Changelog"description = "Changelog"weight = 2+++

You can override theme variable by creating a file named_variables.html in yourtemplates directory.

See the default valuehere

The same way as changing thehero block in thetemplates/index.html, you can change thefavicon.

{% extends "juice/templates/index.html" %}{% block favicon %}<linkrel="icon"type="image/png"href="/favicon.ico">{% endblock favicon %}

If you changed the--xy-font-family-variable in_variables.html, you have to load the mentioned fonts in thetemplates/index.html.

{% extends "juice/templates/index.html" %}{% block fonts %}<linkhref="https://cdn.jsdelivr.net/npm/fork-awesome@1.2.0/css/fork-awesome.min.css"rel="stylesheet"crossorigin="anonymous"><linkhref="https://fonts.googleapis.com/css2?family=Babylonica&display=swap"rel="stylesheet">{% endblock fonts %}

You can customize some builtin property inconfig.toml file:

[extra]juice_logo_name ="Juice"juice_logo_path ="juice.svg"juice_extra_menu = [    {title ="Github",link ="https://github.com/huhu/juice"}]juice_exclude_menu = ["exclude_from_nav"]repository_url ="https://github.com/huhu/juice"

Juice have some builtin shortcodes available intemplates/shortcodes directory.

• issue(id) - A shortcode to render issue url, e.g.issue(id=1) would render to the linkhttps://github.com/huhu/juice/issue/1.

Therepository_url is required.

Please see theshowcases page.

Thank you very much for considering contributing to this project!

We appreciate any form of contribution:

• New issues (feature requests, bug reports, questions, ideas, ...)
• Pull requests (documentation improvements, code improvements, new features, ...)