diff --git a/.github/workflows/axe.yml b/.github/workflows/axe.yml index a745c7d..46d117f 100644 --- a/.github/workflows/axe.yml +++ b/.github/workflows/axe.yml @@ -45,7 +45,7 @@ jobs: run: | pip3 install --upgrade jupyter export JEKYLL_ENV=production - bundle exec jekyll build --lsi + bundle exec jekyll build - name: Purge unused CSS 🧹 run: | npm install -g purgecss diff --git a/.github/workflows/broken-links-site.yml b/.github/workflows/broken-links-site.yml index fae797c..d85270f 100644 --- a/.github/workflows/broken-links-site.yml +++ b/.github/workflows/broken-links-site.yml @@ -33,7 +33,7 @@ jobs: run: | pip3 install --upgrade jupyter export JEKYLL_ENV=production - bundle exec jekyll build --lsi + bundle exec jekyll build - name: Purge unused CSS 🧹 run: | npm install -g purgecss diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml index 1c19625..046ee0d 100644 --- a/.github/workflows/deploy.yml +++ b/.github/workflows/deploy.yml @@ -81,7 +81,7 @@ jobs: run: | pip3 install --upgrade jupyter export JEKYLL_ENV=production - bundle exec jekyll build --lsi + bundle exec jekyll build - name: Purge unused CSS 🧹 run: | npm install -g purgecss diff --git a/CUSTOMIZE.md b/CUSTOMIZE.md index 19c260a..7c63511 100644 --- a/CUSTOMIZE.md +++ b/CUSTOMIZE.md @@ -40,7 +40,7 @@ The configuration file [\_config.yml](_config.yml) contains the main configurati > Note that the `url` and `baseurl` settings are used to generate the links of the website, as explained in the [install instructions](INSTALL.md). -All changes made to this file are only visible after you rebuild the website. That means that you need to run `bundle exec jekyll serve --lsi` again if you are running the website locally or push your changes to GitHub if you are using GitHub Pages. All other changes are visible immediately, you only need to refresh the page. +All changes made to this file are only visible after you rebuild the website. That means that you need to run `bundle exec jekyll serve` again if you are running the website locally or push your changes to GitHub if you are using GitHub Pages. All other changes are visible immediately, you only need to refresh the page. ## Modifying the CV information diff --git a/FAQ.md b/FAQ.md index 8ce3ef1..d6faca5 100644 --- a/FAQ.md +++ b/FAQ.md @@ -40,7 +40,7 @@ Make sure to correctly specify the `url` and `baseurl` paths in `_config.yml`. R #### My site doesn't work when I enable `related_blog_posts`. Why? -This is probably due to the [classifier reborn](https://github.com/jekyll/classifier-reborn) plugin, which is used to calculate related posts. If the error states `Liquid Exception: Zero vectors can not be normalized...` or `sqrt': Numerical argument is out of domain - "sqrt"`, it means that it could not calculate related posts for a specific post. This is usually caused by [empty or minimal blog posts](https://github.com/jekyll/classifier-reborn/issues/64) without meaningful words (i.e. only [stop words](https://en.wikipedia.org/wiki/Stop_words)) or even [specific characters](https://github.com/jekyll/classifier-reborn/issues/194) you used in your posts. Also, the calculus for similar posts are made for every `post`, which means every page that uses `layout: post`, including the announcements. To change this behavior, simply add `related_posts: false` to the front matter of the page you don't want to display related posts on. Another solution is to disable the lsi (latent semantic indexing) entirely by removing the `--lsi` flag in the code. Related issue: [#1828](https://github.com/alshedivat/al-folio/issues/1828). +This is probably due to the [classifier reborn](https://github.com/jekyll/classifier-reborn) plugin, which is used to calculate related posts. If the error states `Liquid Exception: Zero vectors can not be normalized...` or `sqrt': Numerical argument is out of domain - "sqrt"`, it means that it could not calculate related posts for a specific post. This is usually caused by [empty or minimal blog posts](https://github.com/jekyll/classifier-reborn/issues/64) without meaningful words (i.e. only [stop words](https://en.wikipedia.org/wiki/Stop_words)) or even [specific characters](https://github.com/jekyll/classifier-reborn/issues/194) you used in your posts. Also, the calculus for similar posts are made for every `post`, which means every page that uses `layout: post`, including the announcements. To change this behavior, simply add `related_posts: false` to the front matter of the page you don't want to display related posts on. Another solution is to disable the lsi (latent semantic indexing) entirely by setting the `lsi` flag to `false` in `_config.yml`. Related issue: [#1828](https://github.com/alshedivat/al-folio/issues/1828). #### When trying to deploy, it's asking for github login credentials, which github disabled password authentication and it exits with an error. How to fix? diff --git a/INSTALL.md b/INSTALL.md index 62ec84a..8b39920 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -3,8 +3,8 @@ - [Table of Contents](#table-of-contents) - [Installing and Deploying](#installing-and-deploying) - [Recommended Approach](#recommended-approach) - - [Local Setup on Windows](#local-setup-on-windows) - - [Local Setup using Docker (Recommended)](#local-setup-using-docker-recommended) + - [Local setup on Windows](#local-setup-on-windows) + - [Local setup using Docker (Recommended)](#local-setup-using-docker-recommended) - [Build your own docker image](#build-your-own-docker-image) - [Local Setup with Development Containers](#local-setup-with-development-containers) - [Local Setup (Legacy, no longer supported)](#local-setup-legacy-no-longer-supported) @@ -91,7 +91,7 @@ Assuming you have [Ruby](https://www.ruby-lang.org/en/downloads/) and [Bundler]( $ bundle install # assuming pip is your Python package manager $ pip install jupyter -$ bundle exec jekyll serve --lsi +$ bundle exec jekyll serve ``` To see the template running, open your browser and go to `http://localhost:4000`. You should see a copy of the theme's [demo website](https://alshedivat.github.io/al-folio/). Now, feel free to customize the theme however you like. After you are done, remember to **commit** your final changes. @@ -135,7 +135,7 @@ If you need to manually re-deploy your website to GitHub pages, go to Actions, c If you decide to not use GitHub Pages and host your page elsewhere, simply run: ```bash -$ bundle exec jekyll build --lsi +$ bundle exec jekyll build ``` which will (re-)generate the static webpage in the `_site/` folder. @@ -163,7 +163,7 @@ Firstly, from the deployment repo dir, checkout the git branch hosting your publ Then from the website sources dir (commonly your al-folio fork's clone): ```bash -$ bundle exec jekyll build --lsi --destination $HOME/repo/publishing-source +$ bundle exec jekyll build --destination $HOME/repo/publishing-source ``` This will instruct jekyll to deploy the website under `$HOME/repo/publishing-source`. diff --git a/bin/cibuild b/bin/cibuild index 14cfabe..d5c9e19 100755 --- a/bin/cibuild +++ b/bin/cibuild @@ -1 +1 @@ -bundle exec jekyll build --lsi +bundle exec jekyll build diff --git a/bin/deploy b/bin/deploy index 0bf8ed5..c72abbc 100755 --- a/bin/deploy +++ b/bin/deploy @@ -93,7 +93,7 @@ git checkout -b $DEPLOY_BRANCH export JEKYLL_ENV=production # Build site -bundle exec jekyll build --lsi +bundle exec jekyll build # Purge unused css purgecss -c purgecss.config.js