{"id":19379854,"url":"https://github.com/interdiscipline/yassss","last_synced_at":"2025-10-11T21:15:38.617Z","repository":{"id":42165614,"uuid":"225938305","full_name":"interdiscipline/yassss","owner":"interdiscipline","description":"Yet another simple static site starter (for Jekyll)","archived":false,"fork":false,"pushed_at":"2024-05-12T14:13:50.000Z","size":1073,"stargazers_count":13,"open_issues_count":4,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-05-12T15:26:40.360Z","etag":null,"topics":["boilerplate","jekyll","jekyll-template","static-site-generator"],"latest_commit_sha":null,"homepage":null,"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/interdiscipline.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":"2019-12-04T19:08:41.000Z","updated_at":"2024-05-12T15:26:43.060Z","dependencies_parsed_at":"2023-11-27T17:52:49.142Z","dependency_job_id":"6ba7c620-0e53-45d8-b228-33fccb952059","html_url":"https://github.com/interdiscipline/yassss","commit_stats":null,"previous_names":[],"tags_count":7,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interdiscipline%2Fyassss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interdiscipline%2Fyassss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interdiscipline%2Fyassss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interdiscipline%2Fyassss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/interdiscipline","download_url":"https://codeload.github.com/interdiscipline/yassss/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223932087,"owners_count":17227277,"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":["boilerplate","jekyll","jekyll-template","static-site-generator"],"created_at":"2024-11-10T09:11:38.558Z","updated_at":"2025-10-11T21:15:33.570Z","avatar_url":"https://github.com/interdiscipline.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Yassss - Yet another simple static site starter\n## Built by [Interdiscipline](https://interdiscipline.com) ([Grant Blakeman](https://github.com/gblakeman))\n\n### Basics\n\n**Yassss** is a [Jekyll](https://jekyllrb.com/) app that builds CDN-ready static content with proper asset cache-busting. It assumes deployment to Amazon S3 via CircleCI. In addition to the base Jekyll install, it adds support for a `content` section/tag that is parsed with [Markdown](https://daringfireball.net/projects/markdown/). It has some opinionated structure to the javascript, sass/css, and the accompanying linting, but that can be easily changed/removed.\n\nThe goal of Yassss is simple and unambitious: _provide a quick, easy way to spin up a new, production-ready static site, using Jekyll, without much tinkering_. It has opinions and maybe you agree with them and will also find it useful.\n\n[View the demo build.](https://yassss.interdiscipline.com)\n\n### Local Setup\n\nUse this repo as a template—no need to clone it or fork it unless you’re planning to contribute.\n\nBe sure to copy `_config.example.yml` and name it `_config.yml`. If you are planning on deploying with CircleCI, leave the `.example` version in place and set your environment variables. Yasss uses specific versions of Ruby and Node. If you’re new to managing multiple ruby/node versions, you may want to check the [Detailed Install](https://github.com/interdiscipline/yassss/blob/main/DETAILED_INSTALL.md) instructions.\n\nInstall everything with:\n\n`yarn install`\n\nThe `bundle install` command will be run first. You can always run it separately as well.\n\n### Deployment\n\nConnect your repo to a [CircleCI](https://circleci.com) account.\n\nMake sure the following environment variables are set:\n\n* `AWS_ACCESS_KEY_ID`\n* `AWS_SECRET_ACCESS_KEY`\n\nTweak the `.circleci/config.yml` file to observe the branch(es) you wish to deploy on. By default it deploys to Production when commits are made to `production` and to Staging when commits are made to either `staging` or `main`.\n\nAll builds run [HTML Proofer](https://github.com/gjtorikian/html-proofer) in addition to js/sass linting. **You may need to disable it** (comment it out in `.circleci/config.yml`) on your _first deploy(s)_ until the site is up and running publicly because it will check internal links on your site in addition to links to external sites.\n\nIf you are new to static hosting on [AWS](http://aws.amazon.com), Dustin Curtis has a [great guide](https://dcurt.is/how-to-host-a-static-website-on-aws-with-https) that should get you pretty far.\n\n### Content\n\nAny Markdown files added to the `_content` directory can be called via the `content` tag and will be parsed through the Markdown parser.\n\n```\n{% content about.md %}\n```\n\n### Assets\n\nYassss uses the [`jekyll-assets`](https://github.com/envygeeks/jekyll-assets) plugin to manage assets. Place all assets within the `_assets` directory and use the `asset` tag to call them.\n\n```liquid\n{% asset yassss.scss %}\n{% asset yassss.js %}\n```\n\n```css\nbody {\n  background-image: asset_url(\"test.png\");\n}\n```\n\n```markdown\nIn a markdown file:\n\n![Cliff]({% asset cliff.jpg @path %})\n```\n\n[More info…](https://github.com/envygeeks/jekyll-assets)\n\n#### Bourbon \u0026 Normalize\n\nThe default Sass setup takes advantage of [Bourbon](https://www.bourbon.io) and [Normalize](https://github.com/necolas/normalize.css). If you do not wish to use them, remove their references in the core `yassss.scss` file and remove their files from the `_assets/css/vendor` directory.\n\n### Other Jekyll Plugins\n\nBoth [`jekyll-sitemap`](https://github.com/jekyll/jekyll-sitemap) and [`jekyll-feed`](https://github.com/jekyll/jekyll-feed) are included in the basic config and enabled by default. Either or both can be easily disabled/removed based on your needs.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finterdiscipline%2Fyassss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finterdiscipline%2Fyassss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finterdiscipline%2Fyassss/lists"}