contrib: add a Dockerfile to run the website locally

Co-Authored-By: stickies-v <[email protected]>

Author: darosior

README.md

@@ -42,7 +42,8 @@ permalink: /en/2016/01/01/short-title
 
 This website is based on [Jekyll](https://jekyllrb.com/).  To build
 locally, [install Ruby 3.1.2](https://gorails.com/setup) using system
-packages, [rvm](https://rvm.io), [rbenv](https://github.com/rbenv/rbenv), or another method.
+packages, [rvm](https://rvm.io), [rbenv](https://github.com/rbenv/rbenv), or another method. An
+alternative is to use Docker, for which instructions are available [here](./contrib/devtools/).
 Then clone this repository and change directory into it:
 
     git clone https://github.com/bitcoin-core/bitcoincore.org.git

contrib/devtools/Dockerfile

@@ -0,0 +1,19 @@
+FROM ruby:3.1.2
+
+ENV NOKOGIRI_USE_SYSTEM_LIBRARIES=true
+ENV JEKYLL_ENV=production
+ENV RUBYOPT="-KU -E utf-8:utf-8"
+
+RUN apt update && apt install -y make
+
+WORKDIR /site
+
+COPY Gemfile* .
+
+RUN gem install bundler \
+    && bundle install
+
+# Default Jekyll port
+EXPOSE 4000
+
+CMD ["bundle", "exec", "jekyll", "serve", "--future", "--drafts", "--unpublished", "--strict_front_matter", "--host", "0.0.0.0"]

contrib/devtools/README.md

@@ -24,3 +24,20 @@ gribble (18)
 | luke-jr         | [Luke Dashjr][]           |
 [...]
 ```
+
+Dockerfile
+==========
+
+Run the website locally without having to install the dependencies on your machine.
+
+To build the image (from the root of the repository):
+```
+docker build -f ./contrib/devtools/Dockerfile -t corewebsite .
+```
+
+Then the container can be run like so:
+```
+docker run -it --rm -v "$PWD":/site -p 4000:4000 corewebsite
+```
+
+And the website can be accessed at https://localhost:4000.