Merge pull request #28 from andre2007/package_suppliers

Page package suppliers added

Author: wilzbach

source/dubregistry/web.d

@@ -67,4 +67,10 @@ class DubRegistryFullWebFrontend {
 	{
 		render!("settings.dt");
 	}
+
+	@path("/package-suppliers")
+	void getPackageSuppliers()
+	{
+		render!("package_suppliers.dt");
+	}
 }

views/layout.inc.menu.dt

@@ -10,7 +10,7 @@
 			- import std.range : empty;
 			- import std.string : split;
 			- import std.typecons : tuple;
-			- auto listitems = [tuple("Packages", ["https://code.dlang.org"]), tuple("Documentation", ["Getting Started;getting_started", "Advanced Usage;advanced_usage", "Command line documentation;commandline", "Development;develop", "Package format (JSON);package-format-json", "Package format (SDLang);package-format-sdl", "Settings;settings"]), tuple("About",  ["Forums;http://forum.rejectedsoftware.com/groups/rejectedsoftware.dub", "Bug tracker (website);https://github.com/dlang/dub-registry/issues", "Bug tracker (DUB);https://github.com/dlang/dub/issues", "Github repository (website);https://github.com/dlang/dub-registry", "GitHub repository (DUB);https://github.com/dlang/dub"]), tuple("Download", ["https://code.dlang.org/download"])];
+			- auto listitems = [tuple("Packages", ["https://code.dlang.org"]), tuple("Documentation", ["Getting Started;getting_started", "Advanced Usage;advanced_usage", "Command line documentation;commandline", "Development;develop", "Package format (JSON);package-format-json", "Package format (SDLang);package-format-sdl", "Package suppliers;package-suppliers", "Settings;settings"]), tuple("About",  ["Forums;http://forum.rejectedsoftware.com/groups/rejectedsoftware.dub", "Bug tracker (website);https://github.com/dlang/dub-registry/issues", "Bug tracker (DUB);https://github.com/dlang/dub/issues", "Github repository (website);https://github.com/dlang/dub-registry", "GitHub repository (DUB);https://github.com/dlang/dub"]), tuple("Download", ["https://code.dlang.org/download"])];
 			ul
 				- foreach(items; listitems)
 					- if(items[1].length < 2)

views/package_suppliers.dt

@@ -0,0 +1,37 @@
+extends layout
+
+block title
+	- auto title = "Package suppliers";
+
+block body
+	h2 Introduction
+
+	p Dub supports package suppliers of type Dub Registry, Maven and File System. By default, Dub will search on Dub Registry <a href="https://code.dlang.org">https://code.dlang.org</a> and hard-coded and user-set fallbacks.
+
+	p Package suppliers can be specified either using argument <code>--registry</code> or globally using <a href="settings">setting</a> <code>registryUrls</code>. The type of the package supplier can be specified by prefixing the URL with <code>dub+</code> for type Dub Registry, <code>mvn+</code> for type Maven or using the <code>file://</code> scheme for type File System. Without a prefix, the type Dub Registry (<code>dub+</code>) is assumed.
+
+	h3 Dub Registry
+
+	p Dub packages are registered at a <a href="https://github.com/dlang/dub-registry">Dub Registry server</a> like <a href="https://code.dlang.org">https://code.dlang.org</a>. It isn't needed to prefix the address of a Dub Registry.
+
+		ul
+			li https://code.dlang.org/
+			li dub+https://code.dlang.org/
+
+	h3 Maven repository
+
+	p Dub can retrieve dub package zip archives located within a Maven repository like Nexus or Artifactory. The registry address needs to contain the Maven repository and a group id. The dub packages needs to be stored with a common group id, the dub package name as artifact id and dub version as artifact version. The dub package zip file must have the name <code>[packageName]-[version].zip</code>.
+
+	p Example
+
+	p Dub package zip archive <code>calculator-1.0.0.zip</code> is stored on Maven repository <a href="http://localhost:8040/maven/libs-release">http://localhost:8040/maven/libs-release</a> using group id <code>dubpackages</code>. As registry address <code>mvn+http://localhost:8040/maven/libs-release/dubpackages</code> needs to be specified.
+
+	p <code>dub fetch [email protected] --skip-registry=all --registry=mvn+http://localhost:8040/maven/libs-release/dubpackages</code>
+
+	h3 File system
+
+	p A folder containing dub packages as zip files could be specified as registry. The zip files must have the name <code>[packageName]-[version].zip</code>.
+
+	ul
+		li Linux <code>dub fetch [email protected] --skip-registry=all --registry=file:///var/dubpackages</code>
+		li Windows <code>dub fetch [email protected] --skip-registry=all --registry=file:///c:/d/dubpackages</code>