aboutsummaryrefslogtreecommitdiffstats
path: root/archiva-modules/README.adoc
diff options
context:
space:
mode:
authorMartin Stockhammer <martin_s@apache.org>2018-11-15 22:11:20 +0100
committerMartin Stockhammer <martin_s@apache.org>2018-11-15 22:11:20 +0100
commitf528b1addc8164b1466b8dc4aebbf503d43e7152 (patch)
tree1627123c8201e47ed6a1c3d32f57682298f8048d /archiva-modules/README.adoc
parentd712278c12308e346ab01ce7677d1e23c71607b7 (diff)
downloadarchiva-f528b1addc8164b1466b8dc4aebbf503d43e7152.tar.gz
archiva-f528b1addc8164b1466b8dc4aebbf503d43e7152.zip
Adding script for site publish and some documentation
Diffstat (limited to 'archiva-modules/README.adoc')
-rw-r--r--archiva-modules/README.adoc81
1 files changed, 81 insertions, 0 deletions
diff --git a/archiva-modules/README.adoc b/archiva-modules/README.adoc
new file mode 100644
index 000000000..fc24ffe44
--- /dev/null
+++ b/archiva-modules/README.adoc
@@ -0,0 +1,81 @@
+Archiva Modules - Collection of Archiva Subprojects
+===================================================
+:toc:
+
+
+== How to build and publish the pages for the archiva web content
+
+This module and the children contain web content and project reports that can be published to the
+archiva web site: https://archiva.apache.org
+
+The web content parts of this module and submodules are published to the path
+
+ /ref/${project.version}/
+
+=== Use the script
+
+There is a shell script +deploySite.sh+ which you can run to generate the site check and publish to
+the remote repository. It works only on Linux, on other platforms you have to go the next section.
+
+The script is interactive, it asks you to confirm the publish after generation of the staging part.
+
+.Execute
+
+ ./deploySite.sh
+
+All arguments are appended to the mvn calls.
+
+=== Run the mvn steps manually
+
+==== Building the pages
+
+You need enough free disk space to publish the web content. The archiva web site repository is big,
+but the maven build will only checkout the necessary directories for this build (sparse checkout).
+
+For all the commands you have to change to this archiva-modules directory:
+
+ cd archiva/archiva-modules
+
+.The following creates the site to the staging folder
+
+ mvn clean site site:stage
+
+The result can be checked in
+
+ archiva-modules/target/staging/ref/${project.version}
+
+with your browser.
+
+If you would like the use a local checkout of the archiva-web-content.git repository and not push directly
+to the remote repository, you may add this parameter:
+
+ -DsiteRepositoryUrl=scm:git:file:///${path-to-your-local-archiva}/archiva-web-content.git
+
+where +${path-to-your-local-archiva}+ is the path where a bare clone of the archiva-web-content.git is stored.
+
+NOTE: You cannot use +mvn site:run+ because this will place the submodules into the same folder and
+ overwrite each other.
+
+==== Publish the pages
+
+.This command publishes to the git repository
+
+ mvn scm-publish:publish-scm
+
+After publishing to the git repository the gitpubsub mechanism is transferring it to the HTTP server.
+
+If you would like the use a local checkout of the archiva-web-content.git repository and not push directly
+to the remote repository, you may add this parameter:
+
+ -DsiteRepositoryUrl=scm:git:file:///${path-to-your-local-archiva}/archiva-web-content.git
+
+
+=== Some notes about the build process
+
+A sparse checkout of the git repository will be created in
+
+ .site-content
+
+but only, if the directory +.site-content/.git+ does not exist.
+
+