Public Access
Jonathan Miller
95880d3e44
Platform: mokocli CI / Gate 2: Unit Tests (8.1) (pull_request) Blocked by required conditions
Platform: mokocli CI / Gate 2: Unit Tests (8.2) (pull_request) Blocked by required conditions
Platform: mokocli CI / Gate 2: Unit Tests (8.3) (pull_request) Blocked by required conditions
Platform: mokocli CI / Gate 3: Self-Health Check (pull_request) Blocked by required conditions
Platform: mokocli CI / Gate 4: Governance (pull_request) Blocked by required conditions
Platform: mokocli CI / Gate 5: Template Integrity (pull_request) Blocked by required conditions
Platform: mokocli CI / CI Summary (pull_request) Blocked by required conditions
Universal: PR Check / Build RC Package (pull_request) Blocked by required conditions
Universal: PR Check / Report Issues (pull_request) Blocked by required conditions
Universal: PR Check / Branch Policy (pull_request) Successful in 1s
Universal: PR Check / Validate PR (pull_request) Failing after 5s
Universal: PR Check / Secret Scan (pull_request) Successful in 7s
RC Revert / Rename rc/ back to dev/ (pull_request) Has been skipped
Branch Cleanup / Delete merged branch (pull_request) Failing after 1s
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Successful in 14s
Platform: mokocli CI / Gate 1: Code Quality (pull_request) Failing after 53s
390 files: templates, workflows, MCP servers, CLI tools, lib, deploy, validate, wrappers, configs, docs. Pure find-and-replace.
104 lines
3.1 KiB
Markdown
104 lines
3.1 KiB
Markdown
<!--
|
|
Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
|
|
SPDX-License-Identifier: GPL-3.0-or-later
|
|
FILE INFORMATION
|
|
DEFGROUP: MokoPlatform.Index
|
|
INGROUP: MokoPlatform.Templates.Makefiles
|
|
REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
|
|
PATH: /templates/makefiles/README.md
|
|
BRIEF: Makefile templates README
|
|
-->
|
|
|
|
# Makefile Templates
|
|
|
|
This directory contains Makefile templates for different repository types.
|
|
|
|
## Template Files
|
|
|
|
### Makefile.generic.template
|
|
Generic Makefile for standard repositories. Includes common targets for:
|
|
- Building and compiling
|
|
- Testing and linting
|
|
- Cleaning and maintenance
|
|
- Development workflow automation
|
|
|
|
**Usage:**
|
|
```bash
|
|
cp templates/makefiles/Makefile.generic.template ./Makefile
|
|
```
|
|
|
|
### Makefile.joomla.template
|
|
Joomla-specific Makefile for extensions (components, modules, plugins, etc.). Includes targets for:
|
|
- Joomla manifest validation
|
|
- Extension packaging
|
|
- Installation and deployment
|
|
- Testing with Joomla framework
|
|
- Build artifact creation
|
|
|
|
**Usage:**
|
|
```bash
|
|
cp templates/makefiles/Makefile.joomla.template ./Makefile
|
|
```
|
|
|
|
### Makefile.dolibarr.template
|
|
Dolibarr-specific Makefile for modules. Includes targets for:
|
|
- Module descriptor validation
|
|
- SQL migration management
|
|
- Module packaging
|
|
- Installation and deployment
|
|
- Testing with Dolibarr framework
|
|
- Build artifact creation
|
|
|
|
**Usage:**
|
|
```bash
|
|
cp templates/makefiles/Makefile.dolibarr.template ./Makefile
|
|
```
|
|
|
|
## Template Naming Convention
|
|
|
|
All Makefile templates use the `.template` extension to clearly distinguish them from active Makefile files. When copying to your repository:
|
|
|
|
1. **Remove the .template extension**: `Makefile.generic.template` → `Makefile`
|
|
2. **Customize for your project**: Update variables and targets as needed
|
|
3. **Test the targets**: Run `make help` to see available targets
|
|
|
|
## Customization
|
|
|
|
After copying a template:
|
|
|
|
1. Update project-specific variables at the top of the Makefile
|
|
2. Modify paths to match your repository structure
|
|
3. Add or remove targets based on your needs
|
|
4. Update dependencies between targets if necessary
|
|
|
|
## Schema Integration
|
|
|
|
These Makefile templates are referenced in the repository structure schemas:
|
|
|
|
- **default-repository.xml**: Uses `Makefile.generic.template` (suggested)
|
|
- **waas-component.xml**: Uses `Makefile.joomla.template` (required)
|
|
- **crm-module.xml**: Uses `Makefile.dolibarr.template` (required)
|
|
|
|
The schemas define source/destination mappings that automatically convert `.template` extensions to the final `Makefile` name.
|
|
|
|
## Common Targets
|
|
|
|
Most templates include these standard targets:
|
|
|
|
- `make help` - Display available targets
|
|
- `make build` - Build the project
|
|
- `make test` - Run tests
|
|
- `make lint` - Run linters
|
|
- `make clean` - Clean build artifacts
|
|
- `make install` - Install dependencies
|
|
- `make package` - Create distribution package
|
|
|
|
Platform-specific templates may include additional targets relevant to their ecosystem.
|
|
|
|
## Support
|
|
|
|
For questions or issues with Makefile templates:
|
|
- See main mokocli documentation
|
|
- Check the platform-specific guides (Joomla, Dolibarr)
|
|
- Review the schema documentation for source/destination details
|