1. Project Registration

Projects located in _projects/ are registered in the _projects/.makeprojects file. Adding a project name to this file enables the main Makefile to include it in the build cycle.

2. Asset Distribution

Each project has its own Makefile that handles the distribution of assets to the main Jekyll folders during the make process:

JavaScript Integration

• Source: _projects/test-project/js/
• Destination: assets/js/projects/test-project/
• Any .js files you place in the project’s js/ folder are automatically copied. You can then reference them in your HTML/Notebooks using the destination path.

Sass & CSS Integration

• Source: _projects/test-project/sass/
• Sass Destination: _sass/projects/test-project/
• CSS Entry Point: assets/css/projects/test-project/main.scss

The build system automatically creates a CSS entry point that imports your project’s Sass. This allows you to use Jekyll’s native Sass processing while keeping your project styles modular.

3. Build Automation

When you run make from the root, it triggers make build inside the project folder. This ensures that assets are always up to date before the Jekyll server starts.

4. Live Testing

Below is a live test that verifies the JS and Sass integration. If the project was built correctly, the status below will turn green.

JS Integration Test

Waiting for script verification...