Template:Muslim: Difference between revisions

Preparing for site-wide switch to the Dar-us-Salam system
[checked revision][checked revision]
(Expr function should not be used for DarusSalam refs which very often have suffixes for this collection. It was never actually even needed for the USC refs as the Three digit template added leading zeros as needed for the old cmje links but the edit source never had them (as the template would then add too many))
(Preparing for site-wide switch to the Dar-us-Salam system)
Line 2: Line 2:
   {{ #switch: {{lc: {{{3|}}} }}  
   {{ #switch: {{lc: {{{3|}}} }}  
     | in-book = [https://quranx.com/Hadith/Muslim/In-Book/Book-{{{1|1}}}/Hadith-{{{2|1}}}/ Sahih Muslim {{{1|1}}}:{{{2|1}}} (In-Book Ref)]
     | in-book = [https://quranx.com/Hadith/Muslim/In-Book/Book-{{{1|1}}}/Hadith-{{{2|1}}}/ Sahih Muslim {{{1|1}}}:{{{2|1}}} (In-Book Ref)]
     | reference = [https://quranx.com/Hadith/Muslim/Reference/Hadith-{{{2|1}}}/ Sahih Muslim {{{2|1}}} (Fuwad Abdul Baqi reference, Dar-us-Salam)]
     | reference = [https://quranx.com/Hadith/Muslim/Reference/Hadith-{{{2|1}}}/ Sahih Muslim {{{2|1}}}]
     | [https://quranx.com/Hadith/Muslim/Reference/Hadith-{{{2|1}}}/ Sahih Muslim {{{2|1}}} (3rd parameter error)]
     | [https://quranx.com/Hadith/Muslim/Reference/Hadith-{{{2|1}}}/ Sahih Muslim {{{2|1}}} (3rd parameter error)]
   }}|
   }}|
Line 15: Line 15:
"1": {
"1": {
"label": "Book number",
"label": "Book number",
"description": "The Book number when using the USC-MSA or In-book reference system",
"description": "The Book number (only when using the USC-MSA or In-book reference system)",
"required": false,
"required": false,
"suggested": true,
"suggested": true,
Line 32: Line 32:
"3": {
"3": {
"label": "Alternative reference system",
"label": "Alternative reference system",
"description": "Enter reference when you are using the Dar-us-Salam circular bracket reference system or in-book when using the In-book reference system (leave blank if using the USC-MSA reference system)",
"description": "Default value is 'reference', which should be used for the Dar-us-Salam (al-Baqi) reference system (preferred). Enter in-book when using the In-book reference system, or leave blank if using the USC-MSA reference system.",
"required": false,
"required": false,
"suggested": true,
"suggested": true,
"type": "string",
"type": "string",
"default": "",
"default": "reference",
"example": "reference"
"example": "reference"
}
}
Line 43: Line 43:
</templatedata>
</templatedata>


This template is used to provide sources for Sahih Muslim references from USC-MSA and other indexing conventions. It formerly produced links to the cmje website, which no longer works. We are currently using QuranX.com instead, which is able to handle USC-MSA, In-book, and Dar-us-Salam reference conventions.  
This template is used to provide sources for Sahih Muslim references. It formerly produced links to USC's CMJE hadith compendium, which has been retired. We are currently using QuranX.com instead, which is able to handle a choice of indexing conventions:
 
* USC-MSA (created by University of South Carolina)
* In-book (a hybrid system created by sunnah.com)
* Reference (this is the numbering created by the mid 20th century scholar Fuad Abdul Baqi, shown in round brackets in the Dar-us-Salam print editions).
 
The latter has become the de facto standard in English, Arabic and other languages. For that reason we have converted all existing USC-MSA citations for this collection to the Dar-us-Salam (al-Baqi) referencing system.
 
Detailed information about the hadith translations and reference systems available on QuranX.com can be read in the following document:<BR /> https://github.com/QuranX/QuranX/blob/master/docs/QuranXHadiths.md


Note that all of Muslim is Sahih.<BR>
Note that all of Muslim is Sahih.<BR>


==Usage==
==Usage==
First Parameter is the Book Number.<BR>
First Parameter is the Book Number (optional).<BR>
Second Parameter is the Hadith Number.<BR>
Second Parameter is the Hadith Number.<BR>
Third Parameter (optional) is used to indicate that you are using one of the alternative referencing systems: Dar-us-Salam or In-book (default is USC-MSA).  
Third Parameter (optional) is used to indicate that you are using one of the alternative referencing systems: Dar-us-Salam ("reference") or In-book (if left blank, the default is USC-MSA). The revised site policy is to use the Dar-us-Salam ("reference") system.
 
With the Dar-us-Salam Reference system, only a hadith number is specified, and is the same as in the Dar-us-Salam print edition. Please note that this is not the hadith's square bracket number in the Dar-us-Salam edition, but rather the round bracket number next to it, which was devised by the mid-20th century Islamic scholar Fuad Abdul Baqi. This is the number commonly used when a hadith in Sahih Muslim is cited.


With the Dar-us-Salam Reference system, only a hadith number is specified, and is the same as in the Dar-us-Salam print edition. Please note that this is not the square bracket number in the Dar-us-Salam edition, but rather the round bracket number for the hadith in the same book, which was devised by the Islamic scholar Fuwad Abdul Baqi. This is the number commonly used when a hadith in Sahih Muslim is cited.
With the USC-MSA system, the book number and hadith number are as in USC's CMJE database (retired).


With the In-book system, the book number for a hadith is the same as in the Dar-us-Salam print edition, and the hadith number is a simple incremental index starting at 1 for the first hadith in each book.  
With the In-book system, the book number for a hadith is the same as in the Dar-us-Salam print edition, and the hadith number is a simple incremental index starting at 1 for the first hadith in each book.  


To use this template with Dar-us-Salam Reference numbering:    <tt><nowiki>{{Muslim||#|reference}}</nowiki></tt>  (note the empty first parameter)


To use this template with USC-MSA numbering:    <tt><nowiki>{{Muslim|#|#}}</nowiki></tt>
To use this template with USC-MSA numbering:    <tt><nowiki>{{Muslim|#|#}}</nowiki></tt>
To use this template with Dar-us-Salam Reference numbering:    <tt><nowiki>{{Muslim||#|reference}}</nowiki></tt>  (note the empty first parameter)


To use this template with In-book numbering:    <tt><nowiki>{{Muslim|#|#|in-book}}</nowiki></tt>
To use this template with In-book numbering:    <tt><nowiki>{{Muslim|#|#|in-book}}</nowiki></tt>


;Example for hadith using Dar-us-Salam Reference numbering:
:<nowiki>{{Muslim||1178a|reference}}</nowiki>


Produces:
:{{Muslim||1178a|reference}}


;Example for hadiths using MSA-USC numbering:
;Example for the same hadith using MSA-USC numbering:
:<nowiki>{{Muslim|7|2650}}</nowiki>
:<nowiki>{{Muslim|7|2650}}</nowiki>


Produces:
Produces:
:{{Muslim|7|2650}}
:{{Muslim|7|2650}}
;Example for the same hadith using Dar-us-Salam Reference numbering:
:<nowiki>{{Muslim||1178|reference}}</nowiki>
Produces:
:{{Muslim||1178|reference}}


;Example for the same hadith using in-book numbering:
;Example for the same hadith using in-book numbering:
Editors, em-bypass-2, Reviewers, rollback, Administrators
3,454

edits