WMDE Technical Wishes/Sub-referencing/ar
إضافة مراجع فرعية | |
---|---|
Status | قيد التنفيذ |
Origin | استبانات الأمنيات الفنية للسنوات 2013 و2015 و2022 وغيرها |
Focus area | تسهيل إعادة استخدام المراجع |
Phabricator | لوحة المشروع |
Responsible | فريق الأمنيات الفنية |
![]() أخبرنا رأيك نتوجه إليكم بالدعوة لاختبار نموذجنا الأولي الذي نحدثه باستمرار. راقبوا هذه الصفحة أو سجلوا أنفسكم في قائمة الرسائل الجماعية هذه لتتعرفوا على المزيد عن أمور جديدة يمكنكم اختبارها |
في الوقت الراهن، ليس ممكنًا أن تعيد استخدام المراجع ذاتها مستخدماً تفاصيلاً أخرى بسهولة في أي مقالة. طلب أفراد المجتمع عدة مرات حلًا في برمجيات ميدياويكي ينجز هذه المهمة دون الحاجة لقوالب ويستند إلى الطريقة الحالية التي يعمل بها المراجع، في كل من محرر نصوص الويكي والمحرر المرئي. >> تعرفوا على المزيد عن المشكلة
جزء من مجال التركيز المعروف باسم «جعل إعادة استخدام المراجع أسهل»، يقدم لكم فريق الأمنيات الفنية التابع لويكيميديا ألمانيا خاصية إضافة مراجع فرعية – سمة اختيارية تسمح لكم إضافة تفاصيل مختلفة بسهولة إلى مرجع، دون الحاجة لتكرار ذات المرجع.
Our plan is to bring Sub-referencing to the Wikimedia wikis in 2025.
إضافة المراجع الفرعية باختصار
إن أردتم الاستشهاد بمصدر أكثر من مرة واحدة مستخدمين تفاصيل مختلفة، ستحتاجون لمرجع رئيسي ومرجع فرعي.
- يحتوي المرجع الرئيسي على المعلومات الفهرسية الرئيسية.
- يحتوي المرجع الفرعي على التفاصيل: أرقام الصفحات أو أي نوع آخر من المعلومات الإضافية التي تختلف من استشهاد لآخر مثل الفصول أو الآيات أو الملاحظات.
- A sub-reference defines additional details, such as page numbers, chapters, verses, quotes, or video timestamps. In the screenshot, "1.1" and "1.2" followed by a page number represent two different sub-references.

- في قسم المراجع، سيرى القراء كافة المراجع الفرعية مجمّعة تحت مرجعها الرئيسي. ييسر هذا استيعاب عدد مرات الاستشهاد بمصدر واحد في تلك المقالة.
In wikitext you use a new attribute to define the details of a sub-reference. It’s called details
. See below for more information and examples.
في المحرر المرئي، سنغيّر المربع الحواري الحالي المستخدم في الاستشهادات حتى يدعم إضافة المراجع الفرعية.
المنافع الرئيسية
- Sub-referencing is largely based on the existing way references work.
- It's designed to work for both Visual Editor and wikitext.
- سيُدمج الحل في ميدياويكي، وبالتالي فهو متاح عبر جميع مواقع الويكي الخاصة بويكيميديا ويمكن استخدامه دون حلول بديلة قائمة على القوالب.
- ستُعرض المراجع الفرعية بشكل صحيح في معاينة المرجع والنوافذ المنبثقة لمراجع الهاتف المحمول.
- إنه اختياري: يمكنك استخدام طرق أخرى للإشارة. ولكن قد تواجه الإشارات الفرعية في المقالات التي كتبها مستخدمون آخرون.

- اختبار النموذج الأولي! اقرأ المزيد حول كيفية الاختبار.
- قدم تعليقات عامة على صفحة النقاش.
- شاهد هذه الصفحة أو اشترك في قائمة الرسائل الجماعية هذه للتعرف على الأشياء الجديدة التي يمكنك اختبارها.
كيف تعمل
في محرر نصوص الويكي
شارف حل نصوص الويكي للمراجع الفرعية على الانتهاء. ألا أن اسم النعت قد يتغير. لم ننشر الحل حتى الآن في الغالب بسبب أننا نرغب في تجنب أن يختبر مستخدمي المحرر المرئي خبرة مستخدم مختلفة اختلافًا كبيرًا مقارنة بمستخدمي نصوص الويكي. مساندة المحرر المرئي لا زالت قيد التطوير البرمجي.
منافع محددة في محرر نصوص الويكي
- يعتمد الحل على المفهوم الحالي والمعروف للمراجع المسماة.
- لا يتطلب أي معرفة بالقوالب.
- يمكن إزالة المراجع شبه المكررة في الويكي نص، مما يجعله أنظف وأقل تكرارًا وأسهل في القراءة.
How to use Sub-referencing in wikitext
1) Define a Main Reference
Before creating sub-references, you need a main reference that contains the full bibliographic information. This reference must be assigned a name:
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
This main reference can either be defined in-line (within the article text) or in the reference section.
2) Creating a Sub-reference for Inline References
If the main reference is inline, you can create a sub-reference in two ways using the details
attribute:
Option 1: Modify the main reference to include additional details (e.g. a page number)
<!-- 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." />
Example Usage:

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 ==
{{reflist}} <!-- or <references /> -->
Option 2: Insert one or more separate sub-references directly within a new in-line statement while keeping the main reference intact.
<!-- 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." />
Example Usage:

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 ==
{{reflist}} <!-- or <references /> -->
3) Create Sub-References for List-Defined References
If the main reference is stored in the <references>
tag or within {{reflist}}
(or similar templates), you don't need to redefine it in-line. Instead, simply use the following syntax in-line:
<!-- 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>
Example Usage:

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>
4) Reusing an Existing Sub-reference
Once a sub-reference has been defined, you can reuse it in multiple places without redefining the main reference. Simply repeat the same reference syntax in-line:
<ref name="Miller" details="Page 23." />
- Please note that while this is not a pure reuse like you are used to with main references and does create duplicates in wikitext, in the reader and Visual Editor view, identical statements will be merged to prevent unnecessary duplication in the rendered output. This is still work in progress.
- The same re-use statement applies for list-defined and inline main references.
- Tip: Copying and pasting an existing sub-reference statement remains a simple and recommended approach.
Example Usage for Reuse of Inline References:

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 ==
{{reflist}}
Example Usage for Reuse of List-defined References:

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>
Keep In Mind

- Remember to always specify a reference name when using the details attribute. Using a reference name allows others to easily re-use the same reference with different details without needing to define a name first.
- Sub-referencing is not reserved for page numbers only. You can use it for other use cases, too. Some editors have mentioned to us that they’d like to use it for podcast timestamps, URLs, poetry verses, quotes, and other details.
- If you wish to use quotation marks
"
withindetails="…"
(e.g. when inserting a quote), make sure to use"
instead, or delimit the details with single quotes. Visual Editor users will be able to type " when filling out sub-reference details and it will be converted automatically in wikitext. Other special characters which might need to be handled similarly when used withdetails="…"
are<
and>
. - Some gadgets/scripts related to references might also need an update in order to properly work with the new sub-referencing solution.
- When using sub-references, please avoid templates that produce
<ref>
tags, as these cause issues in Visual Editor which we cannot solve at this point in time.
في المحرر المرئي (قيد التطوير البرمجي)
We are actively refining the user experience and workflows for Sub-referencing in Visual Editor. Currently, there is one entry point via the “re-use” tab for creating a sub-reference, but the solution for Visual Editor is expected to evolve in the coming months.
You can also test the prototype with the current state of the Visual Editor solution. Please keep in mind that it will likely change. As always, we will keep you and these project pages updated as Visual Editor gains more capabilities and let you know when we need your feedback!
منافع محددة في المحرر المرئي
- للاستشهاد بنفس المصدر بتفاصيل مختلفة، لم يعد عليك إنشاء مرجع جديد من الصفر.
- المراجع الفرعية متوافقة تمامًا مع المحرر المرئي (على عكس الحلول القائمة على القوالب): يمكنك إنشاؤها عبر مربع حوار الاقتباس ويمكنك تحريرها من داخل قسم المراجع.
تدفقات العمل في النموذج الأولي الحالي (يجوز أن تتغير)
إنشاء مرجع فرعي
- Creating a sub-reference currently works via the the existing citation dialog.
- في علامة التبويب «إعادة الاستخدام»، اختر المرجع الذي ترغب في إعادة استخدامه عن طريق النقاط الثلاث ثم انقر على «أعد استخدام هذا المرجع مع تفاصيل إضافية».
- أدخل تفاصيل ذلك المرجع الفرعي وانقر فوق إدراج.
- تُظهر لك النافذة المنبثقة للمرجع في المحرر المرئي أن هذا المرجع هو مرجع فرعي، وعدد مرات إعادة استخدامه.
تعديل مرجع فرعي قائم
- انقر على علامة الحاشية السفلية في نص المقالة لتحرير مرجع فرعي.
- يمكنك الآن تغيير تفاصيل المرجع الفرعي. يتم إعلامك أيضًا أنه مرجع فرعي.
- لا يمكنك تحرير مرجع فرعي من القائمة المرجعية حتى الآن.
- لتحرير المرجع الرئيسي، انقر فوقه في قسم المراجع.
إعادة استخدام مرجع فرعي
يرجى ملاحظة الآتي
- المشكلة الحالية مع الأسماء التلقائية للمراجع في المحرر المرئي تحدث أيضًا مع الإحالات المرجعية الفرعية.
- We are actively working on creating an even more intuitive user experience for Visual Editor. What you see now is just the beginning, it will be refined and improved over time.
- ما زال علينا العمل على ما يحدث عند حذف مرجع يُعاد استخدامه.
- Currently, if you re-use a sub-reference it will show as a duplicate in the reference list. Once the Visual Editor's UX has evolved, the duplicates will automatically be merged in Visual Editor and the reader view.
اختبار النموذج الأولي
نحتاج إلى ملاحظاتك للتأكد من أننا نبني الأشياء الصحيحة. نرحب دائمًا بتعليقاتكم أو أسئلتكم على صفحة الكلام الخاصة بهذا المشروع.
النموذج الأولي متاح على الويكي التجريبي. ندعوك حاليًا في المقام الأول لاختبار حل wikitext:

- قد تبدو مختلفة (على سبيل المثال عدم استخدام الجلد المفضل لديك).
- قد تقدم بعض الميزات الجديدة التي لا تزال قيد الاختبار.
- فهي تحتوي فقط على بعض الصفحات والقوالب الاختبارية، وليس محتوى الويكي بالكامل، وليس كل القوالب والوحدات النمطية والأدوات وما إلى ذلك التي اعتدت عليها.
- لا يعمل تسجيل دخول ويكيميديا العادي الخاص بك على ويكيبيديا بيتا. يمكنك إما تسجيل حساب - تأكد من استخدام كلمة مرور مختلفة عن حساب ويكيميديا العادي الخاص بك - أو اختبار الميزة بدون حساب، مما سيؤدي إلى إنشاء حساب مؤقت بـ :mw:Special:MyLanguage/Trust and Safety Product/Temporary Accounts (على ويكي ويكي بيتاويكي) - أو عرض عنوان IP الخاص بك (على ويكي ويكي ويكي).
المشكلة التي نحلها
في مقالات ويكيبيديا، من الشائع الإشارة إلى مصدر ما عدة مرات. ولكن بينما يمكنك إعادة استخدام مرجع كما هو بالضبط، لا يمكنك حاليًا إعادة استخدام نفس المرجع مع تفاصيل مختلفة (مثل أرقام صفحات مختلفة). خيارك الوحيد هو إنشاء مرجع جديد بالكامل أو استخدام حلول بديلة.
الوضع الراهن: إعادة استخدام المراجع في محرر نصوص الويكي والمحرر المرئي
إذا كنت ترغب في إعادة استخدام مرجع في نص ويكيتيك، يمكنك تحويله إلى مرجع مسمى والإشارة إلى هذا الاسم في نقطة أخرى في المقالة. يمكن وضع المرجع المسمى في نص المقالة أو في قسم المراجع. في المحرر المرئي يمكنك استخدام خيار ”إعادة الاستخدام“ في مربع حوار الاقتباس. في قسم المراجع، يتم تجميع المراجع التي تحمل نفس الاسم معًا.
-
Wikitext: <ref name> في نص المقالة
-
Wikitext: <ref name> في قسم المراجع 1
-
المحرر المرئي: مربع حوار الاقتباس
-
وجهة نظر القارئ
الوضع الراهن: إعادة استخدام المراجع مستخدمين تفاصيل أخرى في محرر نصوص الويكي
إذا كنت ترغب في إعادة استخدام مرجع موجود بتفاصيل مختلفة في wikitext، تحتاج حاليًا إلى نسخ ولصق المرجع الموجود وتغيير تفاصيل النسخة المكررة أو إنشاء مرجع جديد (متطابق تقريبًا) من الصفر. تستخدم بعض المشاريع حلولاً بديلة مثل اقتباسات قصيرة أو حلول قائمة على القوالب مثل الحواشي السفلية المختصرة. في قسم المراجع، لا يتم تجميع المرجع الأصلي والمرجع الجديد الذي أنشأته معًا.
-
مرجعان متطابقان تقريباً في نص الويكايت.
-
وجهة نظر القارئ: لا يتم تجميع المراجع المتطابقة تقريبًا معًا
-
حل بديل مع الاقتباسات القصيرة في نص wikitext
-
وجهة نظر القارئ: حل بديل مع اقتباسات قصيرة
-
حل بديل ب{{sfn}} في wikitext
-
وجهة نظر القارئ: حل بديل باستخدام {{sfn}}
الوضع الراهن: إعادة استخدام المراجع مستخدمين تفاصيل أخرى في المحرر المرئي
إذا كنت ترغب في إعادة استخدام مرجع موجود بتفاصيل مختلفة في المحرر المرئي، فلن يعمل خيار ”إعادة الاستخدام“ في مربع حوار الاقتباس ولا طريقة النسخ واللصق، لأن كلاهما يؤدي إلى إعادة استخدام متطابق، وتغيير تفاصيل المرجع المعاد استخدامه/نسخه يغير كلا مثيلات ذلك المرجع. بدلًا من ذلك ستحتاج إلى إنشاء مرجع جديد (متطابق تقريبًا) من الصفر. في قسم المراجع، لا يتم تجميع المرجع الأصلي والمرجع الجديد الذي أنشأته معًا.
لا يمكن تحرير المراجع التي تم إنشاؤها بواسطة الحلول المستندة إلى القوالب مثل {{sfn}} من داخل قسم المراجع ولا تظهر في علامة تبويب إعادة استخدام الاقتباس؛ ولكن من الممكن تحريرها يدويًا عند تحديد موقعها في نص المقالة.
حل مؤقت باستخدام {{sfn}}:
-
كيف تبدو في القارئ
-
تختفي المراجع من قسم المراجع عند النقر على ”تعديل“.
-
لا يمكن استخدام مراجع الرموز بالدولار الأمريكي عبر مربع حوار ”إعادة الاستخدام“.
-
يمكن تحرير المراجع فقط عند تحديد موقع المرجع في نص المقالة
مشاكل لبرامج القراءة
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.
مشاكل رئيسية في الوضع الراهن
- تجربة مستخدمي المحرر المرئي ومستخدمي wikitext مختلفة تمامًا.
- معظم الحلول لإعادة استخدام المراجع بتفاصيل مختلفة لا تعمل بشكل صحيح في المحرر المرئي.
- إنشاء الكثير من المراجع المتشابهة تقريبًا بتفاصيل مختلفة يجعل النص الويكيتي أطول وربما يصعب قراءته.
- لا يتم قبول الحلول المستندة إلى القوالب بشكل متساوٍ من قبل جميع المجتمعات وبالتالي فهي غير متاحة عالميًا.
- يحاول بعض المستخدمين تجنب هذه المشكلة عن طريق وضع المصادر في قسم الببليوغرافيا دون استخدامها كمراجع على الإطلاق، مما يجعل من الصعب التحقق من أقسام المقال.
أحدث التغييرات والخطوات التالية
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.
Updates March 2025
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.
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.
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.
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.
- Conducting user testing sessions with community members to help us with intuitively designing the Visual Editor workflows.
- Once the development has reached a stable state, we will reach out to Pilot wikis to plan deployments.
- 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.
Archived updates from 2024
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.
أرسلنا إعلانات عبر جميع مواقع الويكي لإعلام المجتمعات بهذه الميزة القادمة، ودعوناهم لاختبارها وإبداء الملاحظات بشأنها.
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.
- سنستمر في جمع الملاحظات لتحسين الحل بعد نشره.
الأسئلة المتكررة
كيف يمكنني أن أجد مقالات تستخدم المراجع الفرعية؟
A tracking category called Category:Pages that use sub-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.
Also, the team has created a number of examples on the English betawiki.
Can I insert a template into the details
attribute?
The feedback we received so far from the community suggests that using templates in an attribute may cause more issues than benefits. As such, we are evaluating whether to allow templates based on technical feasibility, their impact on Visual Editor’s rendering of references, and other concerns raised by contributors.
We will update you once we have learned more and a decision has been made. Please know that we will always include the community before such a decision is made. If you already have specific ideas about the use of templates within the details attribute, please let us know on our talk page.
How will the new feature affect existing gadgets and scripts?
Some gadgets and scripts related to references might need an update in order to properly work with the new Sub-referencing solution. Because 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.
لم اخترتم إعراب النص البرمجي لنصوص الويكي هذا؟
This post provides a rationale for choosing the details
syntax. We believe that the best and quickest path to delivering a usable feature is through the chosen syntax, even though it does come with some limitations.
Historically, no syntax has been perfect, and each solution has its shortcomings. After long discussions and consultations with multiple teams at the Wikimedia Foundation, we've concluded that this solution meets our technical requirements and is sustainable for long-term maintenance.
It's also fully compatible with wikis that continue to rely on or prefer using {{reflist}}
. This syntax allows the main reference to be used in-line without needing to be placed in the References section, which would otherwise cause limitations in the Visual Editor.
Furthermore, we’re confident that this approach will work consistently across Visual Editor workflows as well.
لم استغرق الأمر هذا الوقت الطويل لإيجاد حل؟
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.