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

Exalt

by eerohele ST3

A Sublime Text 3 plugin for validating and formatting XML documents.

Details

Installs

  • Total 8K
  • Win 5K
  • OS X 2K
  • Linux 979
Apr 25 Apr 24 Apr 23 Apr 22 Apr 21 Apr 20 Apr 19 Apr 18 Apr 17 Apr 16 Apr 15 Apr 14 Apr 13 Apr 12 Apr 11 Apr 10 Apr 9 Apr 8 Apr 7 Apr 6 Apr 5 Apr 4 Apr 3 Apr 2 Apr 1 Mar 31 Mar 30 Mar 29 Mar 28 Mar 27 Mar 26 Mar 25 Mar 24 Mar 23 Mar 22 Mar 21 Mar 20 Mar 19 Mar 18 Mar 17 Mar 16 Mar 15 Mar 14 Mar 13 Mar 12 Mar 11
Windows 2 6 8 6 1 0 1 7 14 8 4 2 2 13 11 9 11 12 5 2 5 4 9 10 11 0 2 10 9 8 10 7 0 2 8 7 9 7 7 2 2 8 9 8 8 11
OS X 1 4 3 2 2 0 1 2 4 2 2 2 0 3 2 7 4 0 2 0 4 5 3 6 1 2 0 2 4 3 4 3 2 1 1 1 4 8 2 1 2 4 6 3 1 2
Linux 4 3 1 5 3 2 1 2 2 5 2 1 0 3 2 1 1 2 0 1 0 7 3 2 0 0 1 0 0 3 2 2 1 0 0 2 2 2 0 1 0 1 0 3 1 1

Readme

Source
raw.​githubusercontent.​com

Exalt

Exalt is a Sublime Text 3 plugin for validating and formatting XML documents.

The theme in the screenshot is Boxy.

Features

Validate files on the fly

Validate XML, XHTML, and XSLT files on the fly with lxml with these validation mechanisms:

Exalt supports XML catalogs via lxml.

XSLT validation

If the syntax of your current file is set to XSLT, Exalt automatically validates the file against Norman Walsh's Relax NG grammars for XSLT stylesheets.

XSD validation

Exalt uses the xsi:schemaLocation or the xsi:noNamespaceSchemaLocation attribute of the root element to validate against the schema defined in that attribute.

This means Exalt can validate Maven POM files that look like this:

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
                             http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>foobar</groupId>

    . . .
</project>

You'll probably want to set up an XML catalog to avoid having to fetch schemas from the internet. See Installing for more information.

xml-model validation

Exalt also supports the xml-model processing instruction. That means that you can have a processing instruction like this before the root element of your DITA XML 1.2 document (but after the XML declaration, of course):

<?xml-model href="urn:dita-ng:dita:rng:topic.rng"
            schematypens="http://relaxng.org/ns/structure/1.0"?>

Exalt will validate against the schema in the href pseudo-attribute. It uses the XML catalog you've set up to resolve the path in the href pseudo-attribute and the schematypens pseudo-attribute to determine the the type of the schema.

You can also use absolute or relative paths in the href pseudo-attribute:

<?xml-model href="file:///etc/xml/common/schemas/docbook/docbook-5.0/docbook.rng"
            schematypens="http://relaxng.org/ns/structure/1.0"?>


<?xml-model href="../docbook-5.0/xsd/docbook.xsd"
            schematypens="http://www.w3.org/2001/XMLSchema"?>


<?xml-model href="file:///etc/xml/common/schemas/dita/schematron/dita-1.2-for-xslt1.sch"
            schematypens="http://purl.oclc.org/dsdl/schematron"?>

If your file doesn't validate, you can press ⌘ + Ctrl + E to jump to the validation error if it's not already in view.

Format XML & HTML files

Press ⌘ + Ctrl + X to reformat (pretty-print) an XML or HTML file. If you have nothing selected, Exalt will format the entire document. If you have one or more selections, Exalt will format those.

NOTE: When formatting a selection, Exalt assumes the selection is a well-formed XML fragment. It will try to recover, but if your selection isn't well-formed, chances are the result is not what you want.

Exalt tries to format non-well-formed XML files via the libxml2 recover flag.

Schema caching

Exalt caches the schemas it uses for performance. This is useful if you're working on XML documents that use large schemas or when the schema is stored elsewhere than your computer.

However, this means that if you're developing a schema, the changes in the schema will not take effect until you clear the Exalt schema cache.

To clear the schema cache, run the Exalt: Clear Parser Cache command via the Sublime Text command palette. If you need to do it often, you might want to add a keyboard shortcut for that command in the Sublime Text settings.

Installing

  1. Install Exalt via Package Control.
  2. Restart Sublime Text.
  3. (Optional, but recommended.) In User/Exalt.sublime-settings, set the path to your XML catalog files.

    For example:

    {
      "xml_catalog_files": ["/etc/xml/catalog", "~/.schemas/catalog.xml"]
    }
    

    By default, the plugin uses the catalog files defined in Exalt/Exalt.sublime-settings. Those catalog files might or might not exist on your system.

    If you want, you can use my catalogs repository to install a set of commonly used XML catalogs and schemas. Just set the xml_catalog_files setting of this plugin to point to the catalog.xml file in where you cloned the repo.

    Alternatively, you can clonecatalogs into /etc/xml and create /etc/xml/catalog.xml with this content:

    <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
      <nextCatalog catalog="catalogs/catalog.xml"/>
    </catalog>
    

    If you do that, you don't have to set the xml_catalog_files setting.

    NOTE: If you change XML catalogs in any way, you need to restart Sublime Text 3 for the changes to take effect.

Known issues

  • Due to libxml2 issues #573483, #753970, and #753997, none of the available validation methods work for DITA 1.3 files.
  • ISO Schematron validation doesn't always report the error position correctly.

Acknowledgements