Jak dodać niestandardowe czcionki do serwera dokumentów ONLYOFFICE

Aby udostępnić niestandardowy krój czcionki w ONLYOFFICE Docs, zainstaluj jego pliki czcionek na komputerze lub kontenerze z uruchomionym serwerem dokumentów, ponownie wygeneruj listę czcionek serwera i sprawdź wynik w edytorze oraz wyeksportowanym dokumencie. Dokładny krok dotyczący utrwalania plików zależy od tego, czy serwer jest zainstalowany bezpośrednio na Linuksie, czy działa w Dockerze.

Pomyślna zmiana oznacza, że ​​czcionka pojawia się pod nazwą rodziny w selektorze czcionek edytora i wyświetla się zgodnie z oczekiwaniami w dokumencie testowym. Zobaczenie nazwy w menu to przydatny pierwszy krok, ale nie gwarantuje to, że każdy styl, język lub ścieżka eksportu działa. Przed użyciem czcionki w dokumentach produkcyjnych sprawdź tekst zwykły i pogrubiony, wszelkie wymagane zestawy znaków oraz podgląd PDF lub wydruku.

Co się zmienia po zainstalowaniu czcionki?

ONLYOFFICE Docs korzysta z czcionek dostępnych na serwerze Document Server i tworzy metadane czcionek dla swoich edytorów. Instrukcje instalacji dostawcy zawierają listę rodzin czcionek TrueType i OpenType, w tym .ttf, .otf, .ttci formaty pokrewne, a także formaty WOFF. Obsługiwane typy plików nie gwarantują identycznego działania każdego pliku czcionki lub funkcji czcionki; przetestuj konkretną czcionkę i dokument, których planujesz używać.

Instalacja czcionek po stronie serwera umożliwia podłączonym redaktorom korzystanie z czcionki za pośrednictwem Serwera Dokumentów. Nie instaluje ona kroju pisma na komputerach wszystkich użytkowników ani na innych serwerach przetwarzania dokumentów. Jeśli pobrany lub oddzielnie otwarty plik zostanie wyświetlony w oprogramowaniu, które nie obsługuje danej czcionki, oprogramowanie to może ją zastąpić inną. ONLYOFFICE zauważa również, że dokumenty mogą być wyświetlane z najbliższym odpowiednikiem, gdy serwer nie posiada czcionki używanej w dokumencie, co może wpłynąć na podział wiersza lub układ strony.

Używaj plików czcionek, które masz uprawnienia do wdrożenia na serwerze. Zachowaj pliki i ich warunki licencji w dokumentacji wdrożenia, zwłaszcza jeśli czcionka ma ograniczenia dotyczące użytkowania na serwerze, redystrybucji lub osadzania w dokumentach.

Wybierz odpowiednią metodę instalacji

• Instalacja pakietu Linux: skopiuj pliki czcionek do systemowego katalogu czcionek na komputerze z Serwerem Dokumentów, a następnie uruchom skrypt generujący czcionki ONLYOFFICE. Jest to odpowiednie rozwiązanie, gdy zarządzasz hostem bezpośrednio.
• Kontener Dockera: zamontuj stały katalog hosta w katalogu czcionek kontenera lub skopiuj czcionki do działającego kontenera na potrzeby krótkotrwałego testu. Wygeneruj ponownie metadane czcionek w kontenerze. Montowanie z powiązaniem zachowuje ważność po odtworzeniu kontenera; jednorazowa kopia do kontenera zazwyczaj nie.
• Wdrożenie zarządzane lub zintegrowane: jeśli kontenerem Serwera Dokumentów zarządza inna platforma lub narzędzie instalacyjne, należy zastosować trwałe montowanie za pośrednictwem konfiguracji tego wdrożenia. Edycja samego działającego kontenera może zostać utracona podczas aktualizacji lub wymiany.

Aktualnie publikowane przewodniki po czcionkach ONLYOFFICE przedstawiają ten sam główny schemat działania dla edycji Community Edition w systemach Linux i Docker, a także zawierają osobny przewodnik po systemie Linux dla edycji Enterprise Edition. Ścieżki, uprawnienia i koordynacja kontenerów mogą się różnić w zależności od wersji i metody instalacji, dlatego należy korzystać z istniejącej konfiguracji wdrożenia, zamiast zastępować ją przykładową konfiguracją z innego środowiska.

Dodawanie czcionek w instalacji systemu Linux

1. Przygotuj i zainstaluj pliki czcionek

Uzyskaj wymagane pliki rodzin czcionek, w tym prawdziwe warianty pogrubienia i kursywy, jeśli rodzina je udostępnia. Przechowuj standardową rodzinę czcionek w jasno nazwanym katalogu. Na przykład administrator może umieścić rodzinę czcionek w /usr/share/fonts/katalogu , który jest używany w instrukcji ONLYOFFICE dla systemu Linux:

sudo mkdir -p /usr/share/fonts/custom/brand-sans
sudo cp BrandSans-*.ttf /usr/share/fonts/custom/brand-sans/

Zastąp przykładowe nazwy plików plikami, które faktycznie posiadasz. Unikaj zmiany nazw plików czcionek w celu zmiany ich nazwy rodziny; edytorzy korzystają z metadanych przechowywanych w każdym pliku czcionki. Upewnij się, że procesy serwera dokumentów mogą odczytywać te pliki. Jeśli zarządzasz czcionkami za pomocą systemu zarządzania pakietami lub konfiguracją, użyj tego procesu, aby pliki pozostały dostępne po konserwacji.

2. Wygeneruj ponownie listę czcionek ONLYOFFICE

Po zainstalowaniu plików uruchom skrypt dostawcy generujący czcionki:

sudo /usr/bin/documentserver-generate-allfonts.sh

Poczekaj, aż skrypt dobiegnie końca i sprawdź jego wyniki pod kątem błędów. Ten krok aktualizuje dane czcionek używane przez Serwer Dokumentów; samo skopiowanie pliku czcionki na hosta może nie spowodować jego wyświetlenia w już uruchomionym edytorze. Nie usuwaj istniejących czcionek serwerowych w ramach tej procedury. Dostawca ostrzega, że ​​usunięcie czcionek systemowych może wpłynąć na układ i wyświetlanie dokumentu.

Dodawanie czcionek do wdrożenia Docker

1. Ustaw katalog czcionek jako trwały

W przypadku wdrożenia zarządzanego za pomocą Docker Compose należy dodać montowanie powiązania do istniejącej usługi serwera dokumentów. Utwórz katalog hosta dla plików, a następnie zmapuj go do katalogu czcionek niestandardowych kontenera. Obraz Dockera w ONLYOFFICE jest deklarowany /usr/share/fonts/truetype/customjako wolumin, a jego instrukcje dotyczące czcionek w Dockerze umożliwiają również kopiowanie czcionek w /usr/share/fonts/.

services:
  onlyoffice-documentserver:
    image: onlyoffice/documentserver:<your-pinned-version>
    volumes:
      - /srv/onlyoffice/fonts:/usr/share/fonts/truetype/custom

To fragment kodu do scalenia z bieżącym plikiem Compose, a nie kompletna konfiguracja zastępcza. Zachowaj istniejącą wersję obrazu, sieci, zmienne środowiskowe, woluminy danych, klucze tajne i nazwę usługi. Przygotuj pliki czcionek na hoście /srv/onlyoffice/fontsi upewnij się, że kontener może je odczytać.

Zastosowanie zmienionego pliku Compose może spowodować ponowne utworzenie kontenera Serwera Dokumentów i przerwanie aktywnych sesji edycji. Sprawdź procedurę wdrożenia, wykonaj kopię zapasową konfiguracji Compose i odpowiednio zaplanuj zmianę. Jeśli kontener jest zarządzany przez urządzenie lub integrację, użyj obsługiwanej przez nią metody konfiguracji zamiast edytować wygenerowany plik Compose.

2. Utwórz ponownie lub uruchom ponownie, a następnie wygeneruj metadane czcionek

Zastosuj montowanie, korzystając ze standardowego przepływu pracy Compose dla swojego wdrożenia. Następnie uruchom skrypt generowania czcionek w kontenerze serwera dokumentów. W przypadku kontenera o nazwie onlyoffice-documentserverpolecenie wygląda następująco:

docker exec onlyoffice-documentserver   /usr/bin/documentserver-generate-allfonts.sh

Użyj nazwy lub identyfikatora kontenera pokazanego przez docker ps. Jeśli chcesz tylko sprawdzić czcionkę przed utrwaleniem konfiguracji, dostawca dokumentuje kopiowanie plików czcionek do działającego kontenera za pomocą docker cp, a następnie uruchamianie w nim tego samego skryptu. Potraktuj to jako test: pliki skopiowane do kontenera mogą zniknąć po jego wymianie.

Sprawdź czcionkę w edytorze i na wyjściu

1. Otwórz dokument w edytorze połączonym z tym serwerem dokumentów i otwórz selektor czcionek. Wyszukaj nazwę rodziny czcionki zapisaną w jej metadanych.
2. Utwórz krótki dokument testowy ze zwykłym tekstem, pogrubionym tekstem i znakami z potrzebnych skryptów językowych. Upewnij się, że wybrano prawidłową grubość, a nie styl syntetyczny lub zastępczy.
3. Zapisz, otwórz ponownie i wyeksportuj lub wydrukuj podgląd dokumentu testowego. Porównaj podziały wierszy, liczbę stron, odstępy i pokrycie glifów z oczekiwanym rezultatem.
4. Powtórz sprawdzenie w edytorze dokumentów lub aplikacji, z której faktycznie korzystają użytkownicy. Dostępność czcionki na serwerze nie gwarantuje, że jest ona dostępna w innej aplikacji lokalnej lub na innym serwerze.

W przypadku starszych instalacji, metadane czcionek przechowywane w pamięci podręcznej przeglądarki mogą opóźniać to, co widzą użytkownicy. Opublikowane przewodniki ONLYOFFICE zalecają, aby w przypadku wersji 8.1.3 lub starszych wyczyścić pamięć podręczną przeglądarki i ponownie otworzyć stronę po dodaniu czcionek; w nowszych wersjach ten krok nie jest wymagany. Najpierw sprawdź pliki po stronie serwera i wygenerowane metadane, a następnie skorzystaj z zaleceń dotyczących pamięci podręcznej tylko wtedy, gdy będą one zgodne z Twoją wersją.

Jeśli brakuje czcionki lub układ ulegnie zmianie

• Czcionka nie jest widoczna w selektorze: sprawdź, czy plik znajduje się w katalogu czcionek na hoście serwera dokumentów lub w odpowiednim kontenerze, jest czytelny i ma obsługiwany typ pliku. Uruchom ponownie skrypt generujący czcionki i odczytaj jego dane wyjściowe. W Dockerze sprawdź montowanie z poziomu kontenera; sama ścieżka hosta nie dowodzi, że wolumin jest podłączony do aktywnej usługi.
• Nazwa rodziny wygląda inaczej: sprawdź osadzone metadane rodziny czcionki. Nazwa pliku, taka jak „ BrandSans-Bold.ttfmoże być zainstalowana poprawnie”, podczas gdy menu pokazuje nazwę rodziny zdefiniowaną w czcionce.
• Czcionka jest widoczna, ale tekst jest niepoprawny: sprawdź, czy czcionka zawiera wymagane znaki i pliki stylów. Czcionka może być widoczna w selektorze, ale nie mieć glifu lub grubości używanej w dokumencie.
• Przeformułuj dokumenty po zmianie: porównaj dokładną rodzinę czcionek i styl używany przed i po. Jeśli oryginalna czcionka nie jest dostępna na innym komputerze lub w usłudze eksportu, czcionka zastępcza może zmienić układ. Zainstaluj licencjonowaną czcionkę wszędzie tam, gdzie odbywa się renderowanie, lub użyj bezpiecznej dla dokumentu alternatywy i ponownie przejrzyj strony.
• Czcionka znika po aktualizacji: sprawdź, czy instalacja została przeprowadzona tylko w kontenerze jednorazowym. Przenieś pliki do stałego katalogu hosta i dołącz go poprzez konfigurację wdrożenia przed ponownym utworzeniem usługi.

Dodawanie niestandardowych czcionek jest najbardziej przydatne, gdy ta sama rodzina jest potrzebna w dokumentach współdzielonych i kontrolowanych eksportach. Ma to jednak swoje ograniczenia: instalacja na serwerze nie przyznaje praw do użytkowania czcionek, nie dodaje brakujących glifów do czcionki ani nie gwarantuje identycznego renderowania pikseli w oprogramowaniu korzystającym z innego zestawu czcionek. Należy zachować katalog niestandardowych czcionek w systemie kontroli wersji lub zarządzania konfiguracją, udokumentować wersję serwera dokumentów i ponownie przeprowadzić weryfikację po aktualizacjach.

Oficjalne referencje

• ONLYOFFICE Docs Community Edition: Dodawanie czcionek w systemie Linux
• ONLYOFFICE Docs Community Edition: Dodawanie czcionek w Dockerze
• ONLYOFFICE Docs Enterprise Edition: Dodawanie czcionek w systemie Linux
• Repozytorium ONLYOFFICE Docker-DocumentServer