Integrating Sphinx for documentation refs #23833

CHANGELOG.md

@@ -3,6 +3,11 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 # Changelog for gCube Catalogue (gCat) Service
 
 
+## [v2.4.1-SNAPSHOT]
+
+- Integrating Sphinx for documentation [#23833]
+
+
 ## [v2.4.0]
 
 - Added moderation link in moderation message [#23142]

pom.xml

@@ -12,7 +12,7 @@
 	<groupId>org.gcube.data-catalogue</groupId>
 	<artifactId>gcat</artifactId>
 	<packaging>war</packaging>
-	<version>2.4.0</version>
+	<version>2.4.1-SNAPSHOT</version>
 	<name>gCube Catalogue (gCat) Service</name>
 	<description>
 		This service allows any client to publish on the gCube Catalogue.
@@ -249,12 +249,30 @@
 			<artifactId>logback-classic</artifactId>
 			<scope>test</scope>
 		</dependency>
-
 	</dependencies>
 	
 	<build>
-
        	<plugins>
+			<!-- Sphinx plugin' -->
+			<plugin>
+				<groupId>kr.motd.maven</groupId>
+				<artifactId>sphinx-maven-plugin</artifactId>
+				<version>2.10.0</version>
+				<configuration>
+					<outputDirectory>${project.build.directory}/${project.artifactId}-${project.version}/docs</outputDirectory>
+					<builder>html</builder>
+					<configDirectory>${basedir}/docs</configDirectory>
+					<sourceDirectory>${basedir}/docs</sourceDirectory>
+				</configuration>
+				<executions>
+					<execution>
+						<phase>process-resources</phase>
+						<goals>
+							<goal>generate</goal>
+						</goals>
+					</execution>
+				</executions>
+			</plugin>
 			<!-- Enunciate Maven plugin -->
 			<plugin>
 			    <groupId>com.webcohesion.enunciate</groupId>
@@ -285,8 +303,8 @@
 			                <outputDirectory>target</outputDirectory>
 			                <resources>
 			                    <resource>
-			                        <targetPath>${project.build.directory}/${project.artifactId}-${project.version}/docs</targetPath>
-			                        <directory>${project.build.directory}/docs</directory>
+			                        <targetPath>${project.build.directory}/${project.artifactId}-${project.version}/apidocs</targetPath>
+			                        <directory>${project.build.directory}/apidocs</directory>
 			                        <filtering>true</filtering>
 			                    </resource>
 			                </resources>
@@ -295,7 +313,6 @@
 			    </executions>
 			</plugin>
 		</plugins>
-
 	</build>
 	
 </project>