foggalong / wren Goto Github PK
View Code? Open in Web Editor NEWA page-like Jekyll theme
Home Page: https://foggalong.github.io/Wren
License: MIT License
A page-like Jekyll theme
Home Page: https://foggalong.github.io/Wren
License: MIT License
The meta include has already been given a spruce up from what it was in stock Minima, but could extra features I'd like to get in:
reading_time
which rounds to the nearest minute (rather than down)
reading_time
overflows and displays page content ~ YYYY-MM-DD
Before I'm happy to start using Wren for my own blog (and others) the following things need completing. When these are done I'll release the beta, v0.2 Bewick.
<h4>
and <h4.a>
I know that Jekyll has categories and tags natively, but this doesn't seem to be a feature that Minima exposed as a theme. Will have to do some digging as see if/how it could be utilised.
Wren 0.2 had tags, each of which had their own post list pages and RSS feeds, and then the main "all posts" page also had a tag cloud like was seen on a lot of early 2000s blogs. That also means fixing this issue is sufficient to make the final scraps of Wren 0.2 code redundant.
Fixing this will also be an opportunity to shift away from "home" still being referenced as the blogs/posts page in some of the behind the scenes code.
It's possible to have multiple GitLab, Mastodon, and extra-links
because of the way they're generated, but can only have one link for everything else. Would be cool to enable that behaviour for any of the links
I've added a Liquid template for video embedding on my own blog but think the feature is useful enough that it should live in stock Wren.
Even if I don't have capacity to package it as a Gem right now, it would be good practice if the repo is vaguely structured such that it could be in future. I think as is now, things like having variables in the _config.yml
just directly in site.X
rather than site.wren.x
could cause problems and similarly with the SASS files just being in _sass
.
Also, how do gemspec?
Minima has files in place to allow the user to include custom HTML in the header, footer, etc without having to modify the main files responsible for them. I initially ripped these out but already can see how they would be useful for me using Wren for more than one project, much less anyone else needing to use it.
I don't see myself ever using this for a multi-user blog, but it should be fairly trivial (famous last words) to add an authors list similar to the categories list in d4ffeb9.
An anti-feature inherited from Minima is that it's not possible to include either:
Both these would be nice features to have.
I'd love an option to use Wren alongside an existing website. This would involve:
Describe the bug
The wren_social_data
YAML in the theme's config isn't merged into the user's config when they're using Wren through jekyll-remote-theme
remotely.
To Reproduce
Steps to reproduce the behaviour:
remote theme: jekyll-wren
wren_social_data
from _config.yml
Expected behaviour
Would expect Jekyll to pick up the wren_social_data
YAML from the theme's config so that the user doesn't have to have the data saved in theirs. This happen if using Wren's gem but not when using the theme remotely.
Unlike with the social link list, it's currently possible to add arbitrary pages to the navigation bar. This is good except there's no fallback icon to go to; thinking "page" and just a default document icon.
All the wiki documentation is entirely outdated, all talking about how to use Wren 0.2 ⚰️ The main sections which need updating are:
The method used to recolour SVGs live is preventing them to cache, meaning they flicker every time a new page is loaded. Need to investigate whether this can be done directly with CSS rather than using HTML's <use>
.
The only big feature from Minima which hasn't been given any attention at all is the support for Paginator. All the CSS and Liquid needed is there, but when I tried switching it on even with stock Minima it just didn't work. Will need some investigation.
When the theme is accessed either using the gem or the jekyll-remote-themes
the prebuilt error pages don't go with it, meaning pages like 404.html
404. Unsure if this is a technical limitation with Jekyll/gemspecs like _data
being inaccessible was
An optional 'first published on' icon feature, see it a lot on blogs that've moved around different hosts. Idea would be a YAML header entry like:
first_published on: Wordpress
which Jekyll then turned into an icon for that service to display as part of meta.html
.
LaTeX with MathJax appears over the navbar when in mobile mode. Noticed it when looking at the ellipse blog.
When adding an inline attribute to an image to control its width, as in
![polyyolks]({{ 'path/polyyolks.jpeg' | relative_url}}){: style="max-width: 300px;" }
the automatic centring of the image by markdown is turned off and it aligns to left. This can be fixed by adding display: block;
into the style of images as standard (which can be overridden in Wren by using the left or right image class).
Wren uses categories as the labelling system for posts. I've just learned, contrary to documentation I read a couple weeks ago, there are in fact a difference between categories and tags in Jekyll. The big two:
The first doesn't affect stock Wren because it's not an exposed feature but the second does; Wren's labels are designed to be fluid over time but as is this will result in a heckin' number of broken links. This could be fixed by specifying the permalink structure in _config.yml
but that effectively kills the category hierarchy feature if a user did want to expose it through a plugin.
Only solution I can see is to switch from categories to tags as the exposed labelling feature.
The current navigation icons are taken from Wren v0.2, themselves taken from various Numix designs which are now 7-8 years old. Reckon I can do a lot better now and it'll give the site a more modern feel. Small filesize should still be prioritised.
As part of this it would also be nice to expand the range of fallback icons beyond just page
, e.g. portfolio, videos, etc.
Would be nice to improve images, making it so white images don't blend into the white background, their centring works more reliably (seems #35 isn't the only trigger there), and that alt text also appears as image title text.
There's a setting to resize the navbar like so
$nav-bar-height: 48px !default;
However going larger than 48 will not increase the size of the icons in the navbar accordingly and going lower than 48 will actually start to crop parts of the icons away. My guess is this is to do with the height and width being specified in the <svg
element itself but I'm not certain.
I have no idea why - the code is the same code from before (which worked) just integrated into the main script.
Would be good to have a post like Welcome to Jekyll to demonstrate Wren's content features.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.