{"id":25456214,"url":"https://github.com/blackstareye/stargazer-layout","last_synced_at":"2025-06-19T08:38:59.248Z","repository":{"id":272988197,"uuid":"918389698","full_name":"Blackstareye/stargazer-layout","owner":"Blackstareye","description":"Stargazer Layout is a hugo theme module that uses beer css for styling and supports node_modules and importmaps. It offers features like minification, fingerprinting, and custom JS/CSS integration.","archived":false,"fork":false,"pushed_at":"2025-05-23T22:19:24.000Z","size":4514,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-23T23:22:43.546Z","etag":null,"topics":["beercss","custom-css","custom-js","fingerprint","hugo","hugo-th","importmap","logging","minify"],"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/Blackstareye.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"kofi":"black_eye"}},"created_at":"2025-01-17T20:41:06.000Z","updated_at":"2025-04-06T11:44:21.000Z","dependencies_parsed_at":null,"dependency_job_id":"8f2e9629-107a-489d-b864-9b20f0f3f522","html_url":"https://github.com/Blackstareye/stargazer-layout","commit_stats":null,"previous_names":["blackstareye/stargazer-layout"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/Blackstareye/stargazer-layout","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blackstareye%2Fstargazer-layout","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blackstareye%2Fstargazer-layout/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blackstareye%2Fstargazer-layout/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blackstareye%2Fstargazer-layout/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Blackstareye","download_url":"https://codeload.github.com/Blackstareye/stargazer-layout/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blackstareye%2Fstargazer-layout/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260718443,"owners_count":23051877,"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":["beercss","custom-css","custom-js","fingerprint","hugo","hugo-th","importmap","logging","minify"],"created_at":"2025-02-18T01:29:29.460Z","updated_at":"2025-06-19T08:38:54.234Z","avatar_url":"https://github.com/Blackstareye.png","language":"HTML","funding_links":["black_eye","https://ko-fi.com/H2H096MU7"],"categories":[],"sub_categories":[],"readme":"# 🌟 Stargazer Layout\n\n![Version](https://img.shields.io/badge/Version-1.1.2-brightgreen)\n![License](https://img.shields.io/badge/License-MIT-blue) ![GitHub\nissues](https://img.shields.io/github/issues/Blackstareye/stargazer-layout)\n![GitHub\nforks](https://img.shields.io/github/forks/Blackstareye/stargazer-layout)\n![GitHub\nstars](https://img.shields.io/github/stars/Blackstareye/stargazer-layout)\n![GitHub last\ncommit](https://img.shields.io/github/last-commit/Blackstareye/stargazer-layout)\n![Maintenance](https://img.shields.io/maintenance/yes/2025)\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/H2H096MU7)\n\nA Product made by Blackeye\n([Oldschoolmanier](https://oldschoolmanier.de))\n\n![screenshot](https://github.com/Blackstareye/stargazer-layout/blob/master/images/screenshot.png?raw=true)\n\n👉 [DEMO](https://blackstareye.github.io/stargazer-layout/)\n\n## Description\n\nStargazer Layout is a hugo theme module that uses [beer\ncss](https://www.beercss.com/) for styling and supports `node_modules`\nand `importmaps`. It offers features like minification, fingerprinting,\nand custom JS/CSS integration.\n\nIt uses `beercss` as default styling. It also enables node_modules and\nimportmaps. Also custom js and css is available.\n\nThis is the theme module that contains all layout specific files and\nfunctions. It can be used as a standalone or as a bundle with Stargazer\n(coming soon).\n\n## 🚀 Features\n\n-   minify and fingerprint on `prod` 🚀 build\n\n-   add css and js as you like\n\n-   enable node module support with vendor folders\n\n-   discover [beer css](https://www.beercss.com/) - full material design\n    ahead!\n\n-   add **js es-modules** with and use it in your own modules with the\n    **importmap**\n\n    -   ✅ works also with `fingerprint and minify`\n\n-   🔨💻 logging functionality integrated, control it with\n    info,warning,debug,error flags :\\\u003e\n\n-   pagination with [beer css](https://www.beercss.com/) 🍺\n\n-   languages: **en** and **de** available and already translated 🌍\\\n\n-   🌗 dark and light mode toggle included\\\n\n-   choose your theme using a **Color** with the param `themeColor` 🎨\\\n\n-   responsive pages and views -- a beautiful blog experience on\n    desktop, tablet, and mobile 📱💻🖥️\n\n### Blogging\n\n[Demo](https://blackstareye.github.io/stargazer-layout/)\n\n-   home page contains `recent posts`, and organizes content in a\n    beutiful grid\n-   all what you need: `list` , `single` , `tags`, `home` page is\n    created\n\n### Soon\n\n-   **soon:** includes\n    [snippets](https://code.visualstudio.com/docs/editor/userdefinedsnippets)\n    for vs code\n    -   for logging with `logging`\n-   **soon:** autodetect scss,ts,js and css in your asset folder\n\n## Screenshots\n\n### Homepage\n\n![alt\ntext](https://github.com/Blackstareye/stargazer-layout/blob/master/_docs/sec/assets/04_Screenshots/image-2.png?raw=true)\n\n### Posts\n\n![alt\ntext](https://github.com/Blackstareye/stargazer-layout/blob/master/_docs/sec/assets/04_Screenshots/image-1.png?raw=true)\n\n### Recent Posts\n\n![recentPosts](https://github.com/Blackstareye/stargazer-layout/blob/master/_docs/sec/assets/04_Screenshots/image.png?raw=true)\n\n## ⚙️ Configuration\n\n### 🔍 SEO\n\nCanonical Link:\n[Wiki](https://en.wikipedia.org/wiki/Canonical_link_element)\n\n``` yaml\n# If enabled, the website sets a canonical link  \n# \u003clink rel=\"canonical\" href=\"http://example.com/\"\u003e\nuseCanonify: True\n```\n\nAnd the usual [Hugo\nconfigurations](https://gohugo.io/getting-started/configuration/#configuration-file)\napply.\n\n### 🚫 Deactivate Demo Content\n\n``` yaml\ndemo: \n    beer: false\n    branding: false\n```\n\n### 🎨 Set Theme\n\nDefine the primary color and generate a complete theme:\n\n``` yaml\nthemeColor: '#44d8f1'\n```\n\n### 📝 Define Menus\n\nFor more details, check out the [Hugo Menu\ndocumentation](https://gohugo.io/templates/menu/).\n\n``` yaml\n# Example config/menus.yaml\nmain: \n  - name: Home\n    pageRef: /\n    pre: \u003ci\u003e Home \u003c/i\u003e\n    weight: 10\n  - name: Blogs\n    pre: \u003ci\u003e Pages \u003c/i\u003e\n    weight: 20\n    identifier: blog_parent  \n  - name: Technical\n    pre: \u003ci\u003e Integration Instructions \u003c/i\u003e\n    parent: blog_parent\n    pageRef: /technique\n    weight: 10\n    identifier: blog_technique\n  - name: Creative\n    pre: \u003ci\u003e Palette \u003c/i\u003e\n    pageRef: /creative\n    parent: blog_parent\n    weight: 20\n    identifier: blog_creative\n```\n\n### ❌ Disable Content Types\n\nPrevent specific content types from appearing in `recent posts`,\n`related posts`, and `categories` pages.\n\n``` yaml\ndisabled:\n  sections: \n      - testing\n      - _index\n```\n\n### 🚀 Set Your Brand\n\n``` yaml\nbrand: \n  # Logo settings (image src and alt text)\n  logo:\n    src: \"images/logo/stargazer/stargazer_layout_big.png\"\n    alt: \"brand_logo\"\n  # Brand title (displayed on tablet and mobile view)\n  title: Demo-Manier\n# will be displayed in the Footer in the Copyright tag if set\nowner: FooMaker\n```\n\n### Set the owner\n\n### 🎭 Custom SCSS / CSS / JS / TS\n\n`node_modules` are automatically included with the wildcard below.\\\nFor finer control, adjust the wildcard or specify files explicitly.\n\n⚠️ **Do not modify sections marked with `!!!`**\n\n``` yaml\nregex_folders: \n    your_site:\n      vendor:  #!!!\n        js: # !!!\n          - \"vendorlibs/**/dist/**/*.min.js\" # Mounted in assets  \n          # Explicit files  \n          - \"vendorlibs/my-explicit-file.js\"\n        css: # !!!\n          - \"vendorlibs/**/dist/**/*.min.css\"\n      custom: # !!!\n        # Custom CSS  \n        css: # !!!\n          - \"css/*.css\"\n          - \"scss/main.scss\"\n        # Custom JS  \n        js: # !!!\n          - \"ts/*.ts\"\n          - \"js/*.js\"\n```\n\n### 🛋️ Importmap - Using Modules in Your Custom Module\n\nUse modules just like in other frameworks.\n\nExample: Vue web app with a `ChildComp` component\n\n``` yaml\nimportmap: # !!!\n  your_site: \n    # Vue  \n    vue: /vendorlibs/vue/dist/vue.esm-browser.prod.js\n    # Component  \n    compact_child: \"js/ChildComp.js\"\n```\n\n``` js\nimport * from \"compact_child\";\n```\n\n\u003e 🔥 **Important:**\\\n\u003e Ensure the file exists at the configured path.\\\n\u003e If your JS file is in `assets/js/foo/bar.js`, then the path should be\n\u003e `js/foo/bar.js`.\n\n### 🛠️ Control Logging\n\n\u003e 📝 **Note:**\\\n\u003e This feature helps with development and provides a structured logging\n\u003e system.\n\nEnable debugging with this snippet:\n\n``` go\n{{ partial \"logging/show_info\" (dict \"level\" \"debug\" \"pre\" \"Debug Message\"  \"inner\" (debug.Dump .) }}\n```\n\n#### 🔹 Parameters\n\n-   `level`: The logging level\\\n-   *(optional)* `pre`: A prefix before the debug message (helps in\n    locating logs)\\\n-   `inner`: The actual message\n\n#### 🛠️ Configure Log Visibility\n\nControl which messages are displayed with:\n\n``` yaml\nshow_infos: \n  error: True\n  warning: True\n  info: True\n  debug: False # \"debug\" messages are hidden\n```\n\n\u003e ⚠️ **Important for Devs:**\\\n\u003e Currently, there's no **logging hierarchy** as in traditional logging\n\u003e frameworks.\\\n\u003e You must manually enable/disable log levels as needed.\n\n## 🎯 Installation\n\n### ⏫ Quickstart\n\nJust copy and paste this into your working directory:\n\n``` sh\nhugo new site my-site\ncd my-site\necho \"theme=[\\\"stargazer-layout\\\"]\" \u003e\u003e hugo.toml\ngit clone https://github.com/Blackstareye/stargazer-layout themes/stargazer-layout\ncd themes/stargazer-layout\nnpm install\ncd ../..\nhugo serve\n```\n\n### 🚀 Install Theme\n\n#### As a Git Submodule\n\nInside your Hugo site folder, run:\n\n``` sh\ngit submodule add https://github.com/Blackstareye/stargazer-layout themes/stargazer-layout\n\n# Go to the theme directory\ncd themes/stargazer-layout\nnpm install\n```\n\n#### Add Theme to Config\n\nInclude this in your Hugo config:\n\n``` yaml\ntheme: \n  - stargazer-layout\n```\n\nOr, if you are using multiple themes:\n\n``` yaml\ntheme: \n  - your-theme\n  - stargazer-layout\n```\n\nFor **TOML** users:\n\n``` toml\ntheme=[\"stargazer-layout\"]\n```\n\nFor more details, check out Hugo's official [Quick\nStart](https://gohugo.io/getting-started/quick-start/) guide.\n\nThat's it! You're all set. 🙌\n\n### 🌟 Run It\n\n``` sh\nhugo serve\n```\n\n## 🛠️ Tech-Stack\n\n-   HTML,JS,SCSS,TS,CSS\n-   [Hugo](https://gohugo.io/getting-started/quick-start/)\n\n## 📄 LICENSE\n\nthis project is under the MIT License, see\n[LICENSE](https://github.com/Blackstareye/stargazer-layout/blob/master/LICENSE)\n\n## 🙏 Credits\n\ninspired by those great themes (check them also out 💚):\n\n-   [Gohugo Theme\n    Anananke](https://github.com/theNewDynamic/gohugo-theme-ananke)\n-   [Hugo Profile](https://github.com/gurusabarish/hugo-profile)\n\n## 📬 Contact\n\n-   **GitHub**: [@blackstareye](https://github.com/Blackstareye)\n\n-   **Website** for Freelancing:\n    [Oldschoolmanier](https://oldschoolmanier.de)\n\n## Star History\n\n\u003ca href=\"https://star-history.com/#Blackstareye/stargazer-layout\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=Blackstareye/stargazer-layout\u0026type=Date\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=Blackstareye/stargazer-layout\u0026type=Date\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=Blackstareye/stargazer-layout\u0026type=Date\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n## Support\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/H2H096MU7)\n\nIf you enjoy the work I do and would like to support me, I would be\ntruly grateful for any donations. Your contribution doesn't just help\nkeep this project going --- it enables me to pursue new ideas, work on\nexciting future projects, and continue creating content that I'm\npassionate about. Every donation, no matter how big or small, makes a\nreal difference and helps me dedicate more time and energy to what I\nlove doing. Your support enables me doing exactly that, thank you 💚.\n\n*Made with ❤️ by Blackeye\n([Oldschoolmanier](https://oldschoolmanier.de))*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackstareye%2Fstargazer-layout","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblackstareye%2Fstargazer-layout","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackstareye%2Fstargazer-layout/lists"}