Pisanie strukturalne: czy obsługiwane jest tłumaczenie map i tematów (Topic) DITA XML?

Diagnoza kluczowego stanu obecnego

Dokumentacja DITA jest wysoce zfragmentowana i szeroko wykorzystuje `conref` do ponownego użycia treści. Tłumaczenie pojedynczych plików bez uwzględnienia relacji odwołań prowadzi do utraty kontekstu.

Analiza przyczyn podstawowych

1

Możliwość analizy map DITA

AI Shangyi obsługuje przesyłanie plików `.ditamap` lub spakowanych archiwów ZIP. System najpierw analizuje plik mapy, ustala hierarchię oraz kolejność czytania wszystkich tematów (Topic), dostarczając AI kompletny „kontekst globalny” zamiast tłumaczyć każdy fragment XML w izolacji.

2

Ochrona Conref (odwołań do treści)

W przypadku znaczników odwołań takich jak `<ph conref="...">` system traktuje je jako zablokowane symbole zastępcze. Jeśli użytkownik przesłał źródłowy plik odwołania, AI zapewnia, że tłumaczenie referencyjnej treści pozostaje spójne we wszystkich miejscach użycia.

3

Filtrowanie atrybutów

Znaczniki DITA zawierają liczne metadane (np. `audience="expert"`). Silnik AI jest skonfigurowany do tłumaczenia wyłącznie zawartości elementów przy ścisłym zachowaniu wszystkich atrybutów funkcjonalnych, co zapewnia prawidłową kompilację przez systemy publikacyjne (np. Oxygen XML).

Podsumowanie rozwiązania końcowego

Idealnie integruje się ze współczesnymi przepływami CI/CD dla dokumentacji technicznej, umożliwiając skalowalne tłumaczenie treści o wysokim stopniu fragmentacji.