{"id":14979301,"url":"https://github.com/kaptn3/future-imperfect","last_synced_at":"2025-10-28T16:31:37.706Z","repository":{"id":109374178,"uuid":"86148365","full_name":"kaptn3/future-imperfect","owner":"kaptn3","description":"Jekyll Theme Future Imperfect ","archived":false,"fork":false,"pushed_at":"2023-03-30T03:55:41.000Z","size":1476,"stargazers_count":22,"open_issues_count":4,"forks_count":41,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-09-29T02:42:19.805Z","etag":null,"topics":["blog","future-imperfect-theme","gh-pages","github-pages","jekyll","jekyll-blog","jekyll-site","jekyll-theme","kaptn","theme"],"latest_commit_sha":null,"homepage":"https://future-imperfect.kaptn.ru","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/kaptn3.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2017-03-25T10:06:02.000Z","updated_at":"2024-09-08T21:41:21.000Z","dependencies_parsed_at":"2024-09-19T02:02:30.051Z","dependency_job_id":null,"html_url":"https://github.com/kaptn3/future-imperfect","commit_stats":{"total_commits":100,"total_committers":1,"mean_commits":100.0,"dds":0.0,"last_synced_commit":"d3df737c97c863930233beceb7588b120a2ec82a"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaptn3%2Ffuture-imperfect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaptn3%2Ffuture-imperfect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaptn3%2Ffuture-imperfect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaptn3%2Ffuture-imperfect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kaptn3","download_url":"https://codeload.github.com/kaptn3/future-imperfect/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219859164,"owners_count":16556037,"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":["blog","future-imperfect-theme","gh-pages","github-pages","jekyll","jekyll-blog","jekyll-site","jekyll-theme","kaptn","theme"],"created_at":"2024-09-24T13:59:46.606Z","updated_at":"2025-10-28T16:31:37.090Z","avatar_url":"https://github.com/kaptn3.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Future Imperfect Theme on Jekyll\n\u003eby [Kapitonenko](https://kaptn.ru)\n\n\u003chttps://future-imperfect.kaptn.ru\u003e - demo  \n\u003chttps://github.com/kaptn3/future-imperfect/\u003e - repository\n\n[![MIT Licence](https://badges.frapsoft.com/os/mit/mit.svg?v=103)](https://opensource.org/licenses/mit-license.php)\n[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.png?v=103)](https://github.com/ellerbrock/open-source-badge/)\n![Future Imperfect Theme preview](https://cdn.rawgit.com/kaptn3/blog/4ccc6d6a/readme_files/screen.png)\n\n1. [Installation](#installation)\n2. [Usage](#usage)\n3. [Content management](#content-management)\n    - [Template](#template)\n    - [Example of post](#example-of-post)\n    - [Category page](#category-page)\n4. [Features](#features)\n    - [Categories](#categories)\n    - [Comments](#comments)\n    - [Icons](#icons)\n    - [Post Image](#post-image)\n    - [Featured image](#featured-image)\n    - [Edit link](#edit-link)\n    - [Web analytics](#web-analytics)\n5. [Upgrading Theme](#upgrading-theme)\n6. [Thanks to the following](#thanks-to-the-following)\n7. [Todo](#todo)\n8. [Donate](#donate)\n9. [Copyright and license](#copyright-and-license)\n\n## Installation \n1. Download, clone or fork repo `git clone git@github.com:kaptn3/blog.git`\n2. Enter the folder: `cd blog/` \n3. Start Jekyll server: `jekyll s`\n\nAccess, [localhost:4000](http://localhost:4000)\n\n## Usage\nIf you're completely new to Jekyll, I recommend checking out the documentation at \u003chttp://jekyllrb.com\u003e or there's a tutorial by Smashing Magazine.\n\nIf you have any questions please ask me at [GitHub Issues](https://github.com/kaptn3/future-imperfect/issues).\n\n## Content management\n### Template\nTemplate of posts setting is in `_drafts/template.md`. `Layout` is always named `post`. `Title` is a title of post, writing in quotation marks. `Date` written in the following format: `yyyy-mm-dd hh:mm`. In `category` specifies one category. In `icon` written the name of icon (its in the folder `images`). In `tags` is possible to write multiple tags using a comma. In `image` specify the path to image preview (can not fill). And in `preview` you can write `0` to on the main page didn't show the announcement of the post. \n\nMore details about all features and setting can be view on [here](#features).\n\n### Example of post\n```\nlayout: post\ntitle:  \"Lorem\"\ndate:   2017-06-04 00:00\ncategory: category_name\nicon: git\nkeywords: tag1, tag2\nimage: 1.png\npreview: 0\n```\n\n### Category page\nIf you want to add a page of category you have to create folder with name of category and file `index.html`, which should contain the following:  \n```\n---\nlayout: default\ntitle: Category1\npermalink: /category1/ \n---\n\n{% include category.html %}\n```\n\nYou can see example in [here](https://github.com/kaptn3/future-imperfect/blob/master/category1) or [here](https://github.com/kaptn3/blog/blob/master/category2).\n\n## Features\n### Categories\nIn blog page, we categorize posts into several categories by url, all category pages use same template html file - `_includes/category.html`. Links of category in menu is in `_data.links.yml`.\n\nFor example: URL is `localhost:4000/category1`. In `_data.links.yml` we define this category named category1, so in `_includes/category.html` we get this URL(/category1/) and change it to my category(category1), then this page are posts about category1.\n\n### Comments\nI use [HyperComments](http://hypercomments.com) instead of other tool, Disqus, so it's slower and don't allows to anonymously send messages. Code of comment is in `_includes/comments` and it included in every post.\n\n### Icons\nFor categories I use svg-icons in `images`. Еhe icon is automatically assigned to the post by its category. The icon name must be `category_name.svg`.\n\n### Post Image\nAll images used in posts that are in `post-image` and its are categorized. For example, images in post of category1's category is in `post-img/category1`. \n\n### Featured image\nYou can specify the preview image for post in [YAML Front Matter](http://jekyllrb.com/docs/frontmatter/). In front matter called \"image\" to indicate the name of the image. The picture must be located in a category folder.    \nFor example, we write post of category_name's category. In folder `post-img/category_name` put the preview image with the title \"1.png\" and in front matter write: `image: 1.png`. [Example](https://github.com/kaptn3/future-imperfect/blob/master/_posts/2017-06-08-learn-git4.md).\n\nAlso, in front matter you can control the announcement of record post. By default, the announcement consists of 35 words. Writing in the front matter called \"preview\" the number 0, the announcement will not be displayed for this entry. [Example](https://github.com/kaptn3/blog/blob/master/_posts/2017-06-08-learn-git4.md).\n\n### Edit link\nAll posts can be edited by users through link: `github.com/kaptn3/future-imperfect/edit/master/{{ page.path }}` or `github.com/kaptn3/blog/edit/master/{{ post.path }}`. \n\n### Web analytics\nI use [Yandex Metrika](https://metrika.yandex.ru) to do web analytics, you can choose either to realize it, just paste your code in `includes/analytics.html`.\n\n## Upgrading Theme\nBlog is always being improved by its users, so sometimes one may need to upgrade.\n\nEnsure 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`git remote add upstream https://github.com/kaptn3/future-imperfect.git`\nPull in the latest changes\n\n`git pull upstream master`\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[Jekyll](http://jekyllrb.com/)  \n[HTML5Up](https://html5up.net/)  \n[Font Awesome](http://fontawesome.io/icons/)  \n[HyperComments](http://hypercomments.com)\n\n## TODO\n- [ ] Add 404 page\n- [ ] Search system\n- [x] Add fontawesome 5\n- [ ] Add paginator\n\n## Donate\nIn `includes/donate.html` you'll see form for donation, includes in every post.  \nAlso if this project let you enjoy your blog time, you can give me a cup of coffee :)\n\n[Donate =)](https://money.yandex.ru/to/410013162271067/10)\n\n## Copyright and license\nThe theme is taken Future Imperfect Theme from [HTML5 UP](https://html5up.net).\n\nIt is under [the MIT license](/LICENSE).\n\nEnjoy :yum:\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaptn3%2Ffuture-imperfect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkaptn3%2Ffuture-imperfect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaptn3%2Ffuture-imperfect/lists"}