Difference between revisions of "Help"

From Freephile Wiki
Jump to navigation Jump to search
(link to Yaron's book)
(One intermediate revision by the same user not shown)
Line 1: Line 1:
For a printed reference on MediaWiki, get Yaron Koren's book ''"[http://workingwithmediawiki.com/ Working With MediaWiki]"''
 
 
A fully free online version is at http://workingwithmediawiki.com/book/
 
 
 
{{Template:Categorypage|Help}}
 
{{Template:Categorypage|Help}}
  
Line 32: Line 28:
  
 
=== Images ===
 
=== Images ===
 +
 +
 +
 +
 
<nowiki>[[Image:foo.jpg]]</nowiki> produces an image  You must first upload the image.  You can not embed external images, with the notable exception that you CAN use 1.5 million images available in the commons project.
 
<nowiki>[[Image:foo.jpg]]</nowiki> produces an image  You must first upload the image.  You can not embed external images, with the notable exception that you CAN use 1.5 million images available in the commons project.
 +
 +
 +
 +
 
<nowiki>[[Media:foo.pdf]]</nowiki> would produce a link to a pdf document, so
 
<nowiki>[[Media:foo.pdf]]</nowiki> would produce a link to a pdf document, so
 +
 +
 +
 +
 
<nowiki>[[Media:Ejbdesignpatterns.pdf]]</nowiki> produces a link to http://freephile.com/wiki/images/6/6d/Ejbdesignpatterns.pdf
 
<nowiki>[[Media:Ejbdesignpatterns.pdf]]</nowiki> produces a link to http://freephile.com/wiki/images/6/6d/Ejbdesignpatterns.pdf
 
* [[mw:Help:Images]]
 
* [[mw:Help:Images]]
 +
  
 
== Using External Editors ==
 
== Using External Editors ==
Line 47: Line 56:
  
 
=== Linked Images ===
 
=== Linked Images ===
By default, when you show an image in mediawiki, it links to it's description page.  Sometimes, you want to use an image to link to a page of your choice.  Starting in v. 1.14 you can link to an article by using the <code>link=</code> attribute in your image.  See [[mw:Manual:Linked_images| many ways to make mediawiki link images]]
+
By default, this system is configured to show an image and link to it's description page.  Sometimes, you want to use an image to link to a page of your choice.  There are [[mw:Help:Linked_images| many ways to make mediawiki link images]], but the most convenient that we settled on here is to use the [[mw:Extension:Icon|Icon extension]]
 +
The syntax (described at [[Icons]]) is
 +
<pre>
 +
{{#icon: Info.png|Info|24|floatright|Special:Help}}
 +
</pre>
 +
 
 +
To get your image to float left or right, wrap the
 +
 
 +
 
 +
 
 +
 
 +
<nowiki>{{#icon}}</nowiki> in a div with the appropriate class like so:
 +
 
 +
 
 +
 
 +
 
 +
<nowiki><div class="floatright">{{#icon}}</div></nowiki> Although I modified the Icon extension to be able to specify a class in the icon tag itself, the extension now reveals some weaknesses that make me want to change to the LinkedImage extension http://www.mediawiki.org/wiki/Extension:LinkedImage

Revision as of 09:16, 13 January 2009


Help:Contents-mw shows a local copy of the MediaWiki Handbook (with links to the original) Later, I imported a large collection of the MediaWiki Handbook so the Help:Contents article locally should be a good place to start without taking you off this website.


Some more helpful information, especially local customizations starts below.


What's Wikipedia?

  1. http://wikipedia.org - the largest encyclopedia in the world. Introduction at http://wikipedia.org/wiki/Wikipedia:About
  2. Ten things you may not know about Wikipedia
  3. Ten things you may not know about images on Wikipedia

Using[edit | edit source]

  1. See the Help desk to ask questions
  2. See the MediaWiki mw:Help:Contents for a much greater resource than what is found locally here.

This site uses a customized theme which means that the links are in different areas. Specifically, the main links are in the left navigation column, while "special" links are at the top margin and bottom of each page.

Editing Information[edit | edit source]

Adding or editing articles is very easy. There is a large volume of "help" information available at the main wikipedia site, so that effort is not reproduced here.

  1. See the Help Table of Contents
  2. http://en.wikipedia.org/wiki/Help:Editing
  3. See the Editor's Handbook
  4. The Cheatsheet (which includes links to the print cheatsheets)
  5. What HTML is allowed?

Images[edit | edit source]

[[Image:foo.jpg]] produces an image You must first upload the image. You can not embed external images, with the notable exception that you CAN use 1.5 million images available in the commons project.



[[Media:foo.pdf]] would produce a link to a pdf document, so



[[Media:Ejbdesignpatterns.pdf]] produces a link to http://freephile.com/wiki/images/6/6d/Ejbdesignpatterns.pdf


Using External Editors[edit | edit source]

You can even use tools like OpenOffice or Eclipse to edit this wiki.

Editing from OpenOffice[edit | edit source]

http://extensions.services.openoffice.org/project/wikipublisher Sun has a new extension to OpenOffice that allows you to write wiki articles from right in your word processor.

Advanced Editing and Customization[edit | edit source]

Please see documentation on customizing the interface and the User's Guide for usage and configuration help.

Linked Images[edit | edit source]

By default, this system is configured to show an image and link to it's description page. Sometimes, you want to use an image to link to a page of your choice. There are many ways to make mediawiki link images, but the most convenient that we settled on here is to use the Icon extension The syntax (described at Icons) is

{{#icon: Info.png|Info|24|floatright|Special:Help}}

To get your image to float left or right, wrap the



{{#icon}} in a div with the appropriate class like so:



<div class="floatright">{{#icon}}</div> Although I modified the Icon extension to be able to specify a class in the icon tag itself, the extension now reveals some weaknesses that make me want to change to the LinkedImage extension http://www.mediawiki.org/wiki/Extension:LinkedImage