WikiIslam:Structure: Difference between revisions

Jump to navigation Jump to search

WikiIslam:Structure (view source)

Revision as of 22:23, 23 July 2020

1,509 bytes added ,  23 July 2020
incorporated new standards into page
mNo edit summary
(incorporated new standards into page)
Line 1: Line 1:
[[File:Lead Image.png|thumb|The Lead Media is the first image seen when opening an article. It should appear on the right-hand side of the lead text, before the table of contents. It should be entered before any text as to align with the top row of the lead paragraph.]]The '''Structure''' of an article concerns the organization of sections and media. Better structure allows the reader to navigate the page easier and feels more intuitive. The structure should also seek to give maintain cohesiveness throughout the wiki. This aims to give the reader a better experience by using a predictable layout. WikiIslam generally adopts an encyclopedic format (e.g. [[72 Virgins]]), but can also include table/list formatted articles (e.g. [[The Timeline of Muhammad]]). All articles can be adjusted to keep the flow and intuitive feel of the article.
[[File:Lead Image.png|thumb|The Lead Media is the first image seen when opening an article. It should appear on the right-hand side of the lead text, before the table of contents. It should be entered before any text as to align with the top row of the lead paragraph.]]The '''Structure''' of an article concerns the organization of sections and media. Better structure allows the reader to navigate the page easier and feels more intuitive. The structure should also seek to give maintain cohesiveness throughout the wiki. This aims to give the reader a better experience by using a predictable layout. WikiIslam generally adopts an encyclopedic format (e.g. [[72 Virgins]]), but can also include table/list formatted articles (e.g. [[The Timeline of Muhammad]]). All articles can be adjusted to keep the flow and intuitive feel of the article.


== Lead ==
The lead is an introductory summary that comes before the table of contents and is not followed by any section titles. It aims to give the most essential information about the subject within the first few lines in simple and short sentences. The lead should contain no more than five easy to read paragraphs.
The lead is an introductory summary that comes before the table of contents and is not followed by any section titles. It aims to give the most essential information about the subject within the first few lines in simple and short sentences. The lead should contain no more than five easy to read paragraphs.


=== First Paragraph ===
The first sentence should tell the reader what or who the subject is. If possible the page title should be the subject and if the subject is definable then the first sentence should be the definition. The first sentence should have the subject’s name in bold for the first occurrence and should not be linked. The rest of the paragraph should aim to answer the questions “Who, What, Where, When, and Why” that have not already been answered in the first sentence. Remember to only use simple
The first sentence should tell the reader what or who the subject is. If possible the page title should be the subject and if the subject is definable then the first sentence should be the definition. The first sentence should have the subject’s name in bold for the first occurrence and should not be linked. The rest of the paragraph should aim to answer the questions “Who, What, Where, When, and Why” that have not already been answered in the first sentence. Remember to only use simple


Following paragraphs should include “peacock terms” or stand out summarized information about the subject from the body. For example, in an article about Aisha, her age at marriage would be a peacock term of interest. This should be mentioned in the lead in no more than one or two sentences and developed later on in the body. These paragraphs should also be kept as simply written and possible. All text should aim to be as neutral as possible.  
Here is a good example from the page on [[Muhammad ibn Abdullah|Muhammad]]:
[[File:Lead First Paragraph Example.png|center|frameless|492.991x492.991px]]
 
=== Following Paragraphs ===
Following paragraphs should include “peacock terms” or stand out summarized information about the subject from the body. For example, in an article about Aisha, her age at marriage would be a peacock term of interest. This should be mentioned in the lead in no more than one or two sentences and developed later on in the body. These paragraphs should also be kept as simply written and possible. All text should aim to be as neutral as possible.


==Body==
==Body==
Line 17: Line 23:


===Text Quote===
===Text Quote===
Text quotes are sometimes necessary to highlight a relevant piece of work within the article. However "Template:Quote" should only be used on specific resource pages and in the "Relevant Quotations" section. If it is necessary to the flow of the article to add a quote you can integrate it into the text.
Text quotes are sometimes necessary to highlight a relevant piece of work within the article. Generally, using the "Template:Quote" format outside of the "Relevant Quotations" section should be avoided, as it is highly preferable to simple incorporate a summary of the source directly into the text along with a footnote. If, however, a summary would prove ineffective and a brief direct quote cannot be incorporated into the text directly (if, for instance, the quote is lengthy or includes a bulleted list), then the "Template:Quote" format may be used. Be sure to include a footnote reference either way.
 
==Commonly Recurring Sections==
Terms, Authenticity, Relevant Quotations, and Apologetic Arguments are reoccurring sections of Islamic articles but can be foregone where they don’t apply (for example, "Apologetic Arguments" and "Terms" sections wouldn’t make sense in an article about Abu Bakr, but would make sense in an article about his rulings).


When anything more than a single sentence or phrase is quoted in the main part of the article, we should use a separate paragraph and indent it left and right for readability, as is done in Wikipedia and scholarly works. Double quotes should not be used around indented quotations (and are unnecessary – see Wikipedia examples). That avoids the need to convert double quotes to single and vice versa within the quoted text itself (as standard convention would require).
=== Terms ===
This section should establish lexical translations of Arabic or classical Arabic terms that will be recurring in a specific article. These terms should be formatted into a "numbered list".


==Commonly Recurring Sections==
Here is a good example from the page on [[Embryology in the Quran]]:
[[File:Terms Example.png|center|frameless|692.986x692.986px]]


===Authenticity===
===Authenticity===
Line 31: Line 42:
This section is a reoccurring section that intends to highlight the harms of some claims and their consequences. Many of the harmful ideas in Islam have real world consequences, so in neutral language, a clear distinction can and should be drawn if applicable and justifiable.
This section is a reoccurring section that intends to highlight the harms of some claims and their consequences. Many of the harmful ideas in Islam have real world consequences, so in neutral language, a clear distinction can and should be drawn if applicable and justifiable.


Examples:  
Here are some examples:  


“Association with terrorism” – Article: 72 Virgins
A section on “[[72 Virgins#Association with Terrorism|Association with Terrorism]]” from the article on [[72 Virgins]]


“Association with Child Marriage” – Article: Aisha’s Age of Consummation
A section on “[[Aishas Age of Consummation#Association with Child Marriage|Association with Child Marriage]]” from the article on [[Aisha's Age of Consummation]]


===Relevant Quotations===
===Relevant Quotations===
{{Quote|WikiIslam:Structure 3:3:1|The “Relevant Quotations” section will contain the most direct relevant quotations to the subject. These will only be in “Template:Quotation” format.  
The “Relevant Quotations” section will contain the most direct relevant quotations from Quran, hadith, and exegeses. These will only be in “Template:Quote" format. Unless necessary this section should contain the only usage of the quotation template in the article.
}}{{Quote|WikiIslam:Structure 3:3:2|If you want to reference something to support a claim in other sections, summarize what it says and cite it in a footnote.}}{{Quote|WikiIslam:Structure 3:3:3|If you find it necessary quote the published work outside of the “Relevant Quotations” section incorporate the quote into the text - See the "Text Quote" subsection above.}}{{Quote|WikiIslam:Structure 3:3:4|This section should be around a single page in length, with the '''important sections of quotes''' in bold with a working link at the bottom right (when referencing outside the article).}}
 
This section should be around a single page in length, with the <nowiki>'''important sections of quotes'''</nowiki> in bold with a working link at the bottom right (when referencing outside the article).
 
Here is an example of a quote formatted for use in a "Relevant Quotations" section:
[[File:Relevant Quotations Example.png|center|frameless|735.991x735.991px]]
If you must reference something to support a claim in other sections, summarize what it says and cite it in a footnote. If you must quote a published work, including Quran and hadith outside of the “Relevant Quotations” section use the quotation template (if, for instance, the quote is lengthy or includes a bulleted list) or, better yet, incorporate the quote into the text -- include a footnote citation at the end either way, and remember that incorporating a quote into the text directly is preferred when possible.


===Apologetic Arguments===
===Apologetic Arguments===
The “Apologetic Arguments” section aims to mention and clarify common apologetic arguments as well as related scripture and counter arguments from other scholars. This section should allow readers to determine for themselves the strength of the apologetic argument.
The “Apologetic Arguments” section aims to mention and clarify common apologetic arguments as well as related scripture and counter arguments from other scholars. This section should allow readers to determine for themselves the strength of the apologetic argument.


This section should come at the end of the article. Within this section, the titles of individual arguments should be in Sub-heading 1 format. Each argument should be presented in two parts: The first part being an short and concise objective explanation of the main points of the apologetic argument which should always be cited wherever possible. The second paragraph (or subsequent paragraphs) should contain a short and concise objective counter argument(s). The counter argument should summarize other scholarly sources, preferably Islamic scriptures. Do ''not'' use quote template in this section - use citation footnotes and quotation marks as needed.
This section should come at the end of the article. Within this section, the titles of individual arguments should be in Sub-heading 1 format. Each argument should be presented in two parts: The first part being an short and concise objective explanation of the main points of the apologetic argument which should always be cited wherever possible. The second paragraph (or subsequent paragraphs) should contain a short and concise objective counter argument(s). The counter argument should summarize other scholarly sources, preferably Islamic scriptures. Avoid using quote templates in this section as much as possible  - use citation footnotes and attempt to incorporate quotes, where they are necessary, into the text directly.
 
Example of weak structure:
[[File:Weak Structure Example.png|center|frameless|1047.98x1047.98px]]
Amended version:
[[File:Amended Structure Example.png|center|frameless|657x657px]]
<br />


==Ending==
==Ending==
IbnPinker
Editors, recentchangescleanup, Reviewers
6,632

edits

Retrieved from "http://wikiislam.net/wiki/Special:MobileDiff/122013"

Navigation menu