F7 Office Deploy d6a3131297 F7 Office: кастомизация брендинга, конфиги coolwsd и Apache

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-02-16 16:53:12 +00:00

4.4 KiB

Raw Blame History

F7 Office — файлы для Git и развёртывания

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

Пути из службы coolwsd (куда смотрит сервис)

Конфиг: /etc/coolwsd/coolwsd.xml
Корень статики: /usr/share/coolwsd (в конфиге: file_server_root_path = browser/../)
Клиент по URL: /browser/ → каталог /usr/share/coolwsd/browser/
Apache (пример): /etc/apache2/sites-available/collabora-le-ssl.conf — прокси на http://127.0.0.1:9980/browser и Alias на dist/f7cloud

Список изменённых файлов для репозитория

В репозиторий имеет смысл положить только эти файлы (в структуре каталогов как на сервере):

etc/
  coolwsd/
    coolwsd.xml
  apache2/
    sites-available/
      collabora-le-ssl.conf

usr/share/coolwsd/browser/dist/
  branding.js
  branding.css
  branding-mobile.css
  branding-tablet.css
  cool.html
  wasm.html
  welcome/
    welcome.html
  src/
    layer/
      tile/
        CanvasTileUtils.js
        TileWorker.js
  f7cloud/
    branding.js
    branding.css
    branding-desktop.css
    branding-mobile.css
    branding-tablet.css
    loading-preview.html
    images/   # при необходимости — только если меняли картинки

Остальное (bundle.js, l10n, admin, тысячи ресурсов) ставится пакетами coolwsd и code-brand и в Git не нужно.

Как выложить в Git (на текущей машине)

Создать репозиторий на https://git.f7cloud.ru/ (например, f7office-deploy).
Создать каталог проекта и структуру:

mkdir -p f7office-deploy/{etc/coolwsd,etc/apache2/sites-available,usr/share/coolwsd/browser/dist/{welcome,src/layer/tile,f7cloud}}

Скопировать файлы с сервера в эту структуру:

cd f7office-deploy
cp /usr/share/coolwsd/browser/dist/branding.js usr/share/coolwsd/browser/dist/
cp /usr/share/coolwsd/browser/dist/branding.css usr/share/coolwsd/browser/dist/
cp /usr/share/coolwsd/browser/dist/branding-mobile.css usr/share/coolwsd/browser/dist/
cp /usr/share/coolwsd/browser/dist/branding-tablet.css usr/share/coolwsd/browser/dist/
cp /usr/share/coolwsd/browser/dist/cool.html usr/share/coolwsd/browser/dist/
cp /usr/share/coolwsd/browser/dist/wasm.html usr/share/coolwsd/browser/dist/
cp /usr/share/coolwsd/browser/dist/welcome/welcome.html usr/share/coolwsd/browser/dist/welcome/
cp /usr/share/coolwsd/browser/dist/src/layer/tile/CanvasTileUtils.js usr/share/coolwsd/browser/dist/src/layer/tile/
cp /usr/share/coolwsd/browser/dist/src/layer/tile/TileWorker.js usr/share/coolwsd/browser/dist/src/layer/tile/
cp -r /usr/share/coolwsd/browser/dist/f7cloud usr/share/coolwsd/browser/dist/
cp /etc/coolwsd/coolwsd.xml etc/coolwsd/
cp /etc/apache2/sites-available/collabora-le-ssl.conf etc/apache2/sites-available/

Положить в корень репозитория: DEPLOY.md, install-f7office.sh, этот README-GIT.md.
Инициализировать Git и отправить:

git init
git add .
git commit -m "F7 Office customizations and configs"
git remote add origin https://git.f7cloud.ru/.../f7office-deploy.git
git push -u origin main

Установка на новую машину (git clone)

Установить Collabora/coolwsd и брендинг:

# репозиторий CODE-ubuntu2204 и пакеты coolwsd, code-brand
sudo apt-get update && sudo apt-get install -y coolwsd code-brand

Клонировать репозиторий и установить файлы:

git clone https://git.f7cloud.ru/.../f7office-deploy.git
cd f7office-deploy
# Адаптировать install-f7office.sh под структуру репо (usr/ и etc/ в корне)
chmod +x install-f7office.sh
sudo ./install-f7office.sh

При необходимости разложить конфиги Apache и coolwsd вручную и перезапустить сервисы.

Подробные шаги и предупреждения — в DEPLOY.md.