{"id":16495982,"url":"https://github.com/jmau111/hugo-theme-ava","last_synced_at":"2025-07-26T21:35:30.156Z","repository":{"id":47672398,"uuid":"394052430","full_name":"jmau111/hugo-theme-ava","owner":"jmau111","description":"Ava is a light theme for your blog with essential features you might dig in.","archived":false,"fork":false,"pushed_at":"2024-04-05T03:04:45.000Z","size":17281,"stargazers_count":13,"open_issues_count":2,"forks_count":5,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-03-15T04:33:15.888Z","etag":null,"topics":["dark-mode","hugo-theme","seo"],"latest_commit_sha":null,"homepage":"https://jmau111.github.io/hugo-theme-ava-demo","language":"SCSS","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/jmau111.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2021-08-08T19:25:30.000Z","updated_at":"2024-08-03T18:04:56.000Z","dependencies_parsed_at":"2024-10-28T16:11:42.099Z","dependency_job_id":"ec1249ef-c3af-4b7f-adfe-21dd5a64a493","html_url":"https://github.com/jmau111/hugo-theme-ava","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmau111%2Fhugo-theme-ava","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmau111%2Fhugo-theme-ava/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmau111%2Fhugo-theme-ava/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmau111%2Fhugo-theme-ava/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jmau111","download_url":"https://codeload.github.com/jmau111/hugo-theme-ava/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245108180,"owners_count":20562001,"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":["dark-mode","hugo-theme","seo"],"created_at":"2024-10-11T14:33:34.326Z","updated_at":"2025-03-23T13:31:36.326Z","avatar_url":"https://github.com/jmau111.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hugo Ava Theme\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/jmau111/hugo-theme-ava/main/images/screenshot2.png\" alt=\"\" width=\"100%\"\u003e\n\n[![LICENSE](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/jmau111/hugo-theme-ava/blob/main/LICENSE)\n[![release](https://img.shields.io/github/release/jmau111/hugo-theme-ava.svg)](https://github.com/jmau111/hugo-theme-ava/releases/latest)\n[![release date](https://img.shields.io/github/release-date/jmau111/hugo-theme-ava.svg)](https://github.com/jmau111/hugo-theme-ava/releases)\n[![release feed](https://img.shields.io/badge/release-feed-yellow)](https://github.com/jmau111/hugo-theme-ava/releases.atom)\n\n\u003c/div\u003e\n\n[See online demo](https://jmau111.github.io/hugo-theme-ava-demo)\n\n[Code source demo](https://github.com/jmau111/hugo-theme-ava-demo)\n\n## Installation\n\n### Install Hugo\n\nFollow [the official installation guide](https://gohugo.io/getting-started/installing/)\n\n**You need the extended version**\n\n### Create a new Hugo site\n\n```\nhugo new site my-site\n```\n\nThis will create a fresh Hugo site in the folder `my-site`.\n\n### Install theme with Git\n\nClone this repo into the themes folder\n```\ncd my-site\ngit clone https://github.com/jmau111/hugo-theme-ava.git themes/hugo-theme-ava\n```\n\n### Copy example content\n\nYou can use contents generated for the demo:\n\n```\ncp -a themes/hugo-theme-ava/exampleSite/. .\n```\n\n### SVGs\n\nIt's not the best practice, but I like to keep things simple.\n\nThat's why I call svgs in templates now.\n\n### Images\n\n#### Default image\n\nUse absolute URLs:\n\n```\n[params]\n  defaultImage = \"https://raw.githubusercontent.com/jmau111/hugo-theme-ava/main/images/default.jpeg\"\n```\n\n#### Default og \u0026 meta image\n\nUse absolute URLs:\n\n```\n[params]\n  [params.meta_tags]\n    meta_og_image = \"https://raw.githubusercontent.com/jmau111/hugo-theme-ava/main/images/default.jpeg\"\n```\n\n#### Subheader and featured images\n\nUse the `image` parameter in your frontmatter (posts). If you want to use an external image use an absolute path.\n\nIf you host your images on the same installation, create a folder for your post in the `content/` directory:\n\n```\ncontent\n   my-post/\n    index.md\n    images/\n      myfeatured.jpg\n```\n\nThen, use relative path in your frontmattter:\n\n```\n---\ntitle: \"Example 8\"\ndescription: \"This is desc 8\"\ndate: 2023-01-05T11:11:11+01:00\ntype: \"post\"\ndraft: false\nimage: \"images/myfeatured.jpg\"\n---\n```\n\nIt's a bit more constraining, but it allows a better organization, as all resources of the same page are grouped in the content folder.\n\n**These few changes should not impact previous installations too much. If so, please open an issue.**\n\n### Change colors\n\nFeel free to change colors for both light and dark mode. See `themes/hugo-theme-ava/assets/scss/_mode_light.scss` or `themes/hugo-theme-ava/assets/scss/_mode_dark.scss`.\n\nYou can customize other CSS variables in `themes/hugo-theme-ava/assets/scss/_variables.scss`\n\n### Icons\n\nThe theme uses [feather icons](https://feathericons.com/), a beautiful and free set of svg icons. The `/assets/images/` folder contains everything.\n\nIt's probably a bit too much, so do not hesitate to delete unused files.\n\n### Don't forget to change the favicon\n\nYou don't have to remove the one set in the theme but ensure you replace the one in the `/static/` folder at the root or your project.\n\n### humans.txt\n\nI've included the `humans.txt` file cause I care about this file. Use custom params to customize it:\n\n```\n [params.humans_txt]\n    dev_team = \"\"\n    dev_github = \"\"\n    thanks = \"\"\n    standards = \"\"\n    software = \"\"\n    other_notes = \"\"\n```\n\n### Using the config.toml\n\nCopy the `config.toml` file into the root folder of your Hugo site, then you can modify the copy.\n\n## Run Hugo\n\nRun dev server:\n\n```\nhugo server\n```\n\nThen you can go to [`localhost:1313`](http://localhost:1313).\n\nBuild:\n\n```\nhugo\n```\n\n## Configuration\n\n### Change baseURL\n\n```\nbaseURL = \"https://www.mysite.com/\"\n```\n\n### Google Analytics\n\nAdd you google analytics ID to the `config.toml`\n\n```\n// config.toml\n[params]\n  ga_id=\"UA-XXXXXXXX-X\"\n```\n\n### Menu\n\nYou can edit and add main menu links in the `config.toml` under `[[menu.main]]`\n\n### Images\n\nYou can set a default image in `config.toml`:\n\n```\n  [params.meta_tags]\n          meta_og_image = \"https://raw.githubusercontent.com/jmau111/hugo-theme-ava/main/images/default.jpeg\"\n```\n\nYou can customize per each post in the front matter:\n\n```md\nimage: \"/images/mangoose.jpeg\"\n```\n\n\nIf you don't set anything then the theme display the default image \"https://raw.githubusercontent.com/jmau111/hugo-theme-ava/main/images/default.jpeg\".\n\n## Comments\n\nThere's now a custom Disqus partial. Please be aware this is not the most privacy-focused solution on the market.\n\nTo enable it, edit the Site variable `disqus` in the `config.toml` and replace \"xxxxxxx\" by your Disqus handle. Otherwise, nothing will be loaded.\n\n## TODO\n\nA lot of stuff, including:\n\n* i18n\n* more shortcodes\n* author box \n\nBut still, it's not a multi-purpose theme.\n\n## License\n\nYou're welcome to fork this, but keep the license MIT please. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmau111%2Fhugo-theme-ava","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjmau111%2Fhugo-theme-ava","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmau111%2Fhugo-theme-ava/lists"}