From: Brett Porter Date: Fri, 23 Nov 2007 10:01:51 +0000 (+0000) Subject: add find artifact page X-Git-Tag: archiva-1.0~3 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=e7b16fcf276b489951b184698713c06cf5bd62e5;p=archiva.git add find artifact page git-svn-id: https://svn.apache.org/repos/asf/maven/archiva/trunk@597622 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/archiva-docs/src/site/apt/userguide/find-artifact.apt b/archiva-docs/src/site/apt/userguide/find-artifact.apt index 132636716..8bdfb5aba 100644 --- a/archiva-docs/src/site/apt/userguide/find-artifact.apt +++ b/archiva-docs/src/site/apt/userguide/find-artifact.apt @@ -4,5 +4,33 @@ Identifying an Artifact - :STUB: This is a documentation stub. + Archiva indexes all of the artifacts that it discovers during the repository scanning process, storing information about their contents. + This includes the checksum of the artifact, which can help to uniquely identify it within the repository. + + Archiva includes a feature that allows you to check for the existence of a given artifact in the repository by checksum. This is useful in + identifying a JAR or other artifact located from an external source that does not contain any Maven or version information. + + To use this functionality, click the "Find Artifact" link in the left navigation. + + When the screen first loads, a Java applet that will allow you to create a local checksum of a given artifact is loaded. Since it is reading the + content of the artifact from the filesystem, it will present a security dialog similar to the following: + +[../images/find-artifact-security.png] Java Applet + + By trusting the applet, you can checksum files of any size locally and just upload the small checksum to the server. If you opt not to trust the + applet, you must enter the checksum into the web form by hand. + + Once you have loaded the page, you have the choice of browsing for a local file to identify, or entering the checksum directly. + +[../images/find-artifact.png] Find Artifact + + Once you submit the form Archiva will look to match the checksum: + + * If more than one artifact matches, a list of results are returned + + * If a unique match is found, the individual artifact information page is returned + + * If no match is found, a "no results" page is returned + + diff --git a/archiva-docs/src/site/resources/images/find-artifact-security.png b/archiva-docs/src/site/resources/images/find-artifact-security.png new file mode 100644 index 000000000..bbc468223 Binary files /dev/null and b/archiva-docs/src/site/resources/images/find-artifact-security.png differ diff --git a/archiva-docs/src/site/resources/images/find-artifact.png b/archiva-docs/src/site/resources/images/find-artifact.png new file mode 100644 index 000000000..4a2a29675 Binary files /dev/null and b/archiva-docs/src/site/resources/images/find-artifact.png differ