{"id":13536616,"url":"https://github.com/johno/pixyll","last_synced_at":"2025-04-12T22:17:38.080Z","repository":{"id":12962709,"uuid":"15641094","full_name":"johno/pixyll","owner":"johno","description":"A simple, beautiful Jekyll theme that's mobile first","archived":false,"fork":false,"pushed_at":"2024-01-05T01:57:38.000Z","size":1252,"stargazers_count":2050,"open_issues_count":38,"forks_count":1344,"subscribers_count":44,"default_branch":"master","last_synced_at":"2025-04-12T22:17:33.475Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://pixyll.com","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"barryclark/jekyll-now","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/johno.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2014-01-04T22:52:55.000Z","updated_at":"2025-04-09T17:08:32.000Z","dependencies_parsed_at":"2024-06-19T02:46:03.346Z","dependency_job_id":"de7959cc-93e8-4968-97bc-871c7225547b","html_url":"https://github.com/johno/pixyll","commit_stats":{"total_commits":399,"total_committers":76,"mean_commits":5.25,"dds":0.5112781954887218,"last_synced_commit":"8b5712d7ad70cc970479b953cf205e42d374d258"},"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johno%2Fpixyll","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johno%2Fpixyll/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johno%2Fpixyll/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johno%2Fpixyll/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/johno","download_url":"https://codeload.github.com/johno/pixyll/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248637786,"owners_count":21137538,"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-08-01T09:00:45.560Z","updated_at":"2025-04-12T22:17:38.057Z","avatar_url":"https://github.com/johno.png","language":"SCSS","funding_links":[],"categories":["SCSS","others","More Themes"],"sub_categories":["Intro / Disclaimer"],"readme":"# Pixyll\n\n[pixyll.com](https://www.pixyll.com/)\n\n![Pixyll screenshot](./screenshot.png)\n\nPixyll is a simple, beautiful theme for Jekyll that emphasizes content rather than aesthetic fluff. It's mobile _first_, fluidly responsive, and delightfully lightweight.\n\nIt's pretty minimal, but leverages large type and drastic contrast to make a statement, on all devices.\n\nThis Jekyll theme was crafted with \u003c3 by [John Otander](https://johno.com/)\n([@4lpine](https://twitter.com/4lpine)).\n\n中文版 \u003chttps://github.com/ee0703/pixyll-zh-cn\u003e.\n\n## Getting Started\n\nIf you're completely new to Jekyll, I recommend checking out the documentation at \u003chttps://jekyllrb.com/\u003e or there's a tutorial by [Smashing Magazine](https://www.smashingmagazine.com/2014/08/build-blog-jekyll-github-pages/).\n\n```\n$ git clone git@github.com:johno/pixyll.git\n$ cd pixyll\n$ gem install bundler # If you don't have bundler installed\n$ bundle install\n```\n\n#### Verify your Jekyll version\n\nIt's important to also check your version of Jekyll since this project uses new `baseurl` features that are [only supported in 3.3+](https://jekyllrb.com/news/2016/10/06/jekyll-3-3-is-here/).\n\n### Fork, then clone\n\nFork the repo, and then clone it so you've got the code locally.\n\n\n### Modify the `_config.yml`\n\nThe `_config.yml` located in the root of the Pixyll directory contains all of the configuration details\nfor the Jekyll site. The defaults are:\n\n```yml\n# Site settings\ntitle: Pixyll\nemail: your_email@example.com\nauthor: John Otander\ndescription: \"A simple, beautiful theme for Jekyll that emphasizes content rather than aesthetic fluff.\"\nbaseurl: \"\"\nurl: \"https://pixyll.com/\"\n\n# Build settings\nmarkdown: kramdown\npermalink: pretty\npaginate: 3\n```\n\n### Jekyll Serve\n\nThen, start the Jekyll Server. I always like to give the `--watch` option so it updates the generated HTML when I make changes.\n\n```\n$ jekyll serve --watch\n```\n\nNow you can navigate to `localhost:4000` in your browser to see the site.\n\n### Using Github Pages\n\nYou can host your Jekyll site for free with Github Pages. [Click here](https://pages.github.com/) for more information.\n\n#### A configuration tweak if you're using a gh-pages sub-folder\n\nIn addition to your github-username.github.io repo that maps to the root url, you can serve up sites by using a gh-pages branch for other repos so they're available at github-username.github.io/repo-name.\n\nThis will require you to modify the `_config.yml` like so:\n\n```yml\n# Site settings\ntitle: Repo Name\nemail: your_email@example.com\nauthor: John Otander\ndescription: \"Repo description\"\nbaseurl: \"/repo-name\"\nurl: \"https://github-username.github.io\"\n\n# Build settings\nmarkdown: kramdown\npermalink: pretty\npaginate: 3\n```\n\nThis will ensure that the the correct relative path is constructed for your assets and posts. Also, in order to run the project locally, you will need to specify the blank string for the baseurl: `$ jekyll serve --baseurl ''`.\n\n##### If you don't want the header to link back to the root url\n\nYou will also need to tweak the header include `/{{ site.baseurl }}`:\n\n```html\n\u003cheader class=\"site-header px2 px-responsive\"\u003e\n  \u003cdiv class=\"mt2 wrap\"\u003e\n    \u003cdiv class=\"measure\"\u003e\n      \u003ca href=\"{{ \"/\" | relative_url }}\" class=\"site-title\"\u003e{{ site.title }}\u003c/a\u003e\n      \u003cnav class=\"site-nav\"\u003e\n        {% include navigation.html %}\n      \u003c/nav\u003e\n    \u003c/div\u003e\n  \u003c/div\u003e\n\u003c/header\u003e\n```\n\nA relevant Jekyll Github Issue: \u003chttps://github.com/jekyll/jekyll/issues/332\u003e\n\n### Contact Form\n\nThe contact form uses \u003chttps://formspree.io/\u003e. It will require you to fill the form out and submit it once, before going live, to confirm your email.\n\nMore setup instructions and advanced options can be found at [https://formspree.io](https://formspree.io/)\n\n\n### Disqus\n\nTo configure Disqus, set up a [Disqus site](https://disqus.com/admin/create/) with the same name as your site. Then, in `_config.yml`, edit the `disqus_shortname` value to enable Disqus.\n\n### Customizing the CSS\n\nAll variables can be found in the `_sass/_variables.scss` file, toggle these as you'd like to change the look and feel of Pixyll.\n\n### Page Animation\n\nIf you would like to add a [fade-in-down effect](https://animate.style/), you can add `animated: true` to your `_config.yml`.\n\n### AnchorJS\n\n[AnchorJS](https://github.com/bryanbraun/anchorjs): _A JavaScript utility for adding deep anchor links to existing page content. AnchorJS is lightweight, accessible, and has no dependencies._ You can turn it on by toggling `enable_anchorjs`. Because it offers many ways for customization, tweaks should be done in `_includes/footer.html`. Default settings after turning AnchorJS on are:\n\n```html\n\u003cscript\u003e\n    anchors.options.visible = 'always';\n    anchors.add('article h2, article h3, article h4, article h5, article h6');\n\u003c/script\u003e\n```\n\nSee [documentation](https://www.bryanbraun.com/anchorjs/#basic-usage) for more options.\n\n### Put in a Pixyll Plug\n\nIf you want to give credit to the Pixyll theme with a link to \u003chttps://pixyll.com/\u003e or my personal website \u003chttps://johno.com/\u003e somewhere, that'd be awesome. No worries if you don't.\n\n### Web analytics and search engines\n\nYou can measure visits to your website either by using [Google Analytics](https://www.google.com/analytics/) tracking embed or the more advanced [Google Tag Manager](https://www.google.com/analytics/tag-manager/) container.\n* For Google Analytics set up the value for `google_analytics`, it should be something like `google_analytics: UA-XXXXXXXX-X` or `google_analytics: G-XXXXXXX` depending on whether you are using universal analytics or not.\n* For Google Tag Manager set up the value for `google_tag_manager`, it should be something like: `google_tag_manager: GTM-XXXXX`.\n* _Do not_ set both of above methods because this will cause conflicts and skew your reporting data.\n* Remember that you need to properly configure the GTM container in its admin panel if you want it to work. More info is available in [GTM's docs](https://www.google.com/analytics/tag-manager/resources/).\n\nYour website is, by default, set to be allowed for crawling and indexing by search engines. (Unless you made yourself a custom robots.txt file). You can use front matter settings on each page to control how search engines will it. Sometimes you may want to exclude a particular page from indexing or forbid Google to store a copy of your page in its cache. It is up to you. Use the `meta_robots` frontmatter key and assign values based on [this table](https://developers.google.com/webmasters/control-crawl-index/docs/robots_meta_tag?hl=en#valid-indexing--serving-directives). Some examples:\n\n```yaml\n# exclude page from index\nmeta_robots: noindex\n\n# allow indexing, disallow caching\nmeta_robots: noarchive\n\n# allow indexing, disallow crawling links\nmeta_robots: nofollow\n\n# disallow indexing, follow links\nmeta_robots: noindex,follow\n```\n\nIn order to get more information about your website's status in search engines, you can register it in [Google Search Console](https://search.google.com/search-console/about) and/or [Bing Webmaster Tools](https://www.bing.com/webmasters/about). Both these tools will ask you to authorize your website with them and there are couple of ways to do that. Pixyll supports verification via meta tags - just fill in values for `google_verification` and/or `bing_verification` in `_config.yml`, the verification strings and meta tags will then be added automatically.\n\nIf search engine optimization is your thing, you can also set up `meta_description` values for each page/post. By default Pixyll uses `summary` to populate the `\u003cmeta name=\"description\" content=\"...\"\u003e` tag and falls back to `description` from `_config.yml` if `summary` is not present in page/post's front matter. The `summary` is also used for generating Open Graph tags. Why would you want to use a dedicated variable for meta description? Because character limit to properly display this description in search results (as a snippet) is way smaller than in Open Graph. It is recommended to keep it at 155-160 characters, for more in-depth info read [this article](https://moz.com/blog/i-cant-drive-155-meta-descriptions-in-2015).\n\nAnd lastly - if you happen to write in language other than English be sure to change `og_locale` in `_config.yml` to reflect it.\n\n### Progressive Web App\n\nPixyll supports features of a progressive web app (PWA).  As a PWA, your site's home page can be installed as a shortcut or an app icon on a mobile device.  Also, certain assets are cached so the site can be accessed should the device be offline from the network.\n\nPixyll supports these features because it provides a Javascript file that acts as a *service worker* in the browser and has a JSON file with a *web manifest*.  By default, these are configured to the settings of Pixyll, but you should consider cutomizing them to your specific site:\n\n1. Provide a different version of `splash-512x512.png` which is the loading screen for your offline app.\n2. A `favicon-192x192.png` for the app icon (if you haven't already).\n3. In `sw.js`, list any other files or pages you want to add to the list of cached artifacts.\n\nFor more information on PWAs:\n\n- https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps\n- https://web.dev/what-are-pwas/\n\n### Enjoy\n\nI hope you enjoy using Pixyll. If you encounter any issues, please feel free to let me know by creating an [issue](https://github.com/johno/pixyll/issues). I'd love to help.\n\n## Upgrading Pixyll\n\nPixyll is always being improved by its users, so sometimes one may need to upgrade.\n\n#### Ensure there's an upstream remote\n\nIf `git remote -v` doesn't have an upstream listed, you can do the following to add it:\n\n```\ngit remote add upstream https://github.com/johno/pixyll.git\n```\n\n#### Pull in the latest changes\n\n```\ngit pull upstream master\n```\n\nThere may be merge conflicts, so be sure to fix the files that git lists if they occur. That's it!\n\n## Thanks to the following\n\n* [BASSCSS](https://basscss.com/)\n* [Jekyll](https://jekyllrb.com/)\n* [Refills](https://refills.bourbon.io/)\n* [Solarized](https://ethanschoonover.com/solarized/)\n* [Animate.css](https://animate.style/)\n\n## Contributing\n\n1. Fork it\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create new Pull Request\n\n## Forking\n\nThere is a [guide to forking Pixyll](https://pixyll.com/jekyll/pixyll/2019/01/26/guide-to-forking-pixyll/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohno%2Fpixyll","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohno%2Fpixyll","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohno%2Fpixyll/lists"}