Fix problem with prettier destroying :::{}:::

.pre-commit-config.yaml

@@ -39,7 +39,6 @@ repos:
     hooks:
       - id: prettier
         types_or: [yaml, markdown, html, css, scss, javascript, json]
-        args: [--prose-wrap=always]
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: "v0.8.4"

docs/index.md

@@ -6,9 +6,11 @@ _remage_ is a modern C++ simulation framework for germanium experiments.
 
 The installation process is documented in {doc}`install`.
 
-:::{warning} A proper user guide is not available yet. In the meanwhile, users
-can have a look at the {doc}`tutorial` or the provided
-[examples](https://github.com/legend-exp/remage/tree/main/examples). :::
+:::{warning}
+A proper user guide is not available yet. In the meanwhile, users can have a
+look at the {doc}`tutorial` or the provided
+[examples](https://github.com/legend-exp/remage/tree/main/examples).
+:::
 
 In the simplest application, the user can simulate in an existing GDML geometry
 through the `remage` executable:

docs/tutorial.md

@@ -191,7 +191,8 @@ radioactive source:
 /run/beamOn 50
 ```
 
-:::{admonition} Complete macro file (`vis-gammas.mac`) :class: dropdown
+:::{admonition} Complete macro file (`vis-gammas.mac`)
+:class: dropdown
 
 ```text
 /RMG/Manager/Logging/LogLevel detail
@@ -245,15 +246,18 @@ $ remage --interactive --gdml-files geometry.gdml -- vis-gammas.mac
 ...
 ```
 
-:::{note} Interactive visualization requires passing `--interactive` to the
-`remage` executable. :::
+:::{note}
+Interactive visualization requires passing `--interactive` to the `remage`
+executable.
+:::
 
 Interactions in HPGes and in LAr are marked in red and blue, respectively.
 
 ![Simulation visualization](img/tutorial-g4-view.jpg)
 
-:::{tip} With Apptainer, additional tweaks are required in order to allow for
-graphics to be displayed, e.g.
+:::{tip}
+With Apptainer, additional tweaks are required in order to allow for graphics
+to be displayed, e.g.
 
 ```console
 $ apptainer run \
@@ -264,11 +268,14 @@ $ apptainer run \
     path/to/remage_latest.sif --interactive [...]
 ```
 
-and similarly with Docker. :::
+and similarly with Docker.
+:::
 
-:::{tip} If `remage` from the Apptainer image refuses to run simulations, this
-might be due to some of your environment variables from outside the container.
-Give `--cleanenv` a try. :::
+:::{tip}
+If `remage` from the Apptainer image refuses to run simulations, this might be
+due to some of your environment variables from outside the container. Give
+`--cleanenv` a try.
+:::
 
 ## Storing simulated data on disk