From NuGOwiki
Contents |
Section I
To add an image, the image file has to be uploaded. Also other files can be uploaded, see below. The system uses the term "image" for any uploaded file.
First give the file a suitable name, because renaming during or after uploading is not possible. Make sure that the file name has the proper extension.
On uploading, a destination filename can be specified, so the file name on the project need not be the same as the name under which it is stored locally.
With the file an image page (also called "image description page") will be associated, with a page name consisting of the file name (including extension), prefixed with "Image:" (or in general the value of variable {{ns:Image}}). Thus the file names are case-sensitive (this applies even for the file name extension) except for the first character.
To upload a file, first ensure you are logged in, and then click on the Upload file link in the toolbox menu on the left hand side of the page.
File name
If you want to replace an existing file, give it the same name, and otherwise a name that does not exist yet. Try to give it a short but descriptive name.
(Below "image" can be read as "file", though some complications, like duplicate names blocking access, are specific for embedding images.)
Choose a name for an image as carefully as you would choose an article name, and use proper spacing and capitalization: the name may not be visible in a page that embeds the image, but it is, for example, on the page for a category that contains the image.
Supported file types; miscellaneous
Apart from text, the NuGOwiki supports the following media inline:
Currently the following file types can be uploaded:
- Graphics files: 'png', 'gif', 'jpg'/'jpeg',
- Document Files: 'pdf','doc', 'xls'
There may be a size limit, the largest one on en: is 6.5 megabytes (but please be reasonable).
Linking
To link to an uploaded file, e.g. test.pdf, use [[Media:test.pdf]] instead of [[Image:test.pdf]], giving Media:test.pdf; to link to the image description page, use [[:Image:test.pdf]], giving Image:test.pdf (the first colon is not displayed).
Piped links work as usual.
External link syntax is as usual. However, if you want a link to an image proper on a page of a project that allows embedded external images, use a bracketed link syntax and not just the URL, to prevent embedding.
For using an image as a link to another document, see Help:Navigational image.
Embedding images
Only images proper can be automatically presented, sound is not automatically played.
An embedded internal image automatically links to the image page, which shows the full image, or, depending on preferences, a reduced version with a link to the full version. The page also provides info about the image.
To add the uploaded image to an article as a thumbnail, one can use [[Image: image name including extension |thumb|caption]] or [[Image: image name including extension |thumb|width in pixels px|caption]].
The default thumbnail width can be set in the preferences, so typically it is better not to specify "px", in order to respect the users' preferences (unless, for a special reason, a specific size is required regardless of preferences, or a size is specified outside the range of widths 120-300 that can be set in the preferences).
The caption can contain links. This format allows both size reduction and enlargement. Both the image itself and an icon link to the image page. The icon has the link title "Enlarge" in its hoverbox, even in cases where the image on the image page is smaller. Depending on preferences the image on the image page may be smaller than the thumbnail image, so a link may be convenient from the thumbnail straight to the image in actual size. E.g. [[image:Icon Idea.png|thumb|50px|[[Media:Icon Idea.png|actual size]]]]
Image at the left
[[image:Icon Idea.png|left|thumb|50px|[[help:contents|demo]]]] puts the image at the left; text that follows floats to the right of it; if a second image immediately comes after the first, the second abuts to the right side of the first; if there is text in between then the second image is at the lower right of the first, under this text:
This is an image of a bulb between the 3rd and 4th images. Some other text that is not very interesting but this is just a demo so who cares after the 4th image.
With [[image:Icon Idea.png|none|thumb|50px|[[help:contents|demo]]]] the image is put at the left, and text that follows starts below it.
Image at the right
[[image:Icon Idea.png|right|thumb|50px|[[help:contents|demo]]]] puts the image at the right; text that follows floats to the left of it. The situation is not symmetric with the case above: a second image is put at the extreme right again, under the first.
Inline images
Inline images cannot have a caption, but they can have a "title"-attribute (often misidentified as the "alt" attribute, which has a different purpose), which is shown in the hoverbox (in the cases above, for the image it is the same as the caption, and for the enlarge icon it is "Enlarge"). It is the last item of the image code, hence, if there is only the image name with prefix "image:" it gives that; if there is an empty item by ending with a pipe character ("|") it gives none; otherwise, it gives the image code item that happens to be last, unless a proper text is specified.
The size of the images can be reduced but they can not be enlarged.
Example (note the hoverbox too): "text [[image:Icon Idea.png]] text [[image:Icon Idea.png|5px|]] text [[image:Icon Idea.png|500px|demo]] text" gives "text File:Icon Idea.png text File:Icon Idea.png text File:Icon Idea.png text".
In the last example, in 1.5 the width is as specified, but the height is the original one.
See also below.
Redirection
An image tag specifying an image can not be made to embed another image through a redirect. There is more flexibility if an image is embedded by calling a template that contains the image, because a template can be redirected to another one.
Embedding external images
If enabled ($wgAllowExternalImages = true; in LocalSettings.php) on this project there is an image here, otherwise just a link to an image: http://en.wikipedia.org/upload/b/bc/Wiki.png
The wiki markup text used for this image is simply the raw url of the image, ie http://en.wikipedia.org/upload/b/bc/Wiki.png. It can be shown in actual size only.
If necessary, download an image of a project and upload a copy into the Commons project, you can then use it on all projects.
The examples in what follows are intended for projects in which embedding is enabled.
To use an image as a link to a specified page (either external URL or an internal wiki page) see navigational image.
If enabled, use unbracketed external link style, i.e. just the URL (of the image itself, not of the image description page), e.g. http://en.wikipedia.org/upload/d/d1/Tile_Hill_train_550.jpg. The URL can be found by checking with your browser the properties of the image when it is displayed on a webpage.
Conversely, to go to the image description page of an image referred to with external link style, put the URL in the address bar and replace "upload/alphanumerics/alphanumerics/" with "wiki/image:".
For inline images, put the url, preceded and followed by a space, in the text: a http://upload.wikimedia.org/wikipedia/commons/2/27/Icon Idea.png b gives a http://upload.wikimedia.org/wikipedia/commons/2/27/Icon Idea.png b
Without special formatting, inline images are positioned like this:
text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text http://en.wikipedia.org/upload/b/bc/Wiki.png text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text
A table may be used to position the image(s) as desired. E.g.
{|
| http://en.wikipedia.org/upload/b/bc/Wiki.png
|
| http://en.wikipedia.org/upload/b/bc/Wiki.png
|-
|
| http://en.wikipedia.org/upload/b/bc/Wiki.png
|
|}
gives
| http://en.wikipedia.org/upload/b/bc/Wiki.png | http://en.wikipedia.org/upload/b/bc/Wiki.png | |
| http://en.wikipedia.org/upload/b/bc/Wiki.png |
Section II
Uploading
Before uploading please ensure that you have rights to upload and redistribute the image(s) in question, and that they comply with any further licensing requirements of the Wikimedia Commons project and other criteria for inclusion.
In the menu on the left under "toolbox" you will have a link named "Upload file". On the following page on most browsers, you will see a "Browse..." button, which will bring up your operating system's standard file open dialog.
Choosing a file will fill the name of that file into the text field next to the button. You must also check the box affirming that you are not violating any copyrights by uploading the file. Press the "Upload file" button to finish the upload. This may take some time if you have a slow internet connection.
The preferred formats are JPEG for photographic images, PNG for drawings and other iconic images, and OGG for sounds. Please name your files descriptively to avoid confusion.
When a file is uploaded with the same name as an existing one, the old one is replaced. If that is not the intention one has to check in advance that the same name does not exist yet, because currently the system does not warn against overwriting. For example, click on http://meta.wikipedia.org/wiki/Image:A and replace the A in the address bar of the browser with the file name. Alternatively use the search feature in Special:Imagelist.
When a media file is replaced by uploading a new one with the same name (e.g. an image in an article is replaced), this does not show up in the page history of the article, nor in the Related changes of the article, nor in the revision history of the image description page (unless the description section is also changed). However, it is recorded in the Image History section of the image description page, and it changes Meta:Upload log. Therefore, to watch changes in images in an article, it is not sufficient to watch the article itself and the image description pages ("watching" in the sense of putting on the list of "watched pages"), but one should watch the Upload log also.
Special:Imagelist provides the same information as the Upload log, but it uses the user's local time instead of the default time (set to Coordinated Universal Time for Wikimedia projects). In addition it gives the file sizes. Further it allows loading of portions and sorting by size in addition to sorting by date, and it has not only links to the image description pages, but also directly to the images.
- Last 50 uploaded files
- MediaWiki file usage - technical notes
Uploading non-image files
You may find php and apache limit the filesize of uploads too giving spurious messages on the upload page such as "The file you uploaded seems to be empty. This might be due to a typo in the file name. Please check whether you really want to upload this file." See Q: What affects the maximum file size which can be uploaded? on this page for details: http://meta.wikimedia.org/wiki/Uploading_files#Frequently_Asked_Questions. (It might be better to have this information conglomerated more centrally).
Take in account there is a blacklist of file extensions in includes/DefaultSettings.php:
- $wgFileBlacklist = array(
- # HTML may contain cookie-stealing JavaScript and web bugs
- 'html', 'htm',
- # PHP scripts may execute arbitrary code on the server
- 'php', 'phtml', 'php3', 'php4', 'phps',
- # Other types that may be interpreted by some servers
- 'shtml', 'jhtml', 'pl', 'py',
- # May contain harmful executables for Windows victims
- 'exe', 'scr', 'dll', 'msi', 'vbs', 'bat', 'com', 'pif', 'cmd', 'vxd', 'cpl' );
Revision history of pages containing images
Pages in the stored page history consist of wikitext with possible references to templates and images. When viewing an old version of a page, these refer to the current versions of the templates and images, if these still exist. Thus the former composite page is not reconstructed.
Linking to an enlarged image
Unfortunately, when linking to an image, no parameters can be specified except the link label, e.g. bullet. Also, when linking to a template instead of embedding it, transfer of parameters is not possible.
Thus one cannot link to an enlarged image unless one has prepared a page containing that enlarged image, e.g. help:Icon Idea.png (large). The large image has been put here in the Help namespace, alternatively it could have been in:
- the image description page (in that case some scrolling is required to see the image history and the pages using the image, but this can be made more convenient with a TOC)
- its talk page (ditto, to see the talk)
- a separate page in the image namespace, like Image:Icon Idea.png (large).
Protection
Protection of an image page is automatically also protection of the image itself: i.e. a new image under the name of the existing image can only be uploaded by a sysop.
WikiTeX
WikiTeX ([1]) is an extension that can produce graphs of functions, various diagrams, etc. It is operational at http://wikisophia.org/ , but not yet on NuGOwiki. Note that one can anyway produce an image on Wikisophia, and subsequently upload it on any MediaWiki project.