Step by step guide to installing the XPath NoteBook
Install NodeJS if it's not already installed
STEP 1: Installing the extension in VS Code
Extensions are managed in the Extensions view (⇧⌘X) of the Side Bar. Type
XPath Notebook in the Extensions view search bar and, on the XPath Notebook for Visual Studio Code entry, press the
STEP 2: Create and save a new XPath Notebook
Open the Visual Studio Code command palette (⇧⌘P), and run the
New XPath Notebook command. An untitled notebook with a markdown cell and a code cell will be shown, initially the file is untitled with a
.xbook file extension.
Save the Notebook file in the usual way (⌘S), keeping the
.xbook extension. Note that XPath Notebook output cell values are not saved when the file is saved.
STEP 3: Setup the XPath Source
To set the evaluation context file for a notebook just open an XML or JSON file in Visual Studio Code.
The context-item is the result of evaluating either
json-doc($uri) respectively on the last opened file (excluding notebook files). Here is a summary of the evaluation context:
Statically known namespaces
Dynamically known namespaces
from root element of last opened file - if it was XML
Default element namespace
any default namespace on root element of last opened XML file
Static Base URI
the URI of the current XPath Notebook file
the URI of the last opened file - if it was XML
STEP 4: Add and execute Notebook cells
Press the '
+ Code' or '
+ Markdown' buttons to add Code or Markdown cells. To execute a cell, press
Ctrl-ENTER on the keyboard or click on the 'execute' button alongside the cell. When a Code cell is executed the result is shown in the Output cell immediately below the current cell.
For XPath Notebooks the default Output Cell type is JSON text. This allows XPath maps, arrays and sequences to be represented in an intuitive way.
STEP 5: Save the XPath Notebook when done
CMD-S keyboard shortcut to save an XPath Notebook so it can be used again. Currently, the Output cell details are not saved.