{"id":18821343,"url":"https://github.com/bowman2001/hugo-mod-meta","last_synced_at":"2025-07-07T16:33:24.449Z","repository":{"id":109922539,"uuid":"538277200","full_name":"bowman2001/hugo-mod-meta","owner":"bowman2001","description":"Generate meta-data for search engines and social networks in the `\u003chead\u003e`. The required data is pulled in by completely configurable template functions.","archived":false,"fork":false,"pushed_at":"2023-09-30T11:25:10.000Z","size":54,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-07T16:33:14.513Z","etag":null,"topics":["facebook","google","hugo","json-ld","seo","twitter"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bowman2001.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}},"created_at":"2022-09-19T00:18:24.000Z","updated_at":"2023-04-10T09:38:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"55bbae1e-89aa-4494-bbcb-8d1e27fe569d","html_url":"https://github.com/bowman2001/hugo-mod-meta","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/bowman2001/hugo-mod-meta","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bowman2001%2Fhugo-mod-meta","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bowman2001%2Fhugo-mod-meta/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bowman2001%2Fhugo-mod-meta/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bowman2001%2Fhugo-mod-meta/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bowman2001","download_url":"https://codeload.github.com/bowman2001/hugo-mod-meta/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bowman2001%2Fhugo-mod-meta/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264113383,"owners_count":23559352,"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":["facebook","google","hugo","json-ld","seo","twitter"],"created_at":"2024-11-08T00:39:09.759Z","updated_at":"2025-07-07T16:33:24.400Z","avatar_url":"https://github.com/bowman2001.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hugo-mod-meta\n\nThis module generates the title, many meta tags and and JSON+LD schema scripts for [Hugo](https://gohugo.io) pages. These are processed by search engines and social networks to create some kind of preview on their pages.\n\nHugo already offers a set of internal templates for this purpose:\n- [**Open Graph**](https://gohugo.io/templates/internal/#open-graph) for Facebook and others\n- [**Twitter Cards**](https://gohugo.io/templates/internal/#twitter-cards)\n- The **Schema** template is undocumented but is using the same concept as the other two templates\n\nThe Hugo templates are doing fine as long as we stick to the data parameters and the content organization they expect. They were the starting point for this project.\n\n## Why this new module then?\n\nThis project became necessary out of four reasons:\n1. My resources are organized in a way the internal Hugo partials can’t find them.\n2. My content structure is different from what these templates expect. (Simple example: The `.Description` only contains a very short description of the content for navigation links which is too short for the description meta tag. I like to use a dedicated SEO description or at least a `.Summary` with one or two full sentences to appear there.) \n3. The Hugo maintainers and core developers are stretched thin and don’t find the time to review pull requests for internal template code. There are many stale PRs for these templates with reasonable small improvements. This module should provide an alternative, because I don’t want to bother the Hugo maintainers with template problems I can write myself.\n4. Reusability: I don’t want to think about meta tags more than absolutely necessary and will include this module in every project of mine. From reading discussions between other developers I get the impression they also reinvented the generation of these tags repeatedly in their projects. The overhead of using a configurable module should pay off fast.\n\n## How?\n\nThe main concept of this module is to make **no fixed assumptions about the project structure**. The partials for generating the meta tags call other partials to get the necessary content. These content partials can be replaced in every project to fit its structure. \n\nBut we don’t have to write all those partials from scratch. There are default templates to start with, which resemble the internal Hugo way.  \n\nThe output doesn’t need a lot of configuration. The resulting tags and schema scripts need to follow the demands of the internet services we like to address. The correct results of the provided partials are predictable. They should adapt in time to any changes of the specifications by social network and search providers.  \n\n## Specifications \n\n- Twitter: \u003chttps://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/markup\u003e \n- Opengraph: \u003chttps://ogp.me/\u003e\n- Schema (JSON-LD): \u003chttps://developers.google.com/search/docs/advanced/structured-data/search-gallery\u003e\n\n## Testing\nThe social network or search engine providers offer validation tools.\nTODO: Add links\n\n## Alternatives\n[SEO module by the New Dynamic](https://github.com/theNewDynamic/hugo-module-tnd-seo)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbowman2001%2Fhugo-mod-meta","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbowman2001%2Fhugo-mod-meta","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbowman2001%2Fhugo-mod-meta/lists"}