Update Antora attachment$ links to {attachmentsdir} and correct xrefs for consistent and accurate navigation across documentation.

Author: gpx1000

en/Building_a_Simple_Engine/Engine_Architecture/01_introduction.adoc

@@ -59,4 +59,4 @@ Performance opportunities often emerge from architectural decisions made early i
 
 Let's begin our exploration of engine architecture with an overview of common architectural patterns used in modern rendering engines.
 
-xref:../introduction.adoc[Previous: Building a Simple Engine Introduction] | xref:Building_a_Simple_Engine/Engine_Architecture/02_architectural_patterns.adoc[Next: Architectural Patterns]
+xref:Building_a_Simple_Engine/introduction.adoc[Previous: Building a Simple Engine Introduction] | xref:Building_a_Simple_Engine/Engine_Architecture/02_architectural_patterns.adoc[Next: Architectural Patterns]

en/Building_a_Simple_Engine/Loading_Models/04_loading_gltf.adoc

@@ -124,7 +124,7 @@ glTF comes in two formats, each with its own advantages:
 
 [NOTE]
 ====
-This section provides a brief overview of PBR materials as they relate to glTF loading. For a more comprehensive explanation of PBR concepts and lighting models, please refer to the xref:Lighting_Materials/02_lighting_models.adoc#physically-based-rendering-pbr[Physically Based Rendering section] in the Lighting Materials chapter.
+This section provides a brief overview of PBR materials as they relate to glTF loading. For a more comprehensive explanation of PBR concepts and lighting models, please refer to the xref:Building_a_Simple_Engine/Lighting_Materials/02_lighting_models.adoc#physically-based-rendering-pbr[Physically Based Rendering section] in the Lighting Materials chapter.
 ====
 
 Materials define how surfaces look when rendered. Modern games and engines use Physically Based Rendering (PBR), which simulates how light interacts with real-world materials based on physical principles.

en/Building_a_Simple_Engine/Loading_Models/09_conclusion.adoc

@@ -23,6 +23,6 @@ As you continue to develop your engine, consider exploring these advanced topics
 
 The code for this chapter can be found in the `simple_engine/20_loading_models.cpp` file.
 
-xref:attachment$simple_engine/20_loading_models.cpp[C{pp} code]
+link:{attachmentsdir}/simple_engine/20_loading_models.cpp[C{pp} code]
 
 xref:Building_a_Simple_Engine/Loading_Models/08_animations.adoc[Previous: Updating Animations] | xref:Building_a_Simple_Engine/Subsystems/01_introduction.adoc[Next: Subsystems] | xref:../index.adoc[Back to Building a Simple Engine]

en/Building_a_Simple_Engine/Mobile_Development/06_conclusion.adoc

@@ -201,9 +201,9 @@ The following short, focused tutorials build directly on the Simple Engine and a
 
 The complete code for this chapter can be found in the following files:
 
-xref:attachment$simple_engine/36_mobile_platform_integration.cpp[Mobile Platform Integration C{pp} code]
-xref:attachment$simple_engine/37_mobile_optimizations.cpp[Mobile Optimizations C{pp} code]
-xref:attachment$simple_engine/38_tbr_optimizations.cpp[TBR Optimizations C{pp} code]
-xref:attachment$simple_engine/39_mobile_extensions.cpp[Mobile Extensions C{pp} code]
+link:{attachmentsdir}/simple_engine/36_mobile_platform_integration.cpp[Mobile Platform Integration C{pp} code]
+link:{attachmentsdir}/simple_engine/37_mobile_optimizations.cpp[Mobile Optimizations C{pp} code]
+link:{attachmentsdir}/simple_engine/38_tbr_optimizations.cpp[TBR Optimizations C{pp} code]
+link:{attachmentsdir}/simple_engine/39_mobile_extensions.cpp[Mobile Extensions C{pp} code]
 
 xref:Building_a_Simple_Engine/Mobile_Development/05_vulkan_extensions.adoc[Previous: Vulkan Extensions for Mobile] | xref:../index.adoc[Back to Building a Simple Engine]

en/Building_a_Simple_Engine/Subsystems/06_conclusion.adoc

@@ -105,7 +105,7 @@ The complete code for this chapter can be found in the following files:
 * `simple_engine/30_audio_subsystem.cpp`: Implementation of the audio subsystem with Vulkan HRTF processing
 * `simple_engine/31_physics_subsystem.cpp`: Implementation of the physics subsystem with Vulkan acceleration
 
-xref:attachment$simple_engine/30_audio_subsystem.cpp[Audio Subsystem C{pp} code]
-xref:attachment$simple_engine/31_physics_subsystem.cpp[Physics Subsystem C{pp} code]
+link:{attachmentsdir}/simple_engine/30_audio_subsystem.cpp[Audio Subsystem C{pp} code]
+link:{attachmentsdir}/simple_engine/31_physics_subsystem.cpp[Physics Subsystem C{pp} code]
 
 xref:Building_a_Simple_Engine/Subsystems/05_vulkan_physics.adoc[Previous: Vulkan for Physics Simulation] | xref:Building_a_Simple_Engine/Tooling/01_introduction.adoc[Next: Tooling] | xref:../index.adoc[Back to Building a Simple Engine]

en/Building_a_Simple_Engine/Tooling/07_conclusion.adoc

@@ -224,9 +224,9 @@ The complete code for this chapter can be found in the following files:
 * `simple_engine/34_crash_handling.cpp`: Implementation of crash handling and minidumps
 * `simple_engine/35_robustness_extensions.cpp`: Implementation of Vulkan extensions for robustness
 
-xref:attachment$simple_engine/32_cicd_setup.cpp[CI/CD Setup C{pp} code]
-xref:attachment$simple_engine/33_debug_utils.cpp[Debug Utils C{pp} code]
-xref:attachment$simple_engine/34_crash_handling.cpp[Crash Handling C{pp} code]
-xref:attachment$simple_engine/35_robustness_extensions.cpp[Robustness Extensions C{pp} code]
+link:{attachmentsdir}/simple_engine/32_cicd_setup.cpp[CI/CD Setup C{pp} code]
+link:{attachmentsdir}/simple_engine/33_debug_utils.cpp[Debug Utils C{pp} code]
+link:{attachmentsdir}/simple_engine/34_crash_handling.cpp[Crash Handling C{pp} code]
+link:{attachmentsdir}/simple_engine/35_robustness_extensions.cpp[Robustness Extensions C{pp} code]
 
 xref:Building_a_Simple_Engine/Tooling/06_packaging_and_distribution.adoc[Previous: Packaging and Distribution] | xref:Building_a_Simple_Engine/Mobile_Development/01_introduction.adoc[Next: Mobile Development]