{"id":20169606,"url":"https://github.com/hwayne/alloy-hugo-demo","last_synced_at":"2026-03-05T16:18:23.962Z","repository":{"id":47629891,"uuid":"377574213","full_name":"hwayne/alloy-hugo-demo","owner":"hwayne","description":"Proof of concept of switching Alloytools from Jekyll to Hugo","archived":false,"fork":false,"pushed_at":"2021-08-20T17:53:57.000Z","size":592,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-13T15:24:13.361Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hwayne.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-06-16T17:19:37.000Z","updated_at":"2021-08-31T16:46:43.000Z","dependencies_parsed_at":"2022-09-10T00:23:58.907Z","dependency_job_id":null,"html_url":"https://github.com/hwayne/alloy-hugo-demo","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/hwayne%2Falloy-hugo-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hwayne%2Falloy-hugo-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hwayne%2Falloy-hugo-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hwayne%2Falloy-hugo-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hwayne","download_url":"https://codeload.github.com/hwayne/alloy-hugo-demo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241605820,"owners_count":19989612,"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-11-14T01:13:12.877Z","updated_at":"2025-11-29T16:03:13.450Z","avatar_url":"https://github.com/hwayne.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Alloy Hugo Demo\n\nThis is a prototype for migrating the current [alloytools](http://alloytools.org/) website to [hugo](https://gohugo.io/).  You can see the current prototype website [here](https://hwayne.github.io/alloy-hugo-demo/).\n\n### Why the migration\n\nAlloytools is currently on [jekyll](https://jekyllrb.com/). Jekyll is very difficult to set up, especially if you're not on Linux. Hugo, by contrast, comes in precompiled binaries per OS. All you need to do is download the appropriate binary and you're good to go. This way you can run the site locally and test for changes\n\nThe migration blocker, as discussed in the (May?) Alloyboard meeting, is that Jekyll natively integrates with Github pages, making it easy to deploy. To address this, we set up a [github action](https://github.com/hwayne/alloy-hugo-demo/actions) on the official repo. After every merge to master, the action will build the site and put the html files in the [`gh-pages`](https://github.com/hwayne/alloy-hugo-demo/tree/gh-pages) branch. Build times are typically less than 30 seconds.\n\n## Setup\n\n### Download the appropiate binary\n\nDownload the appropriate **hugo extended** [for your OS](https://github.com/gohugoio/hugo/releases). Currently, this is `hugo_extended_0.87.0`.\n\n(We need hugo extended because we ported over SASS CSS files from the old site)\n\n### Set up the repo\n\nFirst clone the repo:\n\n```bash\ngit clone https://github.com/hwayne/alloy-hugo-demo.git\n```\n\nThen, while in the repo root folder, download [the ananke theme](https://themes.gohugo.io/themes/):\n\n\n```bash\ngit submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke\ngit submodule init\ngit submodule update\n```\n\n### Run the repo\n\nYou can create a local instance of the site with \n\n```bash\n./hugo_binary serve\n```\n\nIt will automatically update whenever you save a change to a file.  If you just want to build the site without running a local dev server, just do\n\n```bash\n./hugo_binary\n```\nhttps://github.com/peaceiris/actions-hugo\n\n## Contributing\n\n### TODO \n\n* Explain layout of hugo folder\n* Explain drafts\n* Explain shortcodes\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhwayne%2Falloy-hugo-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhwayne%2Falloy-hugo-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhwayne%2Falloy-hugo-demo/lists"}