heiswayi / the-plain

A minimalist Jekyll theme, ideally designed for your personal blog use.

The Plain

The Plain is a minimalist Jekyll theme, ideally designed for your personal blog use. This Jekyll theme provides a minimum distraction so you can focus on writing that matters to you and your readers. This theme is originally inspired from Leonard Lamprecht's leo theme.

• Demo: https://heiswayi.github.io/the-plain/

Usage

On an unlimited Jekyll host

NOTE This does NOT work on GitHub, see the next section.

Put this in your Gemfile:

gem 'the-plain'

and run bundle install to install the plugin.

Add this to your sites _config.yml file:

theme: the-plain

Then copy some of the settings from this repo's _config.yml file to your own, and modify them.

On GitHub

GitHub - for your user account pages or repository gh-pages - only supports a limited set of themes.

Therefore, you need to use the 'remote_theme:' setting instead of 'theme:', which is supported by a 3rd party plugin.

Put this in your Gemfile:

gem 'jekyll-remote-theme'

and run bundle install to install the plugin.

Add the following to your site's _config.yml to activate the plugin and to select this theme:

plugins:
  - jekyll-remote-theme

remote_theme: heiswayi/the-plain

This will grab the theme directly from the GitHub repo.

Now copy some of the settings from this repo's _config.yml file to your own, and modify them.

Authors

• Heiswayi Nrird

See also the list of contributors who participated in this project.

License

MIT

the-plain's Issues

Accessibility errors found in your template

The user @carlsonsantana validate your site template "https://heiswayi.github.io/the-plain" and found these accessibility errors:

• Page https://heiswayi.github.io/the-plain/:
  • Issue 060455b9-abb5-422a-b02b-a56599c902cb:
    • Type: Error
    • Code: WCAG2AA.Principle1.Guideline1_1.1_1_1.H30.2
    • Message: Img element is the only content of the link, but is missing alt text. The alt text should describe the purpose of the link.
    • Selector: html > body > aside > a
    • Context: <a href="https://heiswayi.github.io/the-plain/about"> <img src="https://avatars0.git...</a>

You can check these accessibility errors using pa11y.
You can view the full validation results in our website.

error on the feed.xml page

Thanks for sharing this awesome theme! here's a problem I found on the feed.xml page.

go to feed.xml pageand check it out

Having issues with linking between posts

Having trouble linking between posts might be an issue related to the relative_url base_url?

There was no example of cross post linking to copy in the example posts just links to exterior websites

点击首页头像到 about 页面，404找不到，你的路径是不是要改下

Add [sites using] section

I have used this great theme in my side project: https://sobolevn.github.io/sobole-zsh-theme/

And I find it useful for both a maintainer and people to share their final results.

My suggestion is: to add a section with the final projects, which are using this theme, in the README or in the wiki.

hi, is there any port to ghost? for this theme

This is awesome theme any port to different platforms would be nice..

Add attribution

I'm very honored that you're using my Jekyll theme as a base for yours. But I also need to remind you that my site's source is licensed under MIT, which basically means you'll have to provide some kind of attribution back to me, if you want to keep using it.

Thank you!

New to Jekyll! Is there a way to add comments under each post?

Hello!!

As titled, is there a way to add a comment area for each post?

Thank you!

-- Found it!

Your theme is listed on jekyll-themes.com

Your theme has been listed on https://jekyll-themes.com/.

bundler (~> 1.15) version too low

Hi,
Thanks for this awesome jekyll theme.
When clone this theme and build this by docker found some error, here is the error message:

Bundler could not find compatible versions for gem "bundler":
In Gemfile:
bundler (~> 1.15)

Current Bundler version:
bundler (2.0.2)
This Gemfile requires a different version of Bundler.
Perhaps you need to update Bundler by running gem install bundler?
Could not find gem 'bundler (~> 1.15)' in any of the relevant sources:
the local ruby installation

so i find ./the-plain.gemspec choose the low version of bundler and rake, so maybe upgrade the version of bundler and rake?

I'll send a pull request...
Thank you!

Add facebook comment?

Hi! Can anyone help to add facebook comment to this theme? I make some work around but not work.

Thank you.

Any thoughts on adding labels/tags?

cdn.mathjax.org has been retired

⚠️
cdn.mathjax.org has been retired. Check https://www.mathjax.org/cdn-shutting-down/ for migration tips.

Sharing ribbon

Hello! Really love the plain theme. Great work. 🙂 Would it be possible to provide a sharing ribbon underneath posts? Or, would that go against the minimalist philosophy of this theme?

the about pages 404

when I forked the plain, git clone to my computer and when I visited the about pages, it shows 404, but I can see the file. here is some picture about the issue. PS. I didn't modified any file~

Jekyll 4.0

Hello,
is there any plan to release an updated gem for the latest version soon?

Share posts on social media

Is this feature in the roadmap? Thanks

code highlighting not working

Hello, I am trying to highlight my code using your template Jekyll theme and I realized that code highlighting does not get processed from the page.

The funny thing is that this markdown formatting is properly processed when you view the markdown file directly from the github page.

Your provided _config.yml is as followed.
"""
markdown: kramdown
kramdown:
input: GFM
sass:
style: :compressed
"""
I have researched and from my current understanding I can't find anything wrong with your _config.yml file..

Last update killed all my website

Hi, last "major redesign" commit killed a lot of style I have on my website:

• Website: https://baptiste-leduc.now.sh/
• Repo: https://github.com/Korbeil/website

Is there a way to avoid using last release and use use before that commit ?

Forking Project

I have already a jekyll site working on the main domain (efe.github.io). I want to use this theme as a project. Firstly, I have forked the project. Secondly, I have chanced the baseurl in _config.yml. However, efe.github.io/the-plain looks 404 (page not found).

Where am i missing?

Are the posts paginated?

I mean, when there are a lot of posts?

prompts don't line up in Safari

In Chrome, the floating prompts work beautifully:

However, in Safari they appear in the middle of the page:

bundler dependency version

bundler dependency version needs updating to 2.3.8

Footnotes not parsing

Firstly thankyou for the such simple-great theme. I'm attempting to use footnotes on my test post, instead of showing just like how it works on the theme demo page, the footnotes on my test post (link https://sulis-tiono.github.io/notes/Alternative-async-Google-Analytics-Tracking-Snippet) seem doesn't work and not parsing corectly thus he footnote definition does not appear. Did I miss something? Any help would be much appreciated.

Regards,
Sulistiono

use custom image instead of gravatar

i'd like to use a custom image (a png) at the top of the site instead of using my gravatar image. is it possible?

Your theme is listed in jekyllthemes.ru

Your theme has been listed on http://jekyllthemes.ru