{"id":19215597,"url":"https://github.com/alwaysblank/banner","last_synced_at":"2025-10-29T05:10:26.141Z","repository":{"id":94010010,"uuid":"169757699","full_name":"alwaysblank/banner","owner":"alwaysblank","description":"Jekyll boilerplate. Not finished. ","archived":false,"fork":false,"pushed_at":"2019-02-09T05:53:59.000Z","size":453,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-04T18:28:50.196Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/alwaysblank.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-02-08T15:42:13.000Z","updated_at":"2019-03-26T16:50:11.000Z","dependencies_parsed_at":"2023-03-13T17:08:25.591Z","dependency_job_id":null,"html_url":"https://github.com/alwaysblank/banner","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/alwaysblank%2Fbanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alwaysblank%2Fbanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alwaysblank%2Fbanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alwaysblank%2Fbanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alwaysblank","download_url":"https://codeload.github.com/alwaysblank/banner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240290705,"owners_count":19778114,"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-09T14:14:09.821Z","updated_at":"2025-10-29T05:10:21.102Z","avatar_url":"https://github.com/alwaysblank.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 👨🏻‍🔬 Banner\nJekyll boilerplate powered by gamma radiation.\n\n## Featured\n\n- CSS\n  - [PostCSS](https://postcss.org/) - Manipulate CSS quickly and with understanding.\n  - [SCSS/SASS](https://sass-lang.com/) - Write simpler CSS.\n  - [TailwindCSS](https://tailwindcss.com) - Fast and easy design and prototyping.\n- JavaScript\n  - [Babel](https://babeljs.io/) - Write ES6 without worrying about compatibility.\n- Optimization \n  - [Webpack](https://webpack.js.org/) - Collect, process, and build all your assets.\n  - [PurgeCSS](https://www.purgecss.com/) - Remove unused CSS for the smallest build possible.\n  - [Clean CSS](https://github.com/jakubpawlowicz/clean-css) - Minifies and simplifies your CSS.\n  - [Terser](https://github.com/terser-js/terser) - Minifies and optimizes your final JS.\n- Development\n  - BrowserSync - **Coming Soon**\n\n## Setup\n\n### Requirements\n- Node 10.14.2\n- Yarn 1.13.0\n- Ruby 2.4.3\n  - Bundler 1.17.3\n\nThe versions listed above are the *specific* versions that Netlify uses to build the \nsite remotely. It is *strongly* recommended that you use these versions when developing \nlocally, or you may have to debug build errors on Netlify, which is a bad time.\n\n### Installing\n\nSet up Jekyll:\n```bash\nbundle install\n```\n\nSet up asset processing:\n```bash\nyarn\n```\n\n### Running\n\nBuild assets for development:\n```bash\nyarn build\n```\n\nBuild assets for production:\n```bash\nyarn build:production\n```\n\nBuild site for deployment:\n```bash\nyarn deploy\n```\n\n**COMING SOON**\n\nBuild and watch site and assets for development:\n```bash\nyarn develop\n```\n\n## Known Issues\n\n### Bundler 2\n\nNetlify's build image does not currently support Bundler 2, and if you create a\n`Gemfile.lock` with Bundler 2 you'll get an error on deploy that looks like\nthis: \n\n\u003e You must use Bundler 2 or greater with this lockfile.\n\nThis is a [known issue](https://github.com/netlify/build-image/issues/250) and will\nhopefully eventually be addressed, but for now the workaround is to use an older version\nof Bundler. 1.17.3 is the latest pre-2.0 version. You can install it with the following\ncommand:\n\n```bash\ngem install bundler --version '1.17.3'\n```\n\n### Yarn\n\nOlder versions of yarn will throw an error that says something like this:\n\n\u003e [DEP0005] DeprecationWarning: Buffer() is deprecated due to security and usability issues.\n\nSomething's deprecated! The solution is to use a version of yarn newer than 1.10.0.\n\n### PhpStorm Syntax Highlighting\n\nBy default, PhpStorm doesn't offer any syntax highlighting for Liquid templates (and in fact\nif they are `.html` files it will complain about bad formatting) out of the box. Fortunately,\nit has support for Twig templates, which appear to be identical.\n\nTo enable Liquid syntax highlighting for templates, you'll need to do the following:\n\n1. Rename any templates with a `.html` extension to `.liquid`.\n2. Go to *Settings \u003e Editor \u003e File Types*, find the \"Twig\" file type, and add `*.liquid`\nto the list of file types it uses. Keep in mind that this also means you would need to\nrename and `include` or similar tags: \n`{%- include head.html -%}` =\u003e `{%- include head.liquid -%}` \n\n**Note:** This only applies to using Liquid tags in HTML templates; I don't believe\nthis package would support the use of Liquid tags in CSS or JS files.\n\n### Build Fails on Node or Ruby Version Constraint\n\nYou may run into an issue where you'll see a message like this in the Netlify log after a\nbuild fails:\n\n\u003e 9:20:26 PM: Attempting node version '10.14.2\n\u003e ' from .nvmrc\n\u003e 9:20:26 PM: Version '10.14.2\n\u003e ' not found - try `nvm ls-remote` to browse available versions.\n\u003e 9:20:26 PM: Failed to install node version '10.14.2\n\u003e '\n\nThose forced newlines sure look weird, don't they? That's because there's a newline in the\n`.nvmrc` file that Netlify uses to determine what version of Node to use. (A similar\nproblem can also crop up with `.ruby-version`.)\n\nOftentimes these newlines are automatically added by your editor, so make sure it hasn't\nbeen configured to do so. In PhpStorm, this setting can be found by going to \n*File | Settings | Editor | General --\u003e Other ---\u003e Ensure line feed at file end on Save*.\n[Source](https://intellij-support.jetbrains.com/hc/en-us/community/posts/207071445-On-save-new-line-added-to-end-of-file-How-stop-this-)\n\n## Notes\n\n### Cache-busting and Hashes\n\nA common technique for invalidating cached versions of assets when they change is to add\na hash to the filename during the build process. This then requires some kind of system\nthat operates at runtime to determine what the correct hashed filename is. Fortunately,\nwith Netlify such a system is not necessary: Netlify has [Instant Cache Invalidation](https://www.netlify.com/blog/2015/09/11/instant-cache-invalidation/)\nthat using its own fingerprinting of assets to determine when they've changed an\ninstantly invalidate those items cached across its CDN.\n\n## Thanks and Acknowledgements\n\nThe webpack configuration for this project borrows heavily from the excellent work\ndone on [Sage](https://github.com/roots/sage) by the [Roots team](https://roots.io).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falwaysblank%2Fbanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falwaysblank%2Fbanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falwaysblank%2Fbanner/lists"}