initial commit

Author: EduardKrieger

runners/wikiConsole/index.ts

@@ -173,5 +173,30 @@ export class WikiConsole extends WikiRunner {
 
         return null;
     }
+
+    runExecuteCommand(runCommand: RunCommand): RunResult{
+        let windowsCommand = runCommand.command.parameters[0];
+        let linuxCommand = runCommand.command.parameters[1];
+        let dir = (runCommand.command.parameters.length > 2 && runCommand.command.parameters[2].dir) 
+            ? runCommand.command.parameters[2].dir
+            : undefined;
+        let async = (runCommand.command.parameters.length > 2 && runCommand.command.parameters[2].async)
+            ? runCommand.command.parameters[2].async
+            : false;
+        let args = (runCommand.command.parameters.length > 2 && runCommand.command.parameters[2].args) 
+            ? runCommand.command.parameters[2].args.join(" ")
+            : undefined;
+        let port = (runCommand.command.parameters.length > 3 && runCommand.command.parameters[3].port) 
+            ? runCommand.command.parameters[3].port
+            : undefined;
+        let appPath = (runCommand.command.parameters.length > 3 && runCommand.command.parameters[3].path) 
+            ? runCommand.command.parameters[3].path
+            : undefined; 
+
+        this.renderWiki(path.join(this.getRunnerDirectory(), "templates", "executeCommand.asciidoc"),
+            {windowsCommand: windowsCommand, linuxCommand: linuxCommand, dir: dir, async: async, args: args, port: port, appPath: appPath });
+        
+        return null;
+    }
 }
 

runners/wikiConsole/templates/executeCommand.asciidoc

@@ -0,0 +1,27 @@
+== Execute a command
+
+=== Execute a command in a command prompt
+First, you need to open a command prompt in your current Workspace. For Windows, you can use Powershell and on Linux, you can use the Terminal.
+<% if(async){ %> We want to start a Server so that you have to open a new command prompt, that will be blocked while the server is running. <% } %>
+
+<% if(dir){ %> 
+The command will be executed in the folder *<%= dir; %>* relative to your current Workspace. If the folders are not present, you maybe missed a wiki chapter and have to create it.
+First change your directory with this command `cd <%= dir; %>` <% } %>
+
+.Operating system
+. Windows + 
+Then execute the command `<%- windowsCommand; %><% if(args){ %> <%- args; %><%}%>`.
+. Linux and macOS + 
+Then execute the command `<%- linuxCommand; %><% if(args){ %> <%- args; %><%}%>`.
+
+<% if(port){ %>
+
+=== Startup Assertion
+
+You can check if the server is running correctly by checking if `localhost:<%= port; %>/<%= appPath; %>` is accessible by either using a tool like `curl`, `Postman` or simply accessing the service via your webbrowser.
+
+Example: `curl -Is localhost:<%= port; %>/<%= appPath; %> | head -n 1`
+
+This command should return an `200 OK` header if the service is available.
+
+<% } %>

runners/wikiConsole/templates/runServerJava.asciidoc

@@ -18,7 +18,7 @@ This command will start the Java server.
 
 You can check if the server is running correctly by checking if `localhost:<%= port; %>/<%= app_path; %>` is accessible by either using a tool like `curl`, `Postman` or simply accessing the service via your webbrowser.
 
-Example: `curl -Is localhost:<%= port; %>/<%app_path%> | head -n 1`
+Example: `curl -Is localhost:<%= port; %>/<%= app_path; %> | head -n 1`
 
 This command should return an `200 OK` header if the service is available.