Merge remote-tracking branch 'origin/initializer'

.github/workflows/main.yml

@@ -14,7 +14,7 @@ jobs:
   build:
     runs-on: ubuntu-18.04    
     container:
-      image: riccardoblb/buildenvs:hugo
+      image: jmonkeyengine/buildenv-jme3:hugo
     
     steps: 
     - name: Clone master

README.md

@@ -0,0 +1,30 @@
+# jMonkeyEngine Website
+
+## How to edit the website
+1. Open the folder with [Visual Studio Code](https://code.visualstudio.com/)
+2. Be sure to have the [Easy Less](https://marketplace.visualstudio.com/items?itemName=mrcrowl.easy-less) extension installed (this will autocompile less files on save)
+3. Edit the files you want
+4. Submit a PR to the source repo
+
+## How to test the website locally
+
+### With Docker
+The advantage of using Docker is that the script will pull a container with everything that is needed in order to run the website, if you chose this method you will need to have only a working [Docker installation](https://docs.docker.com/get-started/).
+
+To start an instance with docker, run
+   ```
+   RUNTIME="sudo docker" ./make.sh server
+   ```
+The instance will start and the http server will listen on http://localhost:1313
+
+
+### Without Docker
+If you can't or don't want to use Docker, the alternative is to launch the website manually. 
+ To do that you will need [hugo installed on your system](https://gohugo.io/), you can then choose to launch the instance using the helper script
+   ```
+   DONT_COMPILE_LESS=1 NO_CONTAINER=1 ./make.sh server
+   ```
+or directly with hugo if you are on a platform that doesn't support bash scripts
+```
+hugo server
+```

content/contribute.md

@@ -1,5 +1,6 @@
 ---
 type: "default"
+disable_nav: true
 layout: "post_layout_default"
 ---
 

content/docs.md

@@ -2,6 +2,7 @@
 menu: "main"
 title: "Documentation"
 type: "default"
+disable_nav: true
 layout: "post_layout_default"
 ---
 

content/features.md

@@ -2,6 +2,7 @@
 menu: "main"
 title: "Features"
 type: "default"
+disable_nav: true
 layout: "post_layout_default"
 ---
 

content/start.md

@@ -2,22 +2,103 @@
 type: "default"
 layout: "post_layout_default"
 title: "Quick Start"
+disable_nav: true
 date: 2021-04-25T18:00:00+00:00
 ---
 
-There are a variety of ways to use jMonkeyEngine:
+<style>
+    #qsbuttons{ 
+        text-align:center;
+    }
+    #qsbuttons > p{
+        display:flex;
+        align-items:center;
+        justify-content:center;
+    }
+
+    .qsbtn{
+      flex-grow: 1
+        
+    }
+    #jme-initializer{
+        margin-top:1em;
+        border:none;
+    }
+</style>
+<script>
+function showSubPage(id){
+    const subpages=document.querySelectorAll(".qspage");
+    subpages.forEach(sp=>sp.style.display="none");
+    const selectedSubPage=document.querySelector(".qspage#"+id);
+    selectedSubPage.style.display="block";
+
+    const buttons=document.querySelectorAll("button.qsbtn");
+    buttons.forEach(el=>el.classList.remove("highlightedCl"));
+    
+    const selectedBtn=document.querySelector("button#"+id+"Btn");
+    selectedBtn.classList.add("highlightedCl");
+}
+</script>
+<div id="qsbuttons" style="text-align:center">
+jMonkeyEngine is not bound to any specific IDE or SDK and it can be used as any other java library.
+<br>
+In this page we explore the three main ways of starting a project with jMonkeyEngine.
+<br><br>
+
+<button id="qsinitializerBtn" class="highlightedCl qsbtn" onclick="showSubPage('qsinitializer')">The Inializer</button> 
+<button  class="qsbtn" id="qssdkBtn"  onclick="showSubPage('qssdk')">The SDK</button>
+<button class="qsbtn"  id="qscustomBtn" onclick="showSubPage('qscustom')">DIY</button>
+
+</div>
+<hr>
+<div class="qspage" id="qssdk" style="display:none">
+
+Using the Netbeans-based SDK is by far the quickest solution to get you up and running. Everything needed is provided, along with extra tools and integrations, and is generally the place most users start their endevour. [Download the SDK](https://github.com/jMonkeyEngine/sdk/releases).
+
+</div>
+
+
+
+<div class="qspage" id="qsinitializer" style="text-align:center">
+
+The initializer is a convenient online tool that build a starter gradle script and template for your application.
+You can access the tool directly from [here](https://start.jmonkeyengine.org) or use the embedded version below.
+
+<iframe id="jme-initializer" 
+    style="width:100%;height:800px;" 
+    src="https://start.jmonkeyengine.org"
+></iframe>
+
+<script>
+    const iframe=document.querySelector("#jme-initializer");
+    if(iframe){
+        iframe.src=iframe.src+"?rnd="+Math.random()+"&time="+Date.now(); // avoid caching
+        window.addEventListener("message",(msg)=>{
+            try{
+                const event=JSON.parse(msg.data);
+                if(event.name=="jme-initializer-resize"){
+                    const height=event.height;
+                    document.querySelector("#jme-initializer").style.height = height + 'px';
+                }        
+            }catch(e){
+                console.log(e);
+            }
+            
+        });
+    }
+</script>
+
+</div>
+
 
-* Download the SDK
-* Download the engine
-* Add the libraries to a build script
 
-Using the Netbeans-based SDK is by far the quickest solution to get you up and running. Everything needed is provided, along with extra tools and integrations, and is generally the place most users start their endevour.
-[Download the SDK](https://github.com/jMonkeyEngine/sdk/releases).
+<div class="qspage" id="qscustom" style="display:none">
 
-jMonkeyEngine is not bound to any specific IDE or SDK, though, and if you feel comfortable in the Java environment you can use any IDE. The engine itself and it's dependencies can be downloaded directly and you can include them just like any other library in your java project.
-[Download the Engine](https://github.com/jMonkeyEngine/jmonkeyengine/releases).
+The engine itself and its dependencies can be downloaded from [the releases page](https://github.com/jMonkeyEngine/jmonkeyengine/releases) and used as any other java library.
 
-If you prefer to use online dependencies you can include them in your project from the Maven Central Repository. This is the most common approach for users that use an IDE such as intellij.
+If you prefer to use a build automation tool, you can find the engine hosted on the [Maven Central Repository](https://mvnrepository.com/artifact/org.jmonkeyengine). This is the most common approach for users that use an IDE or editor that supports maven or gradle build scripts (such as [IntelliJ IDEA](https://www.jetbrains.com/idea/) or [Visual Studio Code](https://code.visualstudio.com/) ).
+
+The code below shows how to include the bare minimum to use the jMonkeyEngine in your gradle project
 
 ```groovy
 repositories {
@@ -27,7 +108,7 @@ repositories {
 dependencies {
     implementation "org.jmonkeyengine:jme3-core:3.3.2-stable"
     implementation "org.jmonkeyengine:jme3-desktop:3.3.2-stable"
-    implementation "org.jmonkeyengine:jme3-lwjgl:3.3.2-stable" 
+    implementation "org.jmonkeyengine:jme3-lwjgl3:3.3.2-stable" 
 }
 ```
 
@@ -88,3 +169,6 @@ Running this class will start your first game and display a blue box on the scre
 For a more thorough tutorial on jMonkey browse through our [wiki](https://wiki.jmonkeyengine.org). The wiki provides extended documentation as well as tutorials on how to develop your game effectively using jmonkey practices. Tutorials start from the basics all the way up to collision detection, input mapping and shaders, and will be your go-to place for most of the information you require.
 
 If you ever find yourself confused or wondering how something is done, head over to our [community hub](https://hub.jmonkeyengine.org) and create a new thread. Our ultra-helpful team and community will be more than happy to give you a hand in getting you back on track.
+
+</div>
+

layouts/_default/post_layout_default.html

@@ -18,8 +18,10 @@
                 {{ .Content }}
 
                 </span>
-            {{ partial "articleNavPost.html" . }}
+                {{ if not .Params.disable_nav }}
 
+                    {{ partial "articleNavPost.html" . }}
+                {{ end }}
             </div>
 
 

make.sh

@@ -12,7 +12,7 @@
 set -x
 if [ "$IMAGE" = "" ];
 then
-    export IMAGE="riccardoblb/buildenvs:hugo"
+    export IMAGE="jmonkeyengine/buildenv-jme3:hugo"
 fi
 
 userUID=`id -u`
@@ -26,7 +26,7 @@ fi
 
 if [ "$DONT_COMPILE_LESS" = "" ];
 then
-    export CMD="sleep 2&&echo 'export default \"`date +%s`\"'> static/js/build-id.js&&npm install less -g&&lessc static/css/style.less static/css/style.css&&$CMD"    
+    export CMD="sleep 2&&echo 'export default \"`date +%s`\"'> static/js/build-id.js&&lessc static/css/style.less static/css/style.css&&$CMD"    
 fi
 
 
@@ -87,6 +87,7 @@ fi
 set -x
 if [ "$NO_CONTAINER" = "" ];
 then
+    $RUNTIME pull $IMAGE
     $RUNTIME run  -v"$PWD:$PWD" $ENV_FILE $RUN_AS -w $PWD $ARGS --rm $IMAGE bash -c  "$CMD"
 else
     eval "$CMD"

static/css/style.less

@@ -5,6 +5,11 @@
 
 * {
     box-sizing: border-box;
+    user-select: none;
+}
+
+p,code{
+    user-select:text;
 }
 
 :root {