Wikisłownik:Narzędzia/Edytor tłumaczeń: Różnice pomiędzy wersjami

Usunięta treść Dodana treść

Jednokolumnowy

Wersja z 01:17, 26 maj 2020

Narzędzie umożliwiające sprawne edytowanie elementów w polu tłumaczenia.

Opis narzędzia

Edytor tłumaczeń jest formularzem służącym do swobodnej edycji listy tłumaczeń w hasłach polskich. Dostęp do formularza umożliwia nowy przycisk obok nagłówka pola tłumaczenia. Główną zaletą narzędzia jest obejście standardowego trybu edycji, mianowicie dostęp do formularza nie wymaga przeładowywania strony jak po kliknięciu na przycisk „Edytuj” znajdujący się bezpośrednio nad stroną. Dodatkowo zwalnia z konieczności przeglądania wikikodu całej strony lub sekcji językowej, skupiając uwagę użytkownika na poszczególnych elementach w polu tłumaczeń, w zamierzeniu unikając typowych błędów technicznych w trakcie edycji.

Narzędzie zostało wdrożone w postaci gadżetu dostępnego w preferencjach, w sekcji „Edycja stron”: ext.gadget.translation-editor – główny moduł edytora tłumaczeń.

Zauważone błędy prosimy zgłaszać na stronie dyskusji.

Funkcje

Dodawanie, zmienianie i usuwanie dowolnych pozycji z listy tłumaczeń.
Drobne sprzątanie po wstępnym załadowaniu narzędzia:
- naprawa kolejności tłumaczeń,
- zamiana nazw języków zgodnie z przyjętą konwencją (np. „niderlandzki” na „holenderski”);
- dbanie o poprawność odstępów między poszczególnymi elementami.
Ostrzeganie przed obecnością błędów składniowych w istniejących tłumaczeniach oraz możliwość ich ręcznej naprawy.
Selektor języka wyświetlający sugestie w trakcie pisania, z obsługą przyjętych kodów ISO.
Zapamiętywanie wybranego języka w celu bezpośredniego rozpoczęcia jego edycji podczas następnego uruchomienia narzędzia.
Klawiatura ekranowa.
Podgląd wykonanych zmian na liście tłumaczeń oraz w automatycznie generowanym opisie zmian.
Możliwość dołączenia własnego opisu zmian, usprawnione za pomocą dynamicznego podglądu (czyt. odświeżanie podglądu opisu w trakcie pisania).
Współpraca z gadżetami:
- zabarwienie na fioletowo linków do nieistniejących sekcji językowych (w podglądzie listy tłumaczeń);
- szybki podgląd znaczeń po najechaniu kursorem na odpowiadającą im numerację (np. numer „(1.1)” obok pola wprowadzania tłumaczeń).

Znane problemy

Lista uchybień, o których mamy świadomość:

Narzędzie rozbija tekst podany w polu wprowadzania tłumaczeń, zważając na miejsce przecinków. Na tej podstawie dopasowuje każde tłumaczenie, oddzielone przecinkami od sąsiednich, do kwalifikatorów wskazanych w drugim, mniejszym polu (zwykle chodzi o szablony gramatyczne takie jak {{m}}); następnie tak posegregowane pary tłumaczenie-kwalifikator są sklejane w całość, czyli wiersz tłumaczenia. Z tego powodu obecność przecinków w tłumaczeniu, co zdarza się np. w przypadku przysłów, może spowodować nieprawidłowe dopasowanie kwalifikatora, aczkolwiek w praktyce takie sytuacje zdarzają się nieczęsto lub wcale.

Przyszłość

Następne iteracje narzędzia oraz pomysły do ewentualnego wdrożenia:

Odświeżenie interfejsu przy zastosowaniu biblioteki OOUI, zwracając uwagę na dostępność i użyteczność (accessilibity & usability).
Współpraca z wersją mobilną.
Walidacja wikikodu podczas wprowadzania tłumaczeń.
Dopracowanie pól w celu wygodniejszego wprowadzania transkrypcji oraz szablonów pomocniczych (np. {{furi}}, szablony rodzajów...).
Edycja szablonów {{zobtłum}} przed listą tłumaczeń.
Sugerowanie tłumaczeń na podstawie linkujących.
Poza trybem edycji: wyświetlenie wybranych języków z listy tłumaczeń na wzór enwiktionary (funkcja „Select targeted languages”, np. zob. en:cat/translations).
Tryb pełnoekranowy? Dawniej wdrożony w Specjalna:ApiSandbox.
Tryb WYSIWYG (jak edytor wizualny) zamiast dwuetapowego procesu: 1. wprowadzanie wikitekstu, 2. podgląd wyniku parsowania?

Uwagi oraz nowe propozycje prosimy zgłaszać na stronie dyskusji.

Przewodnik

Typową kolejność czynności w trakcie korzystania z narzędzia stanowią: wybór języka, wprowadzenie tłumaczeń (nowych lub zmieniających już istniejące), podgląd wykonanych zmian, powtórzenie poprzednich kroków w celu dopracowania modyfikacji lub edycji innego języka, zapisanie zmian.

Narzędzie nie jest dostępne, gdy przeglądamy stare wersje strony z jej historii zmian, ani gdy porównujemy zmiany pomiędzy wersjami.

Interfejs

Uruchomienie narzędzia następuje po kliknięciu na przycisk „(edytuj)” umieszczony obok napisu tłumaczenia w hasłach polskich. Jeżeli takiego przycisku nie ma, może to oznaczać, że hasło zawiera błędy w wikiskładni, które należy naprawić w zwyczajnym trybie edycji (zakładka „Edytuj” u góry strony). Upewnij się, że istnieją pola {{tłumaczenia}} i {{znaczenia}}, oraz że w polu znaczeń znajduje się co najmniej jedna definicja i że wszystkie definicje rozpoczyna numeracja w postaci „(1.1)”. Bardziej szczegółowo w WS:Zasady tworzenia haseł.

Narzędzie analizuje wikikod strony w trakcie uruchamiania. Jeżeli zostaną wykryte problemy dot. nieprawidłowej składni, użytkownik zostanie ostrzeżony i dalsze ładowanie edytora wstrzymane. Innym czynnikiem prowadzącym do przerwania jego pracy jest wykonanie edycji na tej samej stronie przez innego użytkownika. W tym wypadku narzędzie ostrzega, że aktualna wersja wyświetlona na ekranie nie jest ostatnią i należy przeładować stronę.

W wypadku pomyślnego załadowania edytor umieszcza listę tłumaczeń (o ile nie była pusta) wewnątrz formularza wraz z pozostałymi elementami, które szerzej opisano w poniższych sekcjach. Każdy przycisk w interfejsie głównym ma dołączony dymek informacyjny – wyświetlany po najechaniu kursorem na element i odczekaniu krótkiej chwili – krótko objaśniający jego przeznaczenie.

Przyciski „(zgłoś problem)” oraz „(pomoc)” otwierają nową zakładkę kierującą odpowiednio do strony zgłaszania błędów narzędzia i do niniejszej sekcji.

Selektor języka

Pierwszą czynnością jest wybór języka. Jeżeli dany język jest już obecny na liście, kliknięcie na przycisk „(edytuj)” obok tłumaczenia rozpoczyna jego edycję – więcej w kolejnych sekcjach. Do tego efektu również prowadzi skorzystanie z selektora języków; jeżeli języka nie ma na liście, jest to jedyny sposób.

Selektor wyświetla sugestie w trakcie pisania. W tym celu korzysta z wbudowanej bazy języków wyszczególnionych na stronie WS:ISO. Można bezpośrednio użyć nazwy języka (np. „angielski”) albo jego identyfikatora ISO (np. „en”). Sugestie obejmują obie kategorie wyników, wyświetlając pasujące identyfikatory ISO w odrębnym obszarze na końcu listy.

Sugestie selektora sprowadzają typowo polskie znaki na ich odpowiednik w klawiaturze niepolskiej, zatem wpisanie początkowej sekwencji „slo” – notabene litera „l” zamiast „ł” – skutkuje wyświetleniem wyników „slovio”, „słowacki”, „słoweński” oraz „słowiński”.

Formularz przejdzie w tryb edycji wybranego języka po jego zaznaczeniu na liście. Alternatywnie można wpisać go ręcznie i kliknąć przycisk „Załaduj” albo nacisnąć klawisz „enter”. Przycisk „Zapamiętaj” służy do automatycznego uruchamiania trybu edycji wybranego języka podczas następnego użycia narzędzia. Ustawienie jest, w przypadku użytkowników niezalogowanych, tymczasowo zapamiętywane w wewnętrznym obszarze pamięci przeglądarki. W przypadku użytkowników zalogowanych wybór języka jest na stałe przypisywany do konta. Wybór można wycofać za pośrednictwem przycisku „Zapomnij”.

Obszar edycji

Wprowadzanie tłumaczeń

W tym obszarze pojawiają się pary pól – po jednej parze na każde znaczenie opisane w haśle. Dłuższe przechowuje poszczególne tłumaczenia oddzielone przecinkami jedne od drugich. Krótsze odwzorowuje odpowiadające im kwalifikatory gramatyczne, typowo określenia rodzajów: „m” – męski; „ż” – żeński; „n” – nijaki („f” jest aliasem dla „ż”). Po przetworzeniu przez narzędzie każde tłumaczenie staje się linkiem do odpowiadającej mu strony w Wikisłowniku, przykładowo:

Pierwsze pole: gato, casa, perro
Drugie pole: m,f,m (pozostawić puste w przypadku języków, które nie rozróżniają rodzajów)
Wynik (wikikod): [[gato]] {{m}}, [[casa]] {{ż}}, [[perro]] {{m}}

NIekiedy potrzebujemy wprowadzić tłumaczenie składające się z wielu wyrazów, które należy linkować osobno, albo chcemy podać transliterację lub inne elementy pomocnicze (dodatkowe kwalifikatory, dookreślenia wewnątrz nawiasów...). Wtedy należy bezpośrednio wpisać wikikod:

Pierwsze pole: [[सहायता]] {{ż}} (sahāyatā)
Drugie pole: puste, rodzaj wskazano w pierwszym polu
Wynik (wikikod): [[सहायता]] {{ż}} (sahāyatā)

Najwygodniej korzystać z ułatwień automatycznego linkowania (pierwszy przykład), zaś uciekać się do wikikodu jedynie w razie konieczności (drugi przykład). Obu sposobów wprowadzania tłumaczeń można użyć jednocześnie w obrębie tego samego znaczenia:

Pierwsze pole: por qué, avión, [[de]] [[vidrio]]
Drugie pole: ,m, (zauważ, że są tu trzy elementy, jednak pierwszy i ostatni to puste ciągi znaków)
Wynik (wikikod): [[por qué]], [[avión]] {{m}}, [[de]] [[vidrio]]

Przycisk „(klawiatura ekranowa)” otwiera okno z zestawem znaków odpowiadających różnym systemom pisma. Kliknięcie na wybrany znak skutkuje wstawieniem go w miejscu kursora w ostatnio aktywnym polu wprowadzania tekstu.

Najechanie kursorem na numerację obok pól wprowadzania tekstu, na przykład „(1.1)”, „(1.2)” itd., powoduje wyświetlenie dymku zawierającego odpowiadającą jej definicję z pola znaczenia.

Podgląd tłumaczeń

Zapisywanie zmian

Opis zmian

Ewolucja

05-14/05/2020 – różne dodatki: wyróżnianie stanu edycji poszczególnych tłumaczeń za pomocą znaków (m, +, ✕), automatyczna naprawa nazwy języka (np. z niderlandzkiego na holenderski), możliwość zmiany nazwy języka z zachowaniem tłumaczeń, dynamiczne generowane opisu zmian i pole do jego edycji, podgląd zmian w formacie diff, przycisk do wyczyszczenia formularza
15/02/2020 – naprawa błędów składniowych: nowe pole tekstowe do swobodnej modyfikacji całego wiersza felernego tłumaczenia
01/12/2019 – ostrzeganie przed obecnością błędów składniowych: poprzednio uniemożliwiała uruchomienie narzędzia
18/11/2019 – modyfikowanie i usuwanie istniejących tłumaczeń: z listy pomysłów Źródłosłowu 2019
20/03/2016 – parsowanie podglądu: generowanie HTML na podstawie wikikodu, współpraca z gadżetem kolorującym na fioletowo linki do brakujących sekcji
19/01/2016 – zapamiętanie wyboru domyślnego języka: edytor zapisuje wybór w ustawieniach użytkownika
17/01/2016 – utworzenie gadżetu: edytor tłumaczeń jest dostępny w preferencjach
08/05/2015 – dodatki do interfejsu: klawiatura ekranowa, przycisk „zgłoś błąd”, dymki wyświetlające definicję po najechaniu na numer znaczenia
04/05/2015 – wprowadzenie selektora języków: możliwość dodawania więcej niż jednego języka (wygląd)
23/04/2014 – pierwsza wersja skryptu, umożliwiającego w szybki sposób dodawanie tłumaczenia na wybrany język, uprzednio skonfigurowany w swoim common.js

Zobacz też

kod źródłowy: JS, CSS
pierwotny skrypt, dziś przechowujący wersję rozwojową powyższego kodu: JS
autor (rozwój i konserwacja narzędzia): Wikisłownikarz:Peter Bowman
ostatnie zmiany przy użyciu edytora tłumaczeń

@@ Linia 56: / Linia 56: @@
 [[Plik:Edytor tłumaczeń (interfejs).png|thumb|Interfejs na przykładzie hasła „[[Specjalna:Niezmienny link/7298827|ratunek]]”]]
-Uruchomienie narzędzia następuje po kliknięciu na przycisk „(edytuj)” umieszczony obok napisu '''tłumaczenia:''' w hasłach polskich. Jeżeli takiego przycisku nie ma, może to oznaczać, że hasło zawiera błędy w wikiskładni, które należy naprawić w zwyczajnym trybie edycji (zakładka „Edytuj” u góry strony). Upewnij się, że istnieją pola {{s|tłumaczenia}} i {{s|znaczenia}}, oraz że w polu znaczeń znajduje się co najmniej jedna definicja i że wszystkie definicje rozpoczyna numeracja w postaci „(1.1)”. Bardziej szczegółowo w [[WS:Zasady tworzenia haseł]].
+Uruchomienie narzędzia następuje po kliknięciu na przycisk „(edytuj)” umieszczony obok napisu '''tłumaczenia''' w hasłach polskich. Jeżeli takiego przycisku nie ma, może to oznaczać, że hasło zawiera błędy w wikiskładni, które należy naprawić w zwyczajnym trybie edycji (zakładka „Edytuj” u góry strony). Upewnij się, że istnieją pola {{s|tłumaczenia}} i {{s|znaczenia}}, oraz że w polu znaczeń znajduje się co najmniej jedna definicja i że wszystkie definicje rozpoczyna numeracja w postaci „(1.1)”. Bardziej szczegółowo w [[WS:Zasady tworzenia haseł]].
-Narzędzie analizuje wikikod strony w trakcie uruchamiania. Jeżeli zostaną wykryte problemy natury nieprawidłowej składni, użytkownik zostanie ostrzeżony i dalsze ładowanie edytora wstrzymane. Innym czynnikiem prowadzącym do przerwania jego pracy jest wykonanie edycji na tej samej stronie przez innego użytkownika. W tym wypadku narzędzie ostrzega, że aktualna wersja wyświetlona na ekranie nie jest ostatnia i należy przeładować stronę.
+Narzędzie analizuje wikikod strony w trakcie uruchamiania. Jeżeli zostaną wykryte problemy dot. nieprawidłowej składni, użytkownik zostanie ostrzeżony i dalsze ładowanie edytora wstrzymane. Innym czynnikiem prowadzącym do przerwania jego pracy jest wykonanie edycji na tej samej stronie przez innego użytkownika. W tym wypadku narzędzie ostrzega, że aktualna wersja wyświetlona na ekranie nie jest ostatnią i należy przeładować stronę.
-W wypadku pomyślnego załadowania edytor umieszcza listę tłumaczeń (o ile nie była pusta) wewnątrz formularza wraz z pozostałymi elementami, które szerzej opisano w poniższych sekcjach. Wszystkie przyciski interfejsu głównego mają dołączony dymek informacyjny – wyświetlany po najechaniu kursorem na element i odczekaniu krótkiej chwili – krótko objaśniający jego przeznaczenie.
+W wypadku pomyślnego załadowania edytor umieszcza listę tłumaczeń (o ile nie była pusta) wewnątrz formularza wraz z pozostałymi elementami, które szerzej opisano w poniższych sekcjach. Każdy przycisk w interfejsie głównym ma dołączony dymek informacyjny – wyświetlany po najechaniu kursorem na element i odczekaniu krótkiej chwili – krótko objaśniający jego przeznaczenie.
+Przyciski „(zgłoś problem)” oraz „(pomoc)” otwierają nową zakładkę kierującą odpowiednio do strony zgłaszania błędów narzędzia i do niniejszej sekcji.
 {{clear}}
@@ Linia 81: / Linia 83: @@
 [[Plik:Edytor tłumaczeń (składnia).png|thumb|Wprowadzanie tłumaczeń]]
+W tym obszarze pojawiają się pary pól – po jednej parze na każde znaczenie opisane w haśle. Dłuższe przechowuje poszczególne tłumaczenia oddzielone przecinkami jedne od drugich. Krótsze odwzorowuje odpowiadające im [[:Kategoria:Szablony skrótów - gramatyka|kwalifikatory gramatyczne]], typowo określenia rodzajów: „m” – męski; „ż” – żeński; „n” – nijaki („f” jest aliasem dla „ż”). Po przetworzeniu przez narzędzie każde tłumaczenie staje się linkiem do odpowiadającej mu strony w Wikisłowniku, przykładowo:
+* Pierwsze pole: <code>[[gato]], [[casa]], [[perro]]</code>
+* Drugie pole: <code>[[Szablon:m|m]],[[Szablon:f|f]],[[Szablon:m|m]]</code> (pozostawić puste w przypadku języków, które nie rozróżniają rodzajów)
+* Wynik (wikikod): <code><nowiki>[[gato]] {{m}}, [[casa]] {{ż}}, [[perro]] {{m}}</nowiki></code>
+NIekiedy potrzebujemy wprowadzić tłumaczenie składające się z wielu wyrazów, które należy linkować osobno, albo chcemy podać transliterację lub inne elementy pomocnicze (dodatkowe kwalifikatory, dookreślenia wewnątrz nawiasów...). Wtedy należy bezpośrednio wpisać wikikod:
+* Pierwsze pole: <code><nowiki>[[</nowiki>[[सहायता]]<nowiki>]]</nowiki> <nowiki>{{</nowiki>[[Szablon:ż|ż]]<nowiki>}}</nowiki> (sahāyatā)</code>
+* Drugie pole: ''puste, rodzaj wskazano w pierwszym polu''
+* Wynik (wikikod): <code><nowiki>[[सहायता]] {{ż}} (sahāyatā)</nowiki></code>
+Najwygodniej korzystać z ułatwień automatycznego linkowania (pierwszy przykład), zaś uciekać się do wikikodu jedynie w razie konieczności (drugi przykład). Obu sposobów wprowadzania tłumaczeń można użyć jednocześnie w obrębie tego samego znaczenia:
+* Pierwsze pole: <code>[[por qué]], [[avión]], <nowiki>[[</nowiki>[[de]]<nowiki>]]</nowiki> <nowiki>[[</nowiki>[[vidrio]]<nowiki>]]</nowiki></code>
+* Drugie pole: <code>,m,</code> (zauważ, że są tu trzy elementy, jednak pierwszy i ostatni to puste ciągi znaków)
+* Wynik (wikikod): <code><nowiki>[[por qué]], [[avión]] {{m}}, [[de]] [[vidrio]]</nowiki></code>
+Przycisk „(klawiatura ekranowa)” otwiera okno z zestawem znaków odpowiadających różnym systemom pisma. Kliknięcie na wybrany znak skutkuje wstawieniem go w miejscu kursora w ostatnio aktywnym polu wprowadzania tekstu.
+Najechanie kursorem na numerację obok pól wprowadzania tekstu, na przykład „(1.1)”, „(1.2)” itd., powoduje wyświetlenie dymku zawierającego odpowiadającą jej definicję z pola '''znaczenia'''.
 {{clear}}