diff --git a/Gemfile.lock b/Gemfile.lock
index 48851d2..6185950 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -112,7 +112,7 @@ GEM
nokogiri (>= 1.4)
htmlcompressor (0.4.0)
http_parser.rb (0.8.1)
- httparty (0.24.0)
+ httparty (0.24.2)
csv
mini_mime (>= 1.0.0)
multi_xml (>= 0.5.2)
@@ -141,7 +141,7 @@ GEM
safe_yaml (~> 1.0)
terminal-table (>= 1.8, < 4.0)
webrick (~> 1.7)
- jekyll-archives-v2 (0.0.6)
+ jekyll-archives-v2 (0.0.7)
activesupport
jekyll (>= 3.6, < 5.0)
jekyll-cache-bust (0.0.1)
@@ -198,7 +198,8 @@ GEM
kramdown (~> 2.0)
latex-decode (0.4.2)
liquid (4.0.4)
- listen (3.9.0)
+ listen (3.10.0)
+ logger
rb-fsevent (~> 0.10, >= 0.10.3)
rb-inotify (~> 0.9, >= 0.9.10)
logger (1.7.0)
@@ -325,4 +326,4 @@ DEPENDENCIES
ostruct
BUNDLED WITH
- 4.0.3
+ 4.0.4
diff --git a/INSTALL.md b/INSTALL.md
index 2c5ce34..94471eb 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -15,9 +15,12 @@
- [For project pages](#for-project-pages)
- [Enabling automatic deployment](#enabling-automatic-deployment)
- [Manual deployment to GitHub Pages](#manual-deployment-to-github-pages)
- - [Deploy on Netlify](https://www.netlify.com/)
+ - [Deploy on Netlify](#deploy-on-netlify)
- [Deployment to another hosting server (non GitHub Pages)](#deployment-to-another-hosting-server-non-github-pages)
- [Deployment to a separate repository (advanced users only)](#deployment-to-a-separate-repository-advanced-users-only)
+ - [Maintaining Dependencies](#maintaining-dependencies)
+ - [Updating the bundler itself](#updating-the-bundler-itself)
+ - [Updating all dependencies](#updating-all-dependencies)
- [Upgrading from a previous version](#upgrading-from-a-previous-version)
@@ -233,6 +236,33 @@ In its default configuration, al-folio will copy the top-level `README.md` to th
**Note:** Do _not_ run `jekyll clean` on your publishing source repo as this will result in the entire directory getting deleted, irrespective of the content of `keep_files` in `_config.yml`.
+## Maintaining Dependencies
+
+**al-folio** uses **Bundler** (a Ruby dependency manager) to keep track of all the Ruby packages (called "gems") needed to run Jekyll and its plugins. Over time, these packages may receive updates that include bug fixes, security patches, and new features.
+
+### Updating the bundler itself
+
+The bundler tool itself should be kept up to date. To update bundler to the latest version, run:
+
+```bash
+$ bundle update --bundler
+```
+
+### Updating all dependencies
+
+To update all Ruby gems to their latest compatible versions (as specified in your `Gemfile`), run:
+
+```bash
+$ bundle update --all
+```
+
+After updating dependencies, test your site locally to ensure everything still works correctly:
+
+- If using Docker: `docker compose up`
+- If using local setup: `bundle exec jekyll serve`
+
+> **Note:** Dependency updates may occasionally introduce breaking changes. If your site fails after updating, check the [FAQ](FAQ.md) for troubleshooting, or revert to the previous version with `bundle lock --add-platform ruby` and `git checkout Gemfile.lock`.
+
## Upgrading from a previous version
If you installed **al-folio** as described above, you can manually update your code by following the steps below:
@@ -241,7 +271,7 @@ If you installed **al-folio** as described above, you can manually update your c
# Assuming the current directory is
$ git remote add upstream https://github.com/alshedivat/al-folio.git
$ git fetch upstream
-$ git rebase v0.16.1
+$ git rebase v0.16.2
```
If you have extensively customized a previous version, it might be trickier to upgrade.
diff --git a/_books/the_godfather.md b/_books/the_godfather.md
index c0689e5..cc97f49 100644
--- a/_books/the_godfather.md
+++ b/_books/the_godfather.md
@@ -8,6 +8,7 @@ isbn: 7539967447 # use ISBN to fetch cover (if no `olid` is provided, dashes are
categories: classics crime historical-fiction mystery novels thriller
tags: top-100
buy_link: https://www.amazon.com/Godfather-Deluxe-Mario-Puzo/dp/0593542592
+date: 2024-08-23
started: 2024-08-23
finished: 2024-09-07
released: 1969
diff --git a/docker-compose.yml b/docker-compose.yml
index a51428c..2a0f8c7 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,7 +1,7 @@
# this file uses prebuilt image in dockerhub
services:
jekyll:
- image: amirpourmand/al-folio:v0.16.1
+ image: amirpourmand/al-folio:v0.16.2
build: .
# uncomment these if you are having this issue with the build:
# /usr/local/bundle/gems/jekyll-4.3.4/lib/jekyll/site.rb:509:in `initialize': Permission denied @ rb_sysopen - /srv/jekyll/.jekyll-cache/.gitignore (Errno::EACCES)