dev: update makefile with practicalli standard task

Resolve: #8

Author: practicalli-johnny

CHANGELOG.md

@@ -9,3 +9,4 @@
 - dev: set markdown and make as github repository language attributes
 - dev: use inclusive git ignore patters
 - readme: update CI status badges
+- dev: update makefile with practicalli standard task

Makefile

@@ -8,27 +8,23 @@
 # https://makefiletutorial.com/#phony
 .PHONY: all clean docs lint pre-commit-check test
 
-
 # ------- Makefile Variables --------- #
-
 # run help if no target specified
 .DEFAULT_GOAL := help
+SHELL := /usr/bin/zsh
 
 # Column the target description is printed from
 HELP-DESCRIPTION-SPACING := 24
 
 # Tool Commands
-MEGALINTER_RUNNER = npx mega-linter-runner --flavor documentation --env "'MEGALINTER_CONFIG=.github/config/megalinter.yaml'" --remove-container
-MKDOCS_SERVE = mkdocs serve --dev-addr localhost:7777
+MEGALINTER_RUNNER := npx mega-linter-runner --flavor documentation --env "'MEGALINTER_CONFIG=.github/config/megalinter.yaml'" --env "'VALIDATE_ALL_CODEBASE=true'"  --remove-container
+MKDOCS_SERVER := mkdocs serve --dev-addr localhost:7777
 
 # Makefile file and directory name wildcard
 EDN-FILES := $(wildcard *.edn)
-
 # ------------------------------------ #
 
-
 # ------  Quality Checks  ------------ #
-
 pre-commit-check: lint
 
 lint:  ## Run MegaLinter with custom configuration (node.js required)
@@ -39,38 +35,38 @@ lint-fix:  ## Run MegaLinter with custom configuration (node.js required)
 	$(info --------- MegaLinter Runner ---------)
 	$(MEGALINTER_RUNNER) --fix
 
-
 lint-clean:  ## Clean MegaLinter report information
 	$(info --------- MegaLinter Clean Reports ---------)
 	- rm -rf ./megalinter-reports
 
+megalinter-upgrade:  ## Upgrade MegaLinter config to latest version
+	$(info --------- MegaLinter Upgrade Config ---------)
+	npx mega-linter-runner@latest --upgrade
 # ------------------------------------ #
 
-
 # --- Documentation Generation  ------ #
-
-docs:  ## Build and run mkdocs in local server
+python-venv:  ## Enable Python Virtual Environment for MkDocs
 	$(info --------- Mkdocs Local Server ---------)
-	$(MKDOCS_SERVE)
+	source ~/.local/venv/bin/activate
 
-docs-changed:  ## Build only changed files and run mkdocs in local server
+docs: ## Build and run mkdocs in local server (python venv)
 	$(info --------- Mkdocs Local Server ---------)
-	$(MKDOCS_SERVE) --dirtyreload
+	source ~/.local/venv/bin/activate && $(MKDOCS_SERVER)
 
-docs-build:  ## Build mkdocs
+docs-changed:  ## Build only changed files and run mkdocs in local server (python venv)
 	$(info --------- Mkdocs Local Server ---------)
-	mkdocs build
+	source ~/.local/venv/bin/activate && $(MKDOCS_SERVER) --dirtyreload
 
+docs-build:  ## Build mkdocs (python venv)
+	$(info --------- Mkdocs Local Server ---------)
+	source ~/.local/venv/bin/activate && mkdocs build
 # ------------------------------------ #
 
-
 # ------------ Help ------------------ #
-
 # Source: https://nedbatchelder.com/blog/201804/makefile_help_target.html
 
 help:  ## Describe available tasks in Makefile
 	@grep '^[a-zA-Z]' $(MAKEFILE_LIST) | \
 	sort | \
 	awk -F ':.*?## ' 'NF==2 {printf "\033[36m  %-$(HELP-DESCRIPTION-SPACING)s\033[0m %s\n", $$1, $$2}'
-
 # ------------------------------------ #