22< html lang ="en ">
33
44< head >
5+ <!-- Google tag (gtag.js) -->
6+ < script async ="true " src ="https://www.googletagmanager.com/gtag/js?id=G-GEZCTHQENJ "> </ script >
7+ < script >
8+ window . dataLayer = window . dataLayer || [ ] ;
9+ function gtag ( ) { dataLayer . push ( arguments ) ; }
10+ gtag ( 'js' , new Date ( ) ) ;
11+
12+ gtag ( 'config' , 'G-GEZCTHQENJ' ) ;
13+ </ script >
514 < meta http-equiv ="Content-Type " content ="text/html; charset=UTF-8 " />
615
716 <!-- Basic Page Needs
2534
2635 <!-- Favicons
2736 ==================================================-->
28- < link rel ="icon " href ="resources/tiny-white-logo.png " sizes ="32x32 "/>
37+ < link rel ="icon " href ="resources/tiny-white-logo.png " sizes ="32x32 " />
2938
3039</ head >
3140
@@ -74,40 +83,53 @@ <h2 class="pageTitle">Overview</h2>
7483 < div class ="two-thirds column ">
7584 < p >
7685 Coding in modern XSLT presents a rewarding yet challenging experience for the developer.
77- Discover in this guide how Visual Studio Code, extended with DeltaXML's
78- < a href ="https://marketplace.visualstudio.com/items?itemName=deltaxml.xslt-xpath "> XSLT/XPath extension</ a > ,
86+ Discover in this guide how Visual Studio Code, extended with DeltaXML's
87+ < a href ="https://marketplace.visualstudio.com/items?itemName=deltaxml.xslt-xpath "> XSLT/XPath
88+ extension</ a > ,
7989 can help with editing, reviewing, refactoring and running XSLT.
8090 </ p >
8191 < aside >
82- < a href ="xslt30.html "> XSLT 3.0</ a > support is standard. Support for the proposed < a href ="xslt40.html "> XSLT 4.0</ a > is enabled by setting < strong > version="4.0"</ strong > on the root element.
92+ < a href ="xslt30.html "> XSLT 3.0</ a > support is standard. Support for the proposed < a
93+ href ="xslt40.html "> XSLT 4.0</ a > is enabled by setting < strong > version="4.0"</ strong > on the root
94+ element.
8395 </ aside >
8496 < p >
85- These pages complement the extensive < a
86- href =" https://code.visualstudio.com/docs " > Visual Studio Code documentation</ a > that begins:
97+ These pages complement the extensive < a href =" https://code.visualstudio.com/docs " > Visual Studio Code
98+ documentation</ a > that begins:
8799 </ p >
88100 < blockquote >
89- Visual Studio Code is a lightweight but powerful source code editor which runs on your desktop and is
90- available for Windows, macOS and Linux. It comes with built-in support for JavaScript, TypeScript and Node.js and has a
101+ Visual Studio Code is a lightweight but powerful source code editor which runs on your desktop and
102+ is
103+ available for Windows, macOS and Linux. It comes with built-in support for JavaScript, TypeScript
104+ and Node.js and has a
91105 rich ecosystem of extensions for other languages...
92106 </ blockquote >
93107 < p >
94108 < img src ="resources/vscode-xslt.png " class ="scale-with-grid " />
95109 </ p >
96110 < h3 > The User Interface</ h3 >
97111 < p >
98- Visual Studio Code's < a href ="https://code.visualstudio.com/docs/getstarted/userinterface "> user interface</ a >
99- has a different look and feel to that of legacy XSLT editors. The Command Palette, along with keybindings to
100- most common commands, play a significant role in providing a clearer environment to work in. User interface clutter is significantly
101- reduced by eschewing previous designs which depended on a set of toolbars, each with an abundance of buttons.</ p >
112+ Visual Studio Code's < a href ="https://code.visualstudio.com/docs/getstarted/userinterface "> user
113+ interface</ a >
114+ has a different look and feel to that of legacy XSLT editors. The Command Palette, along with
115+ keybindings to
116+ most common commands, play a significant role in providing a clearer environment to work in. User
117+ interface clutter is significantly
118+ reduced by eschewing previous designs which depended on a set of toolbars, each with an abundance of
119+ buttons.</ p >
102120
103- < p > The application < strong > menu bar</ strong > and associated dropdown menus usefully group the more essential actions for managing your code.
104- The < strong > View</ strong > menu is particularly useful as it logically sets out the large set of view-configuration commands.
121+ < p > The application < strong > menu bar</ strong > and associated dropdown menus usefully group the more
122+ essential actions for managing your code.
123+ The < strong > View</ strong > menu is particularly useful as it logically sets out the large set of
124+ view-configuration commands.
105125 </ p >
106- < p > The sections below introduce you to the fundamental parts of the user interface from the perspective of an XSLT/XPath developer.
126+ < p > The sections below introduce you to the fundamental parts of the user interface from the perspective
127+ of an XSLT/XPath developer.
107128 </ p >
108129 < h3 > The Command Palette</ h3 >
109130 < p > A principal part of Visual Studio Code's < a
110- href ="https://code.visualstudio.com/docs/getstarted/userinterface "> user interface</ a > is the Command
131+ href ="https://code.visualstudio.com/docs/getstarted/userinterface "> user interface</ a > is the
132+ Command
111133 Palette,
112134 triggered
113135 by the keyboard shortcut < span class ="shortcut "> ⇧⌘P</ span > .
@@ -117,18 +139,23 @@ <h3>The Command Palette</h3>
117139 </ p >
118140 < h3 > Opening Workspace Files</ h3 >
119141 < p >
120- The < strong > File: Open Folder</ strong > command is used to select the starting 'Workspace' folder to be used by VS Code.
121- More folders can be added to the Workspace subsequently using the < strong > Workspaces: Add folder to workspace</ strong >
142+ The < strong > File: Open Folder</ strong > command is used to select the starting 'Workspace' folder to
143+ be used by VS Code.
144+ More folders can be added to the Workspace subsequently using the < strong > Workspaces: Add folder to
145+ workspace</ strong >
122146 command.
123- The keyboard shortcut < span class ="shortcut "> ⌘P</ span > provides quick-access to all Workspace files from a pick-list.
147+ The keyboard shortcut < span class ="shortcut "> ⌘P</ span > provides quick-access to all Workspace files
148+ from a pick-list.
124149 'Fuzzy-matching' allows you to type in just a part of the filename to filter the pick-list files.
125150 </ p >
126151 < h3 > Keyboard Shortcuts</ h3 >
127152 < p >
128- While the Command Palette provides convenient access to features you should find that keyboard shortcuts are
153+ While the Command Palette provides convenient access to features you should find that keyboard
154+ shortcuts are
129155 more effective for commands you use most
130156 frequently.
131- The keyboard shortcut for commands is shown alongside each listed command in the Command Palette. Not all
157+ The keyboard shortcut for commands is shown alongside each listed command in the Command Palette.
158+ Not all
132159 commands
133160 have key bindings, but these can be configured using the command
134161 < code > Preferences: Open Keyboard Shortcuts</ code >
@@ -140,12 +167,14 @@ <h3>Settings</h3>
140167 < p > By adding or modifying Visual Studio Settings, using the < code > Preferences: Open User Settings</ code >
141168 command,
142169 you can customize a range of editor and extension features to meet your needs.
143- See the < a href ="settings.html "> Settings</ a > section for details on some of the more important settings for
170+ See the < a href ="settings.html "> Settings</ a > section for details on some of the more important
171+ settings for
144172 developing in XSLT and XPath.
145173 </ p >
146174 < h3 > Install the XSLT/XPath Extension</ h3 >
147175 < p > Extensions are managed in the Extensions view (< span class ="shortcut "> ⇧⌘X</ span > ) of the Side Bar.
148- Type < code > XSLT XPath</ code > in the Extensions view search bar and, on the < strong > XSLT/Path for Visual Studio
176+ Type < code > XSLT XPath</ code > in the Extensions view search bar and, on the < strong > XSLT/Path for
177+ Visual Studio
149178 Code</ strong > entry, press the < code > install</ code > button
150179 .</ p >
151180 < p >
@@ -154,34 +183,40 @@ <h3>Install the XSLT/XPath Extension</h3>
154183 < h5 > Color Theme Extensions</ h5 >
155184 < p > Visual Studio Code includes a small set of light and dark color themes. Alternative color themes are
156185 installed as extensions. The number of available themes can be overwhelming,
157- but VS Code has a built-in Theme Preview feature and there are websites like < a href ="https://vscodethemes.com/ "> vscodethemes</ a > that provide
186+ but VS Code has a built-in Theme Preview feature and there are websites like < a
187+ href ="https://vscodethemes.com/ "> vscodethemes</ a > that provide
158188 a preview before installing the theme.
159189 </ p >
160- < p > The < a href ="https://marketplace.visualstudio.com/items?itemName=deltaxml.xslt-dark-themes "> XSLT Dark Themes</ a > extension provides
161- a set of popular dark color themes specially enhanced for XSLT and XPath</ p >
190+ < p > The < a href ="https://marketplace.visualstudio.com/items?itemName=deltaxml.xslt-dark-themes "> XSLT Dark
191+ Themes</ a > extension provides
192+ a set of popular dark color themes specially enhanced for XSLT and XPath</ p >
162193 < aside > The XSLT/XPath extension syntax highlighter uses < a
163194 href ="https://code.visualstudio.com/api/language-extensions/semantic-highlight-guide ">
164- Semantic Highlighting</ a > that should be enabled specifically in Settings to work with external color
195+ Semantic Highlighting</ a > that should be enabled specifically in Settings to work with external
196+ color
165197 themes.
166198 Highlighter tokens are defined to provide effective highlighting for all the common color themes.
167199 </ aside >
168200 < h5 > Other Extensions</ h5 >
169201 < p > Among the hundreds of high quality extensions available for Visual Studio Code,
170- < a href ="https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare "> Live Share</ a > ,
202+ < a href ="https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare "> Live
203+ Share</ a > ,
171204 for collaborative working
172- and < a href ="https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer "> Live Server</ a >
205+ and < a href ="https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer "> Live
206+ Server</ a >
173207 for when you're generating HTML with XSLT are particularly useful.
174208 </ p >
175209 < h3 > Edit XML, XSLT or XPath</ h3 >
176210 < p >
177- For a comprehensive guide to the Visual Studio Code editor features see the Microsoft Visual Studio Code
211+ For a comprehensive guide to the Visual Studio Code editor features see the Microsoft Visual Studio
212+ Code
178213 < a href ="https://code.visualstudio.com/docs/editor/codebasics "> User Guide</ a > .
179214 </ p >
180215 < h5 > Language Specific Features</ h5 >
181216 < p > XSLT and XPath specific editing features are described in the < a href ="editing-xslt.html "> Editing
182217 XSLT/XPath</ a > page
183- of the documentation that your are reading now. More general XML editing features are described in the < a
184- href ="editing.html "> Editing XML</ a > section.</ p >
218+ of the documentation that your are reading now. More general XML editing features are described in
219+ the < a href ="editing.html "> Editing XML</ a > section.</ p >
185220 < p > The features described at < a href ="editing-xslt.html "> Editing XSLT/XPath</ a > include:</ p >
186221 < p >
187222 < ul >
@@ -202,17 +237,24 @@ <h3>Run XSLT - Quick Start</h3>
202237 class ="shortcut "> ⌘O</ span > ) from Visual Studio Code.
203238 The configuration is saved in a < code > tasks.json</ code > file in this workspace folder.
204239 </ p >
205- < p > To create your first task, use the < code > Run Build Task</ code > command (< span class ="shortcut "> ⇧⌘B</ span > ).
206- As there is no currently configured task, you should be prompted to configure one
207- (if another extension inhibits this, run < span class ="shortcut "> Configure Task</ span > instead). You can then,
240+ < p > To create your first task, use the < code > Run Build Task</ code > command (< span
241+ class ="shortcut "> ⇧⌘B</ span > ).
242+ As there is no currently configured task, you should be prompted to configure one
243+ (if another extension inhibits this, run < span class ="shortcut "> Configure Task</ span > instead). You
244+ can then,
208245 select either the < code > Saxon</ code > or < code > Saxon-JS</ code > task.</ p >
209- < p > A task will be added to the < code > tasks.json</ code > task with default properties. To further configure the
210- task, these properties can be changed or other properties added. Auto-completion and hints are provided to
211- assist in the task configuration. Next time you press < span class ="shortcut "> ⇧⌘B</ span > your task will be run
212- in a < strong > Task</ strong > tab in the Terminal window (toggled with < span class ="shortcut "> ⌘J</ span > ).
246+ < p > A task will be added to the < code > tasks.json</ code > task with default properties. To further
247+ configure the
248+ task, these properties can be changed or other properties added. Auto-completion and hints are
249+ provided to
250+ assist in the task configuration. Next time you press < span class ="shortcut "> ⇧⌘B</ span > your task
251+ will be run
252+ in a < strong > Task</ strong > tab in the Terminal window (toggled with < span
253+ class ="shortcut "> ⌘J</ span > ).
213254 </ p >
214- < h5 > More on running XSLT</ h5 >
215- < p > XSLT Tasks are explained in full in the < a href ="run-xslt.html "> Running XSLT</ a > section. More general
255+ < h5 > More on running XSLT</ h5 >
256+ < p > XSLT Tasks are explained in full in the < a href ="run-xslt.html "> Running XSLT</ a > section. More
257+ general
216258 information can be found in the Visual Studio Code < a
217259 href ="https://code.visualstudio.com/docs/editor/tasks "> Tasks</ a >
218260 documentation.</ p >
0 commit comments