initial testing with Zensical

This commit is a test run, currently I would stick with MM proper until
Zensical is more mature. Hopefully in about half a year.

Missing features:
- blog for news articles (using template at the moment, not ideal)

docs/merlin6/index.md

@@ -3,7 +3,7 @@
 ## Slurm clusters
 
 * The new Slurm CPU cluster is called **`merlin6`**.
-* The new Slurm GPU cluster is called [**`gmerlin6`**](../gmerlin6/cluster-introduction.md)
+* The new Slurm GPU cluster is called [**`gmerlin6`**](gmerlin6/cluster-introduction.md)
 * The old Slurm *merlin* cluster is still active and best effort support is provided.
 
 The cluster, was renamed as [**merlin5**](../merlin5/cluster-introduction.md).

docs/merlin6/quick-start-guide/accessing-slurm.md

@@ -34,7 +34,7 @@ For further information about how to use this cluster, please visit: [**Merlin6
 
 The **Merlin6 GPU cluster** (**`gmerlin6`**) is visible from the login nodes. However, to submit jobs to this cluster, one needs to specify the option `--cluster=gmerlin6` when submitting a job or allocation.
 
-For further information about how to use this cluster, please visit: [**Merlin6 GPU Slurm Cluster documentation**](../../gmerlin6/slurm-configuration.md).
+For further information about how to use this cluster, please visit: [**Merlin6 GPU Slurm Cluster documentation**](../gmerlin6/slurm-configuration.md).
 
 ### Merlin5 CPU cluster access
 

docs/merlin6/quick-start-guide/introduction.md

@@ -43,7 +43,7 @@ These computational resources are split into **two** different **[Slurm](https:/
 
 * The Merlin6 CPU nodes are in a dedicated **[Slurm](https://slurm.schedmd.com/overview.html)** cluster called [**`merlin6`**](../slurm-configuration.md).
     * This is the **default Slurm cluster** configured in the login nodes: any job submitted without the option `--cluster` will be submited to this cluster.
-* The Merlin6 GPU resources are in a dedicated **[Slurm](https://slurm.schedmd.com/overview.html)** cluster called [**`gmerlin6`**](../../gmerlin6/slurm-configuration.md).
+* The Merlin6 GPU resources are in a dedicated **[Slurm](https://slurm.schedmd.com/overview.html)** cluster called [**`gmerlin6`**](../gmerlin6/slurm-configuration.md).
     * Users submitting to the **`gmerlin6`** GPU cluster need to specify the option ``--cluster=gmerlin6``.
 
 ### Merlin5

docs/merlin6/slurm-general-docs/running-jobs.md

@@ -52,7 +52,11 @@ The following settings are the minimum required for running a job in the Merlin
   #SBATCH --clusters=<cluster_name>     # Possible values: merlin5, merlin6, gmerlin6
   ```
 
-  Refer to the documentation of each cluster ([**`merlin6`**](../slurm-configuration.md),[**`gmerlin6`**](../../gmerlin6/slurm-configuration.md),[**`merlin5`**](../../merlin5/slurm-configuration.md) for further information.
+  Refer to the documentation of each cluster
+  [**`merlin6`**](../slurm-configuration.md),
+  [**`gmerlin6`**](../gmerlin6/slurm-configuration.md),
+  [**`merlin5`**](../../merlin5/slurm-configuration.md) for further
+  information.
 
 * **Partitions:** except when using the *default* partition for each cluster, one needs to specify the partition:
 
@@ -60,7 +64,11 @@ The following settings are the minimum required for running a job in the Merlin
   #SBATCH --partition=<partition_name>  # Check each cluster documentation for possible values
   ```
 
-  Refer to the documentation of each cluster ([**`merlin6`**](../slurm-configuration.md),[**`gmerlin6`**](../../gmerlin6/slurm-configuration.md),[**`merlin5`**](../../merlin5/slurm-configuration.md) for further information.
+  Refer to the documentation of each cluster
+  [**`merlin6`**](../slurm-configuration.md),
+  [**`gmerlin6`**](../gmerlin6/slurm-configuration.md),
+  [**`merlin5`**](../../merlin5/slurm-configuration.md) for further
+  information.
 
 * **[Optional] Disabling shared nodes**: by default, nodes are not exclusive. Hence, multiple users can run in the same node.  One can request exclusive node usage with the following option:
 
@@ -74,7 +82,11 @@ The following settings are the minimum required for running a job in the Merlin
    #SBATCH --time=<D-HH:MM:SS>          # Can not exceed the partition `MaxTime`
    ```
 
-  Refer to the documentation of each cluster ([**`merlin6`**](../slurm-configuration.md),[**`gmerlin6`**](../../gmerlin6/slurm-configuration.md),[**`merlin5`**](../../merlin5/slurm-configuration.md) for further information about partition `MaxTime` values.
+  Refer to the documentation of each cluster
+  [**`merlin6`**](../slurm-configuration.md),
+  [**`gmerlin6`**](../gmerlin6/slurm-configuration.md),
+  [**`merlin5`**](../../merlin5/slurm-configuration.md) for further information
+  about partition `MaxTime` values.
 
 * **Output and error files**: by default, Slurm script will generate standard output (`slurm-%j.out`, where `%j` is the job_id) and error (`slurm-%j.err`, where `%j` is the job_id) files in the directory from where the job was submitted. Users can change default name with the following options:
 
@@ -92,8 +104,14 @@ The following settings are the minimum required for running a job in the Merlin
   #SBATCH --hint=nomultithread          # Don't use extra threads with in-core multi-threading.
   ```
 
-  Refer to the documentation of each cluster ([**`merlin6`**](../slurm-configuration.md),[**`gmerlin6`**](../../gmerlin6/slurm-configuration.md),[**`merlin5`**](../../merlin5/slurm-configuration.md) for further information about node configuration and Hyper-Threading.
-  Consider that, sometimes, depending on your job requirements, you might need also to setup how many `--ntasks-per-core` or `--cpus-per-task` (even other options) in addition to the `--hint` command. Please, contact us in case of doubts.
+  Refer to the documentation of each cluster
+  ([**`merlin6`**](../slurm-configuration.md),
+  [**`gmerlin6`**](../gmerlin6/slurm-configuration.md),
+  [**`merlin5`**](../../merlin5/slurm-configuration.md) for further information
+  about node configuration and Hyper-Threading.  Consider that, sometimes,
+  depending on your job requirements, you might need also to setup how many
+  `--ntasks-per-core` or `--cpus-per-task` (even other options) in addition to
+  the `--hint` command. Please, contact us in case of doubts.
 
   !!! tip
       In general, for the cluster `merlin6` <span

docs/news/index.md

@@ -1,2 +0,0 @@
-# News
-

docs/news/launching-merlin6-docs.md

@@ -1,12 +1,9 @@
 ---
-date:
-  created: 2019-06-12
-tags:
-  - getting_started
+title: "Merlin 6 documentation available"
+date: "12 June 2019"
+template: "news.html"
 ---
 
-# Merlin 6 documentation available
-
 Merlin 6 docs are now available at [Merlin6 docs](../../merlin6/index.md)!
 
 More complete documentation will be coming shortly.

docs/news/merlin7-preprod-docs.md

@@ -1,12 +1,9 @@
 ---
-date:
-  created: 2024-08-07
-tags:
-  - getting_started
+title: "Merlin7 in preproduction"
+date: "7 August 2024"
+template: "news.html"
 ---
 
-# Merlin7 in preproduction
-
 The Merlin7 cluster is officially in preproduction. This phase will be tested by a few users
 and slowly we will contact other users to be part of it. Keep in mind that access is restricted.