{"id":13665439,"url":"https://github.com/svmiller/course-website","last_synced_at":"2026-03-06T15:32:22.318Z","repository":{"id":70532734,"uuid":"144402858","full_name":"svmiller/course-website","owner":"svmiller","description":"This is a Jekyll template, patterned off my main Jekyll template, for organizing a course website and hosting it on Github.","archived":false,"fork":false,"pushed_at":"2019-08-19T23:06:48.000Z","size":2741,"stargazers_count":43,"open_issues_count":1,"forks_count":52,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-08T21:36:01.790Z","etag":null,"topics":["academic-website","classroom","jekyll-site","jekyll-theme"],"latest_commit_sha":null,"homepage":"http://course-website.svmiller.com/","language":"CSS","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/svmiller.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}},"created_at":"2018-08-11T16:54:05.000Z","updated_at":"2025-02-26T08:49:40.000Z","dependencies_parsed_at":"2023-04-29T18:01:20.754Z","dependency_job_id":null,"html_url":"https://github.com/svmiller/course-website","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/svmiller/course-website","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/svmiller%2Fcourse-website","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/svmiller%2Fcourse-website/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/svmiller%2Fcourse-website/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/svmiller%2Fcourse-website/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/svmiller","download_url":"https://codeload.github.com/svmiller/course-website/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/svmiller%2Fcourse-website/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30183472,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T14:42:24.748Z","status":"ssl_error","status_checked_at":"2026-03-06T14:42:14.925Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["academic-website","classroom","jekyll-site","jekyll-theme"],"created_at":"2024-08-02T06:00:38.594Z","updated_at":"2026-03-06T15:32:22.281Z","avatar_url":"https://github.com/svmiller.png","language":"CSS","funding_links":[],"categories":["CSS"],"sub_categories":[],"readme":"Steve's No-Good-Very-Bad Course Website Jekyll Template\n=======================================================\n\nThis repository contains a Jekyll template, patterned entirely off my no-good-very-bad Jekyll Template at [svmiller.com](http://svmiller.com), for organizing a course website. I should note that because I ganked it from my website template, there's a lot of empty tags in the template that make reference to things that don't appear in the main `.yml` file. In other words, they reference things that should be there but, because they're not there, ultimately won't interfere with how the site renders.\n\n\n## Installation\n\nThis assumes that you have a working installation of Jekyll. If you don't, first visit [Jekyll's documentation](https://jekyllrb.com/docs/installation/) to learn how to. \n\n1. [Fork this repo](https://github.com/svmiller/course-website) and clone it locally.\n\n```bash\ncd ~/Sites/\n\ngit clone https://github.com/YOUR_USER_NAME/course-website.git\n\n```\n\n2. Create a new empty theme with Jekyll\n\n```bash\ncd ~/Sites/\n\njekyll new-theme ipa\n\n             create ~/Sites/ipa/assets\n             create ~/Sites/ipa/_layouts\n             create ~/Sites/ipa/_includes\n             create ~/Sites/ipa/_sass\n             create ~/Sites/ipa/_layouts/page.html\n             create ~/Sites/ipa/_layouts/post.html\n             create ~/Sites/ipa/_layouts/default.html\n             create ~/Sites/ipa/Gemfile\n             create ~/Sites/ipa/ipa.gemspec\n             create ~/Sites/ipa/README.md\n             create ~/Sites/ipa/LICENSE.txt\n         initialize ~/Sites/ipa/.git\n             create ~/Sites/ipa/.gitignore\nYour new Jekyll theme, ipa, is ready for you in ~/Sites/ipa! \nFor help getting started, read ~/Sites/ipa/README.md. \n\n\n```\n\n3. Open the ``ipa.gemspec`` file and edit it as follows:\n\n```bash\n  spec.summary\t=\t\"WRITE A SHORT SUMMARY OF YOUR THEME\"\n  spec.homepage\t=\t\"http://address.com\"\n\n### Update the following two version numbers as per what's on your system.\n  spec.add_development_dependency \"bundler\", \"~\u003e 2.0.1\"\n  spec.add_development_dependency \"rake\", \"~\u003e 12.3.2\"\n\n``` \n\n4. Run ``bundle install`` inside ``~/Sites/ipa/``.  This should run successfully and install all the necessary gems.  It will also create a ``Gemfile`` and a ``Gemfile.lock`` inside your project.\n\n5. Now we are ready to migrate necessary theme files from ``~/Sites/course-website/`` to ``~/Sites/ipa/``.  Copy the following files and folders.  If a folder already exists (e.g. ``_includes``), just copy files inside. If a file already exists, overwrite it.\n\n```bash\n_config.yml\n_css/\n_data/\n_images/\n_includes/\n_layouts/\n_posts/\n_sass/\n_site/\nassets/\nblog.md\nCNAME\ncourse-materials.md\nfeed.xml\nindex.html\nlectures.md\nLICENSE.txt\nREADME.md\nsitemap.xml\nsyllabus/\nuntitled-lecture/\n\n```\n\n6. Edit ``_config.yml`` to customize site details.  Then fire up ``jekyll serve``.  You may need to do ``bundle exec jekyll serve`` instead, if you have a separate Ruby installation for Jekyll's purposes.  The site template should be only at ``http://localhost:4000`` now. \n\n7. Follow the remaining directions below to fully customize your site.\n\nHere are the things you should tweak to make it your own:\n\n- `_config.yml`. Naturally. This should be familiar if you're accustomed to Jekyll. Do note, for convenience, that I made the `syllabus` field a full URL entry. You should also fill out the `githubdir` field since the goal is to make your course (and, by extension, the knowledge you propose to communicate) open source and reproducible on Github. Let us know where it is.\n- `course-materials.md`: Fudge this to add in helpful information about your course (e.g. the book and whatever else you want to communicate).\n- `index.html`: You won't need to edit much but, if you want your own lead image for your course website that's *not* from *Stand and Deliver* (I don't know why you would do this, but, hey, it's your class...), edit that Jekyll liquid tag I created that embeds images in my spiffy way. This should be intuitive. Just specify a relative path for the image you want to use, how wide you want it to be, and whatever caption you want to add to it.\n- `_data/lectures.yml`: This uses YAML data to render Github and local links to lectures. This should be straightforward (see my example file) but [feel free to look at this tutorial](https://jekyllrb.com/docs/datafiles/) if you want to better understand what's happening here. You could also edit `lectures.md` if, for example, you render your lectures to HTML in lieu of PDF. I do PDF. Changing this isn't hard, though, and should be straightforward. Basically, change \".pdf\" to \".html\" as you see it and then, probably, find a nice icon for HTML on [Font Awesome](https://fontawesome.com/).\n- `_includes/nav.html`: You won't have to tweak this, per se, but you may want to if, for example, you want to add a course blog. I don't do that, but I do prove a `blog.md` file. Head to [Font Awesome](https://fontawesome.com/) if you're looking for the perfect icon to go with it.\n- `CNAME`: Adding a special domain or subdomain to your course website? Change it here. Is its own Github page on a special account you created on Github (but you're *not* using a special domain on top of that [[example](https://github.com/uw-csss-564)])? Delete it.\n\nYou can see a snapshot of what it looks like below. You can also try it out here: [http://course-website.svmiller.com/](http://course-website.svmiller.com/)\n\n![Snapshot](_images/snapshot.png)\n\nFeel free to contact me at svmille@clemson.edu. Send along some cheers too if you find it useful.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsvmiller%2Fcourse-website","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsvmiller%2Fcourse-website","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsvmiller%2Fcourse-website/lists"}