HHH-19827 Remove some of the relative path usage in the docs

marko-bekhta · marko-bekhta · commit 11be8ba15851 · 2025-10-03T16:44:38.000+02:00
diff --git a/documentation/documentation.gradle b/documentation/documentation.gradle
@@ -243,6 +243,8 @@ asciidoctorj {
             jdbcVersion: jdks.versions.jdbc.get(),
             'root-project-dir': rootProject.layout.projectDirectory.asFile.absolutePath,
             'doc-main-dir': project(':documentation').layout.projectDirectory.dir('src').dir("main").asFile.absolutePath,
+            'doc-generated-content-dir': project(':documentation').layout.buildDirectory.dir('asciidoc').get()
+                    .dir("fragments").asFile.absolutePath,
             'theme-main-dir': rootProject.layout.buildDirectory.dir("unpacked-theme").get()
                     .dir("hibernate-asciidoctor-theme").dir("asciidoc").asFile.absolutePath,
             stylesdir: "css",
diff --git a/documentation/src/main/asciidoc/introduction/Hibernate_Introduction.adoc b/documentation/src/main/asciidoc/introduction/Hibernate_Introduction.adoc
@@ -1,4 +1,4 @@
-:shared-attributes-dir: ../shared
+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared
 
 include::{shared-attributes-dir}/common-attributes.adoc[]
 include::{shared-attributes-dir}/url-attributes.adoc[]
diff --git a/documentation/src/main/asciidoc/querylanguage/Hibernate_Query_Language.adoc b/documentation/src/main/asciidoc/querylanguage/Hibernate_Query_Language.adoc
@@ -1,4 +1,4 @@
-:shared-attributes-dir: ../shared
+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared
 
 include::{shared-attributes-dir}/common-attributes.adoc[]
 include::{shared-attributes-dir}/url-attributes.adoc[]
@@ -10,7 +10,7 @@ include::{shared-attributes-dir}/renderer-attributes.adoc[]
 :extrasdir: extras
 
 = A Guide to Hibernate Query Language
-:title-logo-image: image:../../style/asciidoctor/images/org/hibernate/logo.png[]
+:title-logo-image: image:{doc-main-style-dir}/asciidoctor/images/org/hibernate/logo.png[align=left,pdfwidth=33%]
 :toc2:
 :toclevels: 3
 :sectanchors:
diff --git a/documentation/src/main/asciidoc/querylanguage/Preface.adoc b/documentation/src/main/asciidoc/querylanguage/Preface.adoc
@@ -1,4 +1,4 @@
-:shared-attributes-dir: ../shared/
+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared
 
 include::{shared-attributes-dir}/url-attributes.adoc[]
 
diff --git a/documentation/src/main/asciidoc/quickstart/guides/index.adoc b/documentation/src/main/asciidoc/quickstart/guides/index.adoc
@@ -1,4 +1,4 @@
-:shared-attributes-dir: ../../shared
+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared
 
 include::{shared-attributes-dir}/common-attributes.adoc[]
 include::{shared-attributes-dir}/url-attributes.adoc[]
diff --git a/documentation/src/main/asciidoc/quickstart/guides/preface.adoc b/documentation/src/main/asciidoc/quickstart/guides/preface.adoc
@@ -1,4 +1,4 @@
-:shared-attributes-dir: ../../shared/
+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared
 
 include::{shared-attributes-dir}/url-attributes.adoc[]
 include::{shared-attributes-dir}/filesystem-attributes.adoc[]
diff --git a/documentation/src/main/asciidoc/repositories/Hibernate_Data_Repositories.adoc b/documentation/src/main/asciidoc/repositories/Hibernate_Data_Repositories.adoc
@@ -1,4 +1,4 @@
-:shared-attributes-dir: ../shared
+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared
 
 include::{shared-attributes-dir}/common-attributes.adoc[]
 include::{shared-attributes-dir}/url-attributes.adoc[]
diff --git a/documentation/src/main/asciidoc/repositories/Preface.adoc b/documentation/src/main/asciidoc/repositories/Preface.adoc
@@ -1,4 +1,4 @@
-:shared-attributes-dir: ../shared/
+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared
 
 include::{shared-attributes-dir}/url-attributes.adoc[]
 
diff --git a/documentation/src/main/asciidoc/topical/index.adoc b/documentation/src/main/asciidoc/topical/index.adoc
@@ -1,4 +1,4 @@
-:shared-attributes-dir: ../shared
+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared
 
 include::{shared-attributes-dir}/common-attributes.adoc[]
 include::{shared-attributes-dir}/url-attributes.adoc[]
diff --git a/documentation/src/main/asciidoc/userguide/Hibernate_User_Guide.adoc b/documentation/src/main/asciidoc/userguide/Hibernate_User_Guide.adoc
@@ -1,4 +1,4 @@
-:shared-attributes-dir: ../shared
+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared
 :html-meta-canonical-link: https://docs.jboss.org/hibernate/orm/current/userguide/html_single/Hibernate_User_Guide.html
 
 include::{shared-attributes-dir}/common-attributes.adoc[]
diff --git a/documentation/src/main/asciidoc/userguide/Preface.adoc b/documentation/src/main/asciidoc/userguide/Preface.adoc
@@ -1,4 +1,4 @@
-:shared-attributes-dir: ../shared/
+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared
 include::{shared-attributes-dir}/url-attributes.adoc[]
 
 [[preface]]
diff --git a/documentation/src/main/asciidoc/userguide/appendices/SettingsReference.adoc b/documentation/src/main/asciidoc/userguide/appendices/SettingsReference.adoc
@@ -24,4 +24,4 @@ For (legacy) Hibernate settings which have a direct Jakarta Persistence corollar
 form should be preferred - e.g. `hibernate.connection.driver_class` -> `jakarta.persistence.jdbc.driver`.
 ====
 
-include::../../../../../target/asciidoc/fragments/config-settings.adoc[]
+include::{doc-generated-content-dir}/config-settings.adoc[]

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-:shared-attributes-dir: ../shared`
	`1`	`+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared`
`2`	`2`
`3`	`3`	`include::{shared-attributes-dir}/common-attributes.adoc[]`
`4`	`4`	`include::{shared-attributes-dir}/url-attributes.adoc[]`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-:shared-attributes-dir: ../shared/`
	`1`	`+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared`
`2`	`2`
`3`	`3`	`include::{shared-attributes-dir}/url-attributes.adoc[]`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-:shared-attributes-dir: ../../shared`
	`1`	`+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared`
`2`	`2`
`3`	`3`	`include::{shared-attributes-dir}/common-attributes.adoc[]`
`4`	`4`	`include::{shared-attributes-dir}/url-attributes.adoc[]`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-:shared-attributes-dir: ../../shared/`
	`1`	`+:shared-attributes-dir: {doc-main-dir}/asciidoc/shared`
`2`	`2`
`3`	`3`	`include::{shared-attributes-dir}/url-attributes.adoc[]`
`4`	`4`	`include::{shared-attributes-dir}/filesystem-attributes.adoc[]`