GithubHelp home page GithubHelp logo

patdryburgh / hitchens Goto Github PK

View Code? Open in Web Editor NEW
337.0 7.0 434.0 1.04 MB

An inarguably well-designed Jekyll theme.

Home Page: https://patdryburgh.github.io/hitchens/

License: MIT License

Ruby 3.76% HTML 36.61% SCSS 59.63%
jekyll jekyll-theme jekyll-template

hitchens's People

Contributors

patdryburgh avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

hitchens's Issues

Pagination support

Currently, all posts are displayed on the homepage. For a blog with a large archive, this could prove to be quite unwieldy.

The theme should support some form of pagination. Subsequent pages should not include the large full-screen title splash, else navigating between pages would be rather cumbersome.

RSS feed Template

To make it easier for users to start a blog with this theme, it should include a basic template for an RSS feed.

Small Lighthouse audit details

Just two items from Lighthouse that may impact score and performance could be added, they are:

  • font-auto attribute to load text before the font loads
  • <meta> description attribute (maybe with variable added to _config.yml

I added this in my instance, leaving it up as suggestion.

Flicker when scrolling

First out: Great looking theme! Thanks for making it open source.

Describe the bug
Some flicker/glitch in white at the bottom and top of the page when scrolling.

To Reproduce
Choose a longer article. Scroll in "skim reading" pace, now and then you should see a white flicker. Both scrolling down and up again.

Expected behavior
No flicker when scrolling. It seems to work in Firefox.

Screenshots
Example in this video https://share.cleanshot.com/v4mhuY

Desktop (please complete the following information):

  • OS: Mac OS
  • Browser: Chrome and Brave
  • Version: Latest versions.

Smartphone (please complete the following information):

  • Device: [e.g. iPhone6]
  • OS: [e.g. iOS8.1]
  • Browser [e.g. stock browser, safari]
  • Version [e.g. 22]

Additional context
Add any other context about the problem here.

micro blog support

Currently, Hitchens only supports long-form posts with a title. Ideally, it would also allow for shorter posts and/or posts without a title.

My thinking at the moment for how to accomplish this would be to present micro posts in the same “Table of Contents” on the homepage, but display excerpts rather than the full post where currently the post title is displayed.

JSON Feed

To make it easier for users to start a blog with this theme, it should include a basic template for a JSON feed.

Optional post excerpts in post list

Users of this theme should have the option of displaying post excerpts under the post titles in the post list. This might require a slight redesign of the post titles in the list, but we can work on that as we build out this feature.

It should probably be a setting in the _config.yml file, probably a boolean called show_excerpts. Though, I'm open to other possibilities!

Valid JSON feeds

Pat, I used your JSON feeds as the basis for my own. Here are the gists I have for a feed.json (which has all the long form blog posts) and a micro.json (which has short posts only):

https://gist.github.com/bmann/38b54d893d506d2eb8bb8b325eafaccf

A note: right now, the micropub server I'm using defaults to setting category of short posts to "social", which I couldn't fix, so I just changed it in my Jekyll install.

Also, because of some of the rest of the Jekyll theme that I inherited, I purposefully don't include title in the micro feed.

Lastly, my theme / setup supports a date modified field, so I included that.

The validator for checking feeds is here: http://validator.jsonfeed.org/

(and apologies for not having a Pull Request for you, a lot of this stuff ends up being pretty blog specific)

Improve vertical rhythm

The leading for headings is inconsistent. This should be fixed in order to improve the vertical rhythm of the page.

Formatting for footnotes

Jekyll (or specifically, kramdown) supports footnotes. It would be nice to have formatting for it.

Here's an example of the generated HTML from a footnote:

<div class="footnotes">
  <ol>
  <li id="fn:emailteam">
  <p>I wrote a <a href="https://speakerdeck.com/">presentation about email at companies</a> that I should revisit and add Missive to. <a href="#fnref:emailteam" class="reversefootnote">&#8617;</a></p>
  </li>
  </ol>
</div>

Add pagination example to demo site

Right now, the demo site only displays 3 posts. It should display more posts and the required paginator settings should be added to the _config.yml file so users can see how pagination works with this theme.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.