This repository is a template I made and personally use to bootstrap my C and C++ projects.

Feel free to use it. It's licenced under Unlicence.
You will probably want to change the licence after you clone this, though.

Setting up your workspace

This project has a .editorconfig file to enforce project level coding standards.
CLion has built-in support, VSCode requires a plugin.

You can also use clang-format instead. Uncomment the include(ClangFormat) line in the CMakeLists.txt file and delete the .editorconfig file. Add a .clang-format file to the root of the project if desired.

How to run

This project requires CMake to build. Your IDE (VSCode or CLion) should automatically detect the CMakeLists.txt file and build the project. Install extensions for CMake support if prompted.
If you are using the command line, you can run the following commands:

cmake -B build

cmake --build build --config Debug

Then execute the following command to run the program:

Windows:

.\build\executable

Linux/MacOS:

./build/executable

Generating and Viewing Documentation

This project uses Doxygen to generate documentation.
If Doxygen is available on your system,
You can generate the documentation by running the doc CMake target.

cmake -B build

cmake --build build --target doc

To get graphs in the documentation, you will need to install Graphviz.
Set the HAVE_DOT option in the Doxyfile to NO if you do not have Graphviz installed.

This repository also has an automated workflow to generate documentatation via Github Actions.

The generated documentation can be viewed at ./docs. Documentation is auto-generated and deployed to Github Pages.

Note: Disable Actions on your own copy or delete the workflows folder if you do not want to be billed. (Only for private repos)