Difference between revisions of "Help:Editing"

From Synth DIY wiki
Jump to navigation Jump to search
 
(43 intermediate revisions by the same user not shown)
Line 1: Line 1:
The [http://www.mediawiki.org/ MediaWiki] software is extremely easy to use.  Viewing pages is self-explanatory, but adding new pages and making edits to existing content is extremely easy and intuitive as well. No damage can be done that can't be easily fixed. Although there are some differences, editing SDIY wiki is much the same as editing on Wikipedia.  
+
{{warning|This page can be out of date and is awaiting revision.}}
 +
The [http://www.mediawiki.org/ MediaWiki] software is extremely easy to use.  Viewing pages is self-explanatory, but adding new pages and making edits to existing content is extremely easy and intuitive as well. Editing SDIY wiki is much the same as editing on Wikipedia.
 +
== Editing rules and conventions ==
 +
The number one rule of wiki editing is to '''be bold'''. Go ahead – make changes. No damage can be done that can't be easily fixed.
  
==Editing the wiki==
+
An edit can contribute whole new paragraphs or pages of information, or it can be as simple as fixing a typo or a spelling mistake. In general, try to add or edit text so that it is clear and concise.
By default the enhanced editing toolbar is disabled. To enable it go to [[Special:Preferences#mw-prefsection-editing|Preferences:Editing]] and tick ''Enable enhanced editing toolbar''.  
 
  
At the top of any wiki the page, you will see some tabs titled Page, Discussion, Edit, History, Move And Watch. Clicking the edit tab opens the editor, a large text entry box in the middle of the page.  This is where to enter plain text. Very little formatting code (known as "wiki markup") is required, unlike regular websites using [[wikipedia:HTML|HTML]] and [[wikipedia:Cascading Style Sheets|CSS]]. At the top of this text entry box is a row of buttons with small icons on them. Holding the mouse cursor over an icon displays a tool-tip telling you its function. These buttons make it very simple to use the formatting features of the wiki software.  You can achieve the same effect by typing the correct wiki code, however using the buttons makes it very simple and also eases the process of learning the correct code syntax. Please do your best to always fill in the edit summary field. An enhanced editor can be enabled in user [[Special:Preferences#mw-prefsection-editing|preferences]].
+
== Editing the wiki ==
 +
At the top of any wiki the page, you will see some tabs titled Page, Talk, Edit, History, Move And Watch. Clicking the edit tab opens the editor, a large text entry box in the middle of the page.  This is where to enter plain text. Unlike regular websites using [https://en.wikipedia.org/wiki/HTML HTML] and [https://en.wikipedia.org/wiki/Cascading_Style_Sheets CSS], very little formatting code (known as "wiki markup") is required. At the top of this text entry box is a row of buttons with small icons on them. Holding the mouse cursor over an icon displays a tool-tip telling you its function. These buttons make it very simple to use the formatting features of the wiki software.  You can achieve the same effect by typing the correct wiki code, however using the buttons makes it very simple and also eases the process of learning the correct code syntax. Please do your best to always fill in the edit summary field.
  
==Use a sandbox page==
+
By default an enhanced editing toolbar is disabled. To enable it go to [[Special:Preferences#mw-prefsection-editing|Preferences:Editing]] and tick ''Enable enhanced editing toolbar''.
Use the [[sandbox]] page to play around and experiment with editing. It isn't for formal wiki info, just a place to play and explore. Any content here won't be preserved. You can create your own sandbox area by appending "/sandbox" to the URL of your user page, or click the Sandbox link in the personal toolbar area, if enabled in your preferences. Your own sandbox is where to rough out articles until they're ready for posting. Don't do articles in rough in the main wiki. Sandboxes will be indexed by search engines like any other page, unless the first line is <code><nowiki>__NOINDEX__</nowiki></code> or uses the [[Help:Template|template]] <code><nowiki>{{User sandbox}}</nowiki></code>.
 
  
==Creating links and adding pages==
+
== Try it out on the sandbox page ==
 +
Use the [[sandbox]] page to play around and experiment with editing. It isn't for formal wiki info, just a place to play and explore. Any content here won't be preserved. You can create your own sandbox area by appending "/sandbox" to the URL of your user page, or click the Sandbox link in the personal toolbar area, if enabled in your preferences. Your own sandbox is where to rough out articles until they're ready for posting. Don't do articles in rough in the main wiki. Sandboxes will be indexed by search engines like any other page, unless the first line is <code><nowiki>__NOINDEX__</nowiki></code> or <code><nowiki>{{User sandbox}}</nowiki></code>.
 +
 
 +
== Creating links and adding pages ==
 
The third and fourth buttons are create "Internal link" and "External link". The third button creates an internal link (aka a wikilink) which, in the editor,  has the format <code><nowiki>[[Eurocard]]</nowiki></code> ie. surrounded by double square brackets. Use a vertical bar "|" (the "pipe" symbol) to create a link with a different name to original article eg. <code><nowiki>[[Printed circuit board|PCB]]</nowiki></code>, only [[Printed circuit board|PCB]] appears on the page.
 
The third and fourth buttons are create "Internal link" and "External link". The third button creates an internal link (aka a wikilink) which, in the editor,  has the format <code><nowiki>[[Eurocard]]</nowiki></code> ie. surrounded by double square brackets. Use a vertical bar "|" (the "pipe" symbol) to create a link with a different name to original article eg. <code><nowiki>[[Printed circuit board|PCB]]</nowiki></code>, only [[Printed circuit board|PCB]] appears on the page.
  
Line 16: Line 21:
 
Using the fourth button will make an external link to a page elsewhere on the Internet. This has the form <code><nowiki>[http://www.google.com Google]</nowiki></code>, ie. the URL, followed by a space, followed by linking text in single square brackets.
 
Using the fourth button will make an external link to a page elsewhere on the Internet. This has the form <code><nowiki>[http://www.google.com Google]</nowiki></code>, ie. the URL, followed by a space, followed by linking text in single square brackets.
  
Every article is part of a network of connected topics. Establishing such connections via internal links is a good way to establish context. Each article should be linked from more general subjects, and contain links where readers might want to use them to help clarify a detail. Only create relevant links. When you write a new article, make sure that one or more other pages link to it. There should always be an unbroken chain of links leading from the Main Page to every article in the wiki.
+
Every article is part of a network of connected topics. Establishing such connections via internal links is a good way to establish context. Each article should be linked from more general subjects, and contain links where readers might want to use them to help clarify a detail. Only create relevant links. When you write a new article, make sure that one or more other pages link to it. Ideally there would be an unbroken chain of links leading from every article in the wiki to the Main Page.
  
 
Always preview your edits before saving them and also check any links you have made to confirm that they do link to where you expect.
 
Always preview your edits before saving them and also check any links you have made to confirm that they do link to where you expect.
Line 22: Line 27:
 
See also [http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style/Linking Wikipedia:Manual of Style/Linking]
 
See also [http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style/Linking Wikipedia:Manual of Style/Linking]
  
==Headings==
+
== Headings ==
 
Headings help clarify articles and create a structure shown in the table of contents.
 
Headings help clarify articles and create a structure shown in the table of contents.
  
Line 31: Line 36:
 
Except for names, use ordinary sentence case for headings, also don't have all words with initial caps.
 
Except for names, use ordinary sentence case for headings, also don't have all words with initial caps.
  
==Lists==
+
== Lists ==
 
In an article, significant items should normally be mentioned naturally within the text rather than merely listed. Where a "bulleted list" is required each item/line of the list is preceded by an asterix (<code><nowiki>*</nowiki></code>) or  for indenting a sublist use two asterixes <code><nowiki>**</nowiki></code>). For numbered lists use a hash sign (<code><nowiki>#</nowiki></code>) and further hash signs for subsections. Lists of links are usually bulleted, giving each link on a new line.
 
In an article, significant items should normally be mentioned naturally within the text rather than merely listed. Where a "bulleted list" is required each item/line of the list is preceded by an asterix (<code><nowiki>*</nowiki></code>) or  for indenting a sublist use two asterixes <code><nowiki>**</nowiki></code>). For numbered lists use a hash sign (<code><nowiki>#</nowiki></code>) and further hash signs for subsections. Lists of links are usually bulleted, giving each link on a new line.
 +
==== Capacitors ====
 +
Capacitors are passive components ...
 +
* Ceramic
 +
* Electrolytic
 +
** Aluminum
 +
** Tantalum
 +
* Polyester
 +
*:Replacing polystyrene
 +
* Polypropylene
  
===Definition lists===
+
=== Definition lists ===
 
Are useful for more than just terms and definitions. Use semi-colons and colons:
 
Are useful for more than just terms and definitions. Use semi-colons and colons:
;Some term - this line starts with ;
+
;Some term this line starts with ;
:And then a definition - this line starts with a :
+
:And then a definition this line starts with a :
 
 
== Inserting files ==
 
The sixth button will enable to insert an image (or other media type) into the text. Relevant images add interest to the article. Currently there are limitations on the allowable size of uploads. 
 
 
 
{| align="right" style="font-size:85%; text-align: left; border:1px silver solid;"
 
|<mp3>Synth_filter_sweep.mp3</mp3>
 
|-
 
|An example of a classic analog synthesizer<br>sound - a sawtooth bass filter sweep with<br>gradually increasing resonance.
 
|}
 
For a large selection of freely usable media see [http://commons.wikimedia.org/wiki/Main_Page Wikimedia Commons]. To fulfill the free license requirements, please read the [http://commons.wikimedia.org/wiki/Commons:Reusing_content_outside_Wikimedia Reuse guide]. For more info see [http://en.wikipedia.org/wiki/Wikipedia:Images Wikipedia:Images]
 
 
 
You can also insert MP3 clips by using the tag <nowiki><mp3></nowiki>, but it needs to be put in an inline styled table to format it neatly. Use <nowiki><br></nowiki> tags to format any caption.
 
  
 +
== Images ==
 
File names should be clear and descriptive, without being excessively long. It is helpful to have descriptive names for editors. Very generic filenames should not be used when uploading, as sooner or later someone else will use same name and this will overwrite the first file.
 
File names should be clear and descriptive, without being excessively long. It is helpful to have descriptive names for editors. Very generic filenames should not be used when uploading, as sooner or later someone else will use same name and this will overwrite the first file.
  
For a large selection of freely usable media see [http://commons.wikimedia.org/wiki/Main_Page Wikimedia Commons].
+
=== Finding images ===
 +
* [http://commons.wikimedia.org/wiki/Category:Synth_DIY  Category:Synth DIY], Wikimedia Commons  
 +
* [https://commons.wikimedia.org/wiki/Category:Electronic_components Category:Electronic components], Wikimedia Commons
 +
* [https://en.wikipedia.org/wiki/Wikipedia:Public_domain_image_resources Public domain image resources], Wikipedia's large list of links to public domain image resources.
 +
* [https://www.google.com/advanced_image_search Google Advanced Image Search], allows filtering by licence/usage rights
 +
* [https://ccsearch.creativecommons.org/ Public domain and Creative Commons licensed content]
  
 
=== Hotlinking ===
 
=== Hotlinking ===
[[Help:Hotlinking|Hotlinking]] from from [http://commons.wikimedia.org/wiki/Main_Page Wikimedia Commons] is allowed. You can first [http://commons.wikimedia.org/wiki/Special:UploadWizard upload] your file there, but be sure to use a long descriptive or unique file name. This is to avoid name clash. When files have the same name, some other other file might be displayed locally instead of the one expected.
+
[[Help:Hotlinking|Hotlinking]] from from Wikimedia Commons is allowed. You can first [http://commons.wikimedia.org/wiki/Special:UploadWizard upload] your file there, but be sure to use a long descriptive or unique file name. This is to avoid name clash. When files have the same name, some other other file might be displayed locally instead of the one expected.
  
 
''See also [http://commons.wikimedia.org/wiki/Commons:Reusing_content_outside_Wikimedia/technical Commons:Reusing content outside Wikimedia/technical].''
 
''See also [http://commons.wikimedia.org/wiki/Commons:Reusing_content_outside_Wikimedia/technical Commons:Reusing content outside Wikimedia/technical].''
Line 64: Line 72:
 
Generally hotlinking is wrong because it exploits another servers bandwidth to supply the files. For files on sites other than Wikimedia, don't link directly to those files without permission. Either download a copy from the other site and then upload it to the wiki, or link to the other site's page on which the file can be found.
 
Generally hotlinking is wrong because it exploits another servers bandwidth to supply the files. For files on sites other than Wikimedia, don't link directly to those files without permission. Either download a copy from the other site and then upload it to the wiki, or link to the other site's page on which the file can be found.
  
==Schematics==
+
=== Schematics ===
For quickly illustrating articles with simple schematics and sketches. There's some suggestions listed at  Wikipedia:[http://en.wikipedia.org/wiki/Wikipedia:WikiProject_Electronics/Programs Project Electronics/Programs] and at StackExchange EE:[http://electronics.stackexchange.com/questions/1024/good-tools-for-drawing-schematics Good Tools for Drawing Schematics].  
+
For quickly illustrating articles with simple schematics, there are some suggestions listed at StackExchange EE:[http://electronics.stackexchange.com/questions/1024/good-tools-for-drawing-schematics Good Tools for Drawing Schematics] and at Wikipedia:[http://en.wikipedia.org/wiki/Wikipedia:WikiProject_Electronics/Programs Project Electronics/Programs].
  
==Tables==
+
=== Illustrations ===
Use wiki markup not HTML nor images. The easiest way to work with tables is to use Microsoft Excel. Paste and edit or create a table in Excel, then copy the table into the [http://excel2wiki.net/ tab-delimited string to wiki markup converter].  Other methods are described at [http://commons.wikimedia.org/wiki/Commons:Convert_tables_and_charts_to_wiki_code_or_image_files Commons:Convert tables and charts to wiki code].
+
An article without at least one illustration seems incomplete. Just a few images can help to explain complex ideas. If not photographs then here are a few applications for creating images, that may be worth investigating:
 +
* [http://www.libreoffice.org/discover/draw/ LibreOffice Draw]
 +
* [http://inkscape.org/en/ Inkscape], a vector graphics editor. See this page of links to [http://inkscape.org/en/learn/ learning resources].
 +
* [http://winfig.com/ WinFIG], this is a vector graphics editor for Windows, like [//en.wikipedia.org/wiki/Xfig Xfig].
 +
 
 +
== Other file types ==
 +
''See [[Help:Editing/Multimedia]]''
 +
 
 +
== Tables ==
 +
Use wiki markup not HTML nor images. The easiest way to work with tables is to use Microsoft Excel. Paste and edit or create a table in Excel, then copy the table into the [http://tools.wmflabs.org/magnustools/tab2wiki.php tab-delimited string to wiki markup converter].  Other methods are described at [http://commons.wikimedia.org/wiki/Commons:Convert_tables_and_charts_to_wiki_code_or_image_files Commons:Convert tables and charts to wiki code].
  
 
Enabling the enhanced editor in user preferences, gives an ''Insert a table'' button. Clicking this produces the following.
 
Enabling the enhanced editor in user preferences, gives an ''Insert a table'' button. Clicking this produces the following.
 
<pre>
 
<pre>
{| class="wikitable" border="1"
+
{| class="wikitable"
 
|-
 
|-
 
!header1!!header 2!!header 3
 
!header1!!header 2!!header 3
Line 82: Line 99:
 
</pre>
 
</pre>
 
Which displays as
 
Which displays as
{| class="wikitable" border="1"
+
{| class="wikitable"
 
|-
 
|-
 
!header1!!header 2!!header 3
 
!header1!!header 2!!header 3
Line 93: Line 110:
 
For more in depth information on table markup see [http://en.wikipedia.org/wiki/Help:Table Wikipedia:Help:Table].
 
For more in depth information on table markup see [http://en.wikipedia.org/wiki/Help:Table Wikipedia:Help:Table].
  
==Formatting==
+
== Formatting ==
 
Be sure to keep your content meaningful. Relying on styling to indicate meaning is a bad practice (e.g. for machine readability such as by search engines, screen readers using text-to-speech, and text browsers).
 
Be sure to keep your content meaningful. Relying on styling to indicate meaning is a bad practice (e.g. for machine readability such as by search engines, screen readers using text-to-speech, and text browsers).
  
 
=== Inline styling ===
 
=== Inline styling ===
Some HTML tags and inline styling is allowed, for example <code>&lt;code></code>, <code>&lt;div></code>, <code><nowiki><span></nowiki></code> and <code><nowiki><font></nowiki></code>. These apply anywhere you insert them - depending upon which fonts are installed. <span style="font-family:Courier;font-size:100%;color:#0000ff;background-color:#dddddd">Here is an example using <nowiki><span style="font-family:Courier;font-size:100%;color:#0000ff;background-color:#dddddd"></span></nowiki>.</span> For further information see [http://www.mediawiki.org/wiki/Help:Formatting Mediawiki:Help:Formatting].
+
''See [http://www.mediawiki.org/wiki/Help:Formatting Mediawiki:Help:Formatting].''
 +
==== Inline CSS styling ====
 +
Some HTML tags and inline styling is allowed, for example <code>&lt;code></code>, <code>&lt;div></code>, <code><nowiki><span></nowiki></code> and <code><nowiki><font></nowiki></code>. These apply anywhere you insert them but depend upon which fonts are installed on the client. <span style="font-family:Courier;font-size:100%;color:#0000ff;background-color:#dddddd">Here is an example using <nowiki><span style="font-family:Courier;font-size:100%;color:#0000ff;background-color:#dddddd"></span></nowiki>.</span>
  
 
=== Indenting text ===
 
=== Indenting text ===
Line 111: Line 130:
 
For preformatted text (in a dashed box) simply indent it by one space. Inline styling allows more options e.g. <code><nowiki><div style="background: #eeffff; border: 1px solid #999999; padding: 1em; width:88%;"></nowiki></code>
 
For preformatted text (in a dashed box) simply indent it by one space. Inline styling allows more options e.g. <code><nowiki><div style="background: #eeffff; border: 1px solid #999999; padding: 1em; width:88%;"></nowiki></code>
  
=== LaTeX formulae ===
+
== Mathematical ==
SDIY wiki supports embedding mathematical formulas using [http://en.wikipedia.org/wiki/TeX TeX] syntax. Use <code><nowiki><m></nowiki></code> tags.
+
''See [[Help:Editing/Mathematical]]''
  
For example (use edit to see the source): <m>\operatorname{erfc}(x) = \frac{2}{\sqrt{\pi}} \int_x^{\infty} e^{-t^2}\,dt = \frac{e^{-x^2}}{x\sqrt{\pi}}\sum_{n=0}^\infty (-1)^n \frac{(2n)!}{n!(2x)^{2n}}</m>
+
== Categories ==
 
 
==Categories==
 
 
Add one or more categories to pages or uploaded file, by simply adding eg. <code><nowiki>[[Category:Whatever]]</nowiki></code>. Categories themselves need to be categorised to create a hierarchy for navigating through the wiki.
 
Add one or more categories to pages or uploaded file, by simply adding eg. <code><nowiki>[[Category:Whatever]]</nowiki></code>. Categories themselves need to be categorised to create a hierarchy for navigating through the wiki.
  
==Standard appendices==
+
== Standard appendices ==
 
Information that can follow after the body of the article should follow in this order:
 
Information that can follow after the body of the article should follow in this order:
*A list of works created by the subject of the article
+
* Lists, e.g. a list of designs, or a table of usage
*See also, a list of internal links to related articles
+
* See also, a list of internal links to related articles
*Notes and [[Help:References|references]]
+
* [[Help:References|Notes and references]]
*Further reading, a list of recommended relevant books, articles, or other publications that have not been used as sources
+
* Further reading, a list of recommended relevant books, articles, or other publications that have not been used as sources
*External links, a list of recommended relevant websites that have not been used as sources
+
* External links, a list of recommended relevant websites that have not been used as sources
  
==Templates==
+
== Templates ==
{{Main article|Help:Template}} A template is a page that gets included in another page, (this is called transclusion). This is useful for text that is often repeated. For example, create a page called "Template:Main article" with the text
+
{{Main|Help:Editing/Template}} A template is a page that gets included in another page, (this is called transclusion). This is useful for text that is often repeated. For example, create a page called "Template:Main article" with the text
 
:<code><nowiki>''</nowiki></code>The main article for this is <code><nowiki>[[{{{1}}}]].''</nowiki></code>
 
:<code><nowiki>''</nowiki></code>The main article for this is <code><nowiki>[[{{{1}}}]].''</nowiki></code>
 
and then to use the template insert "<nowiki>{{Main article|Whatever}}</nowiki>" where you want that text to appear.
 
and then to use the template insert "<nowiki>{{Main article|Whatever}}</nowiki>" where you want that text to appear.
  
==Talk pages==
+
== Talk pages ==
Don't leave visible notes and comments in the article. At the top of every article, the second tab entitled [[{{TALKPAGENAME}}|Discussion]], opens the articles "Talk page". This is where to dicuss the article or leave notes for other editors. Remember to sign you posts on talk pages, (second from last button). In articles to leave notes or explanations use HTML commenting. These will be hidden except from other editors. An HTML comment has the form:<code><nowiki><!--This is a comment.--></nowiki></code>.
+
Don't leave visible notes and comments in the article. At the top of every article, the second tab entitled Talk opens the articles talk page. This is where to dicuss the article or leave notes for other editors. Remember to sign you posts on talk pages, (second from last button). In articles to leave notes or explanations use HTML commenting. These will be hidden except from other editors. An HTML comment, which has the form:<code><nowiki><!--This is a comment.--></nowiki></code>, will work fine in Mediawiki.
  
 
== See also ==
 
== See also ==
*[[Help:Article style]]
+
* [[Help:Article style]]
*[[Help:References]]
+
* [[Help:References]]
*[[Help:Splitting and merging]]
+
* [[Help:Splitting and merging]]
 +
* [[Help:Reusing content from other wikis]]
 +
 
 +
== References ==
 +
* [http://en.wikipedia.org/wiki/Wikipedia:Writing_better_articles Wikipedia:Writing better articles].
  
 
== Further reading ==
 
== Further reading ==
 
* [http://en.wikipedia.org/wiki/Help:Wiki_markup Wiki markup] on Wikipedia
 
* [http://en.wikipedia.org/wiki/Help:Wiki_markup Wiki markup] on Wikipedia
 
* [http://www.mediawiki.org/wiki/Help:Formatting Wiki markup] on Mediawiki
 
* [http://www.mediawiki.org/wiki/Help:Formatting Wiki markup] on Mediawiki
* [http://www.mediawiki.org/wiki/Help:Contents MediaWiki Handbook]
+
* The [https://www.mediawiki.org/wiki/Help:Contents MediaWiki Handbook], further documentation to help you edit this wiki.
  
==References==
+
== External links ==
*[http://en.wikipedia.org/wiki/Wikipedia:Writing_better_articles Wikipedia:Writing better articles].
+
* [http://stackoverflow.com/questions/2833263/convert-from-microsoft-word-to-media-wiki-markup-style Convert from Microsoft Word to Media Wiki markup], stackoverflow
  
 
[[Category:Help:Editing]]
 
[[Category:Help:Editing]]

Latest revision as of 19:55, 30 June 2019

The MediaWiki software is extremely easy to use. Viewing pages is self-explanatory, but adding new pages and making edits to existing content is extremely easy and intuitive as well. Editing SDIY wiki is much the same as editing on Wikipedia.

Editing rules and conventions

The number one rule of wiki editing is to be bold. Go ahead – make changes. No damage can be done that can't be easily fixed.

An edit can contribute whole new paragraphs or pages of information, or it can be as simple as fixing a typo or a spelling mistake. In general, try to add or edit text so that it is clear and concise.

Editing the wiki

At the top of any wiki the page, you will see some tabs titled Page, Talk, Edit, History, Move And Watch. Clicking the edit tab opens the editor, a large text entry box in the middle of the page. This is where to enter plain text. Unlike regular websites using HTML and CSS, very little formatting code (known as "wiki markup") is required. At the top of this text entry box is a row of buttons with small icons on them. Holding the mouse cursor over an icon displays a tool-tip telling you its function. These buttons make it very simple to use the formatting features of the wiki software. You can achieve the same effect by typing the correct wiki code, however using the buttons makes it very simple and also eases the process of learning the correct code syntax. Please do your best to always fill in the edit summary field.

By default an enhanced editing toolbar is disabled. To enable it go to Preferences:Editing and tick Enable enhanced editing toolbar.

Try it out on the sandbox page

Use the sandbox page to play around and experiment with editing. It isn't for formal wiki info, just a place to play and explore. Any content here won't be preserved. You can create your own sandbox area by appending "/sandbox" to the URL of your user page, or click the Sandbox link in the personal toolbar area, if enabled in your preferences. Your own sandbox is where to rough out articles until they're ready for posting. Don't do articles in rough in the main wiki. Sandboxes will be indexed by search engines like any other page, unless the first line is __NOINDEX__ or {{User sandbox}}.

Creating links and adding pages

The third and fourth buttons are create "Internal link" and "External link". The third button creates an internal link (aka a wikilink) which, in the editor, has the format [[Eurocard]] ie. surrounded by double square brackets. Use a vertical bar "|" (the "pipe" symbol) to create a link with a different name to original article eg. [[Printed circuit board|PCB]], only PCB appears on the page.

Only the first occurence of a link on the page needs to be the link, any further uses of the word/phrase can be in plain text. If the page doesn't exist already the link will be in shown with red text. Following a redlink opens up the editor window for creating that page within the wiki structure. Linking articles in a structured way is the preferred method of adding new pages to the wiki. Except for names, use ordinary sentence case for article titles.

Using the fourth button will make an external link to a page elsewhere on the Internet. This has the form [http://www.google.com Google], ie. the URL, followed by a space, followed by linking text in single square brackets.

Every article is part of a network of connected topics. Establishing such connections via internal links is a good way to establish context. Each article should be linked from more general subjects, and contain links where readers might want to use them to help clarify a detail. Only create relevant links. When you write a new article, make sure that one or more other pages link to it. Ideally there would be an unbroken chain of links leading from every article in the wiki to the Main Page.

Always preview your edits before saving them and also check any links you have made to confirm that they do link to where you expect.

See also Wikipedia:Manual of Style/Linking

Headings

Headings help clarify articles and create a structure shown in the table of contents.

Headings are hierarchical. The article's title uses a level 1 heading, so you should start with level 2 heading (==Some heading==) and follow it with a level 3 (===A sub-heading===, and just use '''Text made bold''' after that). Whether extensive subtopics should be kept on one page or moved to individual pages is a matter of personal judgment.

Headings should not be links. This is because headings in themselves introduce information and let the reader know what subtopics will be presented; links should be incorporated in the text of the section.

Except for names, use ordinary sentence case for headings, also don't have all words with initial caps.

Lists

In an article, significant items should normally be mentioned naturally within the text rather than merely listed. Where a "bulleted list" is required each item/line of the list is preceded by an asterix (*) or for indenting a sublist use two asterixes **). For numbered lists use a hash sign (#) and further hash signs for subsections. Lists of links are usually bulleted, giving each link on a new line.

Capacitors

Capacitors are passive components ...

  • Ceramic
  • Electrolytic
    • Aluminum
    • Tantalum
  • Polyester
    Replacing polystyrene
  • Polypropylene

Definition lists

Are useful for more than just terms and definitions. Use semi-colons and colons:

Some term – this line starts with ;
And then a definition – this line starts with a :

Images

File names should be clear and descriptive, without being excessively long. It is helpful to have descriptive names for editors. Very generic filenames should not be used when uploading, as sooner or later someone else will use same name and this will overwrite the first file.

Finding images

Hotlinking

Hotlinking from from Wikimedia Commons is allowed. You can first upload your file there, but be sure to use a long descriptive or unique file name. This is to avoid name clash. When files have the same name, some other other file might be displayed locally instead of the one expected.

See also Commons:Reusing content outside Wikimedia/technical.

Hotlinking is not recommended because anyone could change, vandalise, rename or delete a hotlinked image. There is no control over what is served locally. If you do hotlink, then it is still necessary to follow any licensing conditions.

Generally hotlinking is wrong because it exploits another servers bandwidth to supply the files. For files on sites other than Wikimedia, don't link directly to those files without permission. Either download a copy from the other site and then upload it to the wiki, or link to the other site's page on which the file can be found.

Schematics

For quickly illustrating articles with simple schematics, there are some suggestions listed at StackExchange EE:Good Tools for Drawing Schematics and at Wikipedia:Project Electronics/Programs.

Illustrations

An article without at least one illustration seems incomplete. Just a few images can help to explain complex ideas. If not photographs then here are a few applications for creating images, that may be worth investigating:

Other file types

See Help:Editing/Multimedia

Tables

Use wiki markup not HTML nor images. The easiest way to work with tables is to use Microsoft Excel. Paste and edit or create a table in Excel, then copy the table into the tab-delimited string to wiki markup converter. Other methods are described at Commons:Convert tables and charts to wiki code.

Enabling the enhanced editor in user preferences, gives an Insert a table button. Clicking this produces the following.

{| class="wikitable"
|-
!header1!!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
|}

Which displays as

header1 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

For more in depth information on table markup see Wikipedia:Help:Table.

Formatting

Be sure to keep your content meaningful. Relying on styling to indicate meaning is a bad practice (e.g. for machine readability such as by search engines, screen readers using text-to-speech, and text browsers).

Inline styling

See Mediawiki:Help:Formatting.

Inline CSS styling

Some HTML tags and inline styling is allowed, for example <code>, <div>, <span> and <font>. These apply anywhere you insert them but depend upon which fonts are installed on the client. Here is an example using <span style="font-family:Courier;font-size:100%;color:#0000ff;background-color:#dddddd"></span>.

Indenting text

Use a colon : to indent text.

Subscript and superscript

Foo<sub>Bar</sub> gives FooBar and Bar<sup>Baz</sup> gives BarBaz.

Inserting symbols

Symbols and other special characters can be inserted through HTML entities. For example &Omega; will show Ω and &gt; will show >. These are case-sensitive. For a list of HTML entities see Wikipedia:List of HTML entities

Text boxes

For preformatted text (in a dashed box) simply indent it by one space. Inline styling allows more options e.g. <div style="background: #eeffff; border: 1px solid #999999; padding: 1em; width:88%;">

Mathematical

See Help:Editing/Mathematical

Categories

Add one or more categories to pages or uploaded file, by simply adding eg. [[Category:Whatever]]. Categories themselves need to be categorised to create a hierarchy for navigating through the wiki.

Standard appendices

Information that can follow after the body of the article should follow in this order:

  • Lists, e.g. a list of designs, or a table of usage
  • See also, a list of internal links to related articles
  • Notes and references
  • Further reading, a list of recommended relevant books, articles, or other publications that have not been used as sources
  • External links, a list of recommended relevant websites that have not been used as sources

Templates

A template is a page that gets included in another page, (this is called transclusion). This is useful for text that is often repeated. For example, create a page called "Template:Main article" with the text

''The main article for this is [[{{{1}}}]].''

and then to use the template insert "{{Main article|Whatever}}" where you want that text to appear.

Talk pages

Don't leave visible notes and comments in the article. At the top of every article, the second tab entitled Talk opens the articles talk page. This is where to dicuss the article or leave notes for other editors. Remember to sign you posts on talk pages, (second from last button). In articles to leave notes or explanations use HTML commenting. These will be hidden except from other editors. An HTML comment, which has the form:<!--This is a comment.-->, will work fine in Mediawiki.

See also

References

Further reading

External links