Merge pull request #11 from andre2007/feature_settings_json

Settings view added

Author: thewilsonator

source/dubregistry/web.d

@@ -61,4 +61,10 @@ class DubRegistryFullWebFrontend {
 		auto commands = getCommands();
 		render!("docs.commandline.dt", commands);
 	}
+
+	@path("/settings")
+	void getSettings()
+	{
+		render!("settings.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"]), 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", "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/settings.dt

@@ -0,0 +1,76 @@
+extends layout
+
+block title
+	- auto title = "Settings";
+
+block body
+	h2 Configuring default settings
+
+	p User/System wide default DUB values can be specified in settings.json file.
+
+	p A settings.json file could look like this:
+
+	pre.code
+		|{
+		|	"defaultArchitecture": "x86_64",
+		|	"defaultCompiler": "ldc"
+		|}
+
+	p The file settings.json can be located in different locations. Last item in list has highest priority.
+	
+	p Windows
+		ul
+			li <code>%ProgramData%\dub\settings.json</code>
+			li <code>&lt;dub executable folder&gt;\..\etc\dub\settings.json</code>
+			li <code>%APPDATA%\dub\settings.json</code>
+
+	p Posix
+		ul
+			li <code>/var/lib/dub/settings.json</code>
+			li <code>&lt;dub executable folder&gt;/../etc/dub/settings.json</code>
+			li <code>~/.dub/settings.json</code>
+			
+	h3 Settings overview
+
+	table
+		tr
+			th Name
+			th Type
+			th Description
+
+		tr
+			td registryUrls
+			td: code string[]
+			td Search the given registry URL first when resolving dependencies. Can be specified multiple times. Available registry types:
+				ul
+					li DUB: URL to DUB registry (default)
+					li Maven: URL to Maven repository + group id containing dub packages as artifacts. E.g. mvn+http://localhost:8040/maven/libs-release/dubpackages
+
+		tr
+			td skipRegistry
+			td: code string
+			td 	Sets a mode for skipping the search on certain package registry types: 
+				ul
+					li none: Search all configured or default registries (default) 
+					li standard: Don't search the main registry (e.g. https://code.dlang.org/) 
+					li configured: Skip all default and user configured registries 
+					li all: Only search registries specified with --registry
+
+		tr
+			td customCachePaths
+			td: code string[]
+			td 
+				p Additional paths that contain packages in subfolders with the pattern "(name)-(version)/(name)/".
+				p Can be used to provide prebuilt DUB libraries (e.g. for distribution package maintainers).
+
+		tr
+			td defaultCompiler
+			td: code string
+			td 
+				p Specifies the compiler binary to use (can be a path). 
+				p Arbitrary pre- and suffixes to the identifiers below are recognized (e.g. ldc2 or dmd-2.063) and matched to the proper compiler type: dmd, gdc, ldc, gdmd, ldmd
+
+		tr
+			td defaultArchitecture
+			td: code string
+			td Force a different architecture (e.g. x86 or x86_64)