WordPress i AI: jak poprawić język i kierunek tekstu we wklejonym fragmencie HTML

Ustal, która część strony zmienia język

Do francuskojęzycznej strony o fikcyjnych warsztatach dodano fragment po arabsku. Zdanie informuje, że warsztaty zaczynają się o 10:30. Po wklejeniu zdania do bloku Własny HTML na ekranie widać znaki arabskie. Fragment nie ma jednak własnej deklaracji języka i przejmuje kierunek tekstu ze strony. W innej wersji propozycji występuje lang="ar", ale dir="ltr" wciąż wymusza kierunek od lewej do prawej. Każdy z tych stanów wymaga innej poprawki.

Zacznij od przeczytania treści wokół fragmentu. Tytuł, wprowadzenie, menu i dalsze wskazówki są po francusku. Język dokumentu deklaruje element html generowany przez WordPressa i motyw. Zachowaj francuski jako domyślny język dokumentu. We wstawionym fragmencie wskaż faktyczny język zdania i kierunek odpowiedni dla jego pisma. Język opisuje treść. Kierunek bazowy określa, jak przeglądarka układa litery, cyfry i znaki interpunkcyjne w danym kontekście.

Zapisz oczekiwany wynik, zanim zmienisz blok. Strona pozostaje po francusku, z kierunkiem od lewej do prawej. Zdanie powinno być rozpoznawane jako arabskie i znajdować się we fragmencie, którego kierunek bazowy biegnie od prawej do lewej. Oba sąsiednie zdania po francusku powinny nadal wyświetlać się tak jak wcześniej. Po zapisaniu sprawdź także wartość 10:30. Poprawka dotyczy atrybutów i ich zakresu. Zachowaj brzmienie zdania i język domyślny witryny.

Ustal język na podstawie strony widocznej dla odwiedzającego. Język menu w panelu WordPressa może zależeć od ustawień konta, więc sama polska lub francuska nazwa przycisku nic nie mówi o języku wpisu. Porównaj język tytułu, wprowadzenia i cytatu z deklaracją na stronie. Jeśli deklaracja nie pasuje już do tytułu i wprowadzenia, zapisz problem dotyczący całej strony osobno. Pozwoli to poprawić cytat bez zmiany zachowania dokumentu w trakcie tej próby.

Zachowaj stan odniesienia przed zapisaniem wklejonej treści

Pracuj na kopii wpisu lub strony. Napisz francuskie wprowadzenie, cytat o godzinie rozpoczęcia i kolejne francuskie zdanie po cytacie. Zdania otaczające blok posłużą do porównania. W stanie odniesienia sam cytat także jest po francusku. Zachowaj wersję z historii zmian lub dokładną treść bloku, a następnie otwórz kopię w widoku odwiedzającego. Zapisz tekst z trzech miejsc i język elementu głównego. Jeśli strona już deklaruje niewłaściwy język, odnotuj to oddzielnie. Ustawienia innych stron wymagają osobnego sprawdzenia.

Aby odtworzyć propozycję bez korzystania z usługi, zastąp francuski cytat przykładowym zdaniem arabskim w bloku Własny HTML. Zachowaj pierwszą wersję, w której cytat nie ma deklaracji języka ani kierunku. Przygotuj drugą, w której cytat zawiera lang="ar" i dir="ltr". Użyj tego samego arabskiego zdania w obu wersjach. Wtedy obserwowane różnice można przypisać atrybutom, bo słowa i liczba pozostają takie same.

Jeśli masz rzeczywistą propozycję, sprawdź tekst i znaczniki przed wklejeniem. Fragment treści powinien trafić do głównej części strony. Gdy propozycja obejmuje całą strukturę dokumentu z elementami html, head lub body, zachowaj tylko potrzebny fragment. Przy tłumaczeniu całej strony język główny zależy od wygenerowanej strony i jej ustawień. W tym ćwiczeniu język zmienia tylko cytat. Ogranicz więc deklarację do niego.

Przechowuj warianty oddzielnie w notatkach. Blok odniesienia pozwala szybko cofnąć zmianę, jeśli błąd przy wklejaniu dotknie też innej treści. Aby po zapisaniu znaleźć właściwe miejsce, zanotuj początek francuskich zdań przed cytatem i po nim. Możesz również zapisać identyfikator testowy na kopii. Jeśli treść zawiera kilka cytatów, zanotuj dokładną pozycję, aby znaleźć właściwy cytat także wtedy, gdy nie jest pierwszy.

W notatce podaj adres kopii i czas ostatniego zapisu. Dla każdego z trzech miejsc zapisz, czy ma własny atrybut, czy otrzymuje wartość z elementu nadrzędnego. Dopisz oczekiwane brzmienie zdań przed cytatem i po nim. Jeśli masz otwarty stary podgląd, zamknij go przed porównaniem. Powtórzenie kontroli pod tym samym adresem pomaga rozpoznać, czy różnica powstała podczas zapisu, czy wynika z otwarcia innej wersji wpisu.

Rozróżnij odziedziczony język i odziedziczony kierunek

W DOM język zadeklarowany na elemencie obowiązuje też jego elementy potomne bez własnej deklaracji. Cytat bez lang może zatem odziedziczyć francuski ze strony, choć zawiera znaki arabskie. Przeglądarka może pokazać te znaki niezależnie od zadeklarowanego języka. W pierwszym stanie próby inspekcja wskazuje francuski jako język efektywny, ponieważ najbliższa deklaracja znajduje się na poziomie strony.

W tym ćwiczeniu lang="ar" wystarcza do oznaczenia języka arabskiego. Kierunek bazowy ustawia się oddzielnie. W drugim stanie przeglądarka rozpoznaje cytat jako arabski, ale tekst nadal biegnie od lewej do prawej, bo na cytacie wciąż jest dir="ltr". Zapisanie obu wartości osobno pomaga wyjaśnić, dlaczego pierwsza poprawka może wyglądać na kompletną, choć kierunek nadal jest błędny.

Kierunek wpływa na układ tekstu. Zdanie biegnące od prawej do lewej może zawierać cyfry, godzinę lub nazwę zapisaną innym pismem. Unikaj ręcznego odwracania znaków albo przenoszenia interpunkcji, aby skompensować źle ustawiony element otaczający tekst. Najpierw popraw kierunek bazowy fragmentu, a potem przeczytaj zdanie i godzinę na ekranie. Wyrównanie do prawej ustala położenie tekstu w wierszu. Kierunek czytania ma osobne ustawienie.

Wybierz element, który obejmuje dokładnie właściwy fragment. Gdy cały cytat jest po arabsku, użyj elementu otaczającego cytat. Jeśli w zdaniu francuskim zmienia się język tylko kilku słów, oznacz sam ten odcinek. Pojedyncza nazwa własna lub termin używany już w języku tekstu nie zawsze wymaga odrębnej deklaracji. Jeśli masz wątpliwości co do języka lub kierunku, zleć sprawdzenie tekstu przed dobraniem atrybutów. Deklaracja powinna dokładnie opisywać treść, którą otrzyma czytelnik.

Aby prześledzić dziedziczenie, wybierz najpierw akapit, w którym faktycznie znajdują się słowa, i przechodź do kolejnych elementów nadrzędnych, aż znajdziesz deklarację języka. Zanotuj, na którym elemencie się znajduje. Następnie powtórz tę czynność dla sąsiedniego zdania. Oba akapity mogą dziedziczyć język strony lub jeden z nich może mieć własną deklarację. Dzięki temu odróżnisz znalezienie atrybutu gdzieś w dokumencie od ustalenia, czy rzeczywiście obejmuje badane słowa.

Popraw fragment w bloku, który go generuje

Otwórz na kopii blok Własny HTML i znajdź cytat. Dodaj lub popraw lang="ar" i dir="rtl" na elemencie, który go obejmuje. Pozostaw oba francuskie zdania poza tym elementem. W poniższym fragmencie zdanie mówi, że warsztaty zaczynają się o 10:30. Atrybuty opisują cały cytat i obowiązują także wewnątrz niego, w akapicie.

Ogranicz poprawkę do atrybutów opisujących język i kierunek. Przeczytaj tekst przed zapisaniem, aby kolejne wklejenie nie zmieniło godziny. Jeśli propozycja zawiera regułę CSS dotyczącą kierunku lub wyrównania, sprawdź, do czego się stosuje. Znaczniki HTML określają kierunek bazowy. W zależności od motywu reguła wyglądu może mimo to nadać inny kierunek obliczony przez przeglądarkę. Ustal wtedy, która reguła obowiązuje w tym fragmencie.

Jeśli blok pochodzi z szablonu lub wzorca używanego ponownie, ustal, gdzie zapisano tekst. Zmiana wspólnego źródła może wpłynąć na wiele stron. W tym ćwiczeniu używamy bloku lokalnego w jednym wpisie, aby ograniczyć zasięg zmiany. Jeśli musisz zmienić wspólny element, znajdź na kopii witryny inne miejsce, w którym jest używane to samo źródło. Dzięki temu potwierdzisz, czy strony bez cytatu nadal działają jak wcześniej.

Na kopii zapisz jedną zmianę i ponownie otwórz ten sam blok. Zachowaj wycinek zapisanego kodu, aby porównać go z kodem strony. Jeśli podejrzewasz, że edytujesz współdzielony wzorzec, zapisz adres drugiego wystąpienia jeszcze przed modyfikacją. Porównaj je po zapisie. Poprawny cytat na pierwszej stronie nie pokazuje, czy zmiana dotknęła drugiej. Przerwij próbę na wspólnym źródle, jeśli nie udało się ustalić, które miejsca z niego korzystają.

<blockquote lang="ar" dir="rtl">
  <p>تبدأ الورشة عند الساعة 10:30.</p>
</blockquote>

Sprawdź DOM strony po zapisaniu

Zapisz kopię, zamknij poprzedni podgląd i ponownie otwórz adres wpisu. Zbadaj cytat w panelu **Elementy** narzędzi przeglądarki. Najpierw sprawdź, czy element html nadal deklaruje francuski. Następnie potwierdź, że atrybuty znajdują się na cytacie w dokumencie faktycznie wyświetlanym przez przeglądarkę. Mają obejmować akapit arabski i kończyć się przed kolejnym zdaniem. Deklaracja na niewłaściwym poziomie może poprawić cytat, a przy tym zmienić zachowanie innego bloku.

Porównaj kod bloku z DOM. Jeśli wklejony kod zawierał lang lub dir, ale brakuje go w DOM, otwórz blok ponownie i ustal, co zostało zapisane. Jeżeli atrybut zniknął już z zapisanego bloku, różnica powstała między wklejeniem a zapisem. Jeśli blok zachował atrybut, sprawdź komponent, który generuje stronę, oraz sposób, w jaki przeglądarka przetworzyła HTML. W obu przypadkach zanotuj różnicę przed zmianą ustawienia ogólnego lub uprawnień konta.

W stylach obliczonych cytatu znajdź właściwość direction. Dla poprawionego fragmentu w tym ćwiczeniu ma ona wartość rtl. W kolejnym zdaniu francuskim pozostaje ltr. Gdy DOM zawiera dir="rtl", lecz kierunek obliczony przez przeglądarkę nadal wynosi ltr, szukaj reguły dotyczącej tego elementu albo jego potomka. Zanotuj też najbliższą deklarację języka dla każdego akapitu. Panel stylów pokazuje, jakie reguły przeglądarka stosuje do wyglądu. Aby ustalić zadeklarowany język, sprawdź atrybuty oddzielnie.

Przeczytaj zdanie arabskie i liczbę w ich kontekście. Test porównuje tekst z DOM z tekstem początkowym, w tym 10:30. Pomaga to wykryć zmiany treści spowodowane wklejeniem. Widoczne położenie każdego znaku wymaga oddzielnej kontroli. Jeśli fragment łączy różne pisma, obejrzyj go ze stylami używanymi na stronie i poproś o sprawdzenie osobę znającą dany język.

W narzędziach przeglądarki zaznacz akapit wewnątrz cytatu, a nie tylko całą sekcję. Jeżeli kierunek obliczony różni się od deklarowanego, zapisz nazwę reguły i element, którego dotyczy. Tymczasowa zmiana ustawienia w panelu stylów może pomóc odizolować przyczynę w otwartej karcie. Po odświeżeniu jej skutek zniknie. Zapisz obserwację, a potem osobno sprawdź stronę po zapisaniu poprawki w WordPressie. Dzięki temu tymczasowy podgląd nie pomyli się z zapisaną zmianą.

Zinterpretuj wyniki i określ granice testu

W demonstracyjnej instalacji WordPressa element główny zachował lang="fr-FR" i obliczony kierunek od lewej do prawej we wszystkich pięciu stanach. Po pierwszym wklejeniu, bez atrybutów, cytat odziedziczył francuski. W drugiej wersji Chrome rozpoznał lang="ar", ale zachował kierunek od lewej do prawej. Po poprawce cytat miał oczekiwane wartości, a akapit je odziedziczył. Oba francuskie zdania zachowały język, kierunek i brzmienie.

Warianty zapisano w bloku Własny HTML za pomocą funkcji rdzenia WordPressa, a następnie sprawdzono w DOM wczytanej strony. Procedura potwierdza, że w tym środowisku atrybuty i tekst pozostają bez zmian po zapisaniu i wygenerowaniu strony. Odtwarza możliwe stany po wklejeniu. Wklejenie ze schowka w edytorze wizualnym może dać inny wynik. W teście zablokowano arkusze stylów motywu i skrypty strony, aby osobno zaobserwować działanie atrybutów.

Test nie obejmował czytników ekranu. Atrybut lang="ar" przekazuje informację o języku, z której mogą korzystać technologie wspomagające. Zmiana głosu, wymowa tekstu i odczyt godziny wymagają oddzielnego sprawdzenia. Jeżeli ocena obejmuje takie doświadczenie, wykonaj próbę z czytnikiem i głosem używanymi przez zespół. Zapisz, co zostało odczytane, oddzielnie od wyniku kontroli DOM.

Przywróć stan odniesienia i zachowaj sposób kontroli

Aby cofnąć zmianę na kopii, przywróć wersję z historii zmian, która zawiera fragment odniesienia. Jeśli od tego czasu zmieniono inne części wpisu, przywróć tylko cytat i atrybuty zapisane na początku. Ponownie otwórz wpis w przeglądarce. Sprawdź element główny, cytat i dwa zdania kontrolne. Przywrócenie może być niepełne, jeśli tekst wrócił do dawnej postaci, ale dodany atrybut pozostał na elemencie otaczającym cytat.

W teście przywrócenie wersji dokładnie odtworzyło zapisaną treść i wyświetlany fragment. Cytat znów był po francusku, a otaczające go elementy zachowały się jak wcześniej. Wynik byłby inny, gdyby stan odniesienia już zawierał poprawnie oznaczony fragment po arabsku. W takim przypadku przywróć jego tekst i pierwotne atrybuty. Punktem wyjścia jest wersja zachowana dla tej konkretnej strony.

Przy przekazywaniu pracy do sprawdzenia podaj adres kopii, właściwy fragment i oczekiwane wartości. Dodaj zaobserwowane atrybuty i obliczony kierunek we wszystkich trzech miejscach. Zachowaj propozycję w postaci użytej podczas testu i wersję po poprawce. Dzięki temu osoba sprawdzająca może potwierdzić, że godzina pozostała taka sama, cytat jest prawidłowo oznaczony, a reszta strony zachowała zaplanowany język i kierunek.

Przed przywróceniem pełnej wersji porównaj zawartość sąsiednich akapitów w obu wersjach. Jeżeli w międzyczasie zmieniono inny tekst, zachowaj jego nową wersję, a z kopii odzyskaj tylko fragment objęty próbą. Jeżeli atrybut był ustawiony we wspólnym wzorcu, sprawdź, czy przywracasz wpis, czy sam wzorzec. Po zapisaniu otwórz właściwą stronę ponownie i porównaj zarówno cytat, jak i fragmenty, które miały zachować późniejsze zmiany.

Dostosuj kontrolę do wyrażenia wewnątrz zdania

Fragment może się składać z angielskiego wyrażenia w środku francuskiego akapitu. W takim przypadku oba teksty biegną w tym samym kierunku. Oznacz fragment właściwym językiem i przeczytaj słowa przed nim oraz po nim. Jeśli całe zdanie francuskie dziedziczy angielski, atrybut jest zbyt wysoko w dokumencie. Sprawdź sąsiednie słowa także wtedy, gdy kierunek wiersza wygląda tak samo.

Jeśli cały fragment jest akapitem zapisanym od prawej do lewej, ustaw kierunek na akapicie lub na elemencie przeznaczonym do jego otoczenia. Wyrównanie tekstu do krawędzi może pozostać ustawieniem motywu. Sprawdź kierunek zadeklarowany i obliczony przez przeglądarkę przed zmianą wyrównania. Jeśli czytelnik musi rozpoznać godzinę lub oznaczenie, zleć sprawdzenie ostatecznej wersji i zachowaj samą liczbę w notatkach.

W obu przypadkach otwórz blok po zapisaniu i sprawdź dokładnie, gdzie umieszczono atrybut. Gdy propozycja dodaje kilka fragmentów, wybierz francuski tekst kontrolny pomiędzy dwoma z nich. Ułatwia to wykrycie zbyt szerokiego elementu, który przekazuje atrybuty wszystkiemu, co po nim następuje. Zacznij od jednej poprawki o ograniczonym zasięgu. Zastosuj ją do kolejnych fragmentów po potwierdzeniu ich języka, kierunku i położenia w DOM.

Gdy w pobliżu zmiany języka znajduje się liczba albo znak interpunkcyjny, wybierz słowo bezpośrednio przed fragmentem i po nim. Sprawdź w DOM, do którego elementu należy każde z nich. Następnie przeczytaj cały wiersz, aby upewnić się, że wygląd nie maskuje zbyt szerokiego oznaczenia. Jeśli wartości sąsiednich słów są takie jak w stanie odniesienia, przejdź dalej. Jeśli się zmieniły, sprawdź granice elementu, zanim skopiujesz poprawkę do następnych miejsc.