Fix links and try collapsible in TOML

Author: luis-uow

docs/examples/input_format.md

@@ -71,7 +71,7 @@ The table below summarises the main groups of input files:
 ??? info "Strategic pipeline data files description"
 
     **Note:** The structure below follows the order defined in `strategic_pipeline.toml`.  
-    For reference, see the [TOML examples](toml_examples.md).
+    For reference, see the [TOML examples](toml_examples.md#1-strategic-pipeline).
 
     ### A. Demand Data
 
@@ -251,7 +251,7 @@ The table below summarises the main groups of input files:
     | max_dist | Max distance | 150 |
     | time | Heuristic time (minutes) | 25 |
 
-    See [Heuristics Computation Inputs](#heuristics-computation-inputs) for more details.
+    See [Heuristics Computation Inputs](#3-heuristics-computation-inputs) for more details.
 
     ---
 
@@ -271,7 +271,7 @@ The Heuristics are computed to support the path finding algorithm (A*). These ca
 performed as a uniform cost search (UCS).
 
 This subset is sufficient to **compute travel-time heuristics** for the pathfinder. See 
-[heuristics_computation.toml](toml_examples.md) for example of TOML
+[heuristics_computation.toml](toml_examples.md#3-heuristics-computation) for example of TOML
 file configuring the [compute_air_rail_heuristics.py](https://github.com/UoW-ATM/MultiModX/blob/main/script/strategic/compute_air_rail_heuristics.py) script that is the one used to generate the heuristics.
 
 

docs/examples/toml_examples.md

@@ -16,11 +16,10 @@ here a description of the different elements of the configuration  files is prov
 ## 1. Strategic Pipeline
 
 
-::: info "Strategic pipeline TOML description"
+??? info "Strategic pipeline TOML description"
     ```toml
-    {{ read_file("examples/toml/strategic_pipeline.toml") }}
+    {{ read_file("examples/toml/strategic_pipeline.toml") | indent(4) }}
     ```
-:::
 
 ---
 ## 2. Policy Package

docs/pre-tactical/index.md

@@ -22,7 +22,7 @@ Specify:
 - Output folder structure
 - Replanning constraints, to control which itineraries are valid as alternatives, and optimisation objectives, to select how to assign passengers to alternatives.
 
-See [TOML](../examples/toml_examples.md#pretactical-pipeline) for examples and description.
+See [TOML](../examples/toml_examples.md#4-pretactical-pipeline) for examples and description.
 
 ### 2. Run the replanning script
 

docs/strategic/index.md

@@ -59,7 +59,7 @@ python strategic_pipeline.py -tf ../../data/CS_example/v=0.1/CS_example.PP00.tom
 
 The strategic pipeline is fully **configuration-driven** via [TOML files](../examples/toml_examples.md), primarily:
 
-- [`strategic_pipeline.toml`](../examples/toml_examples.md#strategic-pipeline)
+- [`strategic_pipeline.toml`](../examples/toml_examples.md#1-strategic-pipeline)
 - [`policy_package.toml`](../examples/toml_examples.md#2-policy-package)
 
 At a high level, the configuration is organised as follows:
@@ -275,7 +275,7 @@ of the schedules (e.g. due to an optimisation (as performed by the Multimodal Sc
 
 See high-level description of all the CSV input files in
 [Input Files Strategic Pipeline](../examples/input_format.md#2-strategic-pipeline-inputs) for the strategic
-pipeline and [TOML - Policy Package](../examples/toml_examples.md#policy-package) for the definition of the Policy Package in the
+pipeline and [TOML - Policy Package](../examples/toml_examples.md#2-policy-package) for the definition of the Policy Package in the
 associated TOML config file.
 
 #### 3. Compute Potential Paths Stage