{"id":24665928,"url":"https://github.com/ischaojie/willow","last_synced_at":"2025-10-08T03:30:21.585Z","repository":{"id":151171684,"uuid":"623284245","full_name":"ischaojie/willow","owner":"ischaojie","description":"A zola blog theme: willow","archived":false,"fork":false,"pushed_at":"2023-10-27T04:09:02.000Z","size":225,"stargazers_count":15,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-20T03:54:18.871Z","etag":null,"topics":["blog-theme","rust","static-site","zola","zola-theme"],"latest_commit_sha":null,"homepage":"https://willow.chaojie.fun","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/ischaojie.png","metadata":{"files":{"readme":"README-en.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}},"created_at":"2023-04-04T04:10:44.000Z","updated_at":"2024-09-25T02:08:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"feb00cc7-1b74-467d-89c0-8e1af2b71fcd","html_url":"https://github.com/ischaojie/willow","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ischaojie%2Fwillow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ischaojie%2Fwillow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ischaojie%2Fwillow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ischaojie%2Fwillow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ischaojie","download_url":"https://codeload.github.com/ischaojie/willow/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235674122,"owners_count":19027526,"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","rust","static-site","zola","zola-theme"],"created_at":"2025-01-26T07:14:07.900Z","updated_at":"2025-10-08T03:30:21.175Z","avatar_url":"https://github.com/ischaojie.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"willow\n\u003e This file translated by ChatGPT.\n\n\u003cdiv align=\"center\"\u003e\n \u003cimg src=\"static/images/logo.png\" alt=\"logo\" width=\"100\"\u003e\n\n[Example Site](https://willow.chaojie.fun)\n\u003c/div\u003e\n\nHello, Willow is a theme designed for the static site generator [zola](https://www.getzola.org/). Without the beautiful open source UI kit [Tabler](https://github.com/tabler/tabler) and my unattractive aesthetics, I couldn’t create a good-looking theme. Thank you Tabler and other third-party libraries, thanks for open-source.\n\nSome of Willow’s key features:\n\n- Common blog features, such as article lists, tag pages, about pages, RSS, and more.\n- Support for giscus commenting system.\n- Support for photography pages (support for likes TBD).\n- Support for memos feed (I call it “whispers”).\n\n## Usage\n\n\u003e Familiarize yourself with the use of [zola](https://www.getzola.org/) before using willow.\n\n### Installation\n\nMake sure you have created a project using zola init myblog and then clone willow to the themes directory:\n\n```bash\ncd themes\ngit submodule add https://github.com/ischaojie/willow.git themes/willow\n```\nThen specify the theme as willow in the config.toml file:\n```toml\ntheme = \"willow\"\n```\n### Configuration\n\nZola supports adding custom configuration items in the extra field, all of which start with extra.willow. Basic configurations include:\n\n- The number of articles to display on the homepage\n```toml\n[extra.willow]\nshow_article_num = 10\n```\n- Navigation bar orderCurrently supported navigation bars include: articles, tags, about, photography, memos. home is default first.\n\t\u003e **Notice**\n\n\t\u003e Please remember to add the corresponding translation for each\n    \u003e navigation bar:\n    ```toml\n    [languages.zh-CN.translations]\n    language_name = \"Chinese\"\n    home = \"Home\"\n    articles = \"Articles\"\n    tags = \"Tags\"\n    photography = \"Photography\"\n    about = \"About\"\n    memos = \"Whispers\"\n    ```\n```toml\n[extra.willow]\nnav = [\"articles\", \"tags\", \"about\"]\n```\n\n### Social Media Accounts\n\nThe social media accounts currently supported by Willow are: twitter, douban, github (if there are other requirements, please issue a request). Configuration reference:\n```toml\n[extra.willow.social]\ntwitter = \"chaojie_cn\"\ndouban = \"218724191\"\ngithub = \"ischaojie\"\n```\nAll configuration items are account IDs.\n\n### giscus\n\nCurrently, Willow only supports the giscus commenting system (if there are other requirements, please issue a request). First consult [giscus](https://giscus.app/) documentation and generate your own giscus configuration. Then add the corresponding configuration item in the config.toml file:\n```toml\n[extra.willow.comment.giscus]\nrepo = \"\u003c\u003e\"\nrepo_id = \"\u003c\u003e\"\ncategory = \"\u003c\u003e\"\ncategory_id = \"\u003c\u003e\"\nmapping = \"\u003c\u003e\"\n```\n### memos\n\n\u003e memos is a lightweight, self-hosted memo (feed) for you and your team.\n\nRefer to the official documentation to set up your own memos service, and then add the corresponding configuration items in the config.toml file:\n```toml\n[extra.willow.memos]\n# The number of memos displayed each time they are loaded\nshow_num = 10\n# The API interface\napi = \"https://momo.chaojie.fun/api/memo/all\"\n```\n\n### Photography\n\nWillow supports photography pages, by placing the links to the photos you want to display in the photos field. Configuration reference:\n```toml\n[extra.willow.photography]\nphotos = [\n    \"https://file.chaojie.fun/photography/over-spring.jpg\",\n    \"https://file.chaojie.fun/photography/blue.jpg\",\n]\n```\n### Full Configuration Reference\n```toml\n# --- willow config example --- #\n\n[extra.willow]\n# The number of articles to show on the home page\nshow_article_num = 10\n\n# The order of the navigation bar, home is the first by default\n# current supported nav: articles, tags, about, photography, memos\nnav = [\"articles\", \"memos\", \"photography\", \"tags\", \"about\"]\n\n# --- social accounts --- #\n# currently supported: twitter, douban, github\n\n[extra.willow.social]\ntwitter = \"chaojie_cn\"\ndouban = \"218724191\"\ngithub = \"ischaojie\"\n\n# --- photography --- #\n\n[extra.willow.photography]\n# Put the photos you want to show on the photography page here\nphotos = [\n    \"https://file.chaojie.fun/photography/over-spring.jpg\",\n    \"https://file.chaojie.fun/photography/blue.jpg\",\n]\n\n# --- giscus --- #\n# see https://giscus.app/ for more details\n\n[extra.willow.comment.giscus]\nrepo = \"ischaojie/willow\"\nrepo_id = \"R_kgDOJSaQFQ\"\ncategory = \"Announcements\"\ncategory_id = \"DIC_kwDOJSaQFc4CVjI_\"\nmapping = \"title\"\n\n# --- memos --- #\n\n[extra.willow.memos]\nshow_num = 10\n\n# The memo api\napi = \"https://momo.chaojie.fun/api/memo/all\"\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fischaojie%2Fwillow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fischaojie%2Fwillow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fischaojie%2Fwillow/lists"}