Merge #1184: contrib: add a Dockerfile to run the website locally

414b2cf contrib: add a Dockerfile to run the website locally (Antoine Poinsot)

Pull request description:

  It was useful to me, so i cleaned it up and PR'd it in case others do not have a full Ruby toolchain installed, but do have Docker.

ACKs for top commit:
  stickies-v:
    ACK 414b2cf - thanks for addressing my comments!
  glozow:
    ACK 414b2cf, this is super useful for testing changes

Tree-SHA512: d2dbad99d5e69301348d6bffdd6dd690b35a6d9f7e25af1c03dd81b042ce96d396143d9eb5bce60ca0de8177e37c71aaf2ec36841243749bdc248744b986b097

Author: glozow

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,17 @@
+FROM ruby:3.1.2
+
+ENV NOKOGIRI_USE_SYSTEM_LIBRARIES=true
+ENV JEKYLL_ENV=production
+ENV RUBYOPT="-KU -E utf-8:utf-8"
+
+WORKDIR /site
+
+COPY Gemfile* .
+
+RUN gem install bundler \
+    && bundle install
+
+# Default Jekyll port
+EXPOSE 4000
+
+CMD ["bundle", "exec", "jekyll", "serve", "--future", "--drafts", "--unpublished", "--incremental", "--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.