WMDE Technical Wishes/Sub-referencing/he
נכון לעכשיו, לא ניתן בקלות להשתמש באותה הפניה עם פרטים שונים בערך. חברי הקהילה ביקשו שוב ושוב פתרון מדיה-ויקי שעובד ללא תבניות ומבוסס על הדרך הקיימת בה הפניות פועלות, הן עבור ויקיטקסט והן עבור עורך חזותי. » למידע נוסף על הבעיה
| תת־מקורות | |
|---|---|
| Status | בתהליך |
| Origin | Technical Wishes survey 2013, 2015, 2022 and others |
| Focus area | Make reusing references easier |
| Phabricator | לוח פרויקט |
| Responsible | צוות בקשות טכני |
 === ספרו לנו מה אתה חושבים === אנו מזמינים אותך לבדוק את אב הטיפוס שלנו, אותו אנו מעדכנים כל הזמן. צפה בדף זה או הירשם לרשימת התפוצה כדי ללמוד על דברים חדשים שתוכל לבדוק | |
כחלק מתחום המיקוד "הקל על שימוש חוזר בהפניות", צוות המשאלות הטכניות של Wikimedia Deutschland מציג את הפניות משנה - תכונה אופציונלית המאפשרת לך לצרף בקלות פרטים שונים להפניה קיימת, ללא צורך לשכפל אותה.
התוכנית שלנו היא להביא הפניות משנה לויקימדיה בסוף 2024.
Sub-referencing in a nutshell
כדי לצטט מקור יותר מפעם אחת עם פרטים שונים, צריך הפניה עיקרית והפנית משנה.
- ההפניה הראשית מכילה את המידע הביבליוגרפי העיקרי.
- הפנית משנה מכילה את הפרטים הבאים: מספרי עמודים, או כל סוג של מידע נוסף אשר שונה עבור כל ציטוט, למשל: פרקים, פסוקים או הערות.
- בסעיף ההפניות, קוראים רואים את כל הפניות המשנה מקובצות יחד מתחת להפניה הראשית שלהן. כך קל יותר להבין באיזו תדירות צוטט מקור בודד במאמר זה.
- עבור wikitext, אתה משתמש בתכונה חדשה להפניית משנה. השם הנוכחי של התכונה הזו הוא מתרחב, אבל השם עשוי להשתנות לפני פריסת התכונה. נאסוף משוב נוסף על השם
- בעורך חזותי, אנו משנים את תיבת הדו-שיח הקיימת לציטוט כך שתתמוך בהפניות משנה.
יתרונות עיקריים
- הפניות משנה מבוססות על הדרך הקיימת בה פועלות הפניות
.
- זה עובד הן בעורך החזותי והן בעורך קוד מקור, ומקרב אותנו לשיווי תכונות בין שני סוגי העורכים.
- הפתרון ישולב בוויקימדיה, ובכך יהיה זמין בכל אתרי ויקימדיה, ויהיה ניתן לשימוש ללא צורך בפתרונות עוקפים מבוססי תבניות.
- הפניות משנה יוצגו כהלכה בתצוגות מקדימות ובחלונות קופצים של הפניות לנייד.
- זה אופציונלי: אתה עדיין יכול להשתמש בשיטות אחרות להפניה. אבל אתה עלול להיתקל בהפניות משנה במאמרים שנכתבו על ידי משתמשים אחרים.
- בדוק את אב הטיפוס! קרא עוד על אופן הבדיקה.
- תן משוב כללי ב-דף השיחה.
- צפה בדף זה או הירשם לרשימת התפוצה כדי ללמוד על דברים חדשים שאתה יכול לבדוק.
== איך זה עובד ==
בוויקיטקס
פתרון הוויקיטקסט להפניית משנה כמעט הושלם. עם זאת, שם התכונה עשוי להשתנות. הפתרון עדיין לא נפרס בעיקר בגלל שאנו רוצים להימנע מכך שלמשתמשי העורך החזותי תהיה חוויה שונה מאשר למשתמשי ויקיטקסט. התמיכה בעורך החזותי עדיין בפיתוח.
אתה עדיין יכול לבדוק את האב טיפוס ולספר לנו איך הוא עובד עבורך.
יתרונות ספציפיים לויקיטקסט
- הפתרון מבוסס על התפיסה הקיימת והידועה של אסמכתאות בשמות.
- זה לא דורש שום ידע בתבניות.
- ניתן להסיר הפניות כמעט משוכפלות בוויקיטקסט, מה שהופך אותו לנקי יותר, פחות מיותר וקל יותר לקריאה.
צעד אחר צעד
1) אתה צריך הפניה עם המידע הביבליוגרפי הראשי, הפניה הראשית. הפניה זו צריכה שם:
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
ההפניה העיקרית הזו צריכה להיות ממוקמות בסעיף הפניות, אחרת תהיה לך הפניה במאמר שלא מציגה פרטים כמו מספרי עמודים. בקטע ההפניות, השתמש בתחביר <references> … </references>. אם המאמר כבר משתמש ב-<references />, הסר אותו.
2) צור הפניית משנה, תוך שימוש בשם ההפניה הראשית עם התכונה מרחיב. אתה מוסיף את הפרטים בין תגי <ref>:
<ref extends="Miller">Page 23.</ref>
איך זה יראה:
According to scientists, the Sun is pretty big.<ref extends="Miller">Page 23.</ref> In fact, it is very big. Take their word for it.<ref extends="Miller">Page 48.</ref> Don't look directly at the sun!<ref extends="Miller">Page 23.</ref>
==References==
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>
|
|
אם ברצונך להפנות למקור חדש באמצעות הפניות משנה בוויקיפדיה, עליך רק להקפיד ליצור את ההפניה הראשית בסעיף ההפניות.
אבל במקרים רבים, סביר להניח שתרצה להשתמש בהפנית משנה עם הפניה שכבר קיימת במאמר. במקרים אלו
הפוך את ההפניה המקורית להפניה ראשית על ידי שימוש ב-<ref name>.
- העבר את ההפניה הראשית לקטע ההפניות.
- צור הפניה משנה שבה ההפניה המקורית הייתה בעבר בטקסט המאמר.
- העבר את פרטי ההפניה הראשית (מספרי עמודים וכו') לתוך הפנית המשנה. ודא שהם לא נשארים יותר בהפניה הראשית, אחרת הפרטים האלה יוצגו פעמיים.
- צור הפניות משנה נוספות בכל מקום שתרצה לצטט את המקור עם פרטים שונים במאמר.
אתה יכול גם להשתמש בהפניית משנה עצמה על ידי מתן שם להפניה:
According to scientists, the Sun is pretty big.<ref extends="Miller" name="Miller, 23">Page 23.</ref> In fact, it is very big. Take their word for it.<ref extends="Miller">Page 48.</ref> Don't look directly at the sun!<ref name="Miller, 23" />
==References==
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>
|
|
אנא זכרו
- המרת הפניות להפניות ראשיות ומשניות דורשת סדר מסוים; וההפניה הראשית צריכה להיות בדרך כלל בקטע ההפניות (כמתואר למעלה).
- אתה יכול להשתמש בהפנית משנה עם תבניות ציטוט. בדקנו את התבניות הנפוצות ביותר, אך יתכן כי התבנית המועדפת עליך עשויה להזדקק לכמה עדכונים כדי לעבוד עם הפתרון שלנו.
- חלק מהגאדג'טים/סקריפטים הקשורים להפניות עשויים להזדקק לעדכון כדי לעבוד כראוי עם פתרון הפניות המשנה החדש
- לא ניתן לבצע הפנית משנה של הפניה משנה.
- אם נעשה שימוש ב-
<ref group>, ההפניה הראשית והפנית המשנה צריכות להיות באותה קבוצה.
בעורך החזותי (בפיתוח)
בשלב זה, איננו יודעים בדיוק כיצד תיראה התכונה עבור העורך החזותי. עד כה, יש לנו פתרון מינימלי ביותר שעדיין לא מוכן לפריסה. סביר להניח שבשבועות הקרובים פתרון זה ישתנה.
אתה יכול גם לבדוק את אב הטיפוס עם המצב הנוכחי של פתרון העורך החזותי. אנא זכור שסביר להניח שזה ישתנה. אנו נעדכן דף זה כאשר ניתן יהיה לבדוק תכונות חדשים.
יתרונות ספציפיים לעורך חזותי
- כדי לצטט את אותו מקור עם פרטים שונים, לא צריך עוד ליצור הפניה חדשה חדשה.
- הפניות משנה תואמות באופן מלא לעורך החזותי (בניגוד לפתרונות עוקפים המבוססים על תבניות): אתה יכול ליצור אותן באמצעות תיבת הדו-שיח לציטוט ותוכל לערוך אותן מתוך קטע ההפניות.
שיטות עבודה באב הטיפוס הנוכחי (סביר שישתנה)
Creating a sub-reference
- Creating a sub-reference currently works via the the existing citation dialog.
- In the "re-use" tab, select the reference you want to re-use via the three dots and click "re-use this reference with additional details".
- Enter the details of that sub-reference and click insert.
- The reference popup in Visual Editor shows you that this reference is a sub-reference, and how often it is re-used.
Editing an existing sub-reference
- Click on the footnote marker in the article text to edit a sub-reference.
- You can now change the details of the sub-reference. You are also informed that it is a sub-reference.
- You cannot edit a sub-reference from the reference list yet.
- To edit the main reference, click on it in the references section.
Re-using a sub-reference
- You can re-use a sub-reference using the "re-use" tab in the citation dialog.
Please note
- The existing problem with auto-names for references in Visual Editor also occurs with sub-referencing.
- In Visual Editor, it is currently possible to make a sub-reference of a sub-reference. This is an error and causes an error upon saving. It is not supposed to work later in the actual solution, and does not work in wikitext, either.
- We have yet to work on what happens when you delete a reference that is being re-used.
- The workflow on turning an existing reference in a main and sub-reference has yet to be defined.
- When you create a re-use of a sub-reference in Visual Editor and then switch to wikitext, you will find that the statement in wikitext is
<ref extends="main-reference" name="sub-reference" />. This is a bug and will be fixed as part of T367749. <ref name="sub-reference name"/>currently does not show the Reference Preview for the sub-reference properly in Visual Editor editing mode. You will only see the sub-reference's details in the pop-up and not the information from the main reference. To see the main reference's information in the pop-up as well, you should currently use the syntax<ref extends="main" name="sub-reference name" />.
Test the prototype
We need your feedback to make sure we build the right things. Feedback or questions are always welcome on this project’s talk page.
The prototype is available on beta wiki. Currently, we primarily invite you to test the wikitext solution:
- They might look different (e.g. not use your preferred skin).
- They might offer some new features that are still being tested.
- They only contain some test pages and templates, not your entire wiki’s content, and not all the templates, modules, gadgets etc. you are used to.
- Your regular Wikimedia login doesn’t work on beta wikis. You can either register an account – make sure to use a different password than your regular Wikimedia account – or test the feature without an account, which will lead to the creation of a temporary account (on de-betawiki) – or display your IP address (on en-betawiki).
The problem we are solving
In Wikipedia articles, it is common to reference a source multiple times. But while you can re-use a reference exactly as it is, you currently cannot re-use the same reference with different details (e.g. different page numbers). Your only option is to create a whole new reference or to use workarounds.
Status quo: Re-using references in wikitext and Visual Editor
If you want to re-use a reference in wikitext, you can turn it into a named reference and refer to that name at another point in the article. The named reference can be placed in the article text or in the references section. In Visual Editor you can use the option "re-use" in the citation dialog. In the references section, references with the same name are grouped together.
-
Wikitext: <ref name> in the article text -
Wikitext: <ref name> in the references section -
Visual Editor: citation dialog -
Reader's view
Status quo: Re-using references with different details in wikitext
If you want to re-use an existing reference with different details in wikitext, you currently need to copy and paste the existing reference and change the details of the duplicate or create a new (almost identical) reference from scratch. Some projects use workarounds like short citations or template-based solutions like shortened footnotes. In the references section, the original reference and the new one you created are not grouped together.
-
Two almost identical references in the wikitext. -
Reader's view: Almost identical references are not grouped together -
Workaround with short citations in wikitext -
Reader's view: workaround with short citations -
Workaround with {{sfn}} in wikitext -
Reader's view: workaround with {{sfn}}
Status quo: Re-using references with different details in Visual Editor
If you want to re-use an existing reference with different details in Visual Editor, neither the option "re-use" in the citation dialog nor the copy-and-paste method will work, because both lead to identical re-uses, and changing details of the re-used/copied reference changes both instances of that reference. Instead you’ll need to create a new (almost identical) reference from scratch. In the references section, the original reference and the new one you created are not grouped together.
References created by template-based workarounds like {{sfn}} cannot be edited from within the references section and don’t appear in the citation re-use tab; but it is possible to edit them manually when locating them in the article text.
workaround with {{sfn}}:
-
Reader's view -
The references disappear from the references section when clicking "edit". -
It is not possible to use {{sfn}} references via the "re-use"-dialog. -
References can only be edited when locating the reference in the article text
Problems for readers
Template-based workarounds are not properly displayed in Reference Previews, Reference Tooltips and mobile reference pop-ups.
{{sfn}} workaround with previews for references:
-
Reference Previews: The main information is not included in the pop-up. -
Reference Tooltips: The main information is not included in the initial pop-up. -
Reference Tooltips: The main information is shown in another pop-up. -
mobile reference pop-ups: The main information is not included.
Main problems with the status quo
- The experience of Visual Editor and wikitext users is very different.
- Most workarounds for reusing references with different details don’t work properly in Visual Editor.
- Creating lots of almost identical references with different details makes the wikitext longer and potentially harder to read.
- Template-based workarounds are not equally accepted by all communities and thus not globally available.
- Some users try to avoid this issue by putting sources in the bibliography section without using them as references at all, which makes it harder to verify sections of the article.
Recent changes and next steps
Our team has worked on this problem on and off for some time now. Here is an overview of this project’s history, including our research.
Thank you to everyone who participated in tests and interviews and who showed interest, as well as everyone who took the time to comment on our talk pages over the years. It is deeply appreciated. If you have further feedback, please share it on the talk page.
A prototype is available on beta wiki. It covers the wikitext solution and some of the basic features of the Visual Editor solution. You can continuously test the prototype and give feedback.- We have sent out announcements across all wikis to let communities know about this upcoming feature, and have invited them to test and give feedback.
- Our team presented sub-referencing at Wikimania 2024 and discussed with participants. (YouTube)
- 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.
We are aware of other problems in the focus area "reusing references", and we will try to address them along the way. Our focus, however, remains on creating a solution for sub-referencing.
Frequently Asked Questions
How can I find articles that use sub-referencing?
A tracking category called Category:Pages that use extended references is added to any page where sub-referencing is used, allowing you to explore or fix pages using the new feature. The name of this category might change.
Can I use this feature with citation templates/tools?
Yes, you can use sub-referencing with citation templates. We’ve tested the most common citation templates (e.g. cite book or cite web) and don’t expect any issues. But your favorite template might need some updates in order to work with our solution. Some gadgets/scripts related to references might also need an update in order to properly work with the new sub-referencing solution. Because templates, gadgets and scripts are in the hands of the wiki communities, we are unable to adapt them.
Please let us know, on the talk page, if you discover any problems or need some help updating citation templates to make them work with the new feature.
What will the name of the sub-reference attribute be?
We don’t know yet. Currently, the attribute name for creating sub-references in wikitext is extends. We decided on this name some years ago after discussing with communities and stakeholders at the Wikimedia Foundation. However, we have received some feedback that this name might not be the best option. Before we will deploy this feature to the wikis, we want to get more feedback on the attribute name and are planning to put some alternatives up for discussion. We’ll let you know when that happens.
Why did you choose this wikitext syntax?
When we first started working on the wikitext implementation of this feature, we discussed different options. Adding a new tag (e.g. <subref>) was discussed carefully, but we wanted to stick to the existing <ref> approach, to minimize the amount of new syntax users have to learn. Besides, introducing a new tag would require many updates to existing community software (tools, gadgets, bots etc.) for referencing.
One proposal (from 2008) was to specify the subreference’s details within the <ref> tag: <ref page="page 2" name="Miller"> or later <ref detail="page 2" name="Miller"> using the name attribute to refer to the main reference. This is similar to what users know from working with templates like {{cite book}}.
The main issue with this approach is, however, that it causes problems with templates and is very likely to cause errors. Another problem with this syntax is that it does not allow to re-use a sub-reference, because the name attribute has already been used to refer to the main reference and cannot be used a second time.
A way to avoid both these issues is to create a new reference attribute and put the sub-reference’s details in the area between the opening and closing <ref> tags, the same way it is already done for the content of references. This is what our approach does.
Why did it take so long to find a solution?
The Technical Wishes team has worked on this feature on and off for many years. If you want to know more, here’s an overview of the history and complexity of this problem.