Update jme3.adoc

Turned static headings under Advanced and Intermediate into navigable links in the side bar.
Fixed various broken lists.

src/docs/asciidoc/jme3.adoc

@@ -3,6 +3,7 @@
 :revnumber:
 :revdate: 2016/03/17 20:48
 :keywords: documentation, intro, intermediate, about
+:experimental:
 ifdef::env-github,env-browser[:outfilesuffix: .adoc]
 
 
@@ -76,7 +77,7 @@ See also: <<sdk/sample_code#,Trouble running the samples>>?
 
 Now that you understood the basics, let's put it all together. The following intermediate articles help you to understand how to use these concepts in context.
 
-*jMonkeyEngine3 Concepts*
+=== jMonkeyEngine3 Concepts
 
 *  <<jme3/intermediate/best_practices#,Best Practices>>
 *  <<jme3/intermediate/simpleapplication#,SimpleApplication>>
@@ -85,14 +86,14 @@ Now that you understood the basics, let's put it all together. The following int
 *  <<jme3/intermediate/optimization#,Optimization>>
 *  <<jme3/faq#,Frequently Asked Questions (FAQ)>>
 
-*Maths Concepts*
+=== Maths Concepts
 
 *  <<jme3/math_for_dummies#,jME3 Math for Dummies>>
 *  <<jme3/intermediate/math#,Short 3D math &quot;cheat sheet&quot;>>
 *  <<jme3/math#,jME3 math overview>>
 *  <<jme3/math_video_tutorials#,Videos: jME3 math video tutorial series>>
 
-*3D Graphics Concepts*
+=== 3D Graphics Concepts
 
 *  <<jme3/intermediate/multi-media_asset_pipeline#,Multi-Media Asset Pipeline>>
 *  <<jme3/scenegraph_for_dummies#,3D Scene Graph for Dummies>>
@@ -103,24 +104,28 @@ Now that you understood the basics, let's put it all together. The following int
 *  <<jme3/external/blender#,Creating compatible models in blender>>
 *  <<jme3/external/3dsmax#,Creating compatible models in 3dsmax>>
 
-*Game Tutorials*
+=== Game Tutorials
 
 *  link:https://gamedevelopment.tutsplus.com/series/cross-platform-vector-shooter-jmonkeyengine--gamedev-13757[Neon Vector Shooter tutorial on Tuts+]
 
-*Video Use Case Tutorials*
-- Note these videos use alpha features only available in the next release
+=== Video Use Case Tutorials
+
+[NOTE]
+====
+These videos use alpha features only available in the next release.
+====
 
 *  link:http://www.youtube.com/watch?v=-OzRZscLlHY[Video: jMonkeyEngine SDK Use Case Demo 1 (Quixote)]
 *  link:http://www.youtube.com/watch?v=6-YWxD3JByE[Video: jMonkeyEngine SDK Use Case Demo 2 (Models and Materials)]
 
-Learn from sample code in link:https://github.com/jMonkeyEngine/jmonkeyengine/tree/master/jme3-examples/src/main/java/jme3test[src/main/java/jme3test] (also available in the sdk by File &gt; New Project &gt; JME3 Tests) and the example games provided by the community!
+Learn from sample code in link:https://github.com/jMonkeyEngine/jmonkeyengine/tree/master/jme3-examples/src/main/java/jme3test[src/main/java/jme3test] (also available in the sdk by `menu:File[New Project>JME3 Tests]`) and the example games provided by the community!
 
 
 == Documentation for Advanced Users
 
 Now that you understand the concepts, it's time to make the most of the jMonkeyEngine. Deep-dive into the +++<abbr title="Application Programming Interface">API</abbr>+++ and learn about all options, including less commonly used advanced methods. Don't over-extend yourself, developing a good game requires time and dedication. One step at a time, champ! :)
 
-*Controlling Game Logic*
+=== Controlling Game Logic
 
 *  <<jme3/advanced/update_loop#,Update Loop>>
 *  <<jme3/advanced/application_states#,Application States>>
@@ -130,7 +135,7 @@ Now that you understand the concepts, it's time to make the most of the jMonkeyE
 
 *  <<jme3/advanced/multithreading#,Multithreading>>
 
-*Managing Objects in the 3D Scene Graph*
+=== Managing Objects in the 3D Scene Graph
 
 *  <<jme3/advanced/traverse_scenegraph#,Traverse SceneGraph>>
 *  <<jme3/advanced/spatial#,Spatial: Node versus Geometry>>
@@ -144,7 +149,7 @@ Now that you understand the concepts, it's time to make the most of the jMonkeyE
 *  <<jme3/advanced/collision_and_intersection#,Collision and Intersection>>
 *  <<jme3/advanced/level_of_detail#,Level of Detail>>
 
-*Animations and Scenes*
+=== Animations and Scenes
 
 *  <<jme3/advanced/animation#,Animation>>
 *  <<jme3/advanced/cinematics#,Cinematics (cutscenes, fake destruction physics)>>
@@ -157,22 +162,21 @@ Now that you understand the concepts, it's time to make the most of the jMonkeyE
 **  link:https://docs.google.com/fileview?id=0B9hhZie2D-fENDBlZDU5MzgtNzlkYi00YmQzLTliNTQtNzZhYTJhYjEzNWNk&hl=en[Scene Workflow:]
 
 
-Create jme3 compatible racing tracks in blender
-* link:http://www.youtube.com/watch?v=3481ueuDJwQ&feature=youtu.be[Video: Create jme3 compatible models in blender]
-
-Exporting OgreXML scenes from Blender to JME3
+*  Create jme3 compatible racing tracks in blender
+**  link:http://www.youtube.com/watch?v=3481ueuDJwQ&feature=youtu.be[Video: Create jme3 compatible models in blender]
 
-*  link:https://docs.google.com/leaf?id=0B9hhZie2D-fEYmRkMTYwN2YtMzQ0My00NTM4LThhOTYtZTk1MTRlYTNjYTc3&hl=en[Animation Workflow: Create Animated UV-Mapped OgreXML Models in Blender, and use them in JME3]
-**  link:http://www.youtube.com/watch?v=IDHMWsu_PqA[Video: Creating Worlds with Instances in Blender]
-**  <<jme3/advanced/ogrecompatibility#,OgreCompatibility>>
+*  Exporting OgreXML scenes from Blender to JME3
+**  link:https://docs.google.com/leaf?id=0B9hhZie2D-fEYmRkMTYwN2YtMzQ0My00NTM4LThhOTYtZTk1MTRlYTNjYTc3&hl=en[Animation Workflow: Create Animated UV-Mapped OgreXML Models in Blender, and use them in JME3]
+***  link:http://www.youtube.com/watch?v=IDHMWsu_PqA[Video: Creating Worlds with Instances in Blender]
+***  <<jme3/advanced/ogrecompatibility#,OgreCompatibility>>
 
-* CadNav -> Mixamo -> JME Workflow [Video]
+*  CadNav -> Mixamo -> JME Workflow [Video]
 ** link:https://youtu.be/jHgAgTWIers?list=PLv6qR9TGkz8RcUr-fOHI2SksWA4BAU9TS[Part1- Download Free Human 3D Model From CadNav.com]
 ** link:https://youtu.be/GQJSrOpNQwI?list=PLv6qR9TGkz8RcUr-fOHI2SksWA4BAU9TS[Part 2- Rig and Animate Model in Mixamo]
 ** link:https://youtu.be/JzRe2Dxbcmc?list=PLv6qR9TGkz8RcUr-fOHI2SksWA4BAU9TS[Part 3- Import Model to JME]
 ** link:https://youtu.be/8wwDRDJop7k?list=PLv6qR9TGkz8RcUr-fOHI2SksWA4BAU9TS[Part 4- Play Animation (Final Result)]
 
-*Materials, Light, Shadow*
+=== Materials, Light, Shadow
 
 *  <<jme3/intermediate/how_to_use_materials#,How to Use Materials>>
 *  <<jme3/advanced/j3m_material_files#,Creating .j3m Materials>>
@@ -190,7 +194,7 @@ Exporting OgreXML scenes from Blender to JME3
 **  <<jme3/advanced/pbr_part2#,Physically Based Rendering – Part two>>
 **  <<jme3/advanced/pbr_part3#,Physically Based Rendering – Part three>>
 
-*Physics Integration*
+=== Physics Integration
 
 *  <<jme3/advanced/physics#,Physics: Gravity, Collisions, Forces>>
 *  <<jme3/advanced/bullet_multithreading#,Multi-Threaded Physics>>
@@ -202,7 +206,7 @@ Exporting OgreXML scenes from Blender to JME3
 *  <<jme3/advanced/ray_and_sweep_tests#,Physics Rays and Sweep Tests>>
 *  link:http://www.youtube.com/watch?v=yS9a9o4WzL8[Video: Mesh Tool &amp; Physics Editor]
 
-*Audio and Video*
+=== Audio and Video
 
 *  <<jme3/advanced/audio#,Audio: Playing Sounds>>
 *  <<jme3/advanced/audio_environment_presets#,Audio Environment Presets>>
@@ -210,13 +214,13 @@ Exporting OgreXML scenes from Blender to JME3
 *  <<jme3/advanced/screenshots#,Capture Screenshots>>
 *  <<jme3/advanced/capture_audio_video_to_a_file#,Capture Audio/Video to a File>>
 
-*Post-Processor Filters and Effects*
+=== Post-Processor Filters and Effects
 
 *  <<jme3/advanced/effects_overview#,Effects and Filters Overview>>
 *  <<jme3/advanced/bloom_and_glow#,Bloom and Glow>>
 *  <<jme3/advanced/particle_emitters#,Particle Emitters>>
 
-*Landscapes*
+=== Landscapes
 
 *  <<jme3/advanced/sky#,Sky>>
 *  <<jme3/advanced/terrain#,Terrain (TerraMonkey)>>
@@ -227,14 +231,14 @@ Exporting OgreXML scenes from Blender to JME3
 *  <<jme3/advanced/post-processor_water#,Post-Processor Water (SeaMonkey)>>
 *  <<jme3/contributions/vegetationsystem#,Vegetation System>>
 
-*Artificial Intelligence (AI)*
+=== Artificial Intelligence (AI)
 
 *  <<jme3/advanced/recast#,Recast Navigation>>
 *  <<jme3/advanced/building_recast#,Updating and building Recast Native Bindings>>
 *  <<jme3/advanced/monkey_brains#,Monkey Brains>>
 *  <<jme3/advanced/steer_behaviours#,Steer Behaviours>>
 
-*Multiplayer Networking*
+=== Multiplayer Networking
 
 *  <<jme3/advanced/networking#,Multiplayer Networking (SpiderMonkey)>>
 *  <<jme3/advanced/headless_server#,Headless Server>>
@@ -242,11 +246,11 @@ Exporting OgreXML scenes from Blender to JME3
 *  <<jme3/advanced/open_game_finder#,Open Game Finder>>
 *  <<jme3/advanced/networking_video_tutorials#,Videos: jME3 networking video tutorial series>>
 
-*Entity Systems*
+=== Entity Systems
 
 *  <<jme3/contributions/entitysystem#, The Zay-ES Entity System>>
 
-*Camera*
+=== Camera
 
 *  <<jme3/advanced/camera#,Camera>>
 *  <<jme3/advanced/making_the_camera_follow_a_character#,Making the Camera Follow a Character>>
@@ -254,7 +258,7 @@ Exporting OgreXML scenes from Blender to JME3
 *  <<jme3/advanced/multiple_camera_views#,Multiple Camera Views>>
 *  <<jme3/beginner/hellochasecam#,Chase camera (aka 3rd person camera) example>>
 
-*User Interaction*
+=== User Interaction
 
 *  <<jme3/advanced/input_handling#,Input Handling>>
 **  link:https://github.com/jMonkeyEngine-Contributions/Lemur/wiki/Modules[Lemur Scene Graph Tools]
@@ -266,7 +270,7 @@ Exporting OgreXML scenes from Blender to JME3
 *  <<jme3/advanced/combo_moves#,Combo Moves>>
 *  <<jme3/advanced/mouse_picking#,Mouse Picking: Click to Select>>
 
-*Graphical User Interface*
+=== Graphical User Interface
 
 *  link:https://github.com/jMonkeyEngine-Contributions/Lemur[Lemur - a native jME3 GUI library with scene graph tools]
 *  <<jme3/contributions/tonegodgui#,tonegodGUI - a native jME3 GUI library>>
@@ -277,47 +281,47 @@ Exporting OgreXML scenes from Blender to JME3
 *  <<jme3/advanced/localization#,Localization>>
 *  <<jme3/advanced/swing_canvas#,Swing Canvas>>
 
-*Custom Rendering*
+=== Custom Rendering
 
 *  <<jme3/advanced/jme3_forwardrendering#,Forward Rendering process>>
 *  <<jme3/advanced/jme3_renderbuckets#,Render Buckets>>
 
-*Custom Tools*
+=== Custom Tools
 
 *  <<jme3/tools/navigation#,Mercator Projection Tool (Marine Navigation)>>
 *  <<jme3/tools/charts#,Visualizing Maps in JME3 (Marine Charts)>>
 *  <<jme3/advanced/atom_framework#,Atom framework. Mash-up of other plugins>>
 
-*Logging and Debugging*
+=== Logging and Debugging
 
 *  <<jme3/advanced/logging#,Logging>>
 *  <<sdk/log_files#,Log Files>>
 *  <<jme3/advanced/read_graphic_card_capabilites#,Read Graphic Card Capabilites>>
 *  <<jme3/advanced/debugging#,Debugging with Wireframes>>
 
-*Android specific development*
+=== Android specific development
 
 *  <<jme3/advanced/android#,Android Project Cheat Sheet>>
 
-*Deployment*
+=== Deployment
 
 *  <<jme3/android#,Android>>
 *  <<sdk/application_deployment#,Application Deployment (using jMonkeyEngine SDK)>>
 *  <<jme3/webstart#,WebStart Deployment (without jMonkeyEngine SDK)>>
 
-*Scripting*
+=== Scripting
 
 *  <<jme3/scripting#, Groovy scripting>>
 
-*Virtual Reality &amp; Simulation*
+=== Virtual Reality &amp; Simulation
 
 *  <<jme3/virtualreality#, Virtual Reality. OpenCV &amp; JavaCV>>
 
-*jMonkey User Contributions*
+=== jMonkey User Contributions
 
 *  <<jme3/contributions#, Contributions - User made utilities to add functionality to the engine.>>
 
-*Sample Projects*
+=== Sample Projects
 
 *  <<sdk/sample_code#,JmeTests>> – The “official sample project JmeTests.
 *  link:http://code.google.com/p/jmonkeyengine/source/browse/BookSamples/#BookSamples%2Fsrc[BookSamples] – Some more jME3 code samples