Jekyll After Ubuntu Upgrade

I recently had some issues running my Jekyll site after upgrading my OS (Pop!_OS, an Ubuntu derivative).

Ruby

Jekyll is a static web-site development environment - very useful for blogs but also general purpose landing pages.  I use it for profitview.net for example.  It is written in Ruby, a dynamically typed general purpose language, made popular in particular through Ruby-On-Rails website development system that became popular in the mid 2000s.

When updating Pop!_OS typically a new Ruby version will be installed - and the old one removed to avoid conflicts.  Ruby's bundler refers to a specific Ruby instance - which may no longer be there.  Therefore this must be updated.  The mechanism for doing this is as follows:
gem uninstall bundler
gem install bundler
This simply causes it to use the current native Ruby.  Unless the changes in Ruby are substantial, this should cause no problem.

Jekyll

With the newly installed bundler, Jekyll must be reinstalled:
gem install jekyll

Get Your Site Running

Due to the changes, you need to make sure your site is reconfigured properly.  Change to the top directory of your Jekyll site (where the index.html and _config.yml are) and:
bundle install
which will install the packages in Gemfile.lock.

Typically, at this point you will be able to build or run your site - try:
bundle exec jekyll serve --trace
Check the output for errors and check your site at http://127.0.0.1:4000/ - it should run normally.

Troubleshooting

With some upgrades there will be issues.  This could be because there are Ruby changes that are not backward compatible.  In this case it is likely that Jekyll will have also been updated - check jekyllrb.com.  Also, possibly some packages you have chosen to use will not have been updated and may be deprecated.  You should be able to see which packages have failed in the trace, then go to their (typically GitHub) pages to see if there is a remedy.

Comments

Post a Comment

Popular posts from this blog

TEX on Linux

Image
This is not really a Web Dev tip, but I thought it worth quickly noting for those who have a need to produce properly formatted mathematical (and other) high quality textual output on Linux. T E X  is a typesetting system - it lets you format text at the quality of a formal publication like a book, magazine or journal, including complex text formats like equations.  It includes a ( Turing-complete ) language making it extremely powerful. Installing it to use on Linux, is not difficult, however installing MiKTeX with TexWorks  on Ubuntu/Pop!_OS 19.10 as I have requires some additional steps. MiKTeX MiKTeX is a system that brings together a large set of  T E X  related programs.  One system that comes bundled with it is TexWorks.  Using these two works well for normal mathematical formulae that I've tested. TexWorks TexWorks is a convenient  T E X  editor.  You can write your  T E X  and immediately create PDF output...
Read more

Freeze Changing HTML Element in Chrome Developer Tools

Some websites have elements attached to code that changes them dynamically, so that it is not effectively possible to view its source - e.g. notion.so . To freeze the elements in the Developer Tools windows: Open the Developer Tools windows from the top-right “3 vertical dot” menu → More tools → Developer tools, or Ctrl+Shift+i (Window/Linux) or Option+⌘+J (Mac) Select the Sources tab in Developer Tools In the browser, hover over the element concerned (don’t click) Press F8 (Windows/Linux) or FN+F8 (Mac) Go to the Elements tab in Developer Tools The elements will be paused. It will be possible to expand the elements and see the frozen source. (From stackoverflow )
Read more

Change Unix terminal Title

Changing the Terminal Window Title Text To change Linux (and perhaps other systems) Terminal windows' titles, you must use escape codes as follows: printf "\e]2;YOUR TITLE GOES HERE\a" If you execute this in a terminal session, it will change the title of the terminal to “YOUR TITLE GOES HERE” If you omit a title string (i.e. use printf "\e]2;\a" ), the title will default to “Terminal”. Correcting PS1 From Resetting The Title There is one situation in which the above may seem not to work: when the screen title is set within the Unix prompt construction. How The Unix Terminal Prompt is Set The in a Shell , the PS1   environment variable controls what texts is shown at the prompt. Every time a shell command completes and the prompt is shown, PS1 is evaluated. Since it is a shell variable, anything that can be done in the context of shell variables is possible with the PS1 prompt - in fact arbitrary shell code is possible to be run dur...
Read more