{"id":15797254,"url":"https://github.com/terry-d-4tw/terry-d-4tw","last_synced_at":"2026-04-13T17:33:22.056Z","repository":{"id":171778620,"uuid":"648397065","full_name":"terry-d-4tw/terry-d-4tw","owner":"terry-d-4tw","description":"Hack Your Portfolio using GitHub Pages \u0026 Actions, JAM Stack in a form of Jekyll ","archived":false,"fork":false,"pushed_at":"2023-06-02T05:06:34.000Z","size":47,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-12T00:26:20.037Z","etag":null,"topics":["github-actions","github-pages","hackathon","jamstack"],"latest_commit_sha":null,"homepage":"https://terry-d-4tw.github.io/terry-d-4tw/","language":"JavaScript","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/terry-d-4tw.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-01T22:01:18.000Z","updated_at":"2023-06-02T04:47:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"9eaa387b-e78e-45de-9e23-bc749c3f4057","html_url":"https://github.com/terry-d-4tw/terry-d-4tw","commit_stats":{"total_commits":9,"total_committers":3,"mean_commits":3.0,"dds":0.2222222222222222,"last_synced_commit":"30756a0515e6ca890e4d4db25f242cf282b1449e"},"previous_names":["terry-d-4tw/terry-d-4tw"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/terry-d-4tw/terry-d-4tw","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terry-d-4tw%2Fterry-d-4tw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terry-d-4tw%2Fterry-d-4tw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terry-d-4tw%2Fterry-d-4tw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terry-d-4tw%2Fterry-d-4tw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/terry-d-4tw","download_url":"https://codeload.github.com/terry-d-4tw/terry-d-4tw/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terry-d-4tw%2Fterry-d-4tw/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262628641,"owners_count":23339832,"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":["github-actions","github-pages","hackathon","jamstack"],"created_at":"2024-10-05T00:05:44.357Z","updated_at":"2026-04-13T17:33:17.022Z","avatar_url":"https://github.com/terry-d-4tw.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hackathon [hack-your-portfolio](https://hack-your-portfolio.devpost.com)\n\n# Action Plan (WIP / Draft)\n\n- [x] Create a `hidden` repo on GitHub that has the same name as the username/ownername with basic README\n- [x] Set up some elementary testing via GitHub Actions (e.g. assert 'I love Hackathons and Test Driving' is in README)\n- [x] Deploy to GitHub Pages and set up GitHub to auto-deploy on code change\n- [x] Set up elementary JAMStack / Jekyll framework\n- [x] experiment with Jekyll themes\n- [ ] experiment with Bridgetown (Jekyll alternative)\n- [ ] explore some cool JavaScript to spice up JAMStack if theme does not suffice\n- [ ] explore some APIs to connect to JAM Stack\n- [ ] OPTIONAL - enhance CI/CD pipeline\n- [ ] OPTIONAL - enhance basic testing\n- [ ] OPTIONAL - explore OpenTelemetry\n- [ ] OPTIONAL - explore Data / Telemetry visualisation - m.b. explore Grafana\n\n# Logs\n\n## Set up some elementary testing via GitHub Actions (e.g. assert 'I love Hackathons and Test Driving' is in README)\n\n```sh\nif curl -s -N 'https://github.com/terry-d-4tw/' | grep -q \"I love Ruby too\"; then\n echo \"it worked! 🎉\"; exit 0; else\n echo \"it did not work 😔\"; exit 1\nfi\n```\n\n## Set up elementary JAMStack / Jekyll framework\n\njust create a\n```yaml\n# _config.yml\n\ntheme: minima # minima is one of Jekyll's default themes\n```\n\nif you want to be able to develop locally and have nice things that come out of the box with Ruby's Jekyll installer (i.e. default 404 page and some extra configs) do:\n\n```sh\ncd ../\njekyll new terry-d-4tw --force # you need force since you are in a non-empty directory\ncd terry-d-4tw\n# ensure to add `webrick` gem to your gemfile, otherwise you will get an error when running `bundle exec jekyll serve`\nbundle add webrick\n```\n\nnow we can run it locally via\n\n```sh\nbundle exec jekyll serve -P 4001\n```\n\n## experiment with Jekyll themes\n\nOut of the box GitHub supports [these themes](https://pages.github.com/themes/) - they are pretty basic, and in my view minima looks the best, but yet there is a lot to be desired.\n\nAlternative is to use [Minimal Mistakes theme](https://github.com/mmistakes/minimal-mistakes), which is more involved, but hey, that's what we want, right?\n\nCool plugings/snippets/scripts:\n{% raw %}\n```sh\n{% include_relative README.md %} # include a file from the same repo\n\n# add table of conents\n* toc\n{:toc}\n```\n{% endraw %}\n\n## Discovered alternative to Jekyll - Bridgetown (a fork of Jekyll with cool Ruby featureso)\n\nrefer [this](https://www.bridgetownrb.com) or some BridgeTown default README at the bottom\n\nGitHub Pages will need some regigging to support Bridgetown, but it is doable, see [this](https://www.bridgetownrb.com/docs/github-pages)\nor\n\u003chttps://andrewm.codes/deploy-bridgetown-to-github-pages/\u003e\nalso!\n\nremove original deploy from `main` if you used GitHub Jekylls deploy. I went to setting unpublish website, changed `deploy from branch` to `GH Action` and re-run BridgeTown build/deploy action\n# Judging Criteria\n\n## Technology\n   How technically impressive was the hack? Was the technical problem the team tackled difficult? Did it use a particularly clever technique or did it use many different components? Did the technology involved make you go \"Wow\"?\n## Design\n   Did the team put thought into the user experience? How well designed is the interface?\n## Learning\n   Did the team stretch themselves? Did they try to learn something new? What kind of projects have they worked on before?\n## Adherence to Theme\n   Does the hack adhere to the event's theme? Does it implement that theme fully or just partially?\n## Originality\n   Has this project been done before at hackathons in the past? How creative is their project in solving the problem at hand?\n## Completion\n   Does the hack work? Did the team achieve everything they wanted?\n\n---\n\n# Bridgetown Website README\n\nWelcome to your new Bridgetown website! You can update this README file to provide additional context and setup information for yourself or other contributors.\n\n## Table of Contents\n\n- [Prerequisites](#prerequisites)\n- [Install](#install)\n- [Development](#development)\n- [Commands](#commands)\n- [Deployment](#deployment)\n- [Contributing](#contributing)\n\n## Prerequisites\n\n- [GCC](https://gcc.gnu.org/install/)\n- [Make](https://www.gnu.org/software/make/)\n- [Ruby](https://www.ruby-lang.org/en/downloads/)\n  - `\u003e= 2.7`\n- [Bridgetown Gem](https://rubygems.org/gems/bridgetown)\n  - `gem install bridgetown -N`\n- [Node](https://nodejs.org)\n  - `\u003e= 12`\n- [Yarn](https://yarnpkg.com)\n\n## Install\n\n```sh\ncd bridgetown-site-folder\nbundle install \u0026\u0026 yarn install\n```\n\n\u003e Learn more: [Bridgetown Getting Started Documentation](https://www.bridgetownrb.com/docs/).\n\n## Development\n\nTo start your site in development mode, run `bin/bridgetown start` and navigate to [localhost:4000](https://localhost:4000/)!\n\nUse a [theme](https://github.com/topics/bridgetown-theme) or add some [plugins](https://www.bridgetownrb.com/plugins/) to get started quickly.\n\n### Commands\n\n```sh\n# running locally\nbin/bridgetown start\n\n# build \u0026 deploy to production\nbin/bridgetown deploy\n\n# load the site up within a Ruby console (IRB)\nbin/bridgetown console\n```\n\n\u003e Learn more: [Bridgetown CLI Documentation](https://www.bridgetownrb.com/docs/command-line-usage)\n\n## Deployment\n\nYou can deploy Bridgetown sites on hosts like Render or Vercel as well as traditional web servers by simply building and copying the output folder to your HTML root.\n\n\u003e Read the [Bridgetown Deployment Documentation](https://www.bridgetownrb.com/docs/deployment) for more information.\n\n## Contributing\n\nIf repo is on GitHub:\n\n1. Fork it\n2. Clone the fork using `git clone` to your local development machine.\n3. Create your feature branch (`git checkout -b my-new-feature`)\n4. Commit your changes (`git commit -am 'Add some feature'`)\n5. Push to the branch (`git push origin my-new-feature`)\n6. Create a new Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterry-d-4tw%2Fterry-d-4tw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fterry-d-4tw%2Fterry-d-4tw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterry-d-4tw%2Fterry-d-4tw/lists"}