Udostępnij niestandardowe czcionki w Collabora CODE Docker

Aby renderować niestandardową czcionkę w aplikacji Collabora Online CODE działającej w Dockerze, należy zachować pliki czcionek na hoście i zamontować ten sam katalog zarówno w katalogu systemowym czcionek kontenera, jak i w jego pliku systemowym dokumentu. Plik systemowy dostarcza pliki do odizolowanych procesów dokumentu; montowanie czcionek tylko w pliku /usr/share/fontsmoże spowodować, że rodzina pojawi się w menu czcionek bez renderowania jej w dokumencie. W tym przewodniku wykorzystano Docker Compose i bieżącą ścieżkę obrazu CODE /opt/cool/systemplate; sprawdź ścieżkę, jeśli używasz innej linii obrazu.

Wybierz źródło czcionek, które możesz zachować

Montowanie typu „tylko do odczytu” (bind mount) jest zazwyczaj najprostszą opcją dla jednego hosta Dockera. Zachowuje ono pliki czcionek podczas ponownego tworzenia lub aktualizacji kontenera CODE, a Ty możesz dokładnie sprawdzić, które pliki kontener może odczytać. Używaj plików czcionek, które masz uprawnienia do instalacji i redystrybucji na serwerze. Nie kopiuj całego katalogu czcionek systemu stacjonarnego, chyba że sprawdziłeś licencje i potrzebujesz tych plików.

Używaj nieskompresowanych plików czcionek w formatach obsługiwanych przez Twoje środowisko, zazwyczaj TrueType ( .ttf) lub OpenType ( .otf). Uwzględnij style wymagane przez Twoje dokumenty, takie jak zwykły, pogrubiony, kursywa i pogrubiona kursywa. Zadbaj o czytelność nazw rodzin i plików oraz upewnij się, że użytkownik kontenera może odczytać każdy katalog i plik. Czcionka zawierająca tylko jeden styl może spowodować, że Collabora zastąpi ją innym krojem, gdy dokument zażąda pogrubienia lub kursywy.

Najpierw utwórz dedykowany katalog hosta i skopiuj do niego autoryzowane pliki:

sudo mkdir -p /srv/collabora/fonts
sudo cp BrandSans-Regular.ttf BrandSans-Bold.ttf /srv/collabora/fonts/
sudo chmod -R a+rX /srv/collabora/fonts

Zastąp przykładowe nazwy plików rzeczywistymi plikami czcionek. Uprawnienia do odczytu mają znaczenie, ponieważ proces CODE działa jako konto bez uprawnień w bieżących obrazach. Zachowaj stabilną ścieżkę do katalogu; montowania Compose będą się do niej odwoływać.

Zamontuj czcionki zarówno w drzewie czcionek hosta, jak i w płycie systemowej

W istniejącej collaborausłudze w docker-compose.ymldodaj te wpisy woluminów. Zachowaj istniejący obraz, porty, listę dozwolonych domen, ustawienia SSL, sekrety i zasady ponownego uruchamiania; poniższy fragment kodu pokazuje tylko montowanie czcionek.

services:
  collabora:
    volumes:
      - /srv/collabora/fonts:/usr/share/fonts/truetype/more:ro
      - /srv/collabora/fonts:/opt/cool/systemplate/usr/share/fonts/truetype/more:ro

Pierwszy cel udostępnia czcionki do standardowego wyszukiwania czcionek kontenera. Drugi cel umieszcza je w szablonie używanym do przygotowywania izolowanych środowisk dokumentów. Podręcznik SDK Collabora dokumentuje ten dwulokalizacyjny wzorzec woluminów dla Dockera. Nie należy montować w całym katalogu /usr/share/fontsani katalogu systemplate: może to spowodować ukrycie czcionek już dostarczonych przez obraz.

Ścieżka systemplate jest zależna od wersji. Aktualne metadane obrazu CODE 26.04 identyfikują /opt/cool/systemplateścieżkę szablonu systemowego, a aktualna dokumentacja Collabora korzysta z tej lokalizacji. Jeśli używasz starszego obrazu lub kompilacji specyficznej dla dostawcy, sprawdź dokumentację tego obrazu lub konfigurację startową przed edycją ścieżki docelowej.

Utwórz ponownie kontener i potwierdź wykrycie czcionek

Po zapisaniu pliku Compose i umieszczeniu plików czcionek na hoście utwórz ponownie usługę CODE, aby Docker zastosował montowania powiązań:

docker compose up -d --force-recreate collabora
docker compose exec -T collabora fc-list

W wynikach wyszukiwania poszukaj nazwy rodziny czcionek lub ścieżki do zamontowanego pliku. Aby zawęzić listę, przepuść ją grepprzez nazwę rodziny zgłoszoną przez samą czcionkę, na przykład:

docker compose exec -T collabora fc-list | grep -i "Brand Sans"

Jeśli polecenie nie zgłosi zgodności, sprawdź ścieżkę hosta, uprawnienia do plików, wcięcia montowania i logi kontenera. Możesz sprawdzić efektywne montowania za pomocą docker inspectdziałającego kontenera lub użyć polecenia , docker compose configaby wychwycić błędy wcięć w YAML. Uruchomienie usługi docker compose downzazwyczaj nie jest potrzebne tylko do zastosowania zmiany woluminu; wystarczy ponowne utworzenie usługi.

Sprawdź, czy czcionka jest renderowana w rzeczywistym dokumencie

Otwórz dokument testowy za pomocą standardowej integracji Nextcloud lub WOPI, zaznacz krótki fragment tekstu i wybierz niestandardową rodzinę czcionek z selektora czcionek. Wpisz nową linię w tej czcionce, zapisz, zamknij i ponownie otwórz plik. Sprawdź tekst zwykły i pogrubiony oraz porównaj podziały wierszy lub układ strony z dokumentem źródłowym. Pojawienie się rodziny w menu to jedynie sprawdzenie odkrycia; widoczny tekst po ponownym otwarciu to przydatne sprawdzenie renderowania.

• Czcionka pojawia się w menu, ale tekst znika lub jest cofany: sprawdź, czy drugie podłączenie dotyczy katalogu czcionek systemplate i czy zawiera te same pliki.
• Brak czcionki w menu: sprawdź, czy pliki są prawidłowe i czytelne, a następnie sprawdź fc-listdane wyjściowe i dzienniki uruchamiania kontenera.
• Czcionka działa do momentu aktualizacji obrazu: sprawdź, czy oba montowania pozostają w Compose i czy katalog hosta nie znajduje się w tymczasowej ścieżce kontenera.
• Tylko niektóre znaki są renderowane: wybrana czcionka może nie zawierać tych glifów. Dodaj czcionkę z wymaganym pokryciem pisma lub skorzystaj z odpowiedniej opcji awaryjnej.

Montowanie z powiązaniem utrzymuje czcionki niezależne od obrazu CODE, ale nie gwarantuje identycznego układu na każdym kliencie ani w każdym dokumencie. Podmiana czcionek, brakujące glify, różne wersje czcionek i formatowanie specyficzne dla dokumentu mogą nadal wpływać na zawijanie wierszy. Aby uzyskać dodatkowe informacje na temat konfiguracji, skorzystaj z dokumentacji instalacji czcionek Collabora , przewodnika po obrazach CODE Docker oraz podręcznika Collabora Online SDK . Przykład Dockera i aktualna dokumentacja obrazu w podręczniku powinny zostać ponownie sprawdzone po zmianie wersji CODE.