Batch to JS conversion guide - Revision history

Aoineko at 09:39, 1 November 2024

2024-11-01T09:39:20Z

Aoineko at 09:38, 1 November 2024

2024-11-01T09:38:38Z

Aoineko at 17:26, 27 May 2023

2023-05-27T17:26:14Z

Aoineko: /* Create new build file */

2023-05-27T17:25:27Z

‎Create new build file

Aoineko at 17:23, 27 May 2023

2023-05-27T17:23:32Z

Aoineko: /* Create new build file */

2023-05-27T17:22:32Z

‎Create new build file

Aoineko: /* Example */

2023-05-27T17:18:56Z

‎Example

Aoineko: /* Create new build file */

2023-05-27T17:18:45Z

‎Create new build file

Aoineko at 17:15, 27 May 2023

2023-05-27T17:15:43Z

Aoineko at 17:14, 27 May 2023

2023-05-27T17:14:54Z

@@ Line 2: / Line 2: @@
 To open the library to users of other platforms (Linux and macOS) and overcome the limitations of the Batch language, the Build tool has been entirely rewritten in JavaScript and executed via Node.js.
-Everything necessary for the execution of these new scripts being packaged with MSXgl on Windows and Linux, the user has no other software to install. For macOS, SDCC and Node.js must be installed separately.
+Everything necessary for the execution of these new scripts being packaged with MSXgl on Windows and Linux, the user has no other software to install. For macOS, SDCC and Node.js must be [[Install/macOS|installed separately]].
 This guide is intended for users who have already created an MSXgl project and who would like to convert their project configuration to benefit from the new version of the Build tool (which I strongly recommend).

@@ Line 2: / Line 2: @@
 To open the library to users of other platforms (Linux and macOS) and overcome the limitations of the Batch language, the Build tool has been entirely rewritten in JavaScript and executed via Node.js.
-Everything necessary for the execution of these new scripts being packaged with MSXgl on Windows, the user has no other software to install. For Linux, SDCC and Node.js must be installed separately.
+Everything necessary for the execution of these new scripts being packaged with MSXgl on Windows and Linux, the user has no other software to install. For macOS, SDCC and Node.js must be installed separately.
 This guide is intended for users who have already created an MSXgl project and who would like to convert their project configuration to benefit from the new version of the Build tool (which I strongly recommend).

@@ Line 324: / Line 324: @@
 ..\..\tools\build\Node\node.exe ..\..\engine\script\js\build.js target=%1‎</syntaxhighlight>
 Usage example:
-* <tt>build</tt> (execute build with default option)
+* <tt>build</tt> <small>(execute build with default option)</small>
-* <tt>build DOS2</tt> (execute build with target overwrite)
+* <tt>build DOS2</tt> <small>(execute build with target overwrite)</small>
 </div><div style="flex:1; min-width:512px;">'''Linux''' or '''macOS''': <tt>build.sh</tt>‎<syntaxhighlight lang="batch">
 #!/bin/bash
@@ Line 343: / Line 343: @@
 fi‎</syntaxhighlight>
 Usage example:
-* <tt>./build</tt> (execute build with default option)
+* <tt>./build</tt> <small>(execute build with default option)</small>
-* <tt>./build DOS2</tt> (execute build with target overwrite)
+* <tt>./build DOS2</tt> <small>(execute build with target overwrite)</small>
 </div></div>

@@ Line 323: / Line 323: @@
 ..\..\tools\build\Node\node.exe ..\..\engine\script\js\build.js target=%1‎</syntaxhighlight>
 </div><div style="flex:1; min-width:512px;">'''Linux''' or '''macOS''': <tt>build.sh</tt>‎<syntaxhighlight lang="batch">
 #!/bin/bash
@@ Line 339: / Line 342: @@
 	../../tools/build/Node/node ../../engine/script/js/build.js target=$1
 fi‎</syntaxhighlight>
 </div></div>

@@ Line 27: / Line 27: @@
 === Example ===
-<div style="display:flex; flex-direction:row; flex-wrap:wrap;"><div style="flex:1;">
+<div style="display:flex; flex-direction:row; flex-wrap:wrap;"><div style="flex:1; min-width:512px;">
 Batch version:‎<syntaxhighlight lang="batch">
 :: ____________________________
@@ Line 171: / Line 171: @@
 call %LibDir%\script\build.cmd
 ‎</syntaxhighlight>
-</div><div style="flex:1;">
+</div><div style="flex:1; min-width:512px;">
 JS version:‎<syntaxhighlight lang="js">
 // ____________________________
@@ Line 310: / Line 310: @@
 Then, you can create a file to execute the build. Filename and content depends on the plateform:
-<div style="display:flex; flex-direction:row; flex-wrap:wrap;"><div style="flex:1; min-width:500px;">'''Windows''': <tt>build.bat</tt>‎<syntaxhighlight lang="batch">
+<div style="display:flex; flex-direction:row; flex-wrap:wrap;"><div style="flex:1; min-width:512px;">'''Windows''': <tt>build.bat</tt>‎<syntaxhighlight lang="batch">
 :: ____________________________
 :: ██▀▀█▀▀██▀▀▀▀▀▀▀█▀▀█        │   ▄▄▄                ▄▄
@@ Line 323: / Line 323: @@
 ..\..\tools\build\Node\node.exe ..\..\engine\script\js\build.js target=%1‎</syntaxhighlight>
-</div><div style="flex:1; min-width:500px;">'''Linux''' or '''macOS''': <tt>build.sh</tt>‎<syntaxhighlight lang="batch">
+</div><div style="flex:1; min-width:512px;">'''Linux''' or '''macOS''': <tt>build.sh</tt>‎<syntaxhighlight lang="batch">
 #!/bin/bash
 # ____________________________