Add a dockerfile, document its usage in the readme (#260)

2 files changed, 34 insertions, 0 deletions

diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 000000000..ff2baef4f
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,13 @@
+FROM node:buster
+
+RUN apt-get update -y \
+ && apt-get install -y --no-install-recommends \
+    bundler \
+    ruby \
+    ruby-dev \
+    \
+    fontforge \
+    woff-tools \
+    woff2
+
+CMD bash
diff --git a/README.md b/README.md
index 0e86552d5..f7cb4ef3b 100644
--- a/README.md
+++ b/README.md
@@ -88,6 +88,27 @@ Or serve it on a local server on http://localhost:7998:
 
     $ npm run dev
 
+### Build the font in a Docker container
+
+Another possibility is to build the font using the Dockerfile provided.
+
+First, build the Docker image:
+
+    $ docker build -t fa-builder .
+
+Then, run the Docker container:
+
+    $ docker run --rm -it \
+        -u $(id -u):$(id -g) \
+        -v $(pwd):$(pwd) \
+        -w $(pwd) \
+        fa-builder
+
+Within the container, build the font:
+
+    $ bundle install --path vendor/bundle
+    $ npm ci
+    $ make -C src/icons
 
 <!--- reference links for badges -->
 [all-contrib]: https://img.shields.io/badge/all_contributors-125-orange.svg?style=flat-square "All Contributors badge"