Starting a project
To create a new project using MatlabProjectTemplate, go to the GitHub repo and click the green “Use this template” button near the upper right of the page.
Name your new repo after your project name. This will be visible to your end users, so pick a good name!
Once the new repo is created, clone it to your local machine, and edit the
project_settings.sh file to define your project’s basic properties and metadata.
Then open Matlab,
cd to the repo, and run
Have a look around the modified source tree, and if things look good to you, commit the changes with
git add -A; git commit -a -m 'Project initialization from MatlabProjectTemplate and do a
You’re ready to start developing! Next steps:
- Put your main Matlab source code in
- Put your example scripts in
- Edit the files in
doc-project/to reflect your plans.
- Hack away!
What not to do
Do not fork the MatlabProjectTemplate repo. That will make your project’s repo a child fork of MatlabProjectTemplate in the GitHub “fork tree”, instead of a “canonical” repo that is the root of its own fork tree. You don’t want that. You want your project to be a standalone, canonical repo on GitHub.
Do not clone the MatlabProjectTemplate repo. That will leave your local repo pointing to the wrong “origin” repo.
Use the “Use this template” button!
See also these pages:
- Project Layout
- Writing Documentation
- Creating Releases
- Automatic Package Initialization
- Using on Windows
More stuff to go here
TODO: add more content