{"id":16551224,"url":"https://github.com/michaelcurrin/html-to-jekyll-sample","last_synced_at":"2025-08-16T16:34:21.115Z","repository":{"id":93178584,"uuid":"368114221","full_name":"MichaelCurrin/html-to-jekyll-sample","owner":"MichaelCurrin","description":"A demo to showcase converting a plain HTML site to a Jekyll site 🌏 🧪","archived":false,"fork":false,"pushed_at":"2021-06-08T21:03:23.000Z","size":100,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-04T15:47:30.159Z","etag":null,"topics":["gh-pages-site","jekyll","template","tutorial"],"latest_commit_sha":null,"homepage":"https://michaelcurrin.github.io/html-to-jekyll-sample/","language":"HTML","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/MichaelCurrin.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":"2021-05-17T08:39:12.000Z","updated_at":"2021-09-06T09:11:21.000Z","dependencies_parsed_at":"2023-04-11T11:01:12.556Z","dependency_job_id":null,"html_url":"https://github.com/MichaelCurrin/html-to-jekyll-sample","commit_stats":null,"previous_names":[],"tags_count":1,"template":true,"template_full_name":null,"purl":"pkg:github/MichaelCurrin/html-to-jekyll-sample","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelCurrin%2Fhtml-to-jekyll-sample","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelCurrin%2Fhtml-to-jekyll-sample/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelCurrin%2Fhtml-to-jekyll-sample/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelCurrin%2Fhtml-to-jekyll-sample/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MichaelCurrin","download_url":"https://codeload.github.com/MichaelCurrin/html-to-jekyll-sample/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelCurrin%2Fhtml-to-jekyll-sample/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261558931,"owners_count":23177111,"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":["gh-pages-site","jekyll","template","tutorial"],"created_at":"2024-10-11T19:36:40.974Z","updated_at":"2025-06-23T21:33:06.298Z","avatar_url":"https://github.com/MichaelCurrin.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HTML to Jekyll Sample 🌏 🧪\n\u003e A demo to showcase converting a plain HTML site to a Jekyll site\n\n[![GitHub tag](https://img.shields.io/github/tag/MichaelCurrin/html-to-jekyll-sample?include_prereleases=\u0026sort=semver)](https://github.com/MichaelCurrin/html-to-jekyll-sample/releases/)\n[![License](https://img.shields.io/badge/License-MIT-blue)](#license)\n\n[![Made with Ruby](https://img.shields.io/badge/Ruby-\u003e=2.6-blue?logo=ruby\u0026logoColor=white)](https://ruby-lang.org)\n[![Made with Jekyll](https://img.shields.io/badge/Jekyll-3.9-blue?logo=jekyll\u0026logoColor=white)](https://jekyllrb.com)\n\n[![Hosted with GH Pages](https://img.shields.io/badge/Hosted_with-GitHub_Pages-blue?logo=github\u0026logoColor=white)](https://pages.github.com/)\n\n\n## Preview\n\n_Note this site is not finished yet - the navbar is not set up right, but the styling and page structure is setup_.\n\n\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://michaelcurrin.github.io/html-to-jekyll-sample/\"\u003e\n        \u003cimg src=\"/sample.png\" alt=\"Sample screenshot\" title=\"Sample screenshot\" width=\"400\" /\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n\n## Use this project\n\n\u003cdiv align=\"center\"\u003e\n\n[![Use this template](https://img.shields.io/badge/Generate-Use_this_template-2ea44f?style=for-the-badge)](https://github.com/MichaelCurrin/html-to-jekyll-sample/generate)\n\n[![View site - GH Pages](https://img.shields.io/badge/View_site-GH_Pages-blue?style=for-the-badge)](https://michaelcurrin.github.io/html-to-jekyll-sample/)\n\n\u003c/div\u003e\n\n\n## Tutorial\n\nThis explains how I create this project as a new Jekyll site, starting from an HTML site.\n\nFor intetest, see also the [HTML to Jekyll](https://jekyllrb.com/tutorials/convert-site-to-jekyll/) tutorial in the Jekyll docs.\n\n### YouTube video\n\nMy intention was to take an existing site with content and styling and build a Jekyll site out of it.\n\nI hosted a live session on YouTube to do just that. It is available as a recording.\n\n- [Jekyll live coding](https://www.youtube.com/watch?v=6v5vEBUmkGs)\n\nThis repo was created from scratch in that session. I encourage you to watch that video and compare it with this repo.\n\n### Choose an HTML base\n\nI found this article of 99 free HTML templates.\n\n- [99 Free HTML Templates You Can Download Right Now](https://html.com/resources/free-html-templates/)\n\nThe first option on that list is this CodePen, which I liked.\n\n- [Asperion HTML5 template](https://codepen.io/alexdevero/pen/GCirD) by [Alex Devero](http://alexdevero.com) / [@alexdevero](https://github.com/alexdevero).\n\nSo I used that for the tutorial.\n\nIt has \"template\" in the name, so I feel comfortable that the creator indended the code to be reused by others.\n\n### Uploaded repo\n\nI cleaned up the code after the live session and uploaded it as this repo. This is a demo or sample which supplements the tutorial video.\n\nI also copied the rendered content to [sample.html](/sample.html) as well to make it easier to compare the Jekyll site against it and in case the pen disappears.\n\n\n## Related projects\n\nA example of a Jekyll site also with no theme, based on a tutorial in the Jekyll docs (linked so you can follow the steps too):\n\n- [Jekyll Themeless Quickstart](https://github.com/MichaelCurrin/themeless-jekyll-quickstart)\n\nIf you are interested in a Jekyll site with a theme, see:\n\n- [Jekyll Blog Demo](https://github.com/jekyll-blog-demo)\n    - A typical Jekyll site that has minimal basic functionality and a theme and is served on on GH Pages\n- [Jekyll Themed Site Quickstart](https://github.com/MichaelCurrin/jekyll-themed-site-quickstart)\n    - A site with few files that demonstrates using a theme on a GH Pages site.\n\nIf want to build your own theme and then install it in another project of yours, or let the Jekyll community use your theme, see:\n\n- [Jekyll Theme Quickstart](https://github.com/MichaelCurrin/jekyll-theme-quickstart)\n\n\n## Installation\n\nClone the repo.\n\nInstall Ruby and Bundler globally.\n\nInstall project gems.\n\n```sh\n$ make install\n```\n\n\n## Usage\n\nStart dev server.\n\n```sh\n$ make serve\n```\n\nDo a production build and output as `_site` directory.\n\n```sh\n$ make build\n```\n\n\n## Deploy\n\n1. Get a copy of this repo on GitHub.\n2. Go to _Setting_ for your repo, _Pages_ and then enable GitHub Pages on the main branch on the root path.\n3. Wait for your site to build.\n4. Check the _Environment_ tab and find the URL for your site.\n\n\n## License\n\nReleased under [MIT](/LICENSE) by [@MichaelCurrin](https://github.com/MichaelCurrin).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelcurrin%2Fhtml-to-jekyll-sample","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichaelcurrin%2Fhtml-to-jekyll-sample","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelcurrin%2Fhtml-to-jekyll-sample/lists"}