{"id":13424167,"url":"https://github.com/lingxz/sparrow","last_synced_at":"2025-10-24T10:24:03.659Z","repository":{"id":56896557,"uuid":"87933265","full_name":"lingxz/sparrow","owner":"lingxz","description":":v: A clean and minimal Jekyll theme for writers.","archived":false,"fork":false,"pushed_at":"2019-03-15T20:30:25.000Z","size":101345,"stargazers_count":49,"open_issues_count":1,"forks_count":25,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-23T01:40:36.490Z","etag":null,"topics":["github-pages","jekyll","jekyll-theme","ruby-gem","theme"],"latest_commit_sha":null,"homepage":"https://theconfused.me/sparrow","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/lingxz.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}},"created_at":"2017-04-11T12:48:40.000Z","updated_at":"2025-04-19T05:04:29.000Z","dependencies_parsed_at":"2022-08-21T00:50:56.414Z","dependency_job_id":null,"html_url":"https://github.com/lingxz/sparrow","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lingxz/sparrow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lingxz%2Fsparrow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lingxz%2Fsparrow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lingxz%2Fsparrow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lingxz%2Fsparrow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lingxz","download_url":"https://codeload.github.com/lingxz/sparrow/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lingxz%2Fsparrow/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265887632,"owners_count":23844437,"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":["github-pages","jekyll","jekyll-theme","ruby-gem","theme"],"created_at":"2024-07-31T00:00:49.682Z","updated_at":"2025-10-03T17:49:24.945Z","avatar_url":"https://github.com/lingxz.png","language":"CSS","funding_links":[],"categories":["CSS"],"sub_categories":[],"readme":"changelog:\n\n0.1.2\n\n- upgraded to jekyll-paginage-v2 and removed the old jekyll-paginate \n\n# Sparrow\n\n[![Gem Version](https://badge.fury.io/rb/sparrow-jekyll-theme.svg)](https://badge.fury.io/rb/sparrow-jekyll-theme)\n\nA clean minimal Jekyll theme for writers. \n\n[Live Demo](http://theconfused.me/sparrow)\n\n- [Features](#features)\n- [Why the name?](#why-the-name) \n- [Install](#install)\n    - [General configuration](#general-configuration)\n    - [Disqus](#disqus)\n    - [Google analytics](#google-analytics)\n    - [Collections](#collections)\n    - [Pagination](#pagination)\n    - [Navigation](#navigation)\n    - [Front matter defaults](#front-matter-defaults)\n    - [Other](#other)\n- [Credits](#credits)\n\n## Screenshot \n\n![](screenshot.png)\n\n## Features\n\n- Fully compatible with Github Pages\n- Configurable and responsive multi layer menu, adapted from [slimmenu](https://github.com/adnantopal/slimmenu)\n- Disqus integration\n- [Font Awesome icons](http://fontawesome.io/) included\n- Google analytics\n- Social sharing using [rrssb](https://www.rrssb.ml/)\n- 404 page included\n- Typographic optimization for Chinese fonts\n- Atom feed generated with [jekyll-feed](https://github.com/jekyll/jekyll-feed)\n- Pagination enabled for blog using [jekyll-paginate-v2](https://github.com/sverrirs/jekyll-paginate-v2)\n- Basic SEO with Facebook Open Graph tags and Twitter cards\n\n## Why the name? \n\nIn Chinese there's a saying that goes 麻雀虽小，五脏俱全。It roughly translates to: small though a sparrow is, it possesses all internal organs. Small but complete is what this theme aspires to be. Minimal but includes all the essential aspects to building a blog. \n\n## Install\n\nJust fork this repo and replace the posts with your own. Also rename the sample poetry collection to replace it with your own collection, or just delete it if you don't need to use collections. The example is poetry, but you can easily revamp this into essays, short stories, portfolio, or whatever your creative work is. \n\nOR you can also install this theme as a theme gem. To do that, add to your Gemfile: \n\n```ruby\ngem \"sparrow-jekyll-theme\"\n```\n\nAnd add this line site's `_config.yml`: \n\n```yaml\ntheme: sparrow-jekyll-theme\n```\n\nAnd then do `bundle install`. \n\nTo run your site locally, do `bundle exec jekyll serve`. \n\nFor customization, see below. \n\n### General configuration\n\nCustomize these values in the `_config.yml` file: \n\n```yaml\ntitle                    : \"Sparrow\"\ntitle_separator          : \"-\"\ndescription              : \"A clean and minimal theme for writers.\"\nfavicon                  : \"/assets/images/bird.png\"\navatar                   : \"/assets/images/bird.png\"\nurl                      : \"https://theconfused.me\" # the base hostname \u0026 protocol for your site e.g. \"https://mmistakes.github.io\"\nbaseurl                  : \"/sparrow\" \n\n# Site Author\nauthor:\n  name                   : \"Lingyi\" # appears in the footer and atom feed\n```\n\n\n### Disqus\n\nTo activate Disqus, fill in your disqus shortname: \n\n```yaml\ncomments                 : true # set it to false to disable comments\ndisqus:\n  shortname              : your_shortname\n```\n\n### Google analytics\n\nEnable google analytics by filling in your tracking ID: \n\n```yaml\nanalytics:\n  google:\n    tracking_id          : # add your google tracking id here\n```\n\n### Collections\n\nIf you are using collections, be sure to replace this with your collection name: \n\n```yaml\ncollections:\n  poetry:\n    output: true\n    permalink: /:collection/:title/\n```\n\n### Pagination\n\nPagination is done using jekyll-paginate-v2. Currently it is only turned on for the blog page, but it could possibly support pagination on multiple pages. Please read the [jekyll-paginate-v2 documentation](https://github.com/sverrirs/jekyll-paginate-v2/blob/master/README-GENERATOR.md#creating-pagination-trails) for configuraiton. \n\n### Navigation\n\nYou can change the navigation links in `_data/navigation.yml`.\n\n### Front matter defaults\n\nAt the bottom of the config file, you can also set [front matter defaults](https://jekyllrb.com/docs/configuration/#front-matter-defaults) so that you don't have to repeat the same front matter for every post. This is an example: \n\n```yaml\n# Front matter defaults\ndefaults:\n  # _pages\n  - scope:\n      path: \"\"\n      type: pages\n    values:\n      layout: page\n      comments: false\n  # _posts\n  - scope:\n      path: \"\"\n      type: posts\n    values:\n      layout: post\n      comments: true\n      share: true\n  # _poetry\n  - scope:\n      path: \"\"\n      type: poetry\n    values:\n      layout: post\n      share: false\n```\n\n### Other\n\nTo enhance SEO, you can add your twitter username to `_config.yml`. \n\nYou can also add a image path for the `og_image` value in the config file, for a default open graph sharing image. This value can be overridden in individual posts. \n\nFor the various config options see the [sample config file for the demo site](https://github.com/lingxz/sparrow/blob/master/_config.yml)\n\nThere are also helper classes for ease of inserting image and their captions, adapted from the [Minimal Mistakes theme by Michael Rose](https://github.com/mmistakes/minimal-mistakes). You can find a [sample post with images](https://theconfused.me/sparrow/blog/post-with-image/) on the [demo site](https://theconfused.me/sparrow). \n\nThe color schemes and fonts can also be customized through scss, by editing the relevant variable in `_variables.scss`. \n\n## Credits\n\n- Bird icon made by [Freepik](http://www.freepik.com) from [Flaticon](http://www.flaticon.com) and is licensed by [CC 3.0 BY](http://creativecommons.org/licenses/by/3.0/).\n- Photos from [Unsplash](https://unsplash.com/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flingxz%2Fsparrow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flingxz%2Fsparrow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flingxz%2Fsparrow/lists"}