Skip to content

Commit 21111ae

Browse files
committed
docs(vscode): Fix list formatting and improve clarity in instructions in nexus version
1 parent 03ae262 commit 21111ae

File tree

1 file changed

+9
-13
lines changed

1 file changed

+9
-13
lines changed

Docs/XMLDIffWithVSCode.nexus

Lines changed: 9 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,8 @@ This document describes how to use XMLDiff with Visual Studio Code.
1111
[*] VSCode extension [url=https://marketplace.visualstudio.com/items?itemName=emeraldwalk.RunOnSave]Run on Save[/url] by [url=https://marketplace.visualstudio.com/publishers/emeraldwalk]emeraldwalk[/url]
1212
[/list]
1313
[size=3][u][b]Steps[/b][/u][/size]
14-
[olist]
14+
[list=1]
1515
[*] Prepare a folders structure like the following:
16-
[/olist]
1716
[code]
1817
RootExtensionFolder
1918
│ XMLDiffAndPatch
@@ -26,14 +25,14 @@ This document describes how to use XMLDiff with Visual Studio Code.
2625
│ md.modified
2726
│ md.original
2827
[/code]
29-
[olist]
3028
[*] You can skip creation [b]*.original[/b] folders, if you will use the [b]extracted[/b] files folder.
3129
[*] Copy the [url=https://github.com/chemodun/X4-XMLDiffAndPatch/raw/main///forVSCode/RunXMLDiff.bat]RunXMLDiff.bat[/url] file to the root of your project.
3230
[*] Copy the [b]XMLDiff.exe[/b] file to the [b]XMLDiffAndPatch[/b] folder in the root of your project.
3331
[*] Install the VSCode extension [url=https://marketplace.visualstudio.com/items?itemName=emeraldwalk.RunOnSave]Run on Save[/url] by [url=https://marketplace.visualstudio.com/publishers/emeraldwalk]emeraldwalk[/url]
3432
[*] Open the settings of the extension by pressing [b]Ctrl + ,[/b] and search for [b]runOnSave.commands[/b]
3533
[*] Add the following configuration to the settings:
36-
[/olist] 7.1 In case of not to use the "Extracted" files folder, i.e. with [b]*.original[/b] folders:
34+
[list=1]
35+
[*]In case of not to use the "Extracted" files folder, i.e. with [b]*.original[/b] folders:
3736

3837
[code]
3938
"commands": [
@@ -44,7 +43,7 @@ This document describes how to use XMLDiff with Visual Studio Code.
4443
]
4544
[/code]
4645

47-
7.2. With the [b]extracted[/b] folder, which is outside the project folder:
46+
[*]With the [b]extracted[/b] folder, which is outside the project folder:
4847

4948
[code]
5049
"commands": [
@@ -56,9 +55,9 @@ This document describes how to use XMLDiff with Visual Studio Code.
5655
[/code]
5756

5857
Take in account that with the [b]extracted[/b] folder you still can use the [b]*.original[/b] folders for original files. It will be used first, if they exist, otherwise the script will use the [b]extracted[/b] folder.
59-
[olist]
58+
[/list]
6059
[*] Save the settings and close the settings tab.
61-
[/olist]
60+
[/list]
6261
Now you can modify the [b]*.modified[/b] files and the [b]RunXMLDiff.bat[/b] will be executed automatically on save.
6362

6463
You can check an output in the [b]OUTPUT[/b] tab in the VSCode, selecting the [b]Run on Save[/b] item in the dropdown list.
@@ -86,19 +85,16 @@ RunXMLDiff.bat "C:\path\to\md.modified\file.xml" "C:\path\to\XMLDiff.exe" "C:\pa
8685
[/code]
8786

8887
[size=3][u]How It Works[/u][/size]
89-
[olist]
88+
[list=1]
9089
[*] [b]Extract Type and Filename[/b]: The script extracts the type (e.g., [b]aiscript[/b] or [b]md[/b]) and filename from the modified file path.
9190
[*] [b]Determine Target File Path[/b]: The script constructs the target file path by removing [b].modified[/b] from the modified file path.
9291
[*] [b]Determine Original File Path[/b]:
93-
[/olist][list][list]
9492
[*] If the [b]OriginalFilesPath[/b] is provided, the original file path is constructed as [b]OriginalFilesPath\type\filename[/b].
9593
[*] If the [b]OriginalFilesPath[/b] is not provided, the original file path is constructed by replacing [b].modified[/b] with [b].original[/b] in the modified file path.
96-
[/list]
97-
[/list]4. [b]Check Existence[/b]:
98-
[list][list]
94+
[*] [b]Check Existence[/b]:
9995
[*] The script checks for the existence of [b]XMLDiff.exe[/b], the modified file, the original file, and the target file directory.
96+
[*][b]Run XMLDiff[/b]: If all checks pass, the script runs [b]XMLDiff.exe[/b] with the appropriate parameters to generate the diff file.
10097
[/list]
101-
[/list]5. [b]Run XMLDiff[/b]: If all checks pass, the script runs [b]XMLDiff.exe[/b] with the appropriate parameters to generate the diff file.
10298

10399
[size=3][u][i]Error Handling[/i][/u][/size]
104100

0 commit comments

Comments
 (0)