WMDE Technical Wishes/Podprzypisy

Podprzypisy
Status	W trakcie
Origin	Ankiety życzeń Społeczności 2013, 2015, 2022 i inne
Focus area	Uczyńmy ponowne używanie przypisów łatwiejszym
Phabricator	tablica projektu
Responsible	Zespół ds. Życzeń Technicznych
Powiedz nam, co sądzisz Zapraszamy do przetestowania naszego prototypu, który jest stale aktualizowany. Obserwuj tę stronę lub zapisz się na tę listę wiadomości masowych, aby dowiedzieć się o nowych rzeczach, które można przetestować. Przeczytaj więcej o testowaniu i przekazywaniu opinii

Obecnie nie ma możliwości łatwego ponownego wykorzystania tego samego źródła z różnymi szczegółami w artykule. Członkowie społeczności wielokrotnie prosili o rozwiązanie w MediaWiki, które działałoby bez szablonów i było oparte na istniejącym sposobie funkcjonowania przypisów, zarówno w edytorze wikikodu, jak i w edytorze wizualnym. » Dowiedz się więcej o problemie

W ramach obszaru fokusowego "Ułatwienie ponownego wykorzystania referencji", zespół ds. Życzeń Technicznych Wikimedia Deutschland wprowadza podprzypisy – opcjonalną funkcję, która umożliwia łatwe dodawanie różnych szczegółów do istniejących przypisów bez konieczności ich duplikowania.

Podprzypisy zostały wdrożone w niemieckiej Wikipedii we wrześniu 2025 roku. Planujemy wprowadzić podprzypisy do pozostałych wiki Wikimedia w 2026 roku.

• » Najczęściej zadawane pytania
• » Ostatnie zmiany i kolejne kroki

Podprzypisy w skrócie

Aby cytować źródło więcej niż raz, lecz podając różne szczegóły, potrzebny jest przypis główny oraz podprzypis.

• Przypis główny zawiera podstawowe informacje bibliograficzne. Na zrzucie ekranu widać wpis: „1. E. Miller …” i to jest właśnie przypis główny.

• Podprzypis (ang. sub-reference) definiuje dodatkowe szczegóły, takie jak numery stron, rozdziały, wersety, cytaty lub znaczniki czasu wideo. Krótko mówiąc coś co wskazuje na konkretny fragment większego dzieła. Na zrzucie ekranu „1.1” oraz „1.2”, po których podano numer strony, reprezentują dwa różne podprzypisy.

• W sekcji przypisów czytelnicy widzą wszystkie podprzypisy zgrupowane razem pod odpowiadającym im przypisem głównym. Ułatwia to zorientowanie się, jak często jedno źródło zostało przywołane w artykule.
• W wikitekście używasz nowego atrybutu do zdefiniowania szczegółów podprzypisu. Nazywa się on details. Poniżej znajdziesz więcej informacji oraz przykłady.
• W Edytorze Wizualnym, rozszerzamy funkcje istniejącego okna dialogowego przypisów, aby obsługiwało również podprzypisy.

Główne korzyści

• Podprzypisy są w dużej mierze oparte na istniejącym sposobie działania przypisów.
• Jest to zaprojektowane tak, aby działało zarówno dla Edytora Wizualnego, jak i edytorów kodu.
• Rozwiązanie zostanie zintegrowane z rozszerzeniem Cite dla MediaWiki, dzięki czemu będzie dostępne na wszystkich wiki i będzie można z niego korzystać bez używania obejść problemu opartych na różnych szablonów (różnych dla każdej wiki).
• Podprzypisy będą prawidłowo wyświetlane w podglądach przypisów i wyskakujących okienkach przypisów mobilnych.
• Jest to opcjonalne: nadal możesz używać innych metod cytowania. Możesz jednak napotkać podprzypisy w artykułach napisanych przez innych użytkowników.

Powiedz nam, co myślisz. Ważne jest, aby nowa funkcja nie zakłócała pracy użytkowników, była intuicyjna i działała dobrze zarówno dla użytkowników edytora wikikodu i edytora wizualnego, niezależnie od ich poziomu doświadczenia lub wiedzy na temat wikikodu i szablonów. Aby mieć pewność, potrzebujemy Twojej opinii:

• Przetestuj prototyp! Czytaj więcej o tym jak testować.
• Przekaż ogólną opinię na stronie dyskusji.
• Obserwuj tę stronę lub zapisz się na listę masowych wiadomości, aby dowiedzieć się o nowych rzeczach, które możesz przetestować.

Jak to działa

W edytorze wikikodu

Rozwiązanie wikitekstowe dla podprzypisów można przetestować na klastrze beta. Korzyści charakterystyczne dla wikitekstu:

• Nowe rozwiązanie używa istniejącego i dobrze znanego sposobu nazywania przypisów.
• Nie wymaga znajomości szablonów.
• Ręcznie duplikowane przypisy w celu dodania stron będzie można usunąć w wikikodzie, co sprawia, że kod strony jest czytelniejszy i łatwiejszy do edytowania.

 

---

 

Tworzenie przypisu głównego

Zanim utworzysz podprzypisy, potrzebujesz przypisu głównego zawierającego typowe informacje bibliograficzne. Przypis ten musi mieć przypisaną nazwę:

<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>

Ten przypis główny może być zdefiniowany zarówno w treści artykułu (w miejscu użycia), jak i w sekcji przypisów.

Tworzenie podprzypisu dla przypisów w treści

Jeśli przypis główny znajduje się w treści artykułu, możesz utworzyć podprzypis na dwa sposoby, używając atrybutu details:

Opcja 1: Zmodyfikuj przypis główny, aby zawierał dodatkowe szczegóły (np. numer strony).

<!-- Add the details attribute directly to the <ref> tag -->
<ref name="Miller" details="Page 23.">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>

<!-- As a next step, you can add another sub-reference using the following statement: -->
<ref name="Miller" details="Page 48." />

Przykład:

According to scientists, the Sun is pretty big. In fact, it is very big.<ref name="Miller" details="Page 23.">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> Take their word for it.<ref name="Miller" details="Page 48." /> == References == <references /> <!-- or {{reflist}} -->

Opcja 2: Wstaw jeden lub więcej oddzielnych podprzypisów bezpośrednio w nowym fragmencie treści, zachowując przypis główny bez zmian.

<!-- Unchanged main reference (in-line): -->
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
<!-- New sub-references: -->
<ref name="Miller" details="Page 23." />
<ref name="Miller" details="Page 48." />

Przykład:

According to scientists, the Sun is pretty big.<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> In fact, it is very big.<ref name="Miller" details="Page 23." /> Take their word for it.<ref name="Miller" details="Page 48." /> == References == <references /> <!-- or {{reflist}} -->

Tworzenie podprzypisu dla przypisów zdefiniowanych na liście

Jeśli przypis główny jest zapisany w znaczniku <references> (albo w szablonie z listą przypisów), to nie musisz definiować go ponownie w treści artykułu. Zamiast tego po prostu użyj w treści następującej składni:

<!-- Add this directly to the chosen location in the article text -->
<ref name="Miller" details="Page 23." />

<!-- The list-defined reference stays unchanged: -->
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>

Przykład:

According to scientists, the Sun is pretty big. In fact, it is very big.<ref name="Miller" details="Page 23." /> Take their word for it.<ref name="Miller" details="Page 48." /> == References == <references> <ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> </references>

Ponowne użycie podprzypisu

Po zdefiniowaniu podprzypisu możesz używać go ponownie w wielu miejscach bez ponownego definiowania przypisu głównego. Wystarczy powtórzyć w treści tę samą składnię przypisu:

<ref name="Miller" details="Page 23." />

• Zwracamy uwagę, że nie jest to zwykłe ponowne użycie, do jakiego przywykłeś w przypadku innych przypisów. Choć w wikitekście wydaje się powodować to powstanie duplikatów (kod rzeczywiście jest powtórzony), to identyczne podprzypisy są automatycznie scalane w widoku czytelnika oraz VisualEditorze. Dzięki temu mechanizmowi lista odniesień jest krótsza.
• Ta sama opcja ponownego użycia działa już w przypadku zwykłych przypisów — zarówno zdefiniowanych na liście przypisów (w sekcji przypisów), jak i w treści.
• Porada: kopiowanie i wklejanie istniejącego podprzypisu pozostaje prostym i zalecanym podejściem ponownego użycia.

Przykład – ponowne użycie podprzypisów w treści:

According to scientists, the Sun is pretty big.<ref name="Miller" details="Page 23.">E. Miller, ''The Sun''. New York: Academic Press, 2005</ref> In fact, it is very big. Take their word for it.<ref name="Miller" details="Page 48." /> Don't look directly at the sun!<ref name="Miller" details="Page 23." /> == References == <references /> <!-- or {{reflist}} -->

Przykład – ponowne użycie podprzypisów zdefiniowanych na liście:

According to scientists, the Sun is pretty big.<ref name="Miller" details="Page 23." /> In fact, it is very big. Take their word for it.<ref name="Miller" details="Page 48." /> Don't look directly at the sun!<ref name="Miller" details="Page 23." /> == References == <references> <ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005</ref> </references>

Konwertowanie istniejących przypisów na podprzypisy

Najpierw edytuj istniejący przypis, który ma stać się nowym przypisem głównym, przenosząc szczegóły takie jak numery stron do nowego atrybutu details="…". Przypisy do tego samego dzieła możesz zastąpić podprzypisami.

Przykład: wikitekst bez podprzypisów:

According to scientists,<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005. Page 23.</ref> the Sun is pretty big.<ref>E. Miller, ''The Sun''. New York: Academic Press, 2005. Page 30.</ref> In fact, it is very big.<ref>E. Miller, ''The Sun''. New York: Academic Press, 2005. Page 35.</ref> Take their word for it.<ref>E. Miller, ''The Sun''. New York: Academic Press, 2005. Page 48.</ref> Don't look directly at the sun!<ref name="Miller" /> == References == <references /> <!-- or {{reflist}} -->

Przykład: wikitekst po przekonwertowaniu przypisów na podprzypisy

Zwróć uwagę, że pierwszy przypis został przekształcony w przypis główny (wraz ze szczegółami), a pozostałe przypisy zostały przekształcone w podprzypisy.

According to scientists,<ref name="Miller" details="Page 23.">E. Miller, ''The Sun''. New York: Academic Press, 2005</ref> the Sun is pretty big.<ref name="Miller" details="Page 30." /> In fact, it is very big.<ref name="Miller" details="Page 35." /> Take their word for it.<ref name="Miller" details="Page 48." /> Don't look directly at the sun!<ref name="Miller" details="Page 23." /> == References == <references /> <!-- or {{reflist}} -->

Zagnieżdżanie podprzypisów

Możliwe jest używanie zagnieżdżonych przypisów w połączeniu z podprzypisami. Wielopoziomowe zagnieżdżanie również prawdopodobnie będzie działać, choć nie jest aktywnie wspierane.

Przykład – zagnieżdżanie podprzypisów przy użyciu {{refn}}

According to scientists, the Sun is pretty big.<ref name="Miller" details="Page 23.>E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> In fact, it is very big.{{refn|group="notes"|Some scientists disagree.<ref details="Page 30." name="Miller" />}} Take their word for it.<ref name="Miller" details="Page 48." />. == Notes == <references group="notes" /> == References == <references />

Szablony i podprzypisy

Szablony mogą być używane zarówno w podprzypisach, jak i w przypisach głównych — tak samo jak w zwykłych przypisach.

Przykład – podprzypisy z użyciem szablonu {{subref}}

According to scientists, the Sun is pretty big.<ref name="Miller" details="{{Subref|page=23|quote=It's soo big}}">{{Cite book |last=Miller |first=E. |title=The Sun |publisher=Academic Press |location=New York |date=2005}}</ref> In fact, it is very big. Take their word for it.<ref name="Miller" details="{{Subref|page=48}}" /> Don't look directly at the sun!<ref name="Miller" details="{{Subref|page=50|quote=Don't do it}}" /> == References == <references /> <!-- or {{Reflist}} -->

Uwagi użytkowe

• Pamiętaj, aby zawsze podawać nazwę przypisu podczas używania atrybutu details. Zastosowanie nazwy przypisu umożliwia innym łatwe ponowne użycie tego samego przypisu z różnymi szczegółami bez konieczności wcześniejszego definiowania nazwy.
• Podprzypisy nie są zarezerwowane wyłącznie dla numerów stron. Można je wykorzystywać także w innych przypadkach. Niektórzy redaktorzy wspominali nam, że chcieliby używać ich do znaczników czasu w podcastach, adresów URL (np. do rozdziału), wersów poezji, cytatów oraz innych szczegółów.
• Jeśli chcesz użyć cudzysłowów " wewnątrz details="…" (np. podczas wstawiania cytatu), upewnij się, że zamiast nich używasz " albo wydziel szczegóły pojedynczymi apostrofami. Użytkownicy VisualEditora będą mogli wpisać " podczas uzupełniania szczegółów podprzypisu, a znak ten zostanie automatycznie przekonwertowany w wikitekście. Inne znaki specjalne, które mogą wymagać podobnego traktowania przy użyciu details="…", to < oraz >.
• Niektóre gadżety lub skrypty związane z przypisami mogą również wymagać aktualizacji, aby poprawnie działały z nowym rozwiązaniem podprzypisów.
• Podczas korzystania z podprzypisów należy unikać szablonów, które generują znaczniki <ref>, ponieważ powodują one problemy w VisualEditorze, których na ten moment nie jesteśmy w stanie rozwiązać.

Edytor wizualny

Implementację podprzypisów w Edytorze Wizualnym (ang. VisualEditor) można przetestować na klastrze beta. Niektóre szczegóły nadal wymagają dopracowania, a inne funkcje mogą jeszcze ewoluować po wdrożeniu na wiki pilotażowych. Korzyści charakterystyczne dla VisualEditora:

• Aby przywołać to samo źródło z różnymi szczegółami, nie musisz już tworzyć nowego przypisu od podstaw.
• Podprzypisy zostały zaprojektowane tak, aby były w pełni kompatybilne z VisualEditorem (w przeciwieństwie do obejść opartych na szablonach).

 

---

 

Definiowanie przypisu głównego

• Użyj istniejącego okna dialogowego tworzenia przypisów, aby utworzyć przypis główny zawierający typowe informacje bibliograficzne. Pomiń szczegóły wskazujące na konkretne miejsce (np. numery stron). Te szczegóły wykorzystasz w podprzypisach.

Tworzenie podprzypisu

• Wybierz ponownie używany przypis lub utwórz jego kopię (metodą kopiuj&wklej, albo wykorzystując okno dialogowe ponownego użycia przypisów).
• Kliknij przycisk „dodaj szczegóły”, który pojawia się w oknie przypisu, jeśli przypis jest używany ponownie.
  
• Wpisz szczegóły danego podprzypisu i zastosuj zmiany.
  

Edycja podprzypisu

• Kliknij odnośnik do przypisu w tekście artykułu i wybierz drugi przycisk edycji (ikonę pióra), aby zmienić podprzypis.
  
• Możesz teraz edytować szczegóły podprzypisu.
  
• Nie można edytować podprzypisu, klikając go na liście przypisów (choć edycja przypisu głównego działa na liście tak samo jak dotychczas).

Ponowne użycie istniejącego podprzypisu

• Możesz ponownie użyć podprzypisu za pomocą odpowiedniej zakładki w oknie dialogowym.
  
• Alternatywnie możesz — podobnie jak w przypadku zwykłych przypisów — kliknąć na odnośnik do podprzypis i skopiować go w wybrane miejsce artykułu za pomocą kopiowania i wklejania. To również utworzy ponowne użycie podprzypisu.

Konwertowanie istniejących przypisów na podprzypisy

• Wybierz używany kilkukrotnie przypis (lub skopiuj go).
• Kliknij „edytuj”, skopiuj szczegóły, których chcesz użyć w podprzypisach (np. numer strony), a następnie usuń te szczegóły, aby przekształcić przypis w przypis główny.
  

• Kliknij przycisk „dodaj szczegóły”.
  
• Wklej (lub wpisz) właśnie usunięte szczegóły i zastosuj zmiany.
  
• Zastąp inne podobne przypisy ponownym użyciem przypisu głównego i dodaj szczegóły dla każdego z nich.

Szablony i podprzypisy

Szablony mogą być używane zarówno w podprzypisach, jak i w przypisach głównych — tak samo jak w zwykłych przypisach.

• Kliknij przycisk „dodaj szczegóły”.
  
• Użyj przycisku „wstaw”, aby wybrać szablon.
  
• Użyj okna dialogowego szablonów, aby wyszukać żądany szablon.
  
• Uzupełnij parametry szablonu i wstaw szablon.
  
• Podprzypis jest teraz wyświetlany wraz z szablonem.
  

Uwagi

• Pracujemy nad stworzeniem jeszcze bardziej intuicyjnego interfejsu w zakresie korzystania z przypisów w VisualEditorze. To, co widzisz teraz, to dopiero początek — między innymi mamy pomysły na ulepszone okno dialogowe edycji przypisów. Po wdrożeniu podprzypisów na pierwszych wiki pilotażowych poprosimy o opinie na temat niektórych prototypów.
• Istniejące zachowanie polegające na automatycznym nadawaniu numerycznych nazw ponownie używanym przypisom w VisualEditorze występuje również w przypadku podprzypisów. Naprawa tego problemu wykracza poza zakres tego projektu.

Zdecydowaliśmy się usunąć możliwość tworzenia podprzypisów za pomocą karty „ponowne użycie” w oknie dialogowym przypisów na potrzeby wydania wiki pilotażowej, ponieważ testy z użytkownikami wykazały, że nie jest to zbyt intuicyjne. Po wdrożeniu na wiki pilotażowych zbierzemy dodatkowe opinie, aby sprawdzić, czy powinniśmy ponownie dodać tę opcję w kolejnych iteracjach (a jeśli tak — w jaki sposób ją ulepszyć).

 Przetestuj nasz prototyp

Potrzebujemy Twojej opinii, aby mieć pewność, że tworzymy właściwe rozwiązania. Opinie lub pytania są zawsze mile widziane na stronie dyskusji tego projektu albo poprzez bezpośrednie umówienie rozmowy z naszym badaczem UX. Prototyp jest dostępny na beta wiki.

Testuj na beta wiki Przekaż opinię Zarezerwuj zdzwonkę

Pamiętaj, że beta wiki różni się nieco od zwykłej wiki:

• Może wyglądać inaczej (np. nie używać ustawionej przez Ciebie skórki).
• Może zawierać nowe funkcje, które są aktualnie testowane.
• Zawiera tylko kilka stron testowych i szablonów, nie posiada wszystkich modułów, gadżetów itp.
• Używany przez Ciebie w projektach Wikimedia login nie działa na beta wiki. Możesz albo zarejestrować konto (upewnij się, że używasz innego hasła niż to z konta Wikimedia), albo przetestować funkcję bez konta, co doprowadzi do utworzenia konta tymczasowego.

W toku

Podprzypisy są już gotowe zarówno w edytorze kodu, jak i w VisualEditorze oraz zostały wdrożone na niemieckiej Wikipedii. Mamy nadzieję zebrać dzięki temu nowe opinie na potrzeby dalszych ulepszeń. Niektóre z naszych kolejnych kroków:

• Choć nie ma problemów z zwykłymi różnicami wersji, różnice wizualne obecnie nie wyświetlają podprzypisów poprawnie (phab:T397319).
• Edycje w VisualEditorze w artykułach korzystających z podprzypisów czasami prowadzą do nieoczekiwanych zmian w wikitekście bez wpływu jednak na to co widzi czytelnik („brudne diffy”), np. zastępowania <references /> przez <references></references> (phab:T403379).
• Znaki nowej linii wewnątrz podprzypisów w wikitekście obecnie nie wczytują się w VisualEditorze (phab:T390266).
• Nadal występują problemy z VisualEditorem i {{Reflist}}, które musimy rozwiązać przed wdrożeniem w projektach korzystających z podobnych szablonów.

Problem, nad którym pracujemy

W artykułach na Wikipedii powszechne jest wielokrotne odwoływanie się do tego samego źródła. Ale chociaż można ponownie użyć przypisu poprzez „kopiuj-wklej”, to nie jest możliwe ponowne użycie go z „różnymi szczegółami” (np. różnymi numerami stron). Jedyną opcją jest utworzenie zupełnie nowego przypisu lub skorzystanie z jakiegoś obejścia.

Status quo: ponowne użycie przypisu w edytorze wikikodu i edytorze wizualnym

Jeśli chcesz ponownie użyć przypisu w edytorze wikikodu, możesz przekształcić go w nazwany przypis i odwołać się do tej nazwy w innym miejscu artykułu. Nazwany przypis może być umieszczony w tekście artykułu lub w sekcji przypisów. W edytorze wizualnym można użyć opcji „użyj ponownie” w oknie dialogowym cytowania. W sekcji przypisów przypisy o tej samej nazwie są grupowane razem.

• 
  Edytor wikikodu: <ref name> w tekście artykułu
• 
  Edytor wikikodu: <ref name> w sekcji przypisów
• 
  Edytor wizualny: okno dialogowe cytowania
• 
  Widok czytelnika

Status quo: ponowne użycie przypisu z różnymi szczegółami w edytorze wikikodu

Obecnie, jeśli chcesz ponownie użyć istniejącego przypisu z innymi szczegółami w edytorze wikikodu, musisz skopiować i wkleić istniejące przypisy i zmienić szczegóły drugiego lub utworzyć nowy (prawie identyczny) przypis. Niektóre projekty stosują obejścia, takie jak krótkie cytaty lub rozwiązania oparte na szablonach, takie jak skrócone przypisy. W sekcji przypisów, oryginalny przypis i nowy, który został utworzony, nie są zgrupowane razem.

• 
  Dwa prawie identyczne przypisy w edytorze wikikodu.
• 
  Widok czytelnika: Prawie identyczne przypisy nie są zgrupowane
• 
  Obejście z krótkimi cytatami w edytorze wikikodu
• 
  Widok czytelnika: obejście z krótkimi cytatami
• 
  Obejście z {{sfn}} w edytorze wikikodu
• 
  Widok czytelnika: obejście z {{sfn}}

Status quo: ponowne użycie przypisu z różnymi szczegółami w edytorze wikikodu

Jeśli chcesz ponownie użyć istniejącego przypisu z innymi szczegółami w edytorze wizualnym, ani opcja „re-use” w oknie dialogowym cytowania, ani metoda kopiuj-wklej nie zadziałają, ponieważ obie prowadzą do „identycznych” efektów, a zmiana szczegółów ponownie używanego/kopiowanego przypisu zmienia „obie” instancje tego przypisu. Zamiast tego należy utworzyć nowy (prawie identyczny) przypis. W sekcji przypisów oryginalny i nowy nie są zgrupowane razem.

Przypisy stworzone przez rozwiązania oparte na szablonie, takie jak {{sfn}}, nie mogą być edytowane w sekcji przypisów i nie pojawiają się w zakładce ponownego użycia; można je edytować ręcznie w tekście artykułu.

Obejście z {{sfn}}:

• 
  Widok czytelnika
• 
  Przypisy znikają z sekcji przypisów po kliknięciu "Edytuj".
• 
  Nie można używać {{sfn}} poprzez zakładkę "re-use".
• 
  Przypisy można edytować tylko w tekście artykułu

Problemy dla czytelników

Obejścia oparte na szablonach nie są poprawnie wyświetlane w Reference Previews, Reference Tooltips i wyskakujących okienkach mobilnych.

Obejście z użyciem {{sfn}} przy podglądzie przypisów:

• 
  Podgląd przypisów (Reference Previews): szczegółowe informacje nie pokazują się w okienku.
• 
  Podgląd przypisów (Reference Tooltips): szczegółowe informacje nie pokazują się w okienku.
• 
  Podgląd przypisów (Reference Tooltips): szczegółowe informacje pokazują się w osobnym okienku.
• 
  Mobilne okienko: szczegółowe informacje się nie pokazują.

Najważniejsze problemy ze statusem quo

• Doświadczenia użytkowników edytora wizualnego i edytora wikikodu są bardzo różne.
• Większość rozwiązań dla ponownego użycia przypisów z różnymi szczegółami nie działa prawidłowo w edytorze wizualnym.
• Stworzenie wielu prawie identycznych przypisów z różnymi szczegółami sprawia, że wikikod strony jest dłuższy i potencjalnie trudniejszy do czytania.
• Rozwiązania oparte na szablonach nie są akceptowane przez wszystkie społeczności, a zatem nie są dostępne we wszystkich wersjach językowych.
• Niektórzy użytkownicy próbują uniknąć tego problemu, umieszczając źródła w sekcji bibliografii bez użycia ich jako przypisu, co utrudnia weryfikację treści w poszczególnych akapitach artykułu.

Ostatnie zmiany i następne kroki

Nasz zespół pracował nad tym problemem z przerwami już od pewnego czasu. Tutaj znajduje się przegląd historii tego projektu, w tym naszych pogłębionych badań.

Dziękujemy wszystkim, którzy wzięli udział w testach i wywiadach badawczych oraz wykazali zainteresowanie tematem, a także wszystkim, którzy przez lata poświęcili czas na dyskusje nad tym tematem. Bardzo to doceniamy. Jeśli masz dodatkowe uwagi, prosimy o podzielenie się nimi na stronie dyskusji.

Updates

• Y We have deployed sub-referencing in September 2025 to German Wikipedia as our first pilot wiki.
• Y Read more about our learnings and observations from three months of sub-referencing on German Wikipedia.
• We will deploy sub-referencing to additional pilot wikis in February 2026. (phab:T414094)
• We are continuously improving the feature and implementing community feedback.

Next Steps

The Technical Wishes team’s focus remains on completing the sub-referencing feature.

• We’ll update you continuously as the feature evolves on the betawiki and we need you to test it.
• We are planning to deploy the sub-referencing feature to other Wikimedia wikis in 2026.
• Check our report and phab:T414094 for our preliminary deployment plan and our roadmap for upcoming improvements to sub-referencing.
• We will continue to collect feedback to improve the solution after deployment.

Archived updates from 2025

• Y In 2024 we worked on a prototype for discovery and testing purposes based on the extends syntax and engaged with the community through multiple on-wiki communications, user testing sessions, and workshops in different venues, including Wikimania 2024.
• Y In October/November 2024, we explored possible changes to our wikitext approach, based on the community feedback we've received. We reached out to communities and presented a new solution to get their feedback on its usability. We found that the feedback was mixed but nothing spoke against the feature bringing its intended value to the community.
• Y In 2025, we started the development of the new syntax. The engineers and designer of the Technical Wishes team are working on building out sub-referencing.
• Y We have deployed sub-referencing in September 2025 to German Wikipedia as our first pilot wiki.
• Y We are improving sub-referencing and will reach out to other potential pilot wikis in the upcoming months.

Archived updates from 2024

• Y A prototype is available on beta wiki. It covers the wikitext solution and some of the basic features of the VisualEditor solution. You can continuously test the prototype and give feedback.
• Y We've sent out announcements across all wikis to let communities know about this upcoming feature, and have invited them to test and give feedback.
• Y Our team presented sub-referencing at Wikimania 2024 and discussed with participants. (YouTube)
• Y Moderated users tests took place across different projects in 2024.
• As of October/November 2024, we are currently exploring possible changes to our wikitext approach, based on the community feedback we've received. We'll reach out to communities soon to get more feedback on possible changes to the sub-referencing feature.
• Pilot wiki deployment is stalled, pending discussions and potential changes to our feature.
• We are planning to deploy the sub-referencing feature to other Wikimedia wikis in 2025.
• We will continue to collect feedback to improve the solution after deployment.

Najczęściej zadawane pytania

Jak mogę znaleźć artykuły, które używają podprzypisów?

Do każdej strony, na której używane są podprzypisy, dodawana jest kategoria śledząca o nazwie Kategoria:Pages that use sub-references, co umożliwia przeglądanie lub poprawianie stron korzystających z tej nowej funkcji. Nazwa tej kategorii może ulec zmianie.

Ponadto zespół przygotował szereg przykładów na angielskiej beta wiki.

Czy mogę wstawić szablon do atrybutu details?

Tak, możesz wstawiać szablony zarówno w przypisie głównym, jak i w podprzypisie. Początkowo otrzymaliśmy opinie sugerujące, że używanie szablonów w atrybucie może powodować więcej problemów niż korzyści. Inni użytkownicy wyraźnie oczekiwali jednak obsługi szablonów, zwłaszcza w VisualEditorze. Podziel się swoimi przemyśleniami na temat podprzypisów i szablonów na stronie dyskusji.

Jak nowa funkcja wpłynie na istniejące gadżety i skrypty?

Niektóre gadżety i skrypty związane z przypisami mogą wymagać aktualizacji, aby poprawnie działały z nowym rozwiązaniem podprzypisów, choć możliwe jest, że dla części z nich będzie to obojętne (będą ignorować nowy atrybut). Ponieważ gadżety i skrypty znajdują się w gestii społeczności wiki, nie jesteśmy w stanie ich dostosować.

Daj nam proszę znać na stronie dyskusji, jeśli napotkasz jakiekolwiek problemy lub będziesz potrzebować pomocy przy aktualizacji szablonów przypisów (np. Cytuj), aby działały z nową funkcją.

Dlaczego wybraliście taką składnię wikitekstu?

Ten wpis przedstawia uzasadnienie wyboru składni dla atrybutu details. Uważamy, że najlepszą i najszybszą drogą do dostarczenia użytecznej funkcji jest zastosowanie wybranej składni, mimo że wiąże się ona z pewnymi ograniczeniami.

Historycznie rzecz biorąc, żadna składnia nie była idealna i każde rozwiązanie ma swoje wady. Po długich dyskusjach i konsultacjach z wieloma zespołami w Wikimedia Foundation i nie tylko doszliśmy do wniosku, że to rozwiązanie spełnia nasze wymagania techniczne i będzie też dobre pod względem długoterminowego utrzymania.

Jest to również w pełni kompatybilne z wiki, które nadal polegają na {{reflist}} lub preferują jego użycie. Składnia ta pozwala stosować przypis główny bezpośrednio w treści artykułu, bez konieczności umieszczania go w sekcji przypisów, co w przeciwnym razie powodowałoby ograniczenia w VisualEditorze.

Ponadto jesteśmy przekonani, że to podejście będzie działać spójnie również w ramach różnych trybów pracy z VisualEditorem.

Dlaczego znalezienie rozwiązania zajęło tak dużo czasu?

Zespół Technical Wishes pracował nad tą funkcją z przerwami przez wiele lat. Jeśli chcesz dowiedzieć się więcej, zajrzyj na: przegląd historii i złożoności tego problemu.