Consumer Rights Wiki:Write your first article!: Difference between revisions
fixed link |
added some helpful information for new users |
||
Line 3: | Line 3: | ||
Welcome to the Consumer Rights Wiki! If you're reading this, you likely share our desire to see consumers treated more fairly. This article will help you to start documenting an instance of [[Mission_statement#What_is_%22new%22_consumer_protection?|"new" consumer exploitation]], so you can help us to further that cause. | Welcome to the Consumer Rights Wiki! If you're reading this, you likely share our desire to see consumers treated more fairly. This article will help you to start documenting an instance of [[Mission_statement#What_is_%22new%22_consumer_protection?|"new" consumer exploitation]], so you can help us to further that cause. | ||
Before getting started, you need to know some of the requirements for a new article on this wiki. The [[Consumer Rights Wiki:Wiki policy index|wiki policy]] covers all the guidelines that mature articles need to follow, but reading these guidelines from start to finish may be a daunting task for new contributors. The next section describes the minimum requirements in order to write an article that can be molded into complying with these guidelines in a reasonable amount of time. | Before getting started, you need to know some of the requirements for a new article on this wiki. The [[Consumer Rights Wiki:Wiki policy index|wiki policy]] covers all the guidelines that mature articles need to follow, but reading these guidelines from start to finish may be a daunting task for new contributors. The next section describes the minimum requirements in order to write an article that can be molded into complying with these guidelines in a reasonable amount of time. The last section describes how to edit and create articles. | ||
Don't have a topic to write about? Visit [[Consumer Rights Wiki:How to help|How to help]] to see what the wiki needs! | Don't have a topic to write about? Visit [[Consumer Rights Wiki:How to help|How to help]] to see what the wiki needs! | ||
Line 40: | Line 40: | ||
==Creating an article== | ==Creating an article== | ||
Ready to make an new article? Click the [[Consumer_Rights_Wiki:Create_page|Create page]] link on the sidebar. Make sure that the name of the article is singular and in lowercase except for when it's a proper noun like a name. If you are new around here and not sure how to get started, you should follow the guide down below. | |||
===Basic Info=== | |||
* You can make edits using the '''visual editor''' by clicking the "edit" button at the top of an article, or using the '''source editor''' by clicking "edit source" instead. | |||
** The '''visual editor''' is easier to use. It's '''recommended''' to start with this. It's more intuitive in multiple ways, but doesn't allow for complete control like the source editor. | |||
** The '''source editor''' is the advanced editor. You should ignore it for your first few edits, then check it out when you're comfortable with the visual editor. It allows for direct access to the markup language, and generally has more features and control. One downside is that you have to click '''Preview''' to see how it'll look. ''You might find yourself using this more often as you gain experience.'' | |||
** ''Source editor is forced on some namespaces (Talk: and Soyjak_Wiki: for example). This is okay. Proceed as normal, and do add a signature when you write on talk pages.'' | |||
* The wiki uses a markup language called [[mediawikiwiki:Help:Formatting|wikitext]] for formatting. For example, <code><nowiki>'''bold'''</nowiki></code> for '''bold''' text and <code><nowiki>[[link|text to display for the link]]</nowiki></code> for a [[Consumer_Rights_Wiki:Style_guide|link]]. The visual editor can handle most of this. | |||
== | :Here are some examples: | ||
:* '''Bold text''': <code><nowiki>'''bold text'''</nowiki></code> | |||
:* ''Italic text'': <code><nowiki>''italic text''</nowiki></code> | |||
:* '''''Bold and italic text''''': <code><nowiki>'''''bold and italic'''''</nowiki></code> | |||
:* <s>Strikethrough text</s>: <code><nowiki><s>Strikethrough</s></nowiki></code> | |||
:* Internal link: <code><nowiki>[[Page name]]</nowiki></code> | |||
:* Internal link with custom text: <code><nowiki>[[Page name|custom text]]</nowiki></code> | |||
:* External link: <code><nowiki>[https://example.com Example]</nowiki></code> → [https://example.com Example] | |||
:* Headings: <code><nowiki>== Heading 2 ==</nowiki></code>, <code><nowiki>=== Heading 3 ===</nowiki></code> | |||
:* Lists: | |||
:** Bullet: <code><nowiki>* Item</nowiki></code> | |||
:** Numbered: <code><nowiki># Item</nowiki></code> | |||
:* Sign your comments on talk pages with: <code><nowiki>~~~~</nowiki></code> → automatically adds your name and timestamp. Make sure you always do so when using talk pages. | |||
===New references=== | :* You can experiment in the [[Consumer_Rights_Wiki:Sandbox|sandbox]] if you want to try editing without affecting any real pages. | ||
===Advanced section=== | |||
You can ignore this section until you have some experience under your belt and are comfortable with the basics. | |||
* If you want to add colored text, backgrounds, and borders, then the wiki also supports HTML and CSS styling, mainly through the source editor. To use this, first surround the text you want to style in html tags like <code><nowiki><span>this</span></nowiki></code> or <code><nowiki><div>this</div></nowiki></code>, and then in the first tag, add style="property1;property;2;property3; where each property has a semicolon after it, for example <code><nowiki><span style="font-size:10px;color:red;font-weight:bold;>test</span></nowiki></code> becomes <span style="font-size:10px;color:red;font-weight:bold;">test</span>. | |||
Speaking of colored text and backgrounds, you can use '''templates''' to reuse common elements (like infoboxes, alerts, and formatting): | |||
Templates work using a feature called '''transclusion'''. This just means one page can automatically include the contents of another. When the original page is updated, every page that includes it will show the updated version too. | |||
There are a few ways to use templates: | |||
* In the visual editor, click '''Insert > Template''' to bring up the template wizard. | |||
* Or, in source mode, type the code yourself: | |||
** <code><nowiki>{{Template:Template name}}</nowiki></code> — when the page starts with <code>Template:</code> | |||
** <code><nowiki>{{:Page name}}</nowiki></code> — when it's a regular page (like a subpage or shortcut) | |||
For example: | |||
* <code><nowiki>{{Main Page/In The News}}</nowiki></code> brings in the "In The News" section from that subpage. | |||
* <code><nowiki>{{InfoboxCompany}}</nowiki></code> includes a company style infobox. | |||
You can combine this with HTML and styling to make really useful and reusable page elements. If you're curious, go look at the source of one of the templates on the wiki! | |||
''This stuff is optional, but powerful — it's worth playing around with once you've gotten the hang of basic editing.'' | |||
===Adding references=== | |||
====New references==== | |||
To reference a new source: | To reference a new source: | ||
Line 71: | Line 116: | ||
</ol> | </ol> | ||
===Existing references=== | ====Existing references==== | ||
To re-use a source that is referenced elsewhere on the same page: | To re-use a source that is referenced elsewhere on the same page: |