ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Mark​Logic

by paxtonhare ALL

Sublime plugin for MarkLogic XQuery

Details

Installs

  • Total 2K
  • Win 919
  • Mac 540
  • Linux 222
Dec 4 Dec 3 Dec 2 Dec 1 Nov 30 Nov 29 Nov 28 Nov 27 Nov 26 Nov 25 Nov 24 Nov 23 Nov 22 Nov 21 Nov 20 Nov 19 Nov 18 Nov 17 Nov 16 Nov 15 Nov 14 Nov 13 Nov 12 Nov 11 Nov 10 Nov 9 Nov 8 Nov 7 Nov 6 Nov 5 Nov 4 Nov 3 Nov 2 Nov 1 Oct 31 Oct 30 Oct 29 Oct 28 Oct 27 Oct 26 Oct 25 Oct 24 Oct 23 Oct 22 Oct 21 Oct 20
Windows 0 0 1 1 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 4 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 1
Mac 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Linux 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

This Project is Archived

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

MarkLogic Sublime Plugin

About

A feature packed MarkLogic XQuery package for Sublime Text.

Features:

Code completion

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.

XQuery Lint

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
}
Configuring which MarkLogic server to talk to
Via Settings

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

Via Roxy

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"
    ]
}
Via a configuration file in your Folder Structure

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"
        ]
    }
}
Change options via commands

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

Set Content Database

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.

Set Modules Database

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.

Toggle Lint on Save

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 On Server

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

Open MarkLogic api docs

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 + '

Search MarkLogic online docs

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

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

Trigger: attribute

Inserts a constructed attribute “xquery attribute name() { () }

##### Trigger: element
Inserts an inline constructed element
```xquery
element name() { () }
Trigger: element

Inserts a constructed element ”xquery element name() { () }

##### Trigger: fun
Inserts a function declaration with the correct namespace prefix already filled out
```xquery
declare function local:name()
{
    (: code goes here :)
};
Trigger: if

Inserts an if then else statement “xquery if (expression) then () else ()

##### Trigger: ns
Inserts a namespace declaration
```xquery
declare namespace ns = "http://namespace-uri";
Trigger: switch

Inserts a switch statement (xquery 3.0) ”xquery switch (expression) case expression return expression default return expression

##### Trigger: type
Inserts a typeswitch statement
```xquery
typeswitch(expression)
    case expression return
        expression
    default return
        expression
Trigger: variable

Inserts a variable declaration “xquery declare variable $x := ();

##### Trigger: log
Inserts a stubbed xdmp:log() call
```xquery
xdmp:log()
xqdoc

Inserts a stubbed xqdoc comment

Press Ctrl + Alt + d

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

Install with Package Control

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.

Install Manually with Git:

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

Instructions for Sublime Text 3

Mac

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

Linux

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

Windows

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

Instructions for Sublime Text 2

Mac

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

Linux

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

Windows

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