WikiIslam:How to Edit: Difference between revisions

Jump to navigation Jump to search
(43 intermediate revisions by the same user not shown)
Line 10: Line 10:


===Edit screen(s)===
===Edit screen(s)===
[[File:Advanced_Settings_Screenshot.PNG|centeer|thumb|500px|Advanced settings in the visual editor]]
Editing most WikiIslam pages is simple. WikiIslam uses two interface methods: classic editing through [[WikiIslam:Source Editing|source editor]] (using the wiki markup language), and a new VisualEditor (VE). The source editor is chosen by clicking the <kbd>Edit</kbd> tab at the top of a WikiIslam page. This will take you to a new page containing the editable contents of the current page. The source editor is used extensively throughout WikiIslam for such things as [[WikiIslam:Citing, Linking, and Quoting|hyperlinking, quoting, and citations]], tables and columns, special characters, and so on.
Editing most WikiIslam pages is simple. WikiIslam uses two interface methods: classic editing through [[WikiIslam:Source Editing|source editor]] (using the wiki markup language), and a new VisualEditor (VE). The source editor is chosen by clicking the <kbd>Edit</kbd> tab at the top of a WikiIslam page. This will take you to a new page containing the editable contents of the current page. The source editor is used extensively throughout WikiIslam for such things as [[WikiIslam:Citing, Linking, and Quoting|hyperlinking, quoting, and citations]], tables and columns, special characters, and so on.


The VisualEditor option is intended as a user-friendly, "What You See Is What You Get"  editing aid, allowing one to edit pages without the need to learn wiki markup language. See the [[WikiIslam:VisualEditor/User guide|VisualEditor user guide]] for more information.
The VisualEditor option is intended as a user-friendly, "What You See Is What You Get"  editing aid, allowing one to edit pages without the need to learn wiki markup language. See the [[WikiIslam:VisualEditor/User guide|VisualEditor user guide]] for more information.


<gallery mode="packed" class="center" heights="233" style="font-size:95%" caption="Two editing environments: wikitext and VisualEditor">
<gallery mode="packed" class="center" heights="233" style="font-size:95%" caption="Two editing environments: Source editor and VisualEditor">
[[File:Source Editor Screenshot.PNG|alt=Text in a large rectangle below two toolbars and next to a scrollbar.|Edit box showing the [[Help:Wikitext|wikitext markup]]. You can change the formatting and contents of the page by changing what is written in this box.]]
File:Source Editor Screenshot.PNG|alt=Text in a large rectangle below two toolbars and next to a scrollbar.|Edit box showing the [[WikiIslam:Source Editing|source editor]]. You can change the formatting and contents of the page by changing what is written in this box.
[[File:Source Editor Screenshot.PNG|Screenshot showing the same article in [[WikiIslam:VisualEditor|VisualEditor]]. Unlike the wikitext display, VisualEditor will show the text being edited almost as if it were already published.]]
File:VisualEditor Screenshot.PNG|Screenshot showing the same article in [[Wikipedia:VisualEditor|VisualEditor]]. Unlike the source editor display, VisualEditor will show the text being edited almost as if it were already published.
</gallery>
</gallery>


<br />
===Linking to Other Articles on WikiIslam===


[[VisualEditor_Screenshot.PNG]]
Within the text of articles, you can provide hyperlinks, highlighted in blue text, to other articles on WikiIslam, for example [[Textual History of the Qur'an]]. This can be done both in the visual editor and in the source editor. In the visual editor, simply type in [[ and the editor will prompt you to choose the article you desire via a search. In the source editor, the exact name of the article must be put into double brackets, like so: <nowiki>[[Textual History of the Qur'an]]</nowiki>. If you wish to use another piece of text besides the name of the article as the link, [[Textual History of the Qur'an|like so]], you can use the pipe in the source editor. To produce the previous example, the markup language looks like this: <nowiki>[[Textual History of the Qur'an|like so]]</nowiki>.
 
<br />


===Adding references===
===Adding references===


Generally, sources are added directly after the facts they support at the end of the sentence and after any punctuation. WikiIslam permits editors to use any citation system that allows the reader to understand where the information came from, and strongly encourages use of inline citations to do so. Common methods of placing inline citations include footnotes, shortened footnotes and parenthetical references.
Generally, sources are added directly after the facts they support at the end of the sentence and after any punctuation. WikiIslam permits editors to use any citation system that allows the reader to understand where the information came from, and strongly encourages use of inline citations to do so. For more on citations, see  [[WikiIslam:Citing, Linking, and Quoting]]. Common methods of placing inline citations include footnotes, shortened footnotes and parenthetical references.


Inline citations are most commonly placed by inserting a reference between <code><nowiki><ref></nowiki></code> ... <code><nowiki></ref></nowiki></code> tags, directly in the text of an article. The reference is a footnote, appearing as an inline link (e.g. <small><sup><span style="color:#002BB8">[1][2]</span></sup></small>) to a particular item in a collated, numbered list of footnotes, found wherever a {{tl|reflist}} template or <code><nowikhow to i>
Inline citations are most commonly placed by inserting a reference between <code><nowiki><ref></nowiki></code> ... <code><nowiki></ref></nowiki></code> tags, directly in the text of an article. The reference is a footnote, appearing as an inline link (e.g. <small><sup><span style="color:#002BB8">[1][2]</span></sup></small>) to a particular item in a collated, numbered list of footnotes, found wherever a {{tl|reflist}} template or <code><nowiki><references /></nowiki></code> tag is present, usually in a section titled "References" or "Notes". When you add references to an article, this section will automatically be created.


<references />
There are a number of tools available to help with citation placement and formatting, some of which are internal tools and scripts, while others are available from external sites. For an example of the former, RefToolbar is a JavaScript toolbar displayed above the edit box that provides the ability to automatically fill out various [[WikiIslam:Citation templates|citation templates]] and insert them in the text already formatted inside <code><nowiki><ref></nowiki></code> ... <code><nowiki></ref></nowiki></code> tags. For an example of the latter, the [https://alyw234237.github.io/wiki-doi-gbooks-citation-maker/ Wikipedia DOI and Google Books Citation Maker] converts a digital object identifier (DOI) or Google Books address (URL) into a filled-out {{tl|cite journal}} or {{tl|cite book}} template ready to be pasted into an article. See [[https://en.wikipedia.org/wiki/Help:Citation_tools Help:Citation tools]] on Wikipedia for many others.
 
&lt;/nowiki&gt;</code> tag is present, usually in a section titled "References" or "Notes". If you are creating a new page or adding references to a page that didn't previously have any, don't forget to add a references section with this display markup.
 
There are a number of tools available to help with citation placement and formatting, some of which are internal tools and scripts, while others are available from external sites. For an example of the former, [[WikiIslam:RefToolbar|RefToolbar]] is a [[JavaScript]] toolbar displayed above the edit box that provides the ability to automatically fill out various [[WikiIslam:Citation templates|citation templates]] and insert them in the text already formatted inside <code><nowiki><ref></nowiki></code> ... <code><nowiki></ref></nowiki></code> tags. For an example of the latter, the [https://alyw234237.github.io/wiki-doi-gbooks-citation-maker/ Wikipedia DOI and Google Books Citation Maker] converts a [[digital object identifier]] (DOI) or [[Google Books]] address (URL) into a filled-out {{tl|cite journal}} or {{tl|cite book}} template ready to be pasted into an article. See [[Help:Citation tools]] for many others.


===Adding images, sounds, and videos===
===Adding images, sounds, and videos===
 
A file that is already hosted on WikiIslam can be inserted with the basic code <code><nowiki>[[File:FILENAME|thumb|DESCRIPTION]]</nowiki></code>. (<code>Image:</code> can be substituted for <code>File:</code> with no change in effect; the choice between the two is purely a matter of editorial preference.) Using <code>thumb</code> generates a thumbnail of an image (the most common placement option), which is typically sized differently from the original image. Files can be submitted through the upload file link on the right. If you do not have permission to do this, please contact administrator [[User:Asmith]].


===Templates===
===Templates===
Line 46: Line 41:
{{Quote|Sample Source| Sample Text}}
{{Quote|Sample Source| Sample Text}}


These quote boxes can be used for any quoted source. Templates can also be used to link to sources outside WikiIslam, particularly the Qur'an and the hadith. WikiIslam uses www.quranx.com for this purpose. The temple <code><nowiki>{{Quran|surah number|ayah number}}</nowiki></code> will produce a link to the specified surah (chapter) and ayah (verse). For example, to like to surat-al-baqarah (surah number 2), ayah 36 the template format would be <code><nowiki>{{Quran|2|36}}</nowiki></code>. For a series of ayahs the following template cane be used: <code><nowiki>{{Quran|surah number|frist ayah in series|last ayah in series}}</nowiki></code>. For example for surat-al-baqarah verse 20-23 the format would be {{Quran|2|20|23}}</nowiki></code>. All of the "Sahih Six" or authoritative Sunni collections of hadith also have templates which link to QuranX. Below you can see examples of all of their uses:
These quote boxes can be used for any quoted source. Templates can also be used to link to sources outside WikiIslam, particularly the Qur'an and the hadith. WikiIslam uses www.quranx.com for this purpose. The template <code><nowiki>{{Quran|surah number|ayah number}}</nowiki></code> will produce a link to the specified surah (chapter) and ayah (verse). For example, to like to surat-al-baqarah (surah number 2), ayah 36 the template format would be <code><nowiki>{{Quran|2|36}}</nowiki></code>. For a series of ayahs the following template cane be used: <code><nowiki>{{Quran|surah number|first ayah in series|last ayah in series}}</nowiki></code>. For example for surat-al-baqarah verse 20-23 the format would be <nowiki>{{Quran|2|20|23}}</nowiki>. All of the "Sahih Six" or authoritative Sunni collections of hadith also have templates which link to QuranX. Below you can see examples of all of their uses:


{| border="1" cellpadding="5" cellspacing="0" style="width:700px; height:200px"
{| border="1" cellpadding="5" cellspacing="0" style="width:700px; height:200px"
Line 66: Line 61:
| |<nowiki>{{Ibn Majah|9|3|9|1903}}</nowiki>||{{Ibn Majah|9|3|9|1903}}
| |<nowiki>{{Ibn Majah|9|3|9|1903}}</nowiki>||{{Ibn Majah|9|3|9|1903}}
|-
|-
| |<nowiki>{{</nowiki><nowiki>Tabari|4|p. 220}}</nowiki>||{{Tabari|4|p. 220}}
|}
|}


Line 79: Line 73:
Before starting a new article, please understand [[WikiIslam:Scope and Article Relevance|WikiIslam's scope and relevance requirements]]. In short, the article should be directly related to the beliefs and/or practices of Muslims.
Before starting a new article, please understand [[WikiIslam:Scope and Article Relevance|WikiIslam's scope and relevance requirements]]. In short, the article should be directly related to the beliefs and/or practices of Muslims.


An [[WikiIslam:Article wizard|Article Wizard]] is available to help you create articles — it is not required but will help you construct better articles. '''Note:''' The ability to create articles directly in mainspace [[WikiIslam:Autoconfirmed article creation trial/Request for comment on permanent implementation|is restricted]] to autoconfirmed users, though non-confirmed users and non-registered users can submit a proposed article through the [[WikiIslam:Articles for creation|Articles for Creation]] process, where it will be reviewed and considered for publication. Before creating an article, please [[Help:Searching|search]] WikiIslam first to make sure that an article does not already exist on the subject, and please also review the [[WikiIslam:Article titles|article titling policy]] for guidance on what to name the article.
An [[WikiIslam:Article wizard|Article Wizard]] is available to help you create articles — it is not required but will help you construct better articles. '''Note:''' The ability to create articles directly on the wiki [[WikiIslam:Autoconfirmed article creation trial/Request for comment on permanent implementation|is restricted]] to autoconfirmed users, though non-confirmed users and non-registered users can submit a proposed article through the [[WikiIslam:Articles for creation|Articles for Creation]] process, where it will be reviewed and considered for publication. Before creating an article, please [[Help:Searching|search]] WikiIslam first to make sure that an article does not already exist on the subject, and please also review [[WikiIslam:Article Naming]] for guidance on how to name the article.


==Talk pages==
==Talk pages==
[[File:Editing basics - Talk pages.webm|thumb|upright|thumbtime=1|A screencast demonstrating how to use a talk page. <small>(2:43 min)</small>]]
[[File:Screenshot of Talk page.PNG|thumb|upright|thumbtime=1|A screenshot of a sample talk page]]
Every article on WikiIslam has a talk page, reached by clicking the "Talk" tab just above the title (for example, [[Talk:Dhul-Qarnayn and the Alexander Romance]]). There, editors can discuss improvements to the content of an article. If you ever make a change that gets reverted by another editor, discuss the change on the talk page! Through discussion on these pages, consensus can be reached. It is very important that you conduct yourself with civility and assume good faith on the part of others. [https://en.WikiIslam.org/wiki/WikiIslam:Edit_warring| Edit warring] (repeatedly overriding or reimplementing contributions) is highly discouraged.
Every article on WikiIslam has a talk page, reached by clicking the "Talk" tab just above the title (for example, [[Talk:Dhul-Qarnayn and the Alexander Romance]]). There, editors can discuss improvements to the content of an article. If you ever make a change that gets reverted by another editor, discuss the change on the talk page! Through discussion on these pages, consensus can be reached. It is very important that you conduct yourself with civility and assume good faith on the part of others. [https://en.Wikipedia.org/wiki/Wikipedia:Edit_warring Edit warring] (repeatedly overriding or reimplementing contributions) is highly discouraged.


Most other pages on WikiIslam also have associated talk pages, including the user page each editor is assigned once they sign up. When other editors need to contact you, they will usually do this by leaving a message on [[Special:MyTalk|your talk page]]. When someone has left you a message that way, you will see a notice the next time you log in or view a page on WikiIslam. You can sign your contributions to a Talk page by using four tildes (<nowiki>~~~~</nowiki>), which produces your username and a time/date stamp.
Most other pages on WikiIslam also have associated talk pages, including the user page each editor is assigned once they sign up. When other editors need to contact you, they will usually do this by leaving a message on [[Special:MyTalk|your talk page]]. When someone has left you a message that way, you will see a notice the next time you log in or view a page on WikiIslam. You can sign your contributions to a Talk page by using four tildes (<nowiki>~~~~</nowiki>), which produces your username and a time/date stamp.


==See also==
==See also==
<br />
;Helpful tips
;Naming and moving
;Style and layout
*s
;Tools
<br />


;Related
*[[WikiIslam:Source Editing]]
*[[WikiIslam:Scope and Article Relevance]]
*[[WikiIslam:Writing Style Guide]]
*[[WikiIslam:Citing, Linking, and Quoting]]
*[[WikiIslam:Structure]]


----
----
{{center|{{offer help}} }}
[[Category:Help Pages]]
[[Category:WikiIslam how-to|Editing, Help]]
[[Category:Policies and Guidelines]]
[[Category:WikiIslam basic information|Editing, Help]]
[[Category:WikiIslam editing| ]]
Editors, recentchangescleanup, Reviewers
4,544

edits

Navigation menu