4,636
edits
WikiIslam:How to Edit: Difference between revisions
→Editing articles3
| Line 4: | Line 4: | ||
[[WikiIslam|WikiIslam]] is a wiki, meaning it is made for anyone to edit, although currently editing is locked down and only accessible to registered users. There are two editing interfaces: the new Visual Editor (VE) and classic wiki source editing (using the wiki markup language). | [[WikiIslam|WikiIslam]] is a wiki, meaning it is made for anyone to edit, although currently editing is locked down and only accessible to registered users. There are two editing interfaces: the new Visual Editor (VE) and classic wiki source editing (using the wiki markup language). | ||
==Editing | ==Editing articles== | ||
===Content style and policies=== | ===Content style and policies=== | ||
{{see also| | {{see also|WikiIslam:Writing Style Guide}} | ||
An [[ | An [[WikiIslam:Writing better articles#Information style and tone|encyclopedic style]] with a [[WikiIslam:Writing better articles#Tone|formal tone]] is important: straightforward, [[WikiIslam:Summary style|just-the-facts]], instead of essay-like, argumentative, or opinionated. The goal of a WikiIslam article is to create a comprehensive and [[WikiIslam:Neutral point of view|neutrally written]] summary of existing mainstream knowledge about a topic. WikiIslam does not publish [[WikiIslam:No original research|original research]]. An encyclopedia is, by its nature, a [[tertiary source]] that provides a survey of information already published in the wider world. Ideally, all information should be [[WikiIslam:Citing sources|cited]] and [[WikiIslam:Verifiability|verifiable]] by [[WikiIslam:Reliable sources|reliable sources]]. Sourcing requirements are significantly stricter in [[WikiIslam:Biographies of living persons|articles on living persons]]. | ||
{{anchor|Edit window}} | {{anchor|Edit window}} | ||
===Edit screen(s)=== | ===Edit screen(s)=== | ||
Editing most | Editing most WikiIslam pages is simple. WikiIslam uses two interface methods: classic editing through [[Help:Wikitext|wikitext]] (wiki markup), and a new [[WikiIslam:VisualEditor|VisualEditor]] (VE). Wikitext editing is chosen by clicking the <kbd>Edit</kbd> tab at the top of a WikiIslam page (or on a [[Help:Section|section-edit link]]). This will take you to a new page containing the editable contents of the current page. Wikitext is used extensively throughout WikiIslam for such things as [[Help:Link|hyperlinks]], [[Help:Table|tables]] and [[Help:Columns|columns]], [[Help:Footnotes|footnotes]], [[WikiIslam:Inline citation|inline citation]], [[Help:Special characters|special characters]] and so on. | ||
The VisualEditor option is intended as a user-friendly, "What You See Is What You Get" ([[WYSIWYG]]) editing aid, allowing one to edit pages without the need to learn wikitext markup. It is only available to registered logged-in users through an opt-in choice available through [[Special:Preferences#mw-prefsection-betafeatures|personal preferences]], see the [[ | The VisualEditor option is intended as a user-friendly, "What You See Is What You Get" ([[WYSIWYG]]) editing aid, allowing one to edit pages without the need to learn wikitext markup. It is only available to registered logged-in users through an opt-in choice available through [[Special:Preferences#mw-prefsection-betafeatures|personal preferences]], 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: wikitext and VisualEditor"> | ||
File:How to edit a page Edit box.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:How to edit a page Edit box.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: | File:WikiIslam article in VisualEditor 2018-02-12.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. | ||
</gallery> | </gallery> | ||
The | The WikiIslam community has developed [[WikiIslam:Manual of Style|style guidelines]] to make articles and facts appear in a standardized form, and WikiIslam easier to use as a whole. A basic list of [[Help:Wikitext|wikitext]] can be found on the [[Help:Cheatsheet|cheatsheet]]. An "[[Help:Edit toolbar|edit toolbar]]" is provided just above the edit box (pictured below), which allows logged-in users (by selecting the option in [[Special:Preferences#mw-prefsection-gadgets|personal preferences]]) to automatically place and format various aspects of wiki code. See [[Help:Wikitext]] for more information, remember that you can't break WikiIslam, and, although there are many protocols, [[WikiIslam:Editing policy#WikiIslam is a work in progress: perfection is not required|perfection is not required]], as [[WikiIslam:WikiIslam is a work in progress|WikiIslam is a work in progress]]. | ||
[[File:WikiEditor-advanced menu-en.png|center]] | [[File:WikiEditor-advanced menu-en.png|center]] | ||
When you have finished editing, you should write a short [[Help:Edit summary|edit summary]] in the small field below the edit box (pictured below). You may use shorthand to describe your changes, as described in the [[ | When you have finished editing, you should write a short [[Help:Edit summary|edit summary]] in the small field below the edit box (pictured below). You may use shorthand to describe your changes, as described in the [[WikiIslam:Edit summary legend|legend]]. To see how the page looks with your edits, press the "'''Show preview'''" button. To see the differences between the page with your edits and the previous version of the page, press the "'''Show changes'''" button. If you're satisfied with what you see, '''[[WikiIslam:Be bold|be bold]]''' and press the "'''Publish changes'''" button. Your changes will immediately be visible to all WikiIslam users. | ||
{{EditOptions|align=center|width=50em|font-size=80%}} | {{EditOptions|align=center|width=50em|font-size=80%}} | ||
Note: Do not sign the edit summary line with your <nowiki>~~~~</nowiki> signature, as it does not work there. | Note: Do not sign the edit summary line with your <nowiki>~~~~</nowiki> signature, as it does not work there. | ||
| Line 30: | Line 33: | ||
===Adding references=== | ===Adding references=== | ||
{{further|Help:Referencing for beginners| | {{further|Help:Referencing for beginners|WikiIslam:Citing sources}} | ||
{{hatnote|Introductions: [[Help:Introduction to referencing with Wiki Markup/1]] and [[Help:Introduction to referencing with VisualEditor/1]]}} | {{hatnote|Introductions: [[Help:Introduction to referencing with Wiki Markup/1]] and [[Help:Introduction to referencing with VisualEditor/1]]}} | ||
[[File:Citing sources tutorial, part 1.ogv|thumb|upright|A screencast that walks through the essentials needed in citing your sources. <small>(2:01 min)</small>]] | [[File:Citing sources tutorial, part 1.ogv|thumb|upright|A screencast that walks through the essentials needed in citing your sources. <small>(2:01 min)</small>]] | ||
[[File:RefTools rework.ogv|thumb|right|upright|A screencast that walks through how to use the various features of RefTools. <small>(5:03 min)</small>]] | [[File:RefTools rework.ogv|thumb|right|upright|A screencast that walks through how to use the various features of RefTools. <small>(5:03 min)</small>]] | ||
Generally, sources are added directly after the facts they support at the end of the sentence and after any punctuation. | 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 [[WikiIslam:Inline citation|inline citations]] to do so. Common methods of placing inline citations include [[Help:Footnotes|footnotes]], [[Help:Shortened footnotes|shortened footnotes]] and [[WikiIslam:Citing sources#Parenthetical referencing|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>< | 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><references /></nowiki></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, [[ | 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/ WikiIslam 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=== | ||
{{main|Help:Creation and usage of media files}} | {{main|Help:Creation and usage of media files}} | ||
{{hatnote|Introductions: [[Help:Introduction to images with Wiki Markup/1]] and [[Help:Introduction to images with VisualEditor/1]]}} | {{hatnote|Introductions: [[Help:Introduction to images with Wiki Markup/1]] and [[Help:Introduction to images with VisualEditor/1]]}} | ||
A file that is already hosted on | A file that is already hosted on WikiIslam or the [[Wikimedia Commons]] 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. The Wikimedia Commons' [[Commons:Special:UploadWizard|File Upload Wizard]] and WikiIslam's [[WikiIslam:File Upload Wizard|File Upload Wizard]] will guide you through the process of submitting media. There are various file formats available. | ||
==Article creation== | ==Article creation== | ||