Использование переменной make в bash-скрипте как часть команды в Makefile.

Вопрос или проблема

Я создал команду makefile для автоматизации рабочего процесса публикации, используя Pandoc и Generic Preprocessor (GPP). Она выглядит следующим образом:

TODAY = $(shell date +'%Y%m%d-%H%M')
MACROS = utils/gpp/macros.md
TEMPLATE = utils/template.docx

GPP = utils/gpp/gpp.exe
MACROS = utils/gpp/_macros.pp

METADATA = metadata.yaml
FM = content/frontmatter/*.md
MM = content/mainmatter/*.md
CONTENT = $(FM) $(MM)

default: docx

docx:
    for file in $(CONTENT); do \
        fifo=$$(mktemp -u); \
        FIFOS+=("$$fifo"); \
        cat $(MACROS) "$$file" | \
        $(GPP) -DWORD -x -o "$$fifo" & \
    done; \
    pandoc metadata.yaml "$${FIFOS[@]}" -f markdown -t docx \
    --citeproc --csl $(CSL) \
    --reference-doc=$(TEMPLATE) \
    --file-scope \
    -o dist/$(TODAY).docx

Она работает нормально в терминале Git на Windows. Однако на моей системе Ubuntu 24.04 я получаю ошибку /bin/sh: 1: Syntax error: "(" unexpected, и она указывает на строку for file in $(CONTENT); do \. Я пробовал следующее, но безуспешно:

for file in ( $(CONTENT) ); do \
for file in "$(CONTENT)"; do \

Почему это происходит, и как я могу это исправить? (Да, я знаю, что ссылка GPP должна быть обновлена для Ubuntu, но она даже не доходит до этой строки)

Репозиторий является публичным, если кто-то хочет попробовать его локально: https://github.com/khalid-hussain/editorial-project-template

Проблема в том, что /bin/sh, оболочка по умолчанию, используемая Make, это dash на Ubuntu, и ваш Makefile зависит от функций bash (в частности, массивов — ошибка в строке FIFOS+=). Вы можете указать использование bash вместо этого, указав

SHELL = /bin/bash

в вашем Makefile.

Ответ или решение

В мире информационных технологий использование Makefile является основополагающим элементом для автоматизации рабочих процессов. В приведенном вами вопросе была поставлена задача использовать переменные в сценариях Bash, что может стать источником первоначальных трудностей, особенно при переходе с одной операционной системы на другую.

Теория

Системы сборки, такие как Make, часто используют стандартную шелл-интерпретацию для выполнения команд, описанных в Makefile. По умолчанию на Ubuntu, Make использует /bin/sh, который ссылается на интерпретатор dash. Ваша ошибка указывает, что dash не может обработать синтаксис, специфичный для bash, что и вызывает проблемы.

Нюанс заключается в том, что совместимость bash и dash не всегда гарантирована, что может стать причиной ошибки типа: /bin/sh: 1: Syntax error: "(" unexpected. Это происходит, потому что dash не поддерживает некоторые конструкции, которые доступны в bash, такие как расширенные массивы и конструкции вроде +=, используемые в вашей Makefile.

Пример

В вашей Makefile вы определили сложный процесс преобразования файлов, где используется GPP и Pandoc. Это включает создание временных имен файлов и хранение их в массиве FIFOS, что ведет к использованию синтаксиса +=, характерного для bash.

Чтобы это исправить, один из стандартных подходов — сообщить Make использовать bash вместо dash. Это достигается добавлением следующей строки в ваш Makefile:

SHELL = /bin/bash

С этой модификацией Make будет использовать bash для выполнения команд и интерпретации скриптов, что устранит ошибки синтаксиса, связанные с несовместимостью команд.

Применение

Применяя это знание, вы можете улучшить ваш Makefile для использования на различных платформах без изменений. Ваш скрипт будет успешно выполняться на Ubuntu, используя нижеуказанные шаги:

Обновите ваш Makefile: Добавьте строку SHELL = /bin/bash в верхней части файла.
Убедитесь, что bash установлен: Хотя bash обычно установлен по умолчанию на большинстве систем Linux, рекомендуется убедиться, что он доступен по пути /bin/bash.
Проверка работоспособности: После внесения изменений запустите команду Make, чтобы удостовериться, что процесс выполнения проходит без ошибок.
Локальная отладка: Рекомендуется выполнять отладку скрипта в режиме интерактивного bash, если это необходимо, чтобы удостовериться, что все команды и синтаксические конструкции работают ожидаемым образом.
Документация: Напишите сопроводительное руководство по использованию вашего Makefile с учетной записью о необходимости использования bash вместо dash для пользователей, которые могут столкнуться с аналогичными проблемами.

Такой детальный подход не только гарантирует надёжность и кроссплатформенность вашего Makefile, но и обеспечивает легкость сопровождения и модификаций в будущем.

Комплексный и профессиональный подход к описанию и решению задачи делает ваш вклад в проект ценным и понятным для всей команды разработки. Используя данные советы, вы сможете успешно адаптировать и совершенствовать рабочие процессы под разными операционными системами, минимизируя риск сбоев и повышая эффективность рабочего процесса.