Commit 7b2e2ab0 authored by Alexander Rosenberg's avatar Alexander Rosenberg

Hide manual dependency workaround needed for Liquid 4.0.3 and below

parent 2a6fe510
...@@ -17,12 +17,18 @@ code examples are provided under the [MIT](https://opensource.org/licenses/MIT) ...@@ -17,12 +17,18 @@ code examples are provided under the [MIT](https://opensource.org/licenses/MIT)
### Install build tools and dependencies. ### Install build tools and dependencies.
<details>
<summary>Liquid 4.0.3</summary>
> [!WARNING] > [!WARNING]
> Due to Liquid not being updated to work with Ruby 3.2.x, **make sure you have Ruby 3.1.x or older installed**. > If you have the latest dependencies installed, the following does not apply anymore.
>
> The original `jekyll-rtd-theme` 2.0.10 required `github-pages` 209, which effectively capped the version of Liquid to 4.0.3.
> Due to Liquid 4.0.3 and older not being updated to work with Ruby 3.2.x, Ruby 3.1.x or older was required for Liquid 4.0.3.
> https://talk.jekyllrb.com/t/liquid-4-0-3-tainted/7946/18 > https://talk.jekyllrb.com/t/liquid-4-0-3-tainted/7946/18
> >
> #### With Cygwin > #### With Cygwin
> As of this writing (8/8/2024), Cygwin provides Ruby versions 2.6.4-1 and 3.2.2-2. Make sure to install the former. Additionally, the version of bundler supplied with Ruby 2.6 is too old and the version of RubyGems is too new. *After installing the following dependencies*, you must then install the correct versions of RubyGems and bundler manually: > As of 8/8/2024, Cygwin provided Ruby versions 2.6.4-1 and 3.2.2-2. You would need to make sure to install the former. As the version of bundler supplied with Ruby 2.6 is too old and the version of RubyGems is too new, the correct versions of RubyGems and bundler would need to be installed manually after installing all the other dependencies:
> ``` > ```
> gem update --system 3.2.3 > gem update --system 3.2.3
> gem install bundler -v 2.1.4 > gem install bundler -v 2.1.4
...@@ -31,6 +37,8 @@ code examples are provided under the [MIT](https://opensource.org/licenses/MIT) ...@@ -31,6 +37,8 @@ code examples are provided under the [MIT](https://opensource.org/licenses/MIT)
> bundler -v > bundler -v
> ``` > ```
</details>
To allow building of native extensions, install `ruby-devel`, `gcc`, and `make`. To allow building of native extensions, install `ruby-devel`, `gcc`, and `make`.
Install `libxml2`, `libxml2-devel`, `libxslt`, `libxslt-devel`, `libiconv`, Install `libxml2`, `libxml2-devel`, `libxslt`, `libxslt-devel`, `libiconv`,
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment