{"id":13930200,"url":"https://github.com/onweru/newsroom","last_synced_at":"2025-05-15T23:08:18.523Z","repository":{"id":38950393,"uuid":"202606752","full_name":"onweru/newsroom","owner":"onweru","description":"A simple, minimalistic Hugo theme. View Demo here","archived":false,"fork":false,"pushed_at":"2025-01-23T18:50:23.000Z","size":3599,"stargazers_count":308,"open_issues_count":3,"forks_count":119,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-08T10:34:39.965Z","etag":null,"topics":["custom-shortcodes","deeplinks","disqus","hugo","hugo-theme","minimalistic-theme","sass","syntax-highlighting"],"latest_commit_sha":null,"homepage":"https://rooms.netlify.app/","language":"Sass","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/onweru.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":"2019-08-15T20:25:37.000Z","updated_at":"2025-04-08T02:25:19.000Z","dependencies_parsed_at":"2022-09-18T22:54:34.273Z","dependency_job_id":"39a5f181-93c9-47dc-9a03-344be1bb435f","html_url":"https://github.com/onweru/newsroom","commit_stats":{"total_commits":184,"total_committers":13,"mean_commits":"14.153846153846153","dds":0.3152173913043478,"last_synced_commit":"5a0c428a9b15bc1f14876f5406b637e18faf9cf5"},"previous_names":[],"tags_count":2,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onweru%2Fnewsroom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onweru%2Fnewsroom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onweru%2Fnewsroom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onweru%2Fnewsroom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/onweru","download_url":"https://codeload.github.com/onweru/newsroom/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254436949,"owners_count":22070947,"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":["custom-shortcodes","deeplinks","disqus","hugo","hugo-theme","minimalistic-theme","sass","syntax-highlighting"],"created_at":"2024-08-07T18:05:07.461Z","updated_at":"2025-05-15T23:08:12.849Z","avatar_url":"https://github.com/onweru.png","language":"Sass","funding_links":[],"categories":["sass"],"sub_categories":[],"readme":"# Newsroom Theme\n\nThis is a simple, minimalistic theme, which is inspired by [Apple's Newsroom page](https://www.apple.com/newsroom/). It uses *grid css*, *flexbox* \u0026 js (no jQuery, or related libraries).\n\n![Hugo Newsroom Theme](https://raw.githubusercontent.com/onweru/newsroom/master/images/screenshot.png)\n\n## Features\n\n* Blog\n* Modern\n* Responsive\n* Deeplinks\n* Dark Mode\n* Supports native lazy loading of images \u0026 iframes\n* Syntax highlighting\n\n### Deeplinks\n\nFor all content published using markdown, deeplinks will be added to the pages so that you can share with precision 😃 Just   hover on a heading and the link button will pop. Click it to copy.\n\n## Install Newsroom Theme\n\n__Note:__ Newsroom uses is styled in sass. Thefore, __hugo-extended version__ must be installed on your system.\n\n### Option 1: Add Newsroom as a git submodule\n\nAdd this theme as a Git submodule inside your Hugo site folder:\n\n```bash\ngit submodule add https://github.com/onweru/newsroom.git themes/newsroom\n```\n\n### Option 2: Add Newsroom as a hugo module __(Recommended)__\n\nIn your config.toml file, set `theme` field value as follows\n\n```toml\ntheme = [\"github.com/onweru/newsroom\"]\n```\n\nThen run\n\n```\nhugo mod init yourWebsiteName \u0026\u0026 hugo mod get -u .\n```\n\n### Option 3: Install Newsroom into your theme directory __(Least diserable)__\n\nFrom the root of your Hugo website run:\n\n```\ngit clone https://github.com/onweru/newsroom themes/newsroom\n```\n\nIn your config.toml file, set `theme` field value as follows\n\n```toml\ntheme = \"newsroom\"\n```\n\n\n## Configuration\n\nYou can configure the site as follows:\n\n1. **General Information**\n\n    Use `config.toml` file.\n\n2. **menu**, **footer**\n\n    See the yaml files inside the `data/` directory.\n\n## Start publishing\n\nFollow the `exampleSite/`; specifically, the [content](https://github.com/onweru/newsroom/tree/master/exampleSite/content/post) directory\n\n### Dark Mode\n\nToday, operating systems have a system-wide __light ~ dark mode__ switch. Your website will adapt to the user's preferred lighting mode. Still, if the user wants to opt in or out of darkmode, there's a UI control for that too in the menu 😊.\n\n![Dark Mode](https://raw.githubusercontent.com/onweru/newsroom/master/images/screenshot-dark.png)\n\n#### Set a default lighting mode\n\nUsing your site's config.toml file, set the value of `defaultMode` to either `\"dark\"` or `\"light\"`.\n\nIf your site is built from a copy of the exampleSite, the field is already included; you only need to uncomment and set its value.\n\n\u003e The UI control for toggling darkmode will remain in place. This way, the user can decide which mode they would like to use while browsing your website\n\n### Custom 404 Page\n\n![404 page](https://raw.githubusercontent.com/onweru/newsroom/master/images/404.png)\n\n### Syntax highlighting\n\n![Syntax Highlighting](https://raw.githubusercontent.com/onweru/newsroom/master/images/syntax.png) \n\nIf you wish, you can opt to [use Chroma](./exampleSite/config.toml#L17-L27).\n\n### I want to use disqus\n\nIf you like, you could [use disqus on your site](https://github.com/onweru/newsroom/issues/2). To enable disqus on your site, simply, add the line below to you `config.toml` file. If you're working off the [exampleSite](https://github.com/onweru/newsroom/tree/master/exampleSite), the line is [already there](https://github.com/onweru/newsroom/blob/ad9b7a9f7ea266b539f846a2f3bdf080e648bb84/exampleSite/config.toml#L15-L16); just uncomment it.\n\n```toml\ndisqusShortname = \"yourdiscussshortname\"\n```\n\u003e Remember to edit the `yourdiscussshortname` appropriately.\n\nFrom your disqus dashboard, set your scripts `color scheme` to __auto__. See screenshot below\n\n![](https://raw.githubusercontent.com/onweru/newsroom/master/images/disqus-color-scheme.png)\n\n## Custom Shortcodes\n\nThis theme ships with __2 custom shortcodes__ (they both use positional parameters):\n\n1. __Video__\n    This shortcode can be used to embed a youtube video with custom styling. It takes a solo positional parameter.\n\n    ```\n    ...\n    {{\u003c video \"youtubeVideoID\" \u003e}}\n    ...\n    ```\n\n2. __Picture__\n    You want to use darkmode images when darkmode is enabled on a device and a regular image on lightmode? It takes 3 positional parameter\n\n    Store these images in the `static/images` directory.\n    ```\n    ...\n    {{\u003c picture \"lightModeImage.png\" \"darkModeImage.png\" \"Image alt text\" \u003e}}\n    ...\n    ```\n\n## From the same creator\n\n1. [Clarity Theme](https://github.com/chipzoller/hugo-clarity)\n2. [Compose Theme](https://github.com/onweru/compose)\n3. [Swift Theme](https://github.com/onweru/hugo-swift-theme)\n4. [Browse](https://github.com/onweru/browse)\n\n## License\n\nThis theme is available under the [MIT license](https://github.com/onweru/newsroom/blob/master/LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonweru%2Fnewsroom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fonweru%2Fnewsroom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonweru%2Fnewsroom/lists"}