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

Цель Ссылка на заголовок

Оптимизировать сгенерированные Doxygen файлы для работы с мобильными устройствами.

Средства и интсрументы Ссылка на заголовок

Поскольку автодеплой идёт по Web-hook-у Gitea, то логично использование PHP.

Алгоритм Ссылка на заголовок

  1. Gitea: получает обновление репозитория и запускает web-hook на локальный адрес.
  2. PHP: сравнивает секретный код hook-а, запускает соответствующий скрипт.
  3. PHP: вытягивает во временную папку изменения из репозитория.
  4. PHP: запускает Doxygen.
  5. PHP: ищет все сгенерированные .html файлы и вставляет в блок <head></head> ссылку на скрипт.
  6. PHP: в найденных файлах изменяет открывающий тег <body> - добавляет к нему свойство onload с вызовом функции инициализации вставленного
  7. PHP: непосредственно после открывающего тега <body> вставляет нужный <div style="display:none;"></div> блок содержащий в себе необходимые для работы скрипта DOM-объекты(svg, img и прочие).
  8. PHP: завершает выполнение, делает отметку в логе и уведомляет Gitea о результате.

Суть оптимизации Ссылка на заголовок

  • Во все блоки кода сгенерированных файлов вставляется иконка для копирования содержания.
  • Боковое меню на мобильных устройствах должно иметь 2 положения:
    • скрыто: полностью свёрнуто.
    • открыто: развёрнуто на весь экран.

Почему именно так Ссылка на заголовок

  1. Как перфекционист - не хочу засорять код вставляя скрипты в тело документа.
  2. Лишний раз прокачаю навыки JS/CSS/PHP.

Нюансы Ссылка на заголовок

Придётся рефакторить весь JavaScript код связанный с работой бокового меню.

Польза Ссылка на заголовок

Помимо оптимизации внешнего вида останутся инструменты которые возможно пригодятся другим энтузиастам.

Скорее всего это выльется в очередной подмодуль проекта NeurOX или даже скорее в самостоятельный проект.