Use Visual Studio Code and https://github.com/marklogic-community/mlxprs instead.

A feature packed MarkLogic XQuery package for Sublime Text.

• MarkLogic xquery extensions support "1.0-ml"
• Syntax highlighting for MarkLogic builtins
• Code completion for MarkLogic builtin functions
• XQuery Lint - Checks your XQuery files for errors
• Run on server - Runs your XQuery file on a MarkLogic server
• Open MarkLogic api docs for the function under the cursor
• Search MarkLogic online docs for the word under the cursor
• Tab snippets to streamline common patterns

This feature is enabled by default. Simply start typing the name of a MarkLogic function and press tab to complete. The complete function along with parameter list will be inserted in your code. Pressing the tab key will allow you to move between the different parameters.

This feature performs a syntax check on your XQuery code by running it on a MarkLogic server with the static-check option enabled. You can configure this Lint to run on load, save, and edit. Edit check only works on Sublime Text 3.

The lint settings are in the MarkLogic.sublime-settings file:

// LINT settings
"lint": {
	// Automatically lint on edit (Sublime Text 3 only).
	"lint_on_edit": false,

	// Configurable duration before re-linting.
	"lint_on_edit_timeout": 1,

	// Automatically lint when a file is loaded.
	"lint_on_load": false,

	// Automatically lint when a file is saved.
	"lint_on_save": false,

	// Highlight errors when selected.
	"highlight_selected_regions": true,

	// scroll to reveal any errors found
	"scroll_to_error": false
}

You can specify the MarkLogic server via the MarkLogic.sublime-settings file.

Alternatively, if you are using the Roxy Deployer the server settings will automatically be read from your Roxy configuration files.

// settings for Xcc connection
"xcc": {
	// timeout in seconds for xcc connections
	// can be decimal numbers ex: "1.5"
	"timeout": "1",

	// Use Settings from Roxy's properties files
	// If this is not a Roxy project then the setttings above will be used
	"use_roxy_settings": true,

	// The roxy environment configuration to use
	// Valid choices are usually [local, dev, prod] but may vary
	"roxy_environment": "local",

	// MarkLogic hostname
	"ml_host": "localhost",

	// Xcc port to communicate with for running queries
	"xcc_port": "8041",

	// The content database to use when evaluating queries
	"content_database": "Documents",

	// The modules database to use when evaluating queries
	"modules_database": "Modules",

	// user name to use when authenticating to xcc
	"user": "admin",

	// password name to use when authenticating to xcc
	"password": "admin",

	// Whether or not to use https when communicating with Xcc
	"use_https": false,

	// Local Paths to search for your xquery modules
	"search_paths": [],

	// xquery output options that you want applied when running your query
	// see: http://docs.marklogic.com/guide/xquery/langoverview#id_71572
	"output_options": [
		"indent=yes",
		"indent-untyped=yes"
	]
}

You can now create a file .ml-sublime-options that lives in your project directory. This is useful for non-Roxy projects where you wish to specify connection options. The file looks like this:

{
	// settings for Xcc connection
	"xcc": {
		// timeout in seconds for xcc connections
		// can be decimal numbers ex: "1.5"
		"timeout": "1",

		// MarkLogic hostname
		"ml_host": "localhost",

		// Xcc port to communicate with for running queries
		"xcc_port": "8041",

		// The content database to use when evaluating queries
		"content_database": "Documents",

		// The modules database to use when evaluating queries
		"modules_database": "Modules",

		// user name to use when authenticating to xcc
		"user": "admin",

		// password name to use when authenticating to xcc
		"password": "admin",

		// Whether or not to use https when communicating with Xcc
		"use_https": false,

		// Local Paths to search for your xquery modules
		"search_paths": [],

		// xquery output options that you want applied when running your query
		// see: http://docs.marklogic.com/guide/xquery/langoverview#id_71572
		"output_options": [
			"indent=yes",
			"indent-untyped=yes"
		]
	}
}

There are a few commands exposed to you to make switching databases easier:

Open the command palette and find "MarkLogic: Set Xcc Content Database"

This command will present you with a list of available databases. Choose one and it will be set as your content database for Xcc connections.

Open the command palette and find "MarkLogic: Set Xcc Modules Database"

This command will present you with a list of available databases. Choose one and it will be set as your modules database for Xcc connections.

Open the command palette and find "MarkLogic: Toggle Lint on Save"

This command will present you with two options:

• Lint on Save: On
• Lint on Save: Off

Choose one to set the value

Run the current file on a MarkLogic server via the "MarkLogic: Run File" command or by pressing Ctrl+Alt+r.

You can easily open a browser window to the documentation for a MarkLogic function.

When text is selected or your cursor is on a function name in code press the correct key combo for your platform:

• Mac: Command + '
• Linux: Ctrl + '
• Windows: Ctrl + '

You can easily search the MarkLogic online documentation for the current selection or word under the cursor.

When text is selected or your cursor is on a word press the correct key combo for your platform:

• Mac: Command + Shift + '
• Linux: Ctrl + Shift + '
• Windows: Ctrl + Shift + '

Tab Snippets will help you write code faster. Activate them by typing the trigger followed by tab.

Inserts a constructed attribute

attribute name() { () }

Inserts an inline constructed element

element name() { () }

Inserts a constructed element

element name() {
	()
}

Inserts a function declaration with the correct namespace prefix already filled out

declare function local:name()
{
	(: code goes here :)
};

Inserts an if then else statement

if (expression) then
	()
else
	()

Inserts a namespace declaration

declare namespace ns = "http://namespace-uri";

Inserts a switch statement (xquery 3.0)

switch (expression)
	case expression return
		expression
	default return
		expression

Inserts a typeswitch statement

typeswitch(expression)
	case expression return
		expression
	default return
		expression

Inserts a variable declaration

declare variable $x := ();

Inserts a stubbed xdmp:log() call

xdmp:log()

Inserts a stubbed xqdoc comment

Press Ctrl + Alt + d

(:~
 : Function description
 :
 : @param $function-param - description of param
 : @return - description of return
 :)

Use Package Control to install the MarkLogic plugin.

Package Control will keep your plugin up to date as new features are added.

To install via Package Control, do the following:

Within Sublime Text, bring up the Command Palette and type install. Choose Package Control: Install Package. When the plugin list appears choose MarkLogic.

Make sure you follow the instructions for the correct version of Sublime.

> git clone https://github.com/paxtonhare/MarkLogic-Sublime.git ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/MarkLogic

> git clone https://github.com/paxtonhare/MarkLogic-Sublime.git ~/.config/sublime-text-3/Packages/MarkLogic

> git clone https://github.com/paxtonhare/MarkLogic-Sublime.git "%APPDATA%/Sublime Text 3/Packages/MarkLogic"

> git clone https://github.com/paxtonhare/MarkLogic-Sublime.git ~/Library/Application\ Support/Sublime\ Text\ 2/Packages/MarkLogic

> git clone https://github.com/paxtonhare/MarkLogic-Sublime.git ~/.config/sublime-text-2/Packages/MarkLogic

> git clone https://github.com/paxtonhare/MarkLogic-Sublime.git "%APPDATA%/Sublime Text 2/Packages/MarkLogic"