enable devcontainer with updating Dockerfile.

Signed-off-by: Tomoya Fujita <tomoya.fujita825@gmail.com>

Author: fujitatomoya

.devcontainer/devcontainer.json

@@ -0,0 +1,36 @@
+{
+	"name": "Zenoh Web Documentation",
+	"build": {
+		"dockerfile": "../docker/Dockerfile",
+		"args": {
+			"user": "vscode",
+			"uid": "1000"
+		}
+	},
+	"workspaceMount": "source=${localWorkspaceFolder},target=/src,type=bind",
+	"workspaceFolder": "/src",
+	"features": {
+		"ghcr.io/devcontainers/features/git:1": {}
+	},
+	"forwardPorts": [1313],
+	"portsAttributes": {
+		"1313": {
+			"label": "Hugo Server",
+			"onAutoForward": "notify"
+		}
+	},
+	"customizations": {
+		"vscode": {
+			"extensions": [
+				"ritwickdey.LiveServer",
+				"budparr.language-hugo-vscode",
+				"davidanson.vscode-markdownlint"
+			],
+			"settings": {
+				"terminal.integrated.defaultProfile.linux": "bash"
+			}
+		}
+	},
+	"postCreateCommand": "hugo version",
+	"remoteUser": "vscode"
+}

.github/workflows/deploy-website.yml

@@ -18,7 +18,7 @@ jobs:
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v2
         with:
-          hugo-version: '0.102.1'
+          hugo-version: '0.145.0'
           # extended: true
 
       - name: Build

README.md

@@ -4,6 +4,31 @@ The website for the Eclipse zenoh project. Lives at [http://zenoh.io](https://ze
 
 ## Getting Started
 
+### Using Dev Container (Recommended)
+
+The easiest way to develop the Zenoh web documentation is using VS Code Dev Containers, which provides a consistent development environment without installing Hugo locally.
+
+**Prerequisites:**
+
+- [Docker](https://www.docker.com/get-started) installed and running
+- [Visual Studio Code](https://code.visualstudio.com/)
+- [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) for VS Code
+
+**Steps:**
+
+1. Open this repository in VS Code
+2. When prompted, click "Reopen in Container" (or press F1 and select "Dev Containers: Reopen in Container")
+3. VS Code will build the Docker container and set up the development environment
+4. Once ready, run the development server:
+
+   ```bash
+   hugo server
+   ```
+
+5. Visit [http://localhost:1313](http://localhost:1313)
+
+### Local Hugo Installation
+
 The website should build with the latest version of Hugo, the last tested is [Hugo 0.145.0](http://gohugo.io). 
 On MacOS you can install Hugo as described below, in any case refer to [Hugo Documentation](http://gohugo.io) 
 for installation instructioins
@@ -22,6 +47,18 @@ hugo server
 
 Then visit [http://localhost:1313](http://localhost:1313).
 
+### Using Docker Directly
+
+If you prefer to use Docker without VS Code:
+
+```bash
+# Build the Docker image
+docker build -f docker/Dockerfile --build-arg user=$(id -un) --build-arg uid=$(id -u) -t zenoh_web .
+
+# Run the development server
+docker run --rm -v $(pwd):/src -p 1313:1313 zenoh_web
+```
+
 ## License
 
 This project is licensed under the [Eclipse Public License 2.0](LICENSE)

docker/Dockerfile

@@ -1,19 +1,49 @@
-FROM alpine:latest
+# This dockerfile is expecting to be run with the following build command
+# (from the root of the git repository):
+#
+# $ docker build -f docker/Dockerfile -t zenoh_web .
+#
+# Then, to use the image to build the docs:
+#
+# $ docker run --rm -v $(pwd):/src -p 1313:1313 zenoh_web
 
-RUN apk add --no-cache \
-    curl \
-    git
+FROM ubuntu:noble
+
+ARG user=hugo
+ARG uid=1000
+
+ENV DEBIAN_FRONTEND=noninteractive
+ENV SHELL=/bin/bash
+
+# Delete user if it exists in container (e.g Ubuntu Noble: ubuntu)
+RUN if id -u $uid ; then userdel `id -un $uid` ; fi
+
+RUN apt-get update && \
+    apt-get install --no-install-recommends -y \
+        curl \
+        git \
+        ca-certificates \
+        locales && \
+    rm -rf /var/lib/apt/lists/*
+
+RUN locale-gen en_US en_US.UTF-8
+RUN update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8
+ENV LANG=en_US.UTF-8
+
+RUN useradd -u $uid -m $user
+
+ENV HOME=/home/$user
+ENV VERSION=0.145.0
 
-ENV VERSION 0.88.1
 RUN mkdir -p /usr/local/src \
     && cd /usr/local/src \
-
-    && curl -L https://github.com/gohugoio/hugo/releases/download/v${VERSION}/hugo_${VERSION}_linux-64bit.tar.gz | tar -xz \
+    && curl -L https://github.com/gohugoio/hugo/releases/download/v${VERSION}/hugo_${VERSION}_linux-amd64.tar.gz | tar -xz \
     && mv hugo /usr/local/bin/hugo \
+    && chmod +x /usr/local/bin/hugo
 
-    && addgroup -Sg 1000 hugo \
-    && adduser -SG hugo -u 1000 -h /src hugo
-
+USER $user
 WORKDIR /src
 
 EXPOSE 1313
+
+CMD ["hugo", "server"]