Difference between revisions of "Alternative file layout"
From MSX Game Library
| Line 1: | Line 1: | ||
| − | By default, projects using {{MSXGL}} are placed inside the library tree in the <tt> | + | By default, projects using {{MSXGL}} are placed inside the library tree in the <tt>projects</tt> directory. |
This allows all projects to share the same library source and data, and common build options (in <tt>/projects/default_config.js</tt>). | This allows all projects to share the same library source and data, and common build options (in <tt>/projects/default_config.js</tt>). | ||
| Line 9: | Line 9: | ||
└─📁 tools | └─📁 tools | ||
| − | Having said that, some might prefer the opposite: to have one directory per project and the MSXgl directory inside. | + | Having said that, some users might prefer the opposite: to have one directory per project and the MSXgl directory inside (which is more classic and doesn't generate duplication if you only have one project). |
| + | |||
| + | Alternative layout: | ||
| + | 📁 '''MyProject''' | ||
| + | └─📁 MSXgl | ||
| + | ├─📁 engine | ||
| + | ├─📁 projects | ||
| + | └─📁 tools | ||
| + | |||
| + | Here are the steps to follow: | ||
| + | * Create your <tt>MyProject</tt> directory wherever you want. | ||
| + | * [[Install|Install MSXgl]] in it (in <tt>MyProject/MSXgl</tt> for example). | ||
| + | * Create your source files in the <tt>MyProject</tt> directory. For example, copy all the files from the <tt>MSXgl/projects/template</tt> directory to the root of your project. | ||
| + | * Modify the <tt>build.bat</tt> (Windows) or <tt>build.sh</tt> (Linux/macOS) to indicate the path to Node.js (in <tt>MSXgl/tools/build/Node<tt>) and to the build script (<tt>MSXgl/engine/script/js<tt>). | ||
| + | * You're done :) You can now build your project from the root of your directory. | ||
Revision as of 13:52, 31 October 2023
By default, projects using MSXGL are placed inside the library tree in the projects directory. This allows all projects to share the same library source and data, and common build options (in /projects/default_config.js).
Default layout:
📁 MSXgl ├─📁 engine ├─📁 projects │ └─📁 MyProject └─📁 tools
Having said that, some users might prefer the opposite: to have one directory per project and the MSXgl directory inside (which is more classic and doesn't generate duplication if you only have one project).
Alternative layout:
📁 MyProject └─📁 MSXgl ├─📁 engine ├─📁 projects └─📁 tools
Here are the steps to follow:
- Create your MyProject directory wherever you want.
- Install MSXgl in it (in MyProject/MSXgl for example).
- Create your source files in the MyProject directory. For example, copy all the files from the MSXgl/projects/template directory to the root of your project.
- Modify the build.bat (Windows) or build.sh (Linux/macOS) to indicate the path to Node.js (in MSXgl/tools/build/Node<tt>) and to the build script (<tt>MSXgl/engine/script/js<tt>).
- You're done :) You can now build your project from the root of your directory.