From: Kai Moritz Date: Sun, 11 Jan 2026 11:29:52 +0000 (+0100) Subject: Switched to `maven-hugo-skin` -- ALIGN X-Git-Url: http://juplo.de/gitweb/?a=commitdiff_plain;h=8ebea3ef50836dc07919ff00cf0d7afcbed59911;p=hibernate-maven-plugin Switched to `maven-hugo-skin` -- ALIGN --- diff --git a/src/site/markdown/configuration.md b/src/site/markdown/configuration.md index e6e738da..6d541d6a 100644 --- a/src/site/markdown/configuration.md +++ b/src/site/markdown/configuration.md @@ -1,11 +1,7 @@ - - - - - - -

Configuration Examples

-

Configuration Through A Configuration-File

+# Configuration Examples + +## Configuration Through A Configuration-File +

The most simple way to configure the plugin is, to put all the hibernate-configuration in a hibernate.properties- or @@ -30,7 +26,8 @@ </goals> </execution> </executions> -</plugin> +</plugin> +

This would create the configured database. If you want it to be droped beforehand, you have to add the goal @@ -49,7 +46,8 @@ </goals> </execution> </executions> -</plugin> +</plugin> +

A correspondin goal for the command update is missing in this version, but we are planning to implement it in near feature. @@ -65,7 +63,8 @@ hibernate.dialect=org.hibernate.dialect.H2Dialect hibernate.connection.url=jdbc:h2:file:./target/db hibernate.connection.driver_class=org.h2.Driver hibernate.connection.username=sa -hibernate.connection.password= +hibernate.connection.password= +

But be aware, that using this configuration-approach the database-url, that is build in the application is the same that is used while testing, @@ -96,15 +95,18 @@ hibernate.connection.password= <configuration> <url><![CDATA[jdbc:mysql://localhost/test-db]]></url> </configuration> -</plugin> +</plugin> +

Configuration properties, that are set in the configuration-section of the plugin-configuration cannnot be overwritten elsewere (for details - see Configuration-Method-Precedence). + see Configuration-Method-Precedence). You never can overwrite them by accident when specifying a property on the commandline or in your settings.xml.

-

Configuration through maven-properties

+ +## Configuration through maven-properties +

Alternatively, it is possible, to configure the plugin via maven-properties. Each relevant configuration-option has a corresponding maven-property @@ -131,6 +133,7 @@ hibernate.connection.password= testing): 

+
 <properties>
   <hibernate.connection.driver_class>org.hsqldb.jdbcDriver</hibernate.connection.driver_class>
   <hibernate.dialect>org.hibernate.dialect.HSQLDialect</hibernate.dialect>
@@ -162,7 +165,9 @@ hibernate.connection.password=
</configuration> </plugin> -<plugins> +<plugins> + +

This way, you can reuse the same properties to provide a default-configurationthe, that is build into your application, and @@ -205,7 +210,8 @@ hibernate.connection.password= <username>sa</username> <password></password> </configuration> -</plugin> +</plugin> +

The parameter hibernateProperties (name of the hibernate-properties-file to use, defaults to hibernate.properties) can only be configured through @@ -215,7 +221,9 @@ hibernate.connection.password= For more explanations, see the Documentation of the goal create.

-

Configuration-Method-Precedence

+ +## Configuration-Method-Precedence +

The configuration is gathered in a fix order:

@@ -258,6 +266,5 @@ hibernate.connection.password= <configuration> <password>${my-password-property}</password> </configuration> -</plugin> - - +</plugin> + diff --git a/src/site/markdown/debugging.md b/src/site/markdown/debugging.md index 2fab3254..f61897c7 100644 --- a/src/site/markdown/debugging.md +++ b/src/site/markdown/debugging.md @@ -1,10 +1,5 @@ - - - - - - -

Enable Debugging-Output

+# Enable Debugging-Output +

If you are new to hibernate-maven-plugin, in many cases, the Configuration-Method-Precedence @@ -27,5 +22,3 @@ mvn -X compile hibernate:create

But be warned: hibernate-maven-plugin tends to be very chatty ;)

- - diff --git a/src/site/markdown/force.md b/src/site/markdown/force.md index ee3586f7..8e036a72 100644 --- a/src/site/markdown/force.md +++ b/src/site/markdown/force.md @@ -1,10 +1,5 @@ - - - - - - -

Force Execution

+# Force Execution +

The hibernate-maven-plugin computes MD5-sums for all found annotated classes and stores them together with the generated schema. @@ -38,5 +33,3 @@ Or you may specify -Dhibernate.schema.force=true at the command line, if you want to force hibernate-maven-plugin only once.

- - diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md index 7f302377..0b883449 100644 --- a/src/site/markdown/index.md +++ b/src/site/markdown/index.md @@ -1,11 +1,7 @@ - - - - - - -

${project.name}

-

${project.description}

+# ${project.name} + +## ${project.description} +

The hibernate-maven-plugin is a plugin for generating a database-schema from your Hibernate-Mappings and create or update your database @@ -41,7 +37,9 @@ For more information about the inspiration to write this tiny plugin, read our blog-article about the hibernate-maven-plugin.

-

Documentation

+ +## Documentation + -

Releases

+ +## Releases + - - diff --git a/src/site/markdown/issue-tracking.md b/src/site/markdown/issue-tracking.md deleted file mode 100644 index 40e609d8..00000000 --- a/src/site/markdown/issue-tracking.md +++ /dev/null @@ -1,14 +0,0 @@ - - - - - - -

Issue Tracking

- There is no bug-tracking system set up for this project! -

- Please send your bug-reports, questions or feature-requests directly - to the developer. -

- - diff --git a/src/site/markdown/mail-lists.md b/src/site/markdown/mail-lists.md deleted file mode 100644 index 3dbb7330..00000000 --- a/src/site/markdown/mail-lists.md +++ /dev/null @@ -1,14 +0,0 @@ - - - - - - -

Mailing Lists

- There are no mailinglists defined for this project! -

- Please send your bug-reports, questions or feature-requests directly - to the developer. -

- - diff --git a/src/site/markdown/pitfalls.md b/src/site/markdown/pitfalls.md index 07438808..558c1520 100644 --- a/src/site/markdown/pitfalls.md +++ b/src/site/markdown/pitfalls.md @@ -1,11 +1,7 @@ - - - - - - -

Known Pitfalls (FAQ)

-

Annotated classes in dependencies are not found.

+# Known Pitfalls (FAQ) + +## Annotated classes in dependencies are not found. +

hibernate-maven-plugin by default scans dependencies in the scope compile. You can configure it to scan dependencies in other @@ -14,7 +10,9 @@ annotated classes are hidden in a transitive dependency, you can simply add that dependency explicitly.

-

hibernate-maven-plugin always needs a database-connection

+ +## hibernate-maven-plugin always needs a database-connection +

The default-configuration executes the created SQL. Therefore, it needs a valid database-connection and fails, if none is @@ -35,7 +33,9 @@ the dialect. Hence, the plugin will still fail, if this parameter is also missing!

-

Dependency for driver-class XYZ is missing

+ +## Dependency for driver-class XYZ is missing +

One regular problem is the scope of the jdbc-driver-dependency. It is very unlikely, that this dependency is needed at compile-time. @@ -111,7 +111,9 @@ Because otherwise, this dependency will unnecessarily bloat the runtime-dependencies of your project.

-

DBUnit fails after execution of hibernate was skipped because nothing has changed

+ +"##DBUnit fails after execution of hibernate was skipped because nothing has changed +

If hibernate-maven-plugin skips its excecution, this may lead to errors in other plugins. @@ -143,7 +145,9 @@ <skip>${hibernate.schema.skipped}</skip> </configuration> </plugin> -

The database will not be recreated after a manual drop/clean

+ +## The database will not be recreated after a manual drop/clean +

If one manually drops the database or removes the hsqldb-files, it will not be recreated by the hibernate-maven-plugin, because it cannot detect, that @@ -162,7 +166,9 @@ 

 mvn hibernate:create -Dhibernate.schema.force=true
-

The hibernate:create goal is not executed, when tests are skipped

+ +## The hibernate:create goal is not executed, when tests are skipped +

The hibernate-maven-plugin automatically skips its execution, when maven.test.skip is set to true. If you need it to be always @@ -181,7 +187,9 @@ mvn hibernate:create -Dhibernate.schema.force=true Background-information for this design-decission can be found on the extra page To skip or not to skip: that is the question...

-

I do not want my dependencies to be scanned for hibernate annotations

+ +## I do not want my dependencies to be scanned for hibernate annotations +

If you do not want your dependencies to be scanned for hibernate annotations, you can pass -Dhibernate.schema.scan.dependencies=none to maven @@ -197,7 +205,9 @@ mvn hibernate:create -Dhibernate.schema.force=true <scanDependencies>none</scanDependencies> </configuration> </plugin> -

No annotated classes found

+ +## No annotated classes found +

If you are working under Windows and get the error-message No annotated classes found in directory C:\projects\X Y Z\path-to-project\target\classes, @@ -210,7 +220,9 @@ mvn hibernate:create -Dhibernate.schema.force=true You should consider to upgrade to the latest version of the plugin.

-

If two goals are specified, the second one is always skipped

+ +## If two goals are specified, the second one is always skipped +

If you specify two goals, for example drop and create, each goal has to be specified in its own @@ -246,6 +258,5 @@ mvn hibernate:create -Dhibernate.schema.force=true <outputFile>db-schema/create-schema.ddl</outputFile> </configuration> </execution> -</executions> - - +</executions> + diff --git a/src/site/markdown/skip.md b/src/site/markdown/skip.md index 9b570c9f..109a510f 100644 --- a/src/site/markdown/skip.md +++ b/src/site/markdown/skip.md @@ -1,10 +1,5 @@ - - - - - - -

Skipping Execution

+# Skipping Execution +

In most use-cases, the hibernate-maven-plugin is used to create a test-database automatically. In this use-cases, it is very likely, that it @@ -56,5 +51,3 @@ foo.bar to true. For example, if you specify -Dfoo.bar=true on the command-line.

- - diff --git a/src/site/site.xml b/src/site/site.xml index ed66927e..9164bee6 100644 --- a/src/site/site.xml +++ b/src/site/site.xml @@ -1,7 +1,7 @@ - + @@ -18,16 +18,8 @@ de.juplo.maven - maven-thymeleaf-skin - 1.1.2 + maven-siteliberator-skin + 1.0.0-SNAPSHOT - - - /projects - /hibernate-maven-plugin/ - "/index.html","/projects.html" - th:replace="~{/templates/layout.html :: layout(uri='' + ~{:: code[class='site_uri']/text()}, title=~{:: title}, maincontent=~{:: .maincontent}, json='MERGE:' + ~{:: pre[class='json']/text()})}" - -