Pomoc:Web2Cit

Web2Cit – gadżet i zestaw narzędzi wspomagających generator cytowań dla źródeł internetowych. Gadżet domyślnie działa na bazie Citoid, ale umożliwia tworzenie przekształceń dla konkretnych witryn (np. osobny szablon przekształceń dla Rzepy i osobny dla Oko.press).

Instalacja

Wejdź na swoją podstronę common.js. Wstaw ten kod:

// Web2Cit; [[Pomoc:Web2Cit]]
mw.loader.load( '//en.wikipedia.org/w/index.php?title=User:Diegodlh/Web2Cit/script.js&action=raw&ctype=text/javascript' ); // Backlink: [[:en:User:Diegodlh/Web2Cit/script.js]]

Zapisz zmiany.

Po instalacji za każdym razem, gdy będziesz generować przypis w edytorze wizualnym VE, będziesz mieć możliwość skorzystania z Web2Cit. Na obrazku z boku widać pole wyboru „Web2Cit” w oknie dialogowym cytowania (jeśli widzisz taką opcję, to instalacja się udała). Drugie okienko pokazuje przykład wygenerowanego przypisu – cytowanie u góry pochodzi z Citoid, a to na dole z Web2Cit. Po wygenerowaniu przypisu możesz wybrać, który wstawić; wybierz ten, który wydaje się lepszy w danym przypadku.

Procedura tworzenia szablonu witryny

Szablon witryny jest mniej więcej tym samym co szablon na Wikipedii (w sensie: coś, co tworzy się raz, a używa wiele razy w wielu miejscach). Choć technicznie są to pliki JSON, Web2Cit dostarcza narzędzi do ich edycji, więc znajomość JSON nie jest potrzebna. Interfejsem edycji w Web2Cit są po prostu formularze, które trzeba wypełnić i zapisać na Meta.

Tworzenie testów i przekształcenia

Wejdź na: https://web2cit.toolforge.org/
Wpisz URL artykułu w gazecie on-line, np.: https://www.rp.pl/polityka/art44301361-janusz-kowalski-o-swoim-odejsciu-z-prawa-i-sprawiedliwosci-wszystko-ma-swoje-granice
Zobaczysz tabelkę z informacją w rodzaju „Translation summary for domain: www.rp.pl”.
- Na stronie będą widoczne 3 przyciski edycji^[a].
- Wystarczy skorzystać z dwóch linków: Expected output (edit) oraz Translation output (edit). Pierwszy służy do edycji testów (podaje się po prostu oczekiwany rezultat), drugi do edycji przekształcenia (pobierania elementów ze strony za pomocą XPath itp.).
Expected output (edit) [tests.json] – link otwiera interfejs (formularz) do tworzenia testów. Dobrym minimum jest utworzenie dwóch pól testowych (Test field):
1. Author last/full names field – autor cytowanego artykułu.
2. Date field – data publikacji artykułu.
3. Przykład testów dla RP.pl
Przy zapisywaniu testów GUI przeniesie Cię do strony zapisu zmian na Meta-Wiki^[b].
Wróć do strony z tabelką (https://web2cit.toolforge.org/https://www.rp.pl/...) i odśwież ją. Kolumna Expected output powinna zostać wypełniona.
Translation output (edit) [templates.json]^[c]
1. Tutaj formularz powinien być już częściowo wypełniony. Będziesz mieć Template field 1 itemType oraz Template field 2 title. Na początek możesz zostawić te dwa pola bez zmian (zostaną domyślnie pobrane z Citoid).
2. Dodaj nowe pole i wybierz typ, np. author...full (pełny autor, czyli imię i nazwisko). Jako krok przekształcenia podaj XPath. Jeśli nie znasz i nie chcesz znać XPath, poproś LLM o wygenerowanie XPath autora dla danej strony.
Wróć do strony z tabelką i odśwież ją. Kolumna Translation output dla autora powinna zostać wypełniona. Jeśli się nie udało, wejdź ponownie w edycję i spróbuj użyć innego XPath.

Potem możesz dodać kolejne pola. Na pewno warto dodać datę, jeśli umiesz ją wyciągnąć z artykułu źródłowego. Zauważ jednak, że wyniki nie muszą zgadzać się w 100% z testami. Na początek wystarczy, że uda Ci się wyciągnąć jakieś dane. Potem możesz poprosić kogoś o pomoc w dostosowaniu ich za pomocą dodatkowych przekształceń.

Przykład XPath

//div[contains(@class, 'author')]/a/text()

Gdzie:

//div – oznacza element div w dowolnym miejscu strony.
div[contains(@class, 'author')] – oznacza div z atrybutem class o wartości author (ściślej o wartości zawierającej słowo author).
/a – oznacza element a bezpośrednio w tym co jest z lewej.
//div/a – oznacza element a bezpośrednio w div (a jest dzieckiem div).
a/text() – oznacza treść elementu a.

Uwagi

↑ Uwaga! Jeśli tabelka i linki do edycji nie są widoczne, to znaczy, że witryna docelowa blokuje dostęp dla Toolforge. Wszystkie żądania są wykonywane między serwerami, więc nie ma znaczenia, czy Ty widzisz witrynę w przeglądarce, tylko czy serwer może pobrać stronę internetową.
↑ Nie przejmuj się tym, jak wygląda ta strona po zapisie, JSON nie musi być ładnie sformatowany na Meta.
↑ Ważne! Zapis Translation output [templates.json] nie będzie możliwy, jeśli nie dodasz testów. Pamiętaj: najpierw dodaj testy Expected output [tests.json], a potem Translation output [templates.json].

Zobacz też

meta:Web2Cit – oficjalna dokumentacja (ang. • fr.)

[1] Uwaga! Jeśli tabelka i linki do edycji nie są widoczne, to znaczy, że witryna docelowa blokuje dostęp dla Toolforge. Wszystkie żądania są wykonywane między serwerami, więc nie ma znaczenia, czy Ty widzisz witrynę w przeglądarce, tylko czy serwer może pobrać stronę internetową.

[2] Nie przejmuj się tym, jak wygląda ta strona po zapisie, JSON nie musi być ładnie sformatowany na Meta.

[3] Ważne! Zapis Translation output [templates.json] nie będzie możliwy, jeśli nie dodasz testów. Pamiętaj: najpierw dodaj testy Expected output [tests.json], a potem Translation output [templates.json].

[a]

[b]

[c]