twisterrob/twisterrob.github.io

Personal website: www.twisterrob.net

Visit twisterrob.net.

Development Install

Requires both ruby and devkit on Windows 7 x64 to install native extensions.

Ruby

Download ruby-2.1.3-x64-mingw32.7z from bintray. Download Latest DevKit from bintray Note: the version number should match closely what's on: https://pages.github.com/versions/

First time

me@devkit$ ruby dk.rb init
me@devkit$ edit config.yml # add ruby directory
me@devkit$ ruby dk.rb install
me@anywhere$ gem install bundler
me@website$ bundle install # Takes about 5 minutes the first time on a clean Ruby.

In case of SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed follow these instructions. If there's the same SSL issue, for example when using jekyll-gist, then try this.

Run

me@windows$ unsubst bundle exec jekyll serve --config _config.yml,_config_local.yml,_config_dev.yml --trace --skip-initial-build --incremental
me@windows$ gradlew serve dev noskip

Usage

Check if site build successfully before each commit

me@webiste$ gradlew preCommitServe local

Upgrade

• Change gem 'github-pages' version to GitHub version
• bundle update, watch for these lines and read release notes:
  • Fetching github-pages 192 (was 127)
    • https://github.com/github/pages-gem/releases
  • Fetching jekyll 3.7.4 (was 3.4.1)
    • https://jekyllrb.com/news/releases/
    • https://jekyllrb.com/docs/history/
  • Fetching liquid 4.0.4 (was 4.0.3)
  • Fetching kramdown 2.3.2 (was 2.3.1)
  • Fetching rouge 3.26.0 (was 3.25.0)
  • Ruby
    • If it asks for ridk install, choose "MSYS2 and MINGW development toolchain" and install to %RUBY_HOME%\msys64.
• Check if https://help.github.com/articles/configuring-jekyll/#configuration-settings-you-cannot-change has changed

TODO

GHPages:

• 161 Whitelist jekyll-octicons (#483) github/pages-gem#483
• 86-192: rouge 1.11.1 -> 2.2.1
• kramdown 1.13.2 -> 1.17.0

Jekyll 3.5

• Sitemaps for static files
• Liquid 4: https://github.com/Shopify/liquid/blob/main/History.md#400--2016-12-14--branch-4-0-stable
• Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters concat and compact, loop performance improvements and many fixes
• Pages, posts, and other documents can now access layout variables via {{ layout }}.
• The gems key in the _config.yml is now plugins.
• Filters like sort now allow you to sort based on a subvalue, e.g. {% assign sorted = site.posts | sort: "image.alt_text" %}.
• layout: null -> layout: none (null = default, none = no layout)

Jekyll 3.6

• Rouge 2 support, but note you can continue to use Rouge 1

Jekyll 3.7

• --livereload
• slugify latin
• collections folder (https://jekyllrb.com/docs/collections/)
• Ruby 2.5.3

Finished reading news <3.8 and changelog <=3.8

These two end up in sitemap after update:

• /dev/assets/css/style.css
• /dev/redirects.json

dev > sass > line_numbers: true is broken after update (generated CSS files no longer have line numbers) ref https://github.com/jekyll/jekyll-sass-converter/blob/master/lib/jekyll/converters/scss.rb#L48

dev > sass > sourcemap is disabled, check if it can be enabled

new RegExp('vegetarian is broken in javascript, report backslash issue contact wasn't working, now it is? (probably should be generated in debug) shell code formatting lost user@machine$ formatting

https://github.com/jekyll/jekyll/pull/6384/files#diff-514abd885acda367325e5236a9be3192R68 https://github.com/kacperduras/disqus-for-jekyll

Origin

This website is based on the Feeling Responsive theme by Moritz »mo.« Sauer // Phlow.de

twisterrob.github.io's Issues

Dagger indexing issue

Somehow Dagger URLs are showing up on my page:
https://www.google.com/search?q=site%3Atwisterrob.net+dagger

even though I don't have that folder, nor had it for a long long time. It's a potential redirect from
twisterrob.github.io/dagger which would be from the www.github.com/twisterrob/dagger repository. But that repo has been deleted long ago (months), and my DNS was set up to redirect a long time ago too (years).

Fontcustom / iconfont replacement

Problems:

• Last update: 7 years ago at https://github.com/FontCustom/fontcustom
• Requires Ruby 2.7.x, see FontCustom/fontcustom#399 (comment)
• Windows installation is problematic: https://github.com/FontCustom/fontcustom/pull/375/files

Options:

• GH-pages 161 whitelisted https://github.com/primer/octicons at https://github.com/github/pages-gem/pull/483/files
• ?

Latest Ruby

• Pre-requisite #23
• TODO: remove exclusion added at #37

Use GitHub Actions deployment for GitHub Pages

https://github.blog/changelog/2022-07-27-github-pages-custom-github-actions-workflows-beta/

Form asks for Google account

Update the Play Store badges

https://play.google.com/intl/en_us/badges/ from "What's new for Apps & Games in December from Google Play"

Enable liquid.strict_variables in _config.yml

Not possible yet, because:

• _includes use include.param syntax and there are many optional params, e.g. toc.panel, or alert.classes

  twisterrob.github.io/_includes/toc.md

  Line 10 in ebc93f6

  {% if include.panel or site.kramdown.toc_panel %}{% assign show_panel = true %}{% else %}{% assign show_panel = false %}{% endif %}

  twisterrob.github.io/_includes/alert

  Line 30 in ebc93f6

  <div class="alert-box {{ entry[0] }} radius {{ include.classes }}">{{ entry[1] | markdownify }}</div>

  twisterrob.github.io/_includes/snippets/email.html

  Line 8 in ebc93f6

  * safe(optional) = true|false, if not provided it will only be generated if site.safe mode is on

• there are some site.data.filename[hashkey] lookups, e.g.

  twisterrob.github.io/_includes/tag_cloud.html

  Line 12 in ebc93f6

  {% assign tag_data = site.data.tags[tag] %}

• complex array items are not defined, e.g. video.url vs video.youtube in

  twisterrob.github.io/_includes/video.html

  Line 1 in ebc93f6

  {% if include.video.url %}

  twisterrob.github.io/_projects/chroma.md

  Lines 16 to 17 in ebc93f6

  	videos:
  	- youtube: 'ADC9suV2v4U'

• ad-hoc hash lookups like page.images.inline.titles

  twisterrob.github.io/_projects/screenjunkies.md

  Lines 9 to 14 in ebc93f6

  	inline:
  	sj: projects/screenjunkies/sj.jpg
  	sjv: http://i.imgur.com/wAZnRCk.gif
  	my: projects/screenjunkies/my.jpg
  	myv: http://i.imgur.com/oP3Ykjg.gif
  	titles: projects/screenjunkies/titles.jpg

  twisterrob.github.io/_projects/screenjunkies.md

  Line 129 in ebc93f6

  

• default layout params are not inherited, e.g. noindex in

  twisterrob.github.io/_layouts/xml-style.xsl

  Lines 1 to 5 in ebc93f6

  	---
  	layout: null
  	source: 'http://www.evagoras.com/2011/02/10/improving-an-xml-feed-display-through-css-and-xslt/'
  	breadcrumbs: true
  	---

Add links for each page to edit on GitHub

Work through Jekyll 3 TODOs

• GHPages:
  • 86-192-228: rouge 1.11.1 -> 2.2.1 -> 3.26.0 https://github.com/rouge-ruby/rouge/blob/master/CHANGELOG.md
  • kramdown 1.13.2 -> 1.17.0 -> 2.3.2
• Jekyll 3.5
  • Sitemaps for static files
  • Liquid 4: https://github.com/Shopify/liquid/blob/main/History.md#400--2016-12-14--branch-4-0-stable
    https://github.com/Shopify/liquid/blob/main/History.md#403--2019-03-12
  • Jekyll now uses Liquid 4, the latest! It comes with whitespace control, new filters concat and compact, loop performance improvements and many fixes
  • Pages, posts, and other documents can now access layout variables via {{ layout }}.
  • The gems key in the _config.yml is now plugins.
  • Filters like sort now allow you to sort based on a subvalue, e.g. {% assign sorted = site.posts | sort: "image.alt_text" %}.
  • layout: null -> layout: none (null = default, none = no layout)
• Jekyll 3.6
  • Rouge 2 support, but note you can continue to use Rouge 1
• Jekyll 3.7
  • --livereload
  • slugify latin
  • collections folder (https://jekyllrb.com/docs/collections/)
  • Ruby 2.5.3
• Jekyll 3.8
  • Ruby 2.7
• Jekyll 3.9
  • allow kramdown v2
    • gem "kramdown-parser-gfm"
    • turn off guessing
  • 3.9.2-3: Ruby 3.0-1-2
• Read news <4 and changelog <4.0
• These two end up in sitemap after update:
  • /dev/assets/css/style.css
  • /dev/redirects.json

dev > sass > line_numbers: true is broken after update (generated CSS files no longer have line numbers)
ref https://github.com/jekyll/jekyll-sass-converter/blob/master/lib/jekyll/converters/scss.rb#L48

dev > sass > sourcemap is disabled, check if it can be enabled

new RegExp('vegetarian is broken in javascript, report backslash issue
contact wasn't working, now it is? (probably should be generated in debug)
shell code formatting lost user@machine$ formatting

https://github.com/jekyll/jekyll/pull/6384/files#diff-514abd885acda367325e5236a9be3192R68
https://github.com/kacperduras/disqus-for-jekyll

Feeling Responsive

• Get https://github.com/TWiStErRob/twisterrob.github.io up to date
• Research small enough portions to be merged back

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• Update dependency gradle from 8.9-rc-1 to 8.9
• Update dependency ruby from 3.3.2 to 3.3.4
• Update dependency gradle from 8.9-rc-1 to 8.10-rc-1
• Click on this checkbox to rebase all open PRs at once

Detected dependencies

bundler

Gemfile

• wdm '>= 0.1.1'
• faraday-retry '~> 2.2.0'

github-actions

.github/workflows/ci.yml

• TWiStErRob/github-workflows v3@1e06403c5d561d70e40109c2701ea3092ca6ded7
• actions/checkout v4
• ruby/setup-ruby v1
• actions/upload-artifact v4
• ruby/setup-ruby v1
• actions/configure-pages v5
• actions/upload-pages-artifact v3
• actions/deploy-pages v4
• actions/cache v4
• actions/checkout v4
• ruby/setup-ruby v1
• ruby/setup-ruby v1
• actions/configure-pages v5
• actions/upload-artifact v4
• actions/cache v4
• actions/download-artifact v4
• actions/download-artifact v4

.github/workflows/jobs.yml

• actions/checkout v4

gradle

settings.gradle

build.gradle

• org.yaml:snakeyaml 2.2

gradle-wrapper

gradle/wrapper/gradle-wrapper.properties

• gradle 8.9-rc-1

ruby-version

.ruby-version

• ruby 3.3.2

sources/iconfont/.ruby-version

• ruby 2.7.8

---

• Check this box to trigger a request for Renovate to run again on this repository

Cache contains date of generation, so diff fails

https://github.com/TWiStErRob/twisterrob.github.io/actions/runs/7563489869/job/20596061581?pr=43

Heap vis

onenote:///V:\Documents\Notes%20-%20OneNote%20Notebooks\Professional\Programming\Ideas.one#Heap%20vis&section-id={67BE783C-DFB7-4C53-8AC0-8DB6A4DF36FE}&page-id={815714B6-C182-4BA9-B36A-0EC16BCF47F1}&end

/blog/categories redirect infinite

https://search.google.com/search-console/index/drilldown?resource_id=sc-domain%3Atwisterrob.net&item_key=CAMYFCAE&hl=en

Sitemap contains unnecessary items

404
sitemap.xml
xsl

Duplicate icon in Work

target=_blank is adding an after for external link, but there's a more specific selector overriding the content of the icon.

Split from monorepo

• Part of TWiStErRob/TWiStErRob-env#8

• Create issue in target repo
• Link it here
• Clean up local copy
• Use svn2git (TWiStErRob/TWiStErRob-env#71)
• Optional: Build CI
• Delete from SVN
• Replace p:\projects\workspace\x (.svn) with p:\project\workspace\repo.name.x (.git)
• Create tag svn for the last SVN commit in git, and create a pre-release on GitHub: "SVN to GIT migration" and description: "This is the point of the last commit in SVN. After this commits went to GitHub git."
• recreate/tag existing releases on GH
• link new releases from website (see guide)
• tick the box in split epic
• Create CI for jobs
• TWiStErRob/net.twisterrob.jobs#1

Contact form Submit button is not visible

Cannot scroll, can only navigate to submit with Tab.

/blog/ to index or not to index

https://search.google.com/search-console/index/drilldown?resource_id=sc-domain%3Atwisterrob.net&item_key=CAMYHCAE&hl=en

https://yoast.com/help/crawl-error-submitted-url-marked-noindex/

<meta name="robots" content="noindex">

is in <head>, I think the sitemap entry should be excluded.

Cannot submit contact form

Your script, twisterrob.net Contact Form Mailer, has recently failed to finish successfully. A summary of the failure(s) is shown below. To configure the triggers for this script, or change your setting for receiving future failure notifications, click here.

The script is used by the document twisterrob.net Contact Form.

Start Function Error Message Trigger End
12/31/21 6:48:19 PM CET contactMailer Authorization is required to perform that action. formSubmit 12/31/21 6:48:20 PM CET

Trigger: https://script.google.com/home/triggers?trigger_id=QxboDYkuT3Kl6ZB2qVbWng
Form: https://docs.google.com/open?id=1cG89BafxKwdxv9kzS-C_MjZfte0Ldlz37vr0m2U77jA

DNS check

https://github.com/TWiStErRob/twisterrob.github.io/settings/pages

"DNS check in progress"

Work items out of context

No date for example

404 is not indexable

Google does seem to be bothered by 404 showing up in sitemap:
https://search.google.com/search-console/index/drilldown?resource_id=sc-domain%3Atwisterrob.net&item_key=CAMYICAE&hl=en

it's safe to remove as it doesn't provide content.

Jekyll 4

• Prerequisite #34
• Prerequisite #24
• Feature request: github/pages-gem#651
• Infeasibility explainer: github/pages-gem#651 (comment)

Motivations:

• github/pages-gem#752

Workarounds:

• 2019: move to Netlify or other third party.
• 2019: https://github.com/BryanSchuetz/jekyll-deploy-gh-pages (hacky push to gh-pages branch)
• 2020: Deployment from a branch
• 2022: Official response, GitHub Pages custom actions workflows.
• Official 2022 solution implemented in #25

Tasks

• https://jekyllrb.com/docs/upgrading/3-to-4/