Update Dockerfile

Author: sarpedondev

Dockerfile

@@ -1,76 +1,67 @@
 # =====================================================================================
 # STAGE 1: The "Builder"
-# This stage uses Node.js to download the source files and build the static site.
+# This stage uses Node.js and your local source files to build the static site.
 # =====================================================================================
 FROM node:18-alpine AS builder
 
-# Install git, which is required by some tools.
-RUN apk add --no-cache git
-
-# Install the necessary command-line tools globally.
-# gitbook-exporter: Downloads the Markdown source from a live GitBook site.
-# gitbook-cli: The official tool to build a static site from Markdown source.
-RUN npm install -g gitbook-exporter gitbook-cli
+# Install gitbook-cli, the official tool to build a static site from Markdown source.
+RUN npm install -g gitbook-cli
 
 # Set a working directory inside the container.
 WORKDIR /app
 
-# Run the exporter to download the source files from the live GitBook site.
-# This creates a directory named after the book, e.g., "nebula".
-RUN gitbook-exporter https://nebulaclient.gitbook.io/nebula/
-
-# Navigate into the newly created source directory.
-# The directory name is based on the book's title, so we use a wildcard.
-WORKDIR /app/nebula
+# Copy ALL your local files (Markdown, book.json, images, etc.) into the container.
+# This assumes the Dockerfile is at the root of your documentation source.
+COPY . .
 
-# Install the required plugins for the book (defined in its book.json).
+# Run "gitbook install" to download any plugins defined in your book.json.
 RUN gitbook install
 
-# Build the final, static HTML site.
-# This creates a "_book" directory containing all the files.
+# Run "gitbook build" to generate the final static HTML site.
+# This creates a "_book" directory containing all the files needed for hosting.
 RUN gitbook build
 
 # =====================================================================================
 # STAGE 2: The "Runner"
-# This stage uses a minimal NGINX server to host the static files.
+# This stage uses a minimal NGINX server to host the static files. It is the final image.
 # =====================================================================================
 FROM nginx:1.25-alpine
 
-# Set the port you want to expose.
+# Set the port to be used inside the container.
 ARG PORT=3587
 EXPOSE ${PORT}
 
-# Remove the default NGINX configuration file.
+# Remove the default NGINX configuration to avoid conflicts.
 RUN rm /etc/nginx/conf.d/default.conf
 
-# Copy the static HTML files generated in the "builder" stage
-# into the default NGINX web root directory.
-COPY --from=builder /app/nebula/_book /usr/share/nginx/html
+# Copy ONLY the built static HTML files from the "builder" stage
+# into the NGINX web root directory. This keeps the final image small.
+COPY --from=builder /app/_book /usr/share/nginx/html
 
-# Copy our custom NGINX configuration.
-# This config tells NGINX to listen on our chosen port and serve the static files.
+# Create our simple NGINX configuration to serve the static site.
+# This is placed directly into the configuration directory.
 COPY <<EOF /etc/nginx/conf.d/gitbook.conf
 server {
+    # Listen on the port specified during the build.
     listen ${PORT};
     server_name _;
 
     # The root directory where our static files are located.
     root /usr/share/nginx/html;
     index index.html index.htm;
 
-    # Standard configuration for serving static files.
-    # It tries to find a file matching the URI, then a directory,
-    # and finally falls back to the index.html for clean URLs.
+    # This is the crucial part for GitBook's "clean URLs".
+    # It allows you to visit /my-page instead of /my-page.html.
     location / {
         try_files \$uri \$uri/ /index.html;
     }
 
-    # Optional: Add headers for security and caching.
+    # Standard security headers.
     add_header X-Frame-Options "SAMEORIGIN";
     add_header X-Content-Type-Options "nosniff";
     add_header X-XSS-Protection "1; mode=block";
 }
 EOF
 
-# Command to run NGINX in the foreground.
+# The command to start the NGINX server when the container runs.
 CMD ["nginx", "-g", "daemon off;"]