Change EDF snippets to 'toml'

Author: gwangmu

docs/software/container-engine/edf.md

@@ -13,12 +13,12 @@ If not specified, the default value is an empty value of the corresponding type.
 
 !!! example
      * Single environment inheritance:
-        ```bash
+        ```toml
         base_environment = "common_env"
         ```
 
      * Multiple environment inheritance:
-        ```bash
+        ```toml
         base_environment = ["common_env", "ml_pytorch_env1"]
         ```
 
@@ -33,27 +33,27 @@ If not specified, the default value is an empty value of the corresponding type.
 
 !!! example
      * Reference of Ubuntu image in the Docker Hub registry (default registry)
-        ```bash
+        ```toml
         image = "library/ubuntu:24.04"
         ```
 
      * Explicit reference of Ubuntu image in the Docker Hub registry
-        ```bash
+        ```toml
         image = "docker.io#library/ubuntu:24.04"
         ```
 
      * Reference to PyTorch image from NVIDIA Container Registry (nvcr.io)
-        ```bash
+        ```toml
         image = "nvcr.io#nvidia/pytorch:22.12-py3"
         ```
 
      * Image from third-party quay.io registry
-        ```bash
+        ```toml
         image = "quay.io#madeeks/osu-mb:6.2-mpich4.1-ubuntu22.04-arm64"
         ```
 
      * Reference to a manually pulled image stored in parallel FS
-        ```bash
+        ```toml
         image = "/path/to/image.squashfs"
         ```
 
@@ -70,11 +70,11 @@ If not specified, the default value is an empty value of the corresponding type.
 
 !!! example
      * Workdir pointing to a user defined project path 
-        ```bash
+        ```toml
         workdir = "/home/user/projects"
         ```
      * Workdir pointing to the `/tmp` directory
-        ```bash
+        ```toml
         workdir = "/tmp"
         ```
 
@@ -83,7 +83,7 @@ If not specified, the default value is an empty value of the corresponding type.
 (BOOL) If true, run the entrypoint from the container image. Default: true.
 
 !!! example
-    ```bash
+    ```toml
     entrypoint = false
     ```
 
@@ -92,7 +92,7 @@ If not specified, the default value is an empty value of the corresponding type.
 (BOOL) If false, the container filesystem is read-only. Default: true.
 
 !!! example
-    ```bash
+    ```toml
     writable = true
     ```
 
@@ -102,17 +102,17 @@ If not specified, the default value is an empty value of the corresponding type.
 
 !!! example
      * Literal fixed mount map
-        ```bash
+        ```toml
         mounts = ["/capstor/scratch/cscs/amadonna:/capstor/scratch/cscs/amadonna"]
         ```
 
      * Mapping path with `env` variable expansion
-        ```bash
+        ```toml
         mounts = ["/capstor/scratch/cscs/${USER}:/capstor/scratch/cscs/${USER}"]
         ```
 
      * Mounting the scratch filesystem using a host environment variable
-        ```bash
+        ```toml
         mounts = ["${SCRATCH}:/scratch"]
         ```
 
@@ -128,14 +128,14 @@ Environment variables to set in the container. Empty string values will unset th
 
 !!! example
      * Basic `env` block
-        ```bash
+        ```toml
         [env]
         MY_RUN = "production",
         DEBUG = "false"
         ```
 
      * Use of environment variable expansion
-        ```bash
+        ```toml
         [env]
         MY_NODE = "${VAR_FROM_HOST}",
         PATH = "${PATH}:/custom/bin", 
@@ -154,20 +154,20 @@ OCI-like annotations for the container. For more details, refer to the [Annotati
 !!! example
 
      * Disabling the CXI hook
-        ```bash
+        ```toml
         [annotations]
         com.hooks.cxi.enabled = "false"
         ```
 
      * Control of SSH hook parameters via annotation and variable expansion
-        ```bash
+        ```toml
         [annotations.com.hooks.ssh]
         authorize_ssh_key = "/capstor/scratch/cscs/${USER}/tests/edf/authorized_keys"
         enabled = "true"
         ```
 
      * Alternative example for usage of annotation with fixed path
-        ```bash
+        ```toml
         [annotations]
         com.hooks.ssh.authorize_ssh_key = "/path/to/authorized_keys"
         com.hooks.ssh.enabled = "true"

docs/software/container-engine/index.md

@@ -32,7 +32,7 @@ Save this file below as `ubuntu.toml` in `${HOME}/.edf` directory (the default
 Create `${HOME}/.edf` if the folder doesn't exist.
 A more detailed explanation of each entry for the EDF can be seen in the [EDF reference][ref-ce-edf-reference].
 
-```bash
+```toml
 image = "library/ubuntu:24.04"
 mounts = ["/capstor/scratch/cscs/${USER}:/capstor/scratch/cscs/${USER}"]
 workdir = "/capstor/scratch/cscs/${USER}"

docs/software/container-engine/resource-hook.md

@@ -33,19 +33,19 @@ This can be done in multiple ways in TOML: for example, both of the following us
 
      * Attributes can be added to a table only in one place in the TOML file. In other words, each table must be defined in a single square bracket section. For example, in the invalid example below, the `ssh` table was doubly defined both in the `[annotations]` and in the `[annotations.com.hooks.ssh]` sections. See the [TOML format](https://toml.io/en/) spec for more details.
 
-        ```bash title="Valid"
+        ```toml title="Valid"
         [annotations.com.hooks.ssh]
         authorize_ssh_key = "${SCRATCH}/tests/edf/authorized_keys"
         enabled = "true"
         ```
 
-        ```bash title="Valid"
+        ```toml title="Valid"
         [annotations]
         com.hooks.ssh.authorize_ssh_key = "${SCRATCH}/tests/edf/authorized_keys"
         com.hooks.ssh.enabled = "true"
         ```
 
-        ```bash title="Invalid"
+        ```toml title="Invalid"
         [annotations]
         com.hooks.ssh.authorize_ssh_key = "${SCRATCH}/tests/edf/authorized_keys"
 
@@ -69,7 +69,7 @@ Container hooks let you customize container behavior to fit system-specific need
 [](){#ref-ce-cxi-hook}
 ### HPE Slingshot interconnect 
 
-```bash
+```toml
 com.hooks.cxi.enabled = "true"
 ```
 
@@ -167,7 +167,7 @@ The hook is activated by setting the `com.hooks.cxi.enabled` annotation, which
 [](){#ref-ce-aws-ofi-hook}
 ### AWS OFI NCCL Hook 
 
-```bash
+```toml
 com.hooks.aws_ofi_nccl.enabled = "true"
 com.hooks.aws_ofi_nccl.variant = "cuda12"   # (1)
 ```
@@ -187,7 +187,7 @@ At the moment of writing, 4 plugin variants are configured: `cuda11`, `cuda12`
     It sets environment variables to control the behavior of NCCL and the libfabric CXI provider for Slingshot. In particular, the `NCCL_NET_PLUGIN` variable ([link](https://docs.nvidia.com/deeplearning/nccl/user-guide/docs/env.html#nccl-net-plugin)) is set to force NCCL to load the specific network plugin mounted by the hook. This is useful because certain container images (for example, those from NGC repositories) might already ship with a default NCCL plugin. Other environment variables help prevent application stalls and improve performance when using GPUDirect for RDMA communication.
 
 !!! example "EDF for the NGC PyTorch 22.12 image with Cuda 11"
-    ```bash
+    ```toml
     image = "nvcr.io#nvidia/pytorch:22.12-py3"
     mounts = ["/capstor/scratch/cscs/${USER}:/capstor/scratch/cscs/${USER}"]
 
@@ -199,7 +199,7 @@ At the moment of writing, 4 plugin variants are configured: `cuda11`, `cuda12`
 [](){#ref-ce-ssh-hook}
 ### SSH Hook
 
-```bash
+```toml
 com.hooks.ssh.enabled = "true"
 com.hooks.ssh.authorize_ssh_key = "<public-key>"    # (1)
 ```
@@ -246,7 +246,7 @@ By default, the server started by the SSH hook listens to port 15263, but this s
 
 ### NVIDIA CUDA MPS Hook
 
-```bash
+```toml
 com.hooks.nvidia_cuda_mps.enabled = "true"
 ```