Merge pull request #1736 from ramalama-labs/feat/docs

Adds docs site

Author: rhatdan

docs/ramalama-macos.7.md

@@ -2,7 +2,7 @@
 
 # Configure Podman Machine on Mac for GPU Acceleration
 
-Leveraging GPU acceleration on a Mac with Podman requires the configurion of
+Leveraging GPU acceleration on a Mac with Podman requires the configuration of
 the `libkrun` machine provider.
 
 This can be done by either setting an environment variable or modifying the

docs/ramalama.1.md

@@ -27,18 +27,9 @@ RamaLama pulls AI Models from model registries. Starting a chatbot or a rest API
 
 When both Podman and Docker are installed, RamaLama defaults to Podman, The `RAMALAMA_CONTAINER_ENGINE=docker` environment variable can override this behaviour. When neither are installed RamaLama attempts to run the model with software on the local system.
 
-Note:
+Note: On MacOS systems that use Podman for containers, configure the Podman machine to use the `libkrun` machine provider. The `libkrun` provider enables containers within the Podman Machine access to the Mac's GPU. See **[ramalama-macos(7)](ramalama-macos.7.md)** for further information.
 
-On MacOS systems that use Podman for containers, configure the Podman machine
-to use the `libkrun` machine provider. The `libkrun` provider enables
-containers within the Podman Machine access to the Mac's GPU.
-See **[ramalama-macos(7)](ramalama-macos.7.md)** for further information.
-
-Note:
-
-On systems with NVIDIA GPUs, see **[ramalama-cuda(7)](ramalama-cuda.7.md)** to correctly configure the host system.
-
-Default settings for flags are defined in **[ramalama.conf(5)](ramalama.conf.5.md)**.
+Note: On systems with NVIDIA GPUs, see **[ramalama-cuda(7)](ramalama-cuda.7.md)** to correctly configure the host system. Default settings for flags are defined in **[ramalama.conf(5)](ramalama.conf.5.md)**.
 
 ## SECURITY
 
@@ -93,7 +84,7 @@ the model. The following table specifies the order which RamaLama reads the file
 | Administrators  | /etc/ramamala/shortnames.conf             |
 | Users           | $HOME/.config/ramalama/shortnames.conf    |
 
-```code
+```toml
 $ cat /usr/share/ramalama/shortnames.conf
 [shortnames]
   "tiny" = "ollama://tinyllama"

docs/readme/wsl2-podman-cuda.md

@@ -26,6 +26,7 @@ Follow the installation instructions provided in the [NVIDIA Container Toolkit i
 2. **Update the packages list from the repository:**
    ```bash
    sudo apt-get update
+   ```
 3. **Install the NVIDIA Container Toolkit packages:**
    ```bash
    sudo apt-get install -y nvidia-container-toolkit
@@ -47,9 +48,9 @@ Follow the installation instructions provided in the [NVIDIA Container Toolkit i
    Open and edit the NVIDIA container runtime configuration:
    ```bash
    nvidia-ctk cdi list
-     ```
-   **We Should See Something Like This**
    ```
+   **We Should See Something Like This**
+   ```bash
    INFO[0000] Found 1 CDI devices
    nvidia.com/gpu=all
    ```

docsite/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

docsite/Makefile

@@ -0,0 +1,51 @@
+# RamaLama Documentation Site Makefile
+# 
+# This Makefile provides commands for building and managing the RamaLama
+# documentation site powered by Docusaurus.
+
+.PHONY: help convert dev build serve clean install
+
+# Default target - show help
+help: ## Show this help message
+	@echo "RamaLama Documentation Site"
+	@echo "=========================="
+	@echo
+	@echo "Available commands:"
+	@echo
+	@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {printf "  \033[36m%-12s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
+	@echo
+
+convert: ## Convert manpages from ../docs to MDX format for docsite
+	@echo "Converting manpages to MDX format..."
+	@python3 convert_manpages.py
+	@echo "✅ Manpage conversion complete!"
+
+install: ## Install dependencies
+	@echo "Installing dependencies..."
+	@npm install
+	@echo "✅ Dependencies installed!"
+
+dev: ## Start the development server
+	@echo "Starting development server..."
+	@npm start
+
+build: ## Build the production site
+	@echo "Building production site..."
+	@npm run build
+	@echo "✅ Build complete! Output in ./build/"
+
+serve: ## Serve the built site locally
+	@echo "Serving built site locally..."
+	@npm run serve
+
+clean: ## Clean build artifacts and node_modules
+	@echo "Cleaning build artifacts..."
+	@rm -rf build .docusaurus node_modules
+	@echo "✅ Clean complete!"
+
+all: install convert build ## Install deps, convert manpages, and build site
+
+# Development workflow targets
+quick-dev: convert dev ## Convert manpages and start dev server
+
+rebuild: clean install convert build ## Full rebuild from scratch