Devcontainer support

.devcontainer/Dockerfile

@@ -0,0 +1,57 @@
+# Use AlmaLinux as the base image
+FROM almalinux:latest
+
+# Update and install necessary packages
+RUN dnf update -y && \
+    dnf install -y \
+    git \
+    python3 \
+    python3-pyyaml \
+    wget \
+    tar \
+    shadow-utils \
+    sudo \
+    && dnf clean all
+
+# Set up arguments for Hugo installation
+ARG HUGO_VERSION=latest
+ARG HUGO_VARIANT=hugo_extended
+ARG WORKSPACE_DIR
+
+# Download and install Hugo
+RUN if [ "$HUGO_VERSION" = "latest" ]; then \
+    HUGO_VERSION=$(curl -s https://api.github.com/repos/gohugoio/hugo/releases/latest | grep "tag_name" | awk '{print substr($2, 3, length($2)-4)}'); \
+    fi && \
+    ARCH=$(uname -m) && \
+    case "$ARCH" in \
+    "x86_64") HUGO_ARCH="64bit";; \
+    "arm64"|"aarch64") HUGO_ARCH="arm64";; \
+    *) echo "Unsupported architecture: $ARCH" && exit 1;; \
+    esac && \
+    echo "Installing Hugo version: ${HUGO_VERSION}" && \
+    wget -O hugo.tar.gz https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/${HUGO_VARIANT}_${HUGO_VERSION}_Linux-${HUGO_ARCH}.tar.gz && \
+    tar -xzf hugo.tar.gz && \
+    mv hugo /usr/local/bin/hugo && \
+    chmod +x /usr/local/bin/hugo && \
+    rm hugo.tar.gz
+
+# Create a non-root user for development
+ARG USERNAME=vscode
+ARG USER_UID=1000
+ARG USER_GID=$USER_UID
+
+RUN groupadd --gid $USER_GID $USERNAME \
+    && useradd --uid $USER_UID --gid $USER_GID -m $USERNAME \
+    && echo $USERNAME ALL=\(root\) NOPASSWD:ALL > /etc/sudoers.d/$USERNAME \
+    && chmod 0440 /etc/sudoers.d/$USERNAME
+
+USER vscode
+
+# Expose port for Hugo server
+EXPOSE 1313
+
+# Set the working directory to the container workspace directory
+WORKDIR ${WORKSPACE_DIR}
+
+ENTRYPOINT ["hugo", "server"]
+CMD ["--bind=0.0.0.0"]

.devcontainer/README.md

@@ -0,0 +1,23 @@
+### Devcontainer Features:
+
+- VSCode Extensions: Automatically installs the following extensions for optimal Hugo development:
+  _budparr.language-hugo-vscode - Hugo syntax support
+  ms-python.python - Python development support
+  esbenp.prettier-vscode - Code formatting
+  yzhang.markdown-all-in-one - Enhanced Markdown editing
+  tamasfe.even-better-toml - TOML language support_
+
+- **Terminal Configuration:** Sets the integrated terminal to /bin/bash for a familiar shell experience.
+- **Port Forwarding:** Configures port 1313 to be forwarded for Hugo's live server.
+- **User Configuration:** Sets remoteUser to vscode, providing a secure, non-root user environment.
+
+### Dockerfile Setup:
+
+- **Base Image:** Utilizes the latest AlmaLinux image for compatibility and security.
+- **System Updates:** Ensures all system packages are up-to-date.
+- **Software Installation:** Includes essential tools like git, python3, python3-pyyaml, wget, tar, shadow-utils, and sudo.
+- **Hugo Installation:** Fetches and installs the latest Hugo extended binary for dynamic site generation.
+- **User Management:** Creates and configures a vscode user with sudo privileges to enhance security and usability.
+- **Port Exposure:** Exposes port 1313 to allow Hugo's development server to be accessed externally.
+
+This setup aims to streamline the development process by automating the environment setup, ensuring consistency across different machines, and reducing the time spent on configuration. Please review and provide feedback or approval to merge.

.devcontainer/devcontainer.json

@@ -0,0 +1,37 @@
+{
+  "name": "AlmaLinux_WWW_Container",
+  "overrideCommand": false,
+  "build": {
+    "dockerfile": "Dockerfile",
+    "args": {
+      "VARIANT": "hugo",
+      "VERSION": "latest",
+      "WORKSPACE_DIR": "${containerWorkspaceFolder}"
+    }
+  },
+
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "budparr.language-hugo-vscode",
+        "ms-python.python",
+        "esbenp.prettier-vscode",
+        "yzhang.markdown-all-in-one",
+        "tamasfe.even-better-toml",
+        "ms-azuretools.vscode-docker"
+      ],
+      "settings": {
+        "terminal.integrated.defaultProfile.linux": "bash",
+        "terminal.integrated.profiles.linux": {
+          "bash": {
+            "path": "/bin/bash",
+            "icon": "terminal-bash"
+          }
+        }
+      }
+    }
+  },
+  "forwardPorts": [1313],
+  "remoteUser": "vscode",
+  "postCreateCommand": "echo 'function git_branch() { local branch; branch=\"$(git symbolic-ref --short HEAD 2> /dev/null)\"; if [[ -n \"$branch\" ]]; then echo -n \"$branch\"; return 0; fi; return 1; } && function git_has_changes() { git diff --quiet HEAD 2> /dev/null || echo -n \"✗\"; } && export WHITE=\"\\[\\033[1;37m\\]\" && export GREEN=\"\\[\\033[0;32m\\]\" && export BLUE=\"\\[\\033[0;94m\\]\" && export RED=\"\\[\\033[1;31m\\]\" && export YELLOW=\"\\[\\033[1;33m\\]\" && export RESET=\"\\[\\033[0m\\]\" && function prompt_command() { PS1=\"${GREEN}\\u${WHITE} ➜ ${BLUE}\\w ${BLUE}(${RED}\\$(git_branch)${YELLOW}\\$(git_has_changes)${BLUE})${RESET}$ \"; } && export PROMPT_COMMAND=\"prompt_command\"' >> ~/.bashrc"
+}