someweekendreading/someweekendreading.github.io

Data for the obscure blog of an even more obscure retired scientist.

This is the data for an obscure blog of an even more obscure retired scientist

Jekyll automatically builds it into a static site. It lets me write posts locally in Emacs, push up to GitHub as a content management system, and then have the site rebuilt -- static, with no cockroach-like infestations of awful, intrusive Javascript nonsense for nefarious "business purposes" by shadowy corporate oligarchs.

It was started in the summer of 2020, so obviously I'm still just learning what's going on here. Probably lots of Jekyll/Github blunders!

License

The following files, directories, and their contents are copyright by me. You may not reuse anything therein without explicit permission (though admittedly, I'm likely to grant permission):

• _data/
• _posts/
• assets/
• images/
• quotes.md
• about.md

All other directories and files are MIT Licensed. Feel free to use the HTML and CSS as you please. If you do use them, a link back to https://www.someweekendreading.blog/ would be polite, but not required.

---

What are you looking down here for?

someweekendreading.github.io's Issues

Local jekyll

Install jekyll locally, so I can debug locally before pushing out to the world (see README.md)

• Needs Ruby 2.5.0 or higher; I have only 2.3.7p456, so have to upgrade.
• Also need to update RubyGems

1. Install Jekyll and plug-ins in one fell swoop. gem install github-pages This mirrors the plug-ins used by GitHub Pages on your local machine including Jekyll, Sass, etc.
2. Clone down your fork git clone https://github.com/yourusername/yourusername.github.io.git
3. Serve the site and watch for markup/sass changes jekyll serve
4. View your website at https://127.0.0.1:4000/
5. Commit any changes and push everything to the master branch of your GitHub user repository. GitHub Pages will then rebuild and serve your website.

Pro GIT

Read Pro GIT

Comment style

Comments: make assets/main.scss.txt work?

Google Analytics & AdSense

Google Analytics & AdSense, once we have some readers
https://flipdazed.github.io/blog/website/google-adsense-and-google-analytics
https://michaelsoolee.com/google-analytics-jekyll/

Move merit badges to nav bar

... where they'll be seen

Add search button

and magnifying glass icon.

Tag cloud

Add tag cloud, sized by # of posts.

Copyright

Copyright notice on each page, perhaps in build notice

Theme

Figure out themes, and make my stuff a theme. Maybe use MinimalMistakes? Or duplicate it? Clean up CSS in general.

Push as SomeWeekendReadingEditor

How to do pushes from my laptop, when SomeWeekendReading now owns it? Supply SWR
credentials on command line somehow? (And then delete myself as a collaborator.)
Looks related to the staticman bot pushing comments into the repo with a personal
access token, so maybe solve the comment problem first?

https://stackoverflow.com/questions/29776439/username-and-password-in-command-for-git-push
This prompts for the password:
git push https://[email protected]/YOUR_GIT_USERNAME/yourGitFileName.git

ALSO: https://www.appveyor.com/docs/how-to/git-push/

Tags in site.pages

Tags aren't working in .md files in root or /assets/ all 1 tag, as revealed by HTML checker:

Also, they're not in the RSS feed?!
But they are in the sitemap. I do the sitemap, the feed is somewhere inside Jekyll.
See https://jekyllrb.com/tutorials/convert-site-to-jekyll/#10-rss-feed for how to do
it without the jekyll-feed gem, which doesn't seem to handle this?
Also: https://joelglovier.com/writing/rss-for-jekyll

Add google translate button

Font size

Make less gigantic.

Add issues

Use GitHub issues mechanism.

HTML Sitemap

Use XSLT to convert sitemap.xml to HTML and permalink it; also put in nav bar.

Figure out how to serve data files (e.g., spreadsheets for download)

Current scheme of making it a markdown file in assets is just nonsense.

Consider adding your blog to diff.blog

Hello 👋 👋

Over the past decade, we have seen the rise of centralized publishing platforms like Medium. A lot of self hosted blogs were migrated to these platforms in hope of a bigger audience. Sadly, most of these blogs lost their unique identity and became just another page on them.

Our mission is to fight back against monopolies like Medium and promote independent self hosted blogs like yours. We think the best way to make this happen is by improving the visibility and reach of self hosted blogs. And that's why we built diff.blog.

diff.blog is an aggregator of developer blogs. It was started in 2019 to improve the visibility of self hosted blogs. Whenever you publish a new blog post on your blog, it would automatically appear in the diff.blog news feed. The title and summary of the post would be visible to the users of diff.blog and they can click on the post to read the full post on your blog.

We also have a weekly email digest, which would email the most popular blog posts in our index to all diff.blog users.

diff.blog index over 608 blogs at the moment. And our network is growing steadily every day. And we would like to invite you to include your blog in diff.blog as well.

Adding your blog to diff.blog is super easy and takes less than a minute.

• Go to https://diff.blog
• Sign up with your GitHub account.
• Go to blog settings https://diff.blog/account/settings/blog/
• Add the URL of your blog

We are looking forward to have your blog in diff.blog. Let us know if you have any questions. Happy to answer.

Self-host material icons

Figure out how to self-host the material icons
https://github.com/google/material-design-icons/tree/master/font
https://google.github.io/material-design-icons/#icon-font-for-the-web

Liquid scripts for common stuff like right-aligned images

Go over existing posts & find places where we'd like to have macros; write them in liquid. Example: right-aligned images around which the text flows, with alt and title tags, required sizes, and potential href to full size. Also YouTube videos. Also footnotes & references (maybe combine those?).

Robustify merit badges

protect style settings from nav bar mischief, make out of tables so it doesn't rely on artful spacing, etc.

tags on non-post files

Make tag collection scan non-post files like about.md, and 404.md, and .md files in assets/.
*** 1st attempt not working:
Prob not working because tagpage.html assumes it can ref post.date, post.title, post.description
An ordinary page has a title, but no date and no description? Add to YML? (didn't
work either)