{"id":16553542,"url":"https://github.com/roneoorg/hugo-shortcode-roneo-collection","last_synced_at":"2025-03-21T10:32:22.166Z","repository":{"id":64006069,"uuid":"525896780","full_name":"RoneoOrg/hugo-shortcode-roneo-collection","owner":"RoneoOrg","description":"A shortcode collection for Hugo","archived":false,"fork":false,"pushed_at":"2025-02-12T10:29:13.000Z","size":5049,"stargazers_count":45,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-17T17:55:05.080Z","etag":null,"topics":["hugo","hugo-shortcodes","hugo-theme-component"],"latest_commit_sha":null,"homepage":"","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/RoneoOrg.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":"2022-08-17T17:44:25.000Z","updated_at":"2025-02-27T16:38:01.000Z","dependencies_parsed_at":"2023-01-14T18:31:01.009Z","dependency_job_id":"1bc1981e-0d71-431b-ae49-476404d78ae6","html_url":"https://github.com/RoneoOrg/hugo-shortcode-roneo-collection","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/RoneoOrg%2Fhugo-shortcode-roneo-collection","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RoneoOrg%2Fhugo-shortcode-roneo-collection/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RoneoOrg%2Fhugo-shortcode-roneo-collection/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RoneoOrg%2Fhugo-shortcode-roneo-collection/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RoneoOrg","download_url":"https://codeload.github.com/RoneoOrg/hugo-shortcode-roneo-collection/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244778018,"owners_count":20508834,"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":["hugo","hugo-shortcodes","hugo-theme-component"],"created_at":"2024-10-11T19:48:40.284Z","updated_at":"2025-03-21T10:32:17.157Z","avatar_url":"https://github.com/RoneoOrg.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n\n\n## Enhancing Hugo with a Shortcode collection\n\n\n### Use inline SVG icons\n\n- Use 4000+ open source SVG icons with Hugo\n- Easily add your own icons and define custom CSS classes\n\n#### Screenshot\n\n![Inline SVG icons with this shortcode for Hugo](https://gitlab.com/Roneo/hugo-shortcode-roneo-collection/-/raw/main/img/svg-icons.png)  \n\n#### Usage\n\nAs a shortcode:\n\n    {{\u003c ico moon \u003e}}\n\n    {{\u003c ico icon=\"star\" theme=\"solid\" class=\"red medium\" \u003e}}\n\nAs a partial:\n\n    {{ partial \"ico\" \"star\" }}\n\nSee this [release announcement](https://roneo.org/en/hugo-svg-icon-shortcode/) to learn more\n\n----\n\n### Embed audio files\n\nAn elegant way to insert an audio player and share local and remote audio files.\n\nUsage:\n\n```\n{{\u003c audio \"https://archive.org/download/test/aufiofile.mp3\" \u003e}}\n```\nScreenshot:\n\n\u003cdiv align=\"center\"\u003e\n\n![Screenshot of the audio Shortcode in action](https://gitlab.com/Roneo/hugo-shortcode-roneo-collection/-/raw/main/img/screenshot.jpg)\n\n\u003c/div\u003e\n\nOptions are available. Here we define a caption\n\n```go\n{{\u003c audio \"/audiofilename.mp3\" \"A custom comment\" \u003e}}\n```\n\nNamed parameters can be used too:\n\n```go\n{{\u003c audio src=\"/audiofilename.mp3\" caption=\"A custom comment\" class=\"foo\" preload=\"none\" \u003e}}\n```\n\nThis shortcode is based on [Plyr.io](https://plyr.io/), see [this tutorial](https://roneo.org/en/hugo/plyr) to set up with Hugo\n\n----\n\n### Customized notices and warning\n\nUsage:\n\n```\n{{\u003c box info \u003e}}\n  Incididunt labore eiusmod culpa eu nostrud tempor laborum consequat eiusmod excepteur.\n{{\u003c /box \u003e}}\n```\n\nScreenshot:\n\n![Include custom messages in your posts with a Shortcode](https://roneo.org/illustrations/hugo-notices-shortcode-show-warning-message.en-img/20220914110145.jpg)\n\nSee the [demo and documentation](https://roneo.org/en/hugo-warning-messages-shortcode/) for details.\n\n----\n\n### Embed video file\n\n**Mission:** easily embed players from local and remote video files\n\n\nUsage:\n\n    {{\u003c video \"https://archive.org/download/tesfile.mp4\" \u003e}}\n\n\nOptions are available. Here we define a caption:\n\n```go\n{{\u003c video \"/testfile.mp4\" \"A custom caption\" \u003e}}\n```\n\nNamed parameters can be used too:\n\n```go\n{{\u003c video src=\"/test-file.mp4\" caption=\"A custom comment\"  poster=\"preview-image.jpg\" class=\"foo\" preload=\"none\" \u003e}}\n```\n\nThis shortcode is based on [Plyr.io](https://plyr.io/), see [the documentation](https://github.com/sampotts/plyr#features) to learn about the features and [this tutorial](https://roneo.org/en/hugo/plyr) to set up with Hugo\n\n----\n\n### Show Creative Commons icons\n\nCreative Commons public licenses provide a standard set of terms and conditions that creators and other rights holders may use to share original works.\n\nAuthors can give selected rights to others, with optional criterias.\n\nThis Hugo Shortcode can be used to display icons depending on selected criterias.\n\n```\n{{\u003c cc \"by\" \u003e}}  \n{{\u003c cc \"by nc\" \u003e}}\n{{\u003c cc \"by-nc-sa\" \u003e}}\n```\n\nWill show\n\n![Creative commons shortcode for Hugo](https://roneo.org/illustrations/hugo-creative-commons-shortcode.png)\n\nThe linked URL is adapted to point to the right Creative Commons license.\n\n----\n\n### Include a Markdown file into another\n\nThe same content can be relevant in several places.  \nHere is how to include the same Markdown file in multiple pages.\n\n    {{% include \"included-file-name.md\" %}}\n\nFeatures:\n\n- Markdown content and Shortcodes are properly included and rendered\n- The Front Matter of included file is hidden\n- The filename is enough (no fullpath is required)\n\nNote that you may need to restart Hugo Server to see the changes in included files applied.\n\nSee [these notes](https://roneo.org/en/hugo-include-another-file-with-a-shortcode/) for details\n\n\u003c!-- \n### List Github stars\n\n**Mission**: Display a list of the last starred repositories on Github on your website. This list is automatically updated every time the website is rebuilt.\n\n**Screenshot:**\n\n![A screenshot of Github API shortcode for Hugo](https://roneo.org/illustrations/hugo-api-get-users-starred-repo-from-github-api-shortcode.en-img/20220914095801.jpg)\n\n\nSee [the demo](https://demo.roneo.app/hugo-fetch-github-api-shortcode/) for live examples and [the documentation](https://roneo.org/en/hugo-fetch-remote-data-github-api-shortcode/) for guidance.\n\n\n### Embed multiple audio files from Archive.org\n\nUsage:\n\n    {{\u003c audio-archive \"https://archive.org/details/heyamoli\" \u003e}}\n\nDemo: See https://phoni.es/dev/v4/\n\n --\u003e\n\n----\n\n## Installation\n\n\nSee the [dedicated documentation](https://roneo.org/en/hugo-install-shortcode-collection/).\n\n\n## Found a problem?\n\nPlease open an issue on [Github](https://github.com/RoneoOrg/hugo-shortcode-roneo-collection/issues) / [Gitlab](https://gitlab.com/Roneo/hugo-shortcode-roneo-collection) or [drop me an email](https://roneo.org/contact/).\n\n\n## Contribute\n\n**Code contributions are welcome**, and the main place for development is [this Gitlab repo](https://gitlab.com/Roneo/hugo-shortcode-roneo-collection). You can use [this Github repo](https://github.com/RoneoOrg/hugo-shortcode-roneo-collection) too.\n\n**Please star this repo** on [Github](https://github.com/RoneoOrg/hugo-shortcode-roneo-collection) or [Gitlab](https://gitlab.com/Roneo/hugo-shortcode-roneo-collection), to help this project gain some visibility and reach new contributors.\n\n\n## References\n\n- [Hugo documentation about Theme Components](https://gohugo.io/hugo-modules/theme-components/)\n- Hugo documentation about [Shortcodes](https://gohugo.io/content-management/shortcodes/)\n\n## Related projects\n\n- [Awesome Hugo Shortcodes For Your Websites](https://atharvashah.netlify.app/posts/tech/hugo-shortcodes/)\n- [Darth's Hugo shortcodes](https://github.com/Darthagnon/darths-hugo-shortcodes)\n- [Hugo-leaflet: insert OSM Maps, Markers and Tracks](https://github.com/altrdev/hugo-leaflet)\n- [Hugo Attachment shortcode](https://oostens.me/posts/hugo-attachment-shortcode/)\n- [Hugo Tabs shortcode](https://oostens.me/posts/hugo-tabs-shortcode/)\n- [Hugo-cloak-email: hide email adresses from spammers](https://github.com/martignoni/hugo-cloak-email)\n- [Hugo Timeline Shortcode](https://metalblueberry.github.io/post/howto/2021-02-28_hugo_timeline_shortcode/)\n- [Add Plots With Hugo Shortcodes - Plotly](https://metalblueberry.github.io/post/howto/2019-11-23_add_plots_with_hugo_shortcodes/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froneoorg%2Fhugo-shortcode-roneo-collection","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froneoorg%2Fhugo-shortcode-roneo-collection","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froneoorg%2Fhugo-shortcode-roneo-collection/lists"}