# 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 (на текущей машине)

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

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

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

```bash
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/
```

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

```bash
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)

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

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

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

```bash
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
```

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

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