{"id":14979495,"url":"https://github.com/keshiba/better-minima","last_synced_at":"2025-10-02T17:30:27.029Z","repository":{"id":41983065,"uuid":"260750224","full_name":"keshiba/better-minima","owner":"keshiba","description":"Better-Minima is forked over from Minima to provide a personal blog styled theme.","archived":false,"fork":true,"pushed_at":"2024-08-11T18:26:29.000Z","size":2883,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2024-09-25T03:01:52.930Z","etag":null,"topics":["jekyll","jekyll-theme","minimal-theme"],"latest_commit_sha":null,"homepage":"http://keshiba.me","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"jekyll/minima","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/keshiba.png","metadata":{"files":{"readme":"README.md","changelog":"History.markdown","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":"2020-05-02T18:31:04.000Z","updated_at":"2021-09-26T00:48:57.000Z","dependencies_parsed_at":"2023-02-08T12:00:25.728Z","dependency_job_id":null,"html_url":"https://github.com/keshiba/better-minima","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keshiba%2Fbetter-minima","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keshiba%2Fbetter-minima/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keshiba%2Fbetter-minima/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keshiba%2Fbetter-minima/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/keshiba","download_url":"https://codeload.github.com/keshiba/better-minima/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219875833,"owners_count":16554706,"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":["jekyll","jekyll-theme","minimal-theme"],"created_at":"2024-09-24T14:00:08.960Z","updated_at":"2025-10-02T17:30:26.624Z","avatar_url":"https://github.com/keshiba.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# better-minima\n\n[![Gem Version](https://badge.fury.io/rb/better-minima.svg)](https://badge.fury.io/rb/better-minima)\n\n*Better-Minima* is based on [Minima](https://github.com/jekyll/minima) which is Jekyll's default theme.\nMinima is a beautiful theme to begin with and has a clean look. \n\nBetter-Minima builds upon it by making the theme more suitable for a personal blog.\n\n[Theme preview](http://keshiba.me)\n\n![better-minima theme preview](https://raw.githubusercontent.com/keshiba/better-minima/master/screenshot.png)\n\n## Installation\n\nAdd this line to your Jekyll site's Gemfile:\n\n```ruby\ngem \"better-minima\"\n```\n\nAnd then execute:\n\n    $ bundle\n\nThis will fetch the gem and store it locally.\n\nThen, to use this theme, change the `theme` variable in your `_config.yml`\n```\ntheme: \"better-minima\"\n```\n\n### NOTE - Github Pages\nIf you want to host your Jekyll blog on GitHub, you need to follow the steps given below.\n\n\n#### Step1 - Add gem\nAdd the gem `jekyll-remote-theme` to your `Gemfile`.\n```\ngem \"jekyll-remote-theme\"\n```\n\n#### Step2 - Modify _config.yml\nAdd the plugin `jekyll-remote-theme` to your plugins list in `_config.yml`\n```\nplugins:\n  - jekyll-remote-theme\n```\n\n#### Step3 - Set remote-theme\nAdd the theme name `keshiba/better-minima` to the `remote-theme` variable.\n```\ntheme: minima\nremote-theme: \"keshiba/better-minima\"\n```\n\n#### Step4 - Install gem\nRun the `bundle` command to download and install the plugin\n```\n$ bundle\n```\n\n## Usage\n\n### Hero Name\nTo get your name on the homepage as shown in this preview, add the following block to `_config.yml`\n```\nauthor:\n  name: imarandomguy\n```\n\n### Social Links\nTo get the social links on your home page as shown in this preview, add the `social_links` block to `better-minima` config in `_config.yml`\n```\nbetter-minima:\n  social_links:\n    twitter: imarandomguy\n    github: randomguy\n    telegram: randomguy\n```\n\nFor a list of all social links supported by this theme, take a look at this [_config.yml](https://github.com/keshiba/better-minima/blob/master/_config.yml) file.\n\n### Featured Posts\nA list of *Featured Posts* are displayed on the homepage.\nTo add a post to this list, set the `featured` variable to `true`.\n\n```\n---\ntitle: \"This is a featured post\"\nfeatured: true\n---\nPost content goes here\n```\n\n### Recent Posts\nThe \"Recent Posts\" section shows 10 recent posts (by default) in it. \nTo change the recent posts count, add the following property to `_config.yml`.\n\n```\nrecent_posts_count: 15\n```\n\n### Pagination\n\nUnlike minima, better-minima shows just the *Featured Posts* and *Recent Posts* on the homepage. \nThe \"All Posts\" section must be on a separate page for pagination to work correctly.\n\nTo enable pagination, follow the steps given below.\n\n\n#### Step 1 \n\nTo `_config.yml`, add the following properties\n```\npaginate: 5\npaginate_root_path: \"/blog/\"\npaginate_path: \"/blog/page:num/\n```\n`paginate:5` - This enables pagination and instructs the theme to show *5* posts in a page.\n\n`paginate_root_path: \"/blog/\"` - This is your preferred URL path to navigate to the \"All Posts\" section.\n\n`paginate_path: \"/blog/page:num/` - This is the path used by Minima to navigate to other pages while paginating. `:num` is the placeholder for page number.\n\n#### Step 2\nTo `_config.yml`, add the plugin `jekyll-plugins` to the `plugins` block\n\n```\nplugins:\n - jekyll-paginate\n```\n\n#### Step 3\nAdd gem dependency to `Gemfile`\n\n```\ngem 'jekyll-paginate', '\u003e= 1.1.0\n```\n\n#### Step 4\n\nCreate a new folder in your project's base directory with the name which you provided for `paginate_root_path` in `_config.yml`\n\nFor example, if your jekyll site is located at `D:\\Sites\\MySite`, then you should create the folder at `D:\\Sites\\MySite\\blog\\`\n\n\n#### Step 5\n\nDownload [index.html](https://github.com/keshiba/better-minima/blob/master/blog/index.html) into the folder which you created in Step-2.\n\nThis file will serve as the template for pagination and must be included exactly in the `paginate_root_path`.\n\n\n## For More Information\n\nVisit https://github.com/jekyll/minima\n\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/keshiba/better-minima. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.\n\n\n## License\n\nThe theme is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeshiba%2Fbetter-minima","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkeshiba%2Fbetter-minima","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeshiba%2Fbetter-minima/lists"}