diff --git a/README.md b/README.md index 199db6fef..99e27e078 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,42 @@ Note: MOOSE is complementary to [MIST](https://github.com/mrSkortch/MissionScrip The goal of MOOSE is to allow mission designers to enhance their scripting with mission orchestration objects, which can be instantiated from defined classes within the framework. This will allow to write mission scripts with minimal code embedded. Of course, the richness of the framework will determine the richness of the misson scenarios. We can expect that MOOSE will evolve over time, as more missions will be designed within the framework. +# Installation of tools and sync the MOOSE repository. + +1. Install [Eclipse LDT](https://eclipse.org/ldt) on your Windows 64 bit system. This is a free lua editor based on the Eclipse ecosystem. The advantage of LDT is that it greatly enhances your lua development environment with intellisense, better search capabilities etc. You may have to install [java](https://www.java.com/en/download) first. Ensure you install the **64-bit versions** of both Eclipse LDT and java! +2. Install [GITHUB](https://desktop.github.com) desktop. We use GITHUB desktop to sync the moose repository to your system. +3. Link the MOOSE repository on GITHUB to your freshly installed GITHUB desktop. Do this by browing to the MOOSE repository at GITHUB, and select the green button **Clone or Download** -> **Open in Desktop**. +4. Specify a local directory on your PC where you want to store the MOOSE repository contents. +5. Sync the MOOSE repository to a defined local MOOSE directory on your PC using GITHUB desktop (press the sync button). +6. On your local MOOOSE directory, execute the batch file [DCS_Folder_Sync.bat](https://github.com/FlightControl-Master/MOOSE/blob/master/DCS_Folder_Sync.bat). This will sync the dcs folder in the MOOSE repository from the submodule DCS API. + +As a result, you have installed the MOOSE repository on your PC, and it is fully synced. + +# Setup Eclipse LDT to work with MOOSE and activate your intellisense etc. + +1. Open Eclipse LDT. +2. Select the workspace to be stored at your user id. +3. Select from the Menu: File -> New -> Lua Project. + +![LDT_New_Project](Setup\LDT_New_Project.JPG) + +4. A dialog box is shown. + +![LDT_Project](Setup\LDT_Project.JPG) + +5. Type the Project Name: Moose_Framework +6. In the sub-box Project Contents, select the option Create Project at existing location (from existing source). Browse to the local MOOSE directory and select the root directory of MOOSE. +7. Select the Next button. +8. You should see now a dialog box with the following properties. Note that the Moose_Framework/Moose Development/Moose directory is flagged as the **Source Directory*. This is important because it will search in the files in this directory and sub directories for lua documentator enabled lua files. It will make the intellisense work! + +![LDT Finish](Setup\LDT_Moose_Framework_Finish.JPG) + +9. Press the Finish button. + +As a result, when you browse to the Script Explorer, you'll see the following: + +![LDT_Script_Explorer](Setup\LDT_Script_Explorer.JPG) + # MOOSE Directory Structure * Moose Development: Contains the collection of lua files that define the MOOSE classes. You can use this directory to build the dynamic luadoc documentation intellisense in your eclipse development environment. diff --git a/docs/Setup/LDT_Moose_Framework_Finish.JPG b/docs/Setup/LDT_Moose_Framework_Finish.JPG new file mode 100644 index 000000000..b433f392c Binary files /dev/null and b/docs/Setup/LDT_Moose_Framework_Finish.JPG differ diff --git a/docs/Setup/LDT_New_Project.JPG b/docs/Setup/LDT_New_Project.JPG new file mode 100644 index 000000000..0d0fe94e7 Binary files /dev/null and b/docs/Setup/LDT_New_Project.JPG differ diff --git a/docs/Setup/LDT_Project.JPG b/docs/Setup/LDT_Project.JPG new file mode 100644 index 000000000..ac36141e4 Binary files /dev/null and b/docs/Setup/LDT_Project.JPG differ diff --git a/docs/Setup/LDT_Project_Source_Directory.JPG b/docs/Setup/LDT_Project_Source_Directory.JPG new file mode 100644 index 000000000..abb1e78ad Binary files /dev/null and b/docs/Setup/LDT_Project_Source_Directory.JPG differ diff --git a/docs/Setup/LDT_Script_Explorer.JPG b/docs/Setup/LDT_Script_Explorer.JPG new file mode 100644 index 000000000..67df16696 Binary files /dev/null and b/docs/Setup/LDT_Script_Explorer.JPG differ