{"id":17910138,"url":"https://github.com/austingebauer/devise","last_synced_at":"2025-04-03T06:28:57.583Z","repository":{"id":46755263,"uuid":"193039721","full_name":"austingebauer/devise","owner":"austingebauer","description":"A fast, minimal, responsive Hugo theme for blogs.","archived":false,"fork":false,"pushed_at":"2024-11-08T18:00:07.000Z","size":19051,"stargazers_count":111,"open_issues_count":7,"forks_count":54,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-02-08T20:23:59.038Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://themes.gohugo.io/devise","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/austingebauer.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-06-21T05:59:52.000Z","updated_at":"2025-02-02T09:43:57.000Z","dependencies_parsed_at":"2024-11-08T18:40:16.425Z","dependency_job_id":null,"html_url":"https://github.com/austingebauer/devise","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/austingebauer%2Fdevise","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/austingebauer%2Fdevise/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/austingebauer%2Fdevise/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/austingebauer%2Fdevise/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/austingebauer","download_url":"https://codeload.github.com/austingebauer/devise/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246946994,"owners_count":20859202,"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":[],"created_at":"2024-10-28T19:29:20.741Z","updated_at":"2025-04-03T06:28:57.554Z","avatar_url":"https://github.com/austingebauer.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Devise\n\nA fast, minimal, responsive [Hugo](https://gohugo.io/) theme for blogs.\n\n![screenshot.png](https://raw.githubusercontent.com/austingebauer/devise/master/images/screenshot.png)\n\nFor a live demo of the theme, see at: \n- [themes.gohugo.io/devise](https://themes.gohugo.io/devise)\n- [austingebauer.dev](https://austingebauer.dev)\n\n## Features\n\n- All of Hugo's builtin [Content Management](https://gohugo.io/content-management/)\n- Easy installation of [Google Analytics](https://analytics.google.com/analytics/web/provision/#/provision) via Hugo [configuration](https://gohugo.io/getting-started/configuration/) file\n- Fast loading with a 95-100 score on [Google PageSpeed](https://developers.google.com/speed/pagespeed/insights/)\n- Ability to use [Bootstrap 4](https://getbootstrap.com/docs/4.0/getting-started/introduction/) CSS classes via HTML/CSS in Markdown\n- Ability to use [Font Awesome](https://fontawesome.com/) icons\n- Ability to customize the theme styles via [Sass](https://sass-lang.com/)\n- Ability to customize the following items via Hugo [configuration](https://gohugo.io/getting-started/configuration/) file\n    - Meta description\n    - Title\n    - Subtitle\n    - Image\n    - Image border color\n    - Navigation menu\n    - Social icons\n    - Last 'n' recent posts\n    - Background color\n    - Font family\n    - Font color\n\n## Usage\n\nThis following guides installation, configuration, and updating of the Devise Hugo theme.\n\n### Installation\n\nBefore installing this theme, be sure to [install Hugo](https://gohugo.io/getting-started/quick-start/) \nand [create a new site](https://gohugo.io/getting-started/quick-start/#step-2-create-a-new-site).\n\nTo install the theme, run the following from the root directory of your Hugo site:\n\n```bash\n$ git submodule add https://github.com/austingebauer/devise.git themes/devise\n```\n\n### Configuration\n\nNext, open the `config.toml` file in the root of your Hugo site and set the theme:\n\n```toml\ntheme = \"devise\"\n```\n\nExample `config.toml` file with all configuration features filled out:\n\n```toml\nbaseURL = \"https://example.com\"\ntitle = \"Your Website Title\"\nlanguageCode = \"en-us\"\ntheme = \"devise\"\nrelativeURLs = true\nenableEmoji = true\ngoogleAnalytics = \"\"\nenableRobotsTXT = true\ncopyright = \"\u0026copy; Copyright Year, Your Name\"\n\n# Main menu items\n[menu]\n  [[menu.main]]\n    identifier = \"about\"\n    name = \"About\"\n    title = \"About\"\n    url = \"/about/\"\n    weight = -110\n  [[menu.main]]\n    identifier = \"posts\"\n    name = \"Posts\"\n    title = \"Posts\"\n    url = \"/post/\"\n    weight = -100\n  [[menu.main]]\n    identifier = \"categories\"\n    name = \"Categories\"\n    title = \"Categories\"\n    url = \"/categories/\"\n    weight = -90\n\n# Configuration Features\n[params]\n  description = \"Your meta description\"      # Your meta description of the site\n  header_title = \"Your Name\"                 # Your header title\n  header_subtitle = \"Your Creative Subtitle\" # Your header subtitle\n  home_image = \"/images/avatar.png\"          # Path to header image starting from the static directory (optional)\n  recent_posts = 5                           # Max amount of recent posts to show\n  mainSections = [\"posts\", \"post\", \"blog\"]   # Main sections to include in recent posts\n  [params.style]                             # CSS style overrides\n    backgroundColor = \"#f8f9fa\"\n    homeImageBorderColor = \"#ffffff\"\n    fontFamilyBase = \"Helvetica Neue\"        # First-choice font\n    fontColor = \"#212529\"\n  [[params.social]]\n    fa_icon = \"fab fa-github fa-1x\"          # Font Awesome icon class\n    href = \"http://github.com/youruser\"      # Link to associate with icon (http://, https://, mailto:)\n  [[params.social]]\n    fa_icon = \"fab fa-linkedin-in fa-1x\"\n    href = \"\"\n  [[params.social]]\n    fa_icon = \"fab fa-twitter fa-1x\"\n    href = \"\"\n  [[params.social]]\n    fa_icon = \"fas fa-at fa-1x\"\n    href = \"\"\n```\n\n### Updating\n\nTo get updates to the theme, run the following from the root directory of your Hugo site: \n\n```\n$ git submodule update --remote themes/devise\n```\n\n### Adding Custom Styles\n\nAdding custom styles to the devise theme is simple. There are two options \navailable for doing so.\n\n#### Option 1:\n\nIn the `config.toml` file of your website, you can set the following custom style\nparameters:\n\n```toml\n[params.style]\n  backgroundColor = \"#f8f9fa\"\n  homeImageBorderColor = \"#ffffff\"\n  fontFamilyBase = \"Helvetica Neue\"\n  fontColor = \"#212529\"\n```\n\nIf you'd like to see other custom styles available as config parameters, please open an [issue](https://github.com/austingebauer/devise/issues).\n\n#### Option 2:\n\nTo add custom [Sass](https://sass-lang.com/) styles to the devise theme, you'll \nneed to add the following file to the [assets](https://gohugo.io/hugo-pipes/introduction/#asset-directory) \ndirectory of your site:\n\n- `assets/sass/custom.scss`\n\nIn the file, you can use [Sass](https://sass-lang.com/) syntax to declare\nyour custom styles. After doing so, you should see custom styling added to \nyour devise based Hugo site.\n\n## Demo\n\nTo run a live demo of the theme on your laptop, run the following from the `exampleSite` directory of the \ndevise theme:\n\n```bash\nhugo server --themesDir ../.. --watch --verbose --cleanDestinationDir --disableFastRender\n```\n\nFor a live demo of the theme, see at: \n- [themes.gohugo.io/devise](https://themes.gohugo.io/devise)\n- [austingebauer.dev](https://austingebauer.dev)\n\n## Contributing\n\nIf you have an idea for a new feature or found a bug, please feel free to use Github\n[issues](https://github.com/austingebauer/devise/issues) to let me know.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faustingebauer%2Fdevise","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faustingebauer%2Fdevise","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faustingebauer%2Fdevise/lists"}