Jump to content

Help:Editing: Difference between revisions

From RetroTechCollection
← Older editNewer edit →
undoJosh (talk | contribs)
Bureaucrats, Interface administrators, Moderators, Suppressors, Administrators
6,267 edits
VisualWikitext
No edit summary
Line 2: Line 2:
{| class="wikitable" style="width:100%; background-color:#e8f4fa; border-radius:10px; box-shadow:0 4px 8px rgba(0,0,0,0.2);"
{| class="wikitable" style="width:100%; background-color:#e8f4fa; border-radius:10px; box-shadow:0 4px 8px rgba(0,0,0,0.2);"
|-
|-
! style="font-size:200%; padding:20px; background-color:#4B9CD3; color:white; text-align:center;" | '''Editing'''
! style="font-size:200%; padding:20px; background-color:#4B9CD3; color:white; text-align:center;" | '''Editing Guide'''
|-
|-
| style="font-size:120%; padding:10px; text-align:center;" | ''Your Guide to Editing & Contributing to the Wiki''
| style="font-size:120%; padding:10px; text-align:center;" | ''Your comprehensive guide to editing and contributing to RetroTechCollection Wiki''
|}
|}


== ✏️ Getting Started ==
<div style="background-color:#f0f9ff; border-left:5px solid #4B9CD3; padding:15px; margin:20px 0;">
Welcome to the '''RetroTechCollection Wiki'''! This page provides a '''step-by-step guide on editing pages''', creating new articles, formatting content, and contributing to the wiki.
'''Welcome editors!''' This guide covers everything from basic text formatting to advanced editing techniques. Whether you're fixing a typo or writing comprehensive articles about vintage technology, you'll find the information you need here.
</div>


If you've come from the Getting Started Page, great! If not, you should take a look! [[Help:Getting Started|Getting Started Page]]
{{TOC limit|3}}


If you’re new to wiki editing, don’t worry! Editing follows '''MediaWiki markup''', which is easy to learn.
== 📚 Before You Begin ==


New users are required to make 3 (good) contributions before being added into the automoderated role.
=== Prerequisites ===
* You must be '''13 years or older''' to edit
* You need a '''registered account''' to edit pages
* New users must make '''3 quality contributions''' before gaining autoconfirmed status
* Review our '''[[Terms of Use]]''' and '''[[Help:Getting Started|Getting Started guide]]'''


== 🔍 Basic Editing ==
=== Core Editing Principles ===
To edit a page, simply '''click the "Edit" tab''' at the top of any article. This opens the editor, where you can modify text, fix errors, and improve content.
{| class="wikitable" style="width:100%; background-color:#f9f9f9;"
! Principle !! Description !! Example
|-
| '''Neutral Point of View''' || Present facts without bias || "The ZX Spectrum had 16KB of RAM" not "The ZX Spectrum had only 16KB of RAM"
|-
| '''Verifiability''' || All claims need reliable sources || Add citations for specifications, dates, and claims
|-
| '''No Original Research''' || Don't publish your own findings || Use published sources, not personal experiments
|-
| '''Collaborative Spirit''' || Work with other editors || Discuss major changes on talk pages first
|}
 
== ✏️ Basic Editing ==
 
=== Accessing the Editor ===
 
There are several ways to edit a page:
 
# '''Edit entire page:''' Click the "Edit" tab at the top
# '''Edit section:''' Click the [edit] link next to any section heading
# '''Visual Editor:''' Use the "Edit" button for WYSIWYG editing (if enabled)
# '''Source Editor:''' Use "Edit source" for direct wikitext editing
 
=== The Editing Interface ===
 
When you click edit, you'll see:
* '''Edit toolbar:''' Buttons for common formatting
* '''Edit window:''' Where you type your changes
* '''Edit summary box:''' Explain your changes (required)
* '''Preview button:''' See how your changes will look
* '''Save button:''' Publish your changes
* '''Show changes:''' Compare your version with the current
 
=== Making Your First Edit ===
 
# Find a page that needs improvement
# Click "Edit"
# Make your changes in the edit window
# Write a clear edit summary (e.g., "Fixed typo in specifications")
# Click "Show preview" to check your work
# Click "Save changes" when satisfied
 
<div style="background-color:#e8f9e8; border-left:5px solid #28a745; padding:15px; margin:20px 0;">
'''💡 Pro tip:''' Always preview your changes before saving! This helps catch formatting errors and ensures your edit looks correct.
</div>
 
== 🖋️ Wiki Markup Fundamentals ==
 
=== Text Formatting ===
 
{| class="wikitable" style="width:100%;"
! style="width:35%;" | You type
! style="width:35%;" | You get
! style="width:30%;" | Notes
|-
| <nowiki>''italic text''</nowiki>
| ''italic text''
| Two apostrophes on each side
|-
| <nowiki>'''bold text'''</nowiki>
| '''bold text'''
| Three apostrophes on each side
|-
| <nowiki>'''''bold italic'''''</nowiki>
| '''''bold italic'''''
| Five apostrophes on each side
|-
| <nowiki><u>underlined</u></nowiki>
| <u>underlined</u>
| Use sparingly
|-
| <nowiki><s>strikethrough</s></nowiki>
| <s>strikethrough</s>
| For corrections
|-
| <nowiki><code>inline code</code></nowiki>
| <code>inline code</code>
| For commands, filenames
|-
| <nowiki><small>small text</small></nowiki>
| <small>small text</small>
| For annotations
|-
| <nowiki><big>big text</big></nowiki>
| <big>big text</big>
| Deprecated, use sparingly
|-
| <nowiki>H<sub>2</sub>O</nowiki>
| H<sub>2</sub>O
| Subscript
|-
| <nowiki>E=mc<sup>2</sup></nowiki>
| E=mc<sup>2</sup>
| Superscript
|}


* Use '''double square brackets''' to link to other pages → [[Page Name]]
=== Creating Links ===
* Use `'''Triple Apostrophes'''` for <nowiki>'''bold'''</nowiki> text → '''Bold'''
* Use `''Double Apostrophes''` for <nowiki>''italic''</nowiki> text → ''Italic''
* Headings are made with equal signs: == Section Title ==
* Lists can be created with:
  * `*` for bulleted lists
  * `#` for numbered lists


== 🖋️ Formatting Guide ==
==== Internal Links ====
{| class="wikitable" style="width:100%; text-align:center; background-color:#f8f8f8; border-radius:8px;"
 
{| class="wikitable" style="width:100%;"
! You type !! Result !! Usage
|-
|-
! style="background-color:#6CAEE0; color:white;" | Markup !! style="background-color:#6CAEE0; color:white;" | Output
| <nowiki>[[Commodore 64]]</nowiki>
| [[Commodore 64]]
| Basic link
|-
|-
| <nowiki>'''Bold Text'''</nowiki> || '''Bold Text'''
| <nowiki>[[Commodore 64|C64]]</nowiki>
| [[Commodore 64|C64]]
| Link with custom text
|-
|-
| <nowiki>''Italic Text''</nowiki> || ''Italic Text''
| <nowiki>[[Commodore 64#History]]</nowiki>
| [[Commodore 64#History]]
| Link to section
|-
|-
| <nowiki>== Heading Level 2 ==</nowiki> || == Heading Level 2 ==
| <nowiki>[[Commodore 64#History|C64 History]]</nowiki>
| [[Commodore 64#History|C64 History]]
| Section link with custom text
|-
|-
| <nowiki>[[Page Name]]</nowiki> || [[Page Name]]
| <nowiki>[[Category:Home computers]]</nowiki>
| (adds page to category)
| Categorize page
|-
|-
| <nowiki>[https://example.com External Link]</nowiki> || [https://example.com External Link]
| <nowiki>[[:Category:Home computers]]</nowiki>
| [[:Category:Home computers]]
| Link to category page
|-
|-
| <nowiki>* Bullet List</nowiki> ||
| <nowiki>[[File:Example.jpg]]</nowiki>
* Bullet List
| (embeds image)
| Embed image
|-
|-
| <nowiki># Numbered List</nowiki> ||
| <nowiki>[[:File:Example.jpg]]</nowiki>
# Numbered List
| [[:File:Example.jpg]]
| Link to image page
|}
 
==== External Links ====
 
{| class="wikitable" style="width:100%;"
! You type !! Result
|-
|-
| <nowiki>{| class="wikitable"</nowiki> || Creates a ''table''
| <nowiki>https://example.com</nowiki>
| https://example.com
|-
| <nowiki>[https://example.com]</nowiki>
| [https://example.com]
|-
| <nowiki>[https://example.com Example site]</nowiki>
| [https://example.com Example site]
|-
| <nowiki>[https://example.com Example site] (archived)</nowiki>
| [https://example.com Example site] (archived)
|}
|}


== 📌 Creating a New Page ==
=== Headings and Sections ===
To create a new page:
 
1. '''Search for the page title''' – If it doesn’t exist, you can create it.
<pre>
2. '''Click "Create"''' to start editing.
= Heading 1 = (Never use - reserved for page title)
3. '''Use standard formatting''' to structure your content.
== Heading 2 == (Main sections)
4. '''Save your changes''' with an edit summary.
=== Heading 3 === (Subsections)
==== Heading 4 ==== (Sub-subsections)
===== Heading 5 ===== (Rarely used)
====== Heading 6 ====== (Avoid if possible)
</pre>
 
'''Best practices:'''
* Start with level 2 headings (<nowiki>==</nowiki>)
* Don't skip levels (e.g., don't go from 2 to 4)
* Keep heading names concise and descriptive
* Avoid links in headings
* Capitalize only the first word and proper nouns
 
=== Lists ===
 
==== Unordered Lists ====
<pre>
* First item
* Second item
** Sub-item
** Another sub-item
*** Third level
* Back to first level
</pre>
 
Results in:
* First item
* Second item
** Sub-item
** Another sub-item
*** Third level
* Back to first level
 
==== Ordered Lists ====
<pre>
# First step
# Second step
## Sub-step 2.1
## Sub-step 2.2
# Third step
</pre>
 
Results in:
# First step
# Second step
## Sub-step 2.1
## Sub-step 2.2
# Third step
 
==== Definition Lists ====
<pre>
; Term 1
: Definition 1
; Term 2
: Definition 2a
: Definition 2b
</pre>
 
Results in:
; Term 1
: Definition 1
; Term 2
: Definition 2a
: Definition 2b
 
=== Paragraphs and Line Breaks ===
 
* '''Paragraphs:''' Leave a blank line between paragraphs
* '''Line break:''' Use <nowiki><br /></nowiki> for forced line break
* '''Indentation:''' Start line with <nowiki>:</nowiki> (each colon adds a level)
* '''Preformatted text:''' Start line with space
 
Example:
<pre>
This is a paragraph.
 
This is another paragraph.
 
:This is indented once.
::This is indented twice.
 
Line one<br />
Line two (forced break)
 
This text is preformatted
and preserves spacing
</pre>
 
== 📊 Tables ==
 
=== Basic Table Structure ===
 
<pre>
{| class="wikitable"
|+ Table caption (optional)
|-
! Header 1
! Header 2
! Header 3
|-
| Row 1, Cell 1
| Row 1, Cell 2
| Row 1, Cell 3
|-
| Row 2, Cell 1
| Row 2, Cell 2
| Row 2, Cell 3
|}
</pre>
 
=== Advanced Table Features ===
 
<pre>
{| class="wikitable sortable" style="width:100%;"
|+ Commodore Computer Specifications
|-
! Model !! Year !! CPU !! RAM !! Price
|-
| Commodore 64 || 1982 || MOS 6510 @ 1MHz || 64KB || $595
|-
| Commodore 128 || 1985 || MOS 8502 @ 2MHz || 128KB || $299
|-
| colspan="5" style="text-align:center;" | ''Prices are US MSRP at launch''
|}
</pre>
 
Results in:
{| class="wikitable sortable" style="width:100%;"
|+ Commodore Computer Specifications
|-
! Model !! Year !! CPU !! RAM !! Price
|-
| Commodore 64 || 1982 || MOS 6510 @ 1MHz || 64KB || $595
|-
| Commodore 128 || 1985 || MOS 8502 @ 2MHz || 128KB || $299
|-
| colspan="5" style="text-align:center;" | ''Prices are US MSRP at launch''
|}
 
== 🖼️ Working with Images ==
 
=== Uploading Images ===
 
1. Go to '''[[Special:Upload]]'''
2. Choose your file
3. Give it a descriptive name (e.g., "Apple_IIe_motherboard_front.jpg")
4. Fill out the information form:
 
<pre>
{{Information
|description = Front view of Apple IIe motherboard showing all components
|source = {{own}}
|date = 2024-01-15
|author = [[User:YourUsername]]
|permission =
|other_versions =
}}
</pre>
 
=== Image Syntax ===
 
{| class="wikitable" style="width:100%;"
! Purpose !! Syntax !! Example
|-
| Basic embed
| <nowiki>[[File:Example.jpg]]</nowiki>
| Displays full-size image
|-
| Thumbnail
| <nowiki>[[File:Example.jpg|thumb|Caption text]]</nowiki>
| Creates thumbnail with caption
|-
| Sized image
| <nowiki>[[File:Example.jpg|200px]]</nowiki>
| Sets width to 200 pixels
|-
| Left align
| <nowiki>[[File:Example.jpg|left|thumb|Caption]]</nowiki>
| Floats image left
|-
| Center
| <nowiki>[[File:Example.jpg|center|300px]]</nowiki>
| Centers image
|-
| Gallery
| <nowiki><gallery>...</gallery></nowiki>
| Creates image gallery
|}
 
=== Image Gallery Example ===
 
<pre>
<gallery mode="packed" heights="150">
File:Apple_II.jpg|Apple II (1977)
File:Apple_IIplus.jpg|Apple II+ (1979)
File:Apple_IIe.jpg|Apple IIe (1983)
File:Apple_IIc.jpg|Apple IIc (1984)
</gallery>
</pre>
 
== 📝 Citations and References ==
 
=== Why Citations Matter ===
* Verify information accuracy
* Allow readers to learn more
* Establish credibility
* Protect against deletion
 
=== Basic Citation Format ===
 
<pre>
The Commodore 64 sold over 12 million units.<ref>{{cite book
|last = Bagnall
|first = Brian
|title = Commodore: A Company on the Edge
|year = 2010
|publisher = Variant Press
|isbn = 978-0973864960
|page = 224
}}</ref>
</pre>
 
=== Common Citation Templates ===
 
==== Book Citation ====
<pre>
{{cite book
|last =
|first =
|title =
|year =
|publisher =
|isbn =
|page =
}}
</pre>
 
==== Magazine Citation ====
<pre>
{{cite magazine
|last =
|first =
|title =
|magazine =
|issue =
|date =
|pages =
|url =
}}
</pre>
 
==== Web Citation ====
<pre>
{{cite web
|url =
|title =
|website =
|date =
|access-date =
|archive-url =
|archive-date =
}}
</pre>
 
=== Reference List ===
 
Add at the bottom of the article:
<pre>
== References ==
{{reflist}}
 
== External links ==
* [https://example.com Official website]
 
[[Category:Appropriate category]]
</pre>
 
== 🎨 Templates ==
 
=== Using Templates ===
 
Templates provide consistent formatting. Common templates include:
 
==== Infoboxes ====
<pre>
{{Infobox computer
|name = Commodore 64
|image = Commodore-64.jpg
|caption = The best-selling computer model of all time
|manufacturer = [[Commodore International]]
|type = [[Home computer]]
|release date = August 1982
|discontinued = April 1994
|processor = [[MOS Technology 6510|MOS 6510]] @ 1.023 MHz
|memory = 64 KB RAM, 20 KB ROM
|graphics = [[VIC-II]] (320×200, 16 colors)
|sound = [[SID chip|SID 6581]]
}}
</pre>
 
==== Message Boxes ====
<pre>
{{Warning|This procedure may damage your equipment if not done correctly.}}
 
{{Note|The original manual contains additional information not covered here.}}
 
{{Tip|Use a proper anti-static wrist strap when handling components.}}
</pre>
 
==== Navigation Templates ====
<pre>
{{Commodore computers}}
{{Home computers of the 1980s}}
</pre>
 
== 🔧 Advanced Techniques ==
 
=== Magic Words ===
 
{| class="wikitable" style="width:100%;"
! Magic word !! Output !! Usage
|-
| <nowiki>{{PAGENAME}}</nowiki>
| {{PAGENAME}}
| Current page name
|-
| <nowiki>{{CURRENTDAY}}</nowiki>
| {{CURRENTDAY}}
| Current day
|-
| <nowiki>{{CURRENTMONTHNAME}}</nowiki>
| {{CURRENTMONTHNAME}}
| Current month
|-
| <nowiki>{{CURRENTYEAR}}</nowiki>
| {{CURRENTYEAR}}
| Current year
|-
| <nowiki>__TOC__</nowiki>
| (forces table of contents)
| Position TOC
|-
| <nowiki>__NOTOC__</nowiki>
| (hides table of contents)
| Hide TOC
|-
| <nowiki>__NOEDITSECTION__</nowiki>
| (hides edit links)
| Hide section editing
|}
 
=== Parser Functions ===
 
<pre>
{{#if: {{{parameter|}}} | Parameter exists | Parameter missing }}
 
{{#ifeq: {{{type}}} | computer | [[Category:Computers]] | [[Category:Other]] }}
 
{{#switch: {{{year}}}
| 1977 = Early era
| 1982 = Golden age
| 1985 = Late period
| #default = Unknown era
}}
</pre>
 
=== Redirects ===
 
Create redirects for alternate names:
<pre>
#REDIRECT [[Commodore 64]]
</pre>
 
Common redirect scenarios:
* Abbreviations (C64 → Commodore 64)
* Alternative spellings
* Common misspellings
* Previous names
 
== ⚡ Editing Best Practices ==
 
=== Before Editing ===
 
1. **Check page history** - See what changes have been made recently
2. **Read talk page** - Check for ongoing discussions
3. **Verify sources** - Ensure your information is accurate
4. **Plan major changes** - Discuss big edits on talk page first
 
=== While Editing ===
 
1. **Use preview** - Check your work before saving
2. **Edit incrementally** - Make focused changes
3. **Write clear summaries** - Explain what and why
4. **Cite sources** - Add references for new facts
5. **Check spelling** - Proofread your contributions
 
=== Edit Summaries ===
 
Good edit summaries help other editors:
 
{| class="wikitable" style="width:100%;"
! Type of edit !! Example summary
|-
| Fixing typo || "Fixed typo: 'Comodore' → 'Commodore'"
|-
| Adding content || "Added specifications section with sources"
|-
| Removing content || "Removed unsourced claim about sales figures"
|-
| Formatting || "Formatted specifications as table"
|-
| Citation || "Added citation for release date"
|-
| Major revision || "Restructured article per talk page consensus"
|}
 
=== Common Mistakes to Avoid ===
 
{| class="wikitable" style="width:100%; background-color:#fff3cd;"
! ❌ Don't !! ✅ Do Instead
|-
| Write in first person ("I think...") || Use third person neutral tone
|-
| Add personal opinions || Stick to verifiable facts
|-
| Copy from other websites || Write in your own words
|-
| Use lots of exclamation points!!! || Use professional tone
|-
| WRITE IN ALL CAPS || Use normal capitalization
|-
| Leave test edits || Use your sandbox for testing
|-
| Ignore preview button || Always preview before saving
|-
| Make massive changes without discussion || Discuss major changes first
|}
 
== 🚨 Handling Conflicts ==
 
=== Edit Conflicts ===
 
If someone edits the page while you're editing:
1. Don't panic - your work isn't lost
2. Copy your text to a text editor
3. Review the other person's changes
4. Incorporate both sets of changes
5. Save the merged version
 
=== Content Disputes ===
 
1. **Stay calm** - Don't edit war
2. **Discuss** - Use the talk page
3. **Provide sources** - Back up your position
4. **Seek consensus** - Find common ground
5. **Get help** - Ask for third opinion if needed
 
=== The Three-Revert Rule ===
Don't revert the same page more than three times in 24 hours. Instead:
* Discuss on the talk page
* Seek mediation
* Request page protection if necessary
 
== 📋 Quick Reference ==
 
=== Essential Shortcuts ===
 
* '''Bold:''' <nowiki>'''text'''</nowiki>
* '''Italic:''' <nowiki>''text''</nowiki>
* '''Link:''' <nowiki>[[Page name]]</nowiki>
* '''External:''' <nowiki>[https://example.com Text]</nowiki>
* '''Heading:''' <nowiki>== Heading ==</nowiki>
* '''List:''' <nowiki>* Item</nowiki>
* '''Reference:''' <nowiki><ref>Source</ref></nowiki>
* '''Sign talk pages:''' <nowiki>~~~~</nowiki>
 
=== Keyboard Shortcuts ===
 
* **Alt+Shift+P** - Preview
* **Alt+Shift+S** - Save
* **Alt+Shift+V** - View history
* **Alt+Shift+E** - Edit page
* **Alt+Shift+T** - Talk page
 
== 🆘 Getting Help ==
 
=== Help Resources ===
 
* '''[[Help:Contents]]''' - Complete help documentation
* '''[[RetroTechCollection:Help desk]]''' - Ask questions
* '''[[RetroTechCollection:Village Pump]]''' - Community discussion
* '''[[Special:RecentChanges]]''' - See editing examples
* '''[[User:Example/sandbox|Your sandbox]]''' - Practice editing
 
=== Finding Mentors ===


If unsure, check '''[[Help:Page Structure]]''' for guidance on structuring new pages.
* Look for users with [[Template:User mentor|mentor badges]]
* Check [[RetroTechCollection:Active editors|active editors list]]
* Ask on [[RetroTechCollection:New user help|new user help]]


== 🔧 Advanced Editing ==
== 🎯 Next Steps ==
For experienced users, the following features help enhance content quality:
* '''Templates''' – Use pre-formatted templates for consistency Template:Infobox_computer, Warning).
* '''Tables''' – Organize data using `wikitable` class.
* '''Images''' – Upload images via '''Special:Upload''' and insert using File:Example.jpg|thumb|Description.
* '''Categories''' – Add <nowiki>[[Category:Example]]</nowiki> at the bottom of a page to categorize it.


== ⚠️ Editing Guidelines ==
Now that you understand editing basics:
When editing, please follow these rules:
✅ '''Keep content factual and relevant''' 
✅ '''Use proper formatting for readability''' 
✅ '''Cite sources when necessary''' 
✅ '''Be respectful of other contributors''' 
❌ '''Do not add spam or unverified information''' 


If you need assistance, visit our '''[https://forum.retrotechcollection.com Editing Help Forum]'''.
1. **Practice in your [[Special:MyPage/sandbox|sandbox]]**
2. **Start with small edits** - Fix typos, add links
3. **Expand stubs** - Add content to short articles
4. **Create new articles** - Document missing systems
5. **Join a [[RetroTechCollection:WikiProjects|WikiProject]]**


== 🔗 Related Help Pages ==
<div style="background-color:#e8f9e8; border:2px solid #28a745; border-radius:10px; padding:20px; margin:20px 0; text-align:center;">
* [[Help:Formatting]] – Advanced formatting tips
<span style="font-size:150%;">'''Ready to start editing?'''</span><br />
* [[Help:Page Structure]] – How to structure pages correctly
<span style="font-size:120%;">Find an article about your favorite vintage system and improve it!</span><br />
* [[Help:Templates]] – Using and creating wiki templates
<span style="font-size:110%;">Remember: Be bold, but be careful. Happy editing!</span>
* [[Help:Categories]] – Organizing pages with categories
</div>
* [[Help:Uploading Images]] – Adding images to the wiki


== 🛠️ Get Involved! ==
----
Editing and improving articles is the '''best way to contribute to the wiki'''! If you're ready to help, jump in and start editing, or visit our '''community forums''' for collaboration.


Happy Editing! 🎉 
'''Questions?''' Visit the [[RetroTechCollection:Help desk|Help desk]] or leave a message on [[Help talk:Editing|this page's talk page]].
— The RetroTechCollection Wiki Team 


[[Category:Help Pages]]
[[Category:Help]]
[[Category:Editing]]
[[Category:RetroTechCollection]]

Revision as of 13:48, 2 August 2025

Editing Guide
Your comprehensive guide to editing and contributing to RetroTechCollection Wiki

Welcome editors! This guide covers everything from basic text formatting to advanced editing techniques. Whether you're fixing a typo or writing comprehensive articles about vintage technology, you'll find the information you need here.

📚 Before You Begin

Prerequisites

  • You must be 13 years or older to edit
  • You need a registered account to edit pages
  • New users must make 3 quality contributions before gaining autoconfirmed status
  • Review our Terms of Use and Getting Started guide

Core Editing Principles

Principle Description Example
Neutral Point of View Present facts without bias "The ZX Spectrum had 16KB of RAM" not "The ZX Spectrum had only 16KB of RAM"
Verifiability All claims need reliable sources Add citations for specifications, dates, and claims
No Original Research Don't publish your own findings Use published sources, not personal experiments
Collaborative Spirit Work with other editors Discuss major changes on talk pages first

✏️ Basic Editing

Accessing the Editor

There are several ways to edit a page:

  1. Edit entire page: Click the "Edit" tab at the top
  2. Edit section: Click the [edit] link next to any section heading
  3. Visual Editor: Use the "Edit" button for WYSIWYG editing (if enabled)
  4. Source Editor: Use "Edit source" for direct wikitext editing

The Editing Interface

When you click edit, you'll see:

  • Edit toolbar: Buttons for common formatting
  • Edit window: Where you type your changes
  • Edit summary box: Explain your changes (required)
  • Preview button: See how your changes will look
  • Save button: Publish your changes
  • Show changes: Compare your version with the current

Making Your First Edit

  1. Find a page that needs improvement
  2. Click "Edit"
  3. Make your changes in the edit window
  4. Write a clear edit summary (e.g., "Fixed typo in specifications")
  5. Click "Show preview" to check your work
  6. Click "Save changes" when satisfied

💡 Pro tip: Always preview your changes before saving! This helps catch formatting errors and ensures your edit looks correct.

🖋️ Wiki Markup Fundamentals

Text Formatting

You type You get Notes
''italic text'' italic text Two apostrophes on each side
'''bold text''' bold text Three apostrophes on each side
'''''bold italic''''' bold italic Five apostrophes on each side
<u>underlined</u> underlined Use sparingly
<s>strikethrough</s> strikethrough For corrections
<code>inline code</code> inline code For commands, filenames
<small>small text</small> small text For annotations
<big>big text</big> big text Deprecated, use sparingly
H<sub>2</sub>O H2O Subscript
E=mc<sup>2</sup> E=mc2 Superscript
You type Result Usage
[[Commodore 64]] Commodore 64 Basic link
[[Commodore 64|C64]] C64 Link with custom text
[[Commodore 64#History]] Commodore 64#History Link to section
[[Commodore 64#History|C64 History]] C64 History Section link with custom text
[[Category:Home computers]] (adds page to category) Categorize page
[[:Category:Home computers]] Category:Home computers Link to category page
[[File:Example.jpg]] (embeds image) Embed image
[[:File:Example.jpg]] File:Example.jpg Link to image page
You type Result
https://example.com https://example.com
[https://example.com] [1]
[https://example.com Example site] Example site
[https://example.com Example site] (archived) Example site (archived)

Headings and Sections

= Heading 1 = (Never use - reserved for page title)
== Heading 2 == (Main sections)
=== Heading 3 === (Subsections)
==== Heading 4 ==== (Sub-subsections)
===== Heading 5 ===== (Rarely used)
====== Heading 6 ====== (Avoid if possible)

Best practices:

  • Start with level 2 headings (==)
  • Don't skip levels (e.g., don't go from 2 to 4)
  • Keep heading names concise and descriptive
  • Avoid links in headings
  • Capitalize only the first word and proper nouns

Lists

Unordered Lists

* First item
* Second item
** Sub-item
** Another sub-item
*** Third level
* Back to first level

Results in:

  • First item
  • Second item
    • Sub-item
    • Another sub-item
      • Third level
  • Back to first level

Ordered Lists

# First step
# Second step
## Sub-step 2.1
## Sub-step 2.2
# Third step

Results in:

  1. First step
  2. Second step
    1. Sub-step 2.1
    2. Sub-step 2.2
  3. Third step

Definition Lists

; Term 1
: Definition 1
; Term 2
: Definition 2a
: Definition 2b

Results in:

Term 1
Definition 1
Term 2
Definition 2a
Definition 2b

Paragraphs and Line Breaks

  • Paragraphs: Leave a blank line between paragraphs
  • Line break: Use <br /> for forced line break
  • Indentation: Start line with : (each colon adds a level)
  • Preformatted text: Start line with space

Example: 

This is a paragraph.

This is another paragraph.

:This is indented once.
::This is indented twice.

Line one<br />
Line two (forced break)

 This text is preformatted
 and preserves spacing

📊 Tables

Basic Table Structure

{| class="wikitable"
|+ Table caption (optional)
|-
! Header 1
! Header 2
! Header 3
|-
| Row 1, Cell 1
| Row 1, Cell 2
| Row 1, Cell 3
|-
| Row 2, Cell 1
| Row 2, Cell 2
| Row 2, Cell 3
|}

Advanced Table Features

{| class="wikitable sortable" style="width:100%;"
|+ Commodore Computer Specifications
|-
! Model !! Year !! CPU !! RAM !! Price
|-
| Commodore 64 || 1982 || MOS 6510 @ 1MHz || 64KB || $595
|-
| Commodore 128 || 1985 || MOS 8502 @ 2MHz || 128KB || $299
|-
| colspan="5" style="text-align:center;" | ''Prices are US MSRP at launch''
|}

Results in:

Commodore Computer Specifications
Model Year CPU RAM Price
Commodore 64 1982 MOS 6510 @ 1MHz 64KB $595
Commodore 128 1985 MOS 8502 @ 2MHz 128KB $299
Prices are US MSRP at launch

🖼️ Working with Images

Uploading Images

1. Go to Special:Upload 2. Choose your file 3. Give it a descriptive name (e.g., "Apple_IIe_motherboard_front.jpg") 4. Fill out the information form: 

{{Information
|description = Front view of Apple IIe motherboard showing all components
|source = {{own}}
|date = 2024-01-15
|author = [[User:YourUsername]]
|permission = 
|other_versions = 
}}

Image Syntax

Purpose Syntax Example
Basic embed [[File:Example.jpg]] Displays full-size image
Thumbnail [[File:Example.jpg|thumb|Caption text]] Creates thumbnail with caption
Sized image [[File:Example.jpg|200px]] Sets width to 200 pixels
Left align [[File:Example.jpg|left|thumb|Caption]] Floats image left
Center [[File:Example.jpg|center|300px]] Centers image
Gallery <gallery>...</gallery> Creates image gallery 
<gallery mode="packed" heights="150">
File:Apple_II.jpg|Apple II (1977)
File:Apple_IIplus.jpg|Apple II+ (1979)
File:Apple_IIe.jpg|Apple IIe (1983)
File:Apple_IIc.jpg|Apple IIc (1984)
</gallery>

📝 Citations and References

Why Citations Matter

  • Verify information accuracy
  • Allow readers to learn more
  • Establish credibility
  • Protect against deletion

Basic Citation Format

The Commodore 64 sold over 12 million units.<ref>{{cite book
|last = Bagnall
|first = Brian
|title = Commodore: A Company on the Edge
|year = 2010
|publisher = Variant Press
|isbn = 978-0973864960
|page = 224
}}</ref>

Common Citation Templates

Book Citation

{{cite book
|last = 
|first = 
|title = 
|year = 
|publisher = 
|isbn = 
|page = 
}}

Magazine Citation

{{cite magazine
|last = 
|first = 
|title = 
|magazine = 
|issue = 
|date = 
|pages = 
|url = 
}}

Web Citation

{{cite web
|url = 
|title = 
|website = 
|date = 
|access-date = 
|archive-url = 
|archive-date = 
}}

Reference List

Add at the bottom of the article: 

== References ==
{{reflist}}

== External links ==
* [https://example.com Official website]

[[Category:Appropriate category]]

🎨 Templates

Using Templates

Templates provide consistent formatting. Common templates include:

Infoboxes

{{Infobox computer
|name = Commodore 64
|image = Commodore-64.jpg
|caption = The best-selling computer model of all time
|manufacturer = [[Commodore International]]
|type = [[Home computer]]
|release date = August 1982
|discontinued = April 1994
|processor = [[MOS Technology 6510|MOS 6510]] @ 1.023 MHz
|memory = 64 KB RAM, 20 KB ROM
|graphics = [[VIC-II]] (320×200, 16 colors)
|sound = [[SID chip|SID 6581]]
}}

Message Boxes

{{Warning|This procedure may damage your equipment if not done correctly.}}

{{Note|The original manual contains additional information not covered here.}}

{{Tip|Use a proper anti-static wrist strap when handling components.}}

{{Commodore computers}}
{{Home computers of the 1980s}}

🔧 Advanced Techniques

Magic Words

Magic word Output Usage
{{PAGENAME}} Editing Current page name
{{CURRENTDAY}} 13 Current day
{{CURRENTMONTHNAME}} July Current month
{{CURRENTYEAR}} 2026 Current year
__TOC__ (forces table of contents) Position TOC
__NOTOC__ (hides table of contents) Hide TOC
__NOEDITSECTION__ (hides edit links) Hide section editing

Parser Functions

{{#if: {{{parameter|}}} | Parameter exists | Parameter missing }}

{{#ifeq: {{{type}}} | computer | [[Category:Computers]] | [[Category:Other]] }}

{{#switch: {{{year}}}
| 1977 = Early era
| 1982 = Golden age
| 1985 = Late period
| #default = Unknown era
}}

Redirects

Create redirects for alternate names: 

#REDIRECT [[Commodore 64]]

Common redirect scenarios:

  • Abbreviations (C64 → Commodore 64)
  • Alternative spellings
  • Common misspellings
  • Previous names

⚡ Editing Best Practices

Before Editing

1. **Check page history** - See what changes have been made recently 2. **Read talk page** - Check for ongoing discussions 3. **Verify sources** - Ensure your information is accurate 4. **Plan major changes** - Discuss big edits on talk page first

While Editing

1. **Use preview** - Check your work before saving 2. **Edit incrementally** - Make focused changes 3. **Write clear summaries** - Explain what and why 4. **Cite sources** - Add references for new facts 5. **Check spelling** - Proofread your contributions

Edit Summaries

Good edit summaries help other editors:

Type of edit Example summary
Fixing typo "Fixed typo: 'Comodore' → 'Commodore'"
Adding content "Added specifications section with sources"
Removing content "Removed unsourced claim about sales figures"
Formatting "Formatted specifications as table"
Citation "Added citation for release date"
Major revision "Restructured article per talk page consensus"

Common Mistakes to Avoid

❌ Don't ✅ Do Instead
Write in first person ("I think...") Use third person neutral tone
Add personal opinions Stick to verifiable facts
Copy from other websites Write in your own words
Use lots of exclamation points!!! Use professional tone
WRITE IN ALL CAPS Use normal capitalization
Leave test edits Use your sandbox for testing
Ignore preview button Always preview before saving
Make massive changes without discussion Discuss major changes first

🚨 Handling Conflicts

Edit Conflicts

If someone edits the page while you're editing: 1. Don't panic - your work isn't lost 2. Copy your text to a text editor 3. Review the other person's changes 4. Incorporate both sets of changes 5. Save the merged version

Content Disputes

1. **Stay calm** - Don't edit war 2. **Discuss** - Use the talk page 3. **Provide sources** - Back up your position 4. **Seek consensus** - Find common ground 5. **Get help** - Ask for third opinion if needed

The Three-Revert Rule

Don't revert the same page more than three times in 24 hours. Instead:

  • Discuss on the talk page
  • Seek mediation
  • Request page protection if necessary

📋 Quick Reference

Essential Shortcuts

  • Bold: '''text'''
  • Italic: ''text''
  • Link: [[Page name]]
  • External: [https://example.com Text]
  • Heading: == Heading ==
  • List: * Item
  • Reference: <ref>Source</ref>
  • Sign talk pages: ~~~~

Keyboard Shortcuts

  • **Alt+Shift+P** - Preview
  • **Alt+Shift+S** - Save
  • **Alt+Shift+V** - View history
  • **Alt+Shift+E** - Edit page
  • **Alt+Shift+T** - Talk page

🆘 Getting Help

Help Resources

Finding Mentors

🎯 Next Steps

Now that you understand editing basics:

1. **Practice in your sandbox** 2. **Start with small edits** - Fix typos, add links 3. **Expand stubs** - Add content to short articles 4. **Create new articles** - Document missing systems 5. **Join a WikiProject**

Ready to start editing?
Find an article about your favorite vintage system and improve it!
Remember: Be bold, but be careful. Happy editing!

Questions? Visit the Help desk or leave a message on this page's talk page.

Retrieved from "https://wiki.retrotechcollection.com/index.php?title=Help:Editing&oldid=4460"