Difference between revisions of "Help"

(About Images)
Line 6: Line 6:
 
===What should we cover in documentation===
 
===What should we cover in documentation===
 
Simple said - everything. But for a start, focus on explaining available features. Give no hacks or custom modifications anywhere on the wiki page. If you find necessary to include some hack as a reference, link it to the forums.
 
Simple said - everything. But for a start, focus on explaining available features. Give no hacks or custom modifications anywhere on the wiki page. If you find necessary to include some hack as a reference, link it to the forums.
 +
 +
==About MediaWiki Markup==
 +
Mediawiki have a very strong markup so try to keep it as simple as possible<br/>
 +
 +
===H2 H3 H4 and H5 tags===
 +
To create headings on the page, you need to use desired numbers of = character
 +
<nowiki>==This is the H2 Heading==<nowiki><br/>
 +
<nowiki>===This is the H3 Heading===<nowiki><br/>
 +
<nowiki>====This is the H4 Heading====<nowiki><br/>
 +
<nowiki>=====This is the H5 Heading=====<nowiki><br/>
 +
H1 heading is also availably by
 +
<nowiki>=This is the H1 Heading=<nowiki><br/>
 +
'''but do not use this heading in your articles under any circumstances'''<br/>
 +
It is the same as page title, and can be confusing
 +
  
 
==About Images==
 
==About Images==

Revision as of 20:55, 22 January 2013

Overwiew

The tutorial bellow is designed for wiki administrators to explain some common practices we will impose on this wiki.
Please read through it completely

What should we cover in documentation

Simple said - everything. But for a start, focus on explaining available features. Give no hacks or custom modifications anywhere on the wiki page. If you find necessary to include some hack as a reference, link it to the forums.

About MediaWiki Markup

Mediawiki have a very strong markup so try to keep it as simple as possible

H2 H3 H4 and H5 tags

To create headings on the page, you need to use desired numbers of = character ==This is the H2 Heading==<nowiki><br/> <nowiki>===This is the H3 Heading===<nowiki><br/> <nowiki>====This is the H4 Heading====<nowiki><br/> <nowiki>=====This is the H5 Heading=====<nowiki><br/> H1 heading is also availably by <nowiki>=This is the H1 Heading=<nowiki><br/> '''but do not use this heading in your articles under any circumstances'''<br/> It is the same as page title, and can be confusing ==About Images== In wiki guides and explanations, try to use as many images as possible, but dont go crazy with them. Try to explain as many things as possible with one single image.<br /> As an wiki admin, you can access the media upload by visiting the [[Special:Upload]] page. <br/> To see list of all files that are already uploaded to wiki, visit this page [[Special:ListFiles]]<br/> The list of already available files is particularly useful for those images that can be reused in different tutorials.<br/> For example, you dont have to upload new file to show user how to access JomSocial configuration page as this file already exist. [[File:jsconfigmenu.png|250px]]<br /> '''Note''' - the image is resized for the purpose of this help. You wont resize images in your articles as you want users to clearly see what to do without clicking the image thumb.<br/> [[Setting Up Photo Galleries|Example]]<br/> You can also upload your reusable images, but try to reuse them as much as you can whenever is possible. For every new article that will include some Back End image, use the images from Joomla 3. Make sure that name of your test site is '''JomSocial Docs''' as shown on the image above.<br/> If you're about to post image regarding external source, please use alert like on [[Setting up Cron Job|this example]] ==About Alerts== There are 4 types of alerts available in bootstrap. These are * danger or error * info * success * no class ====Danger Alert==== Use this alert when you want to make clear that user should be extra careful * syntax <pre>{{alert|<strong>Warning:</strong> This is the warning|alert-danger}} or {{alert|<strong>Warning:</strong> This is the warning|alert-error}}</pre> * output {{alert|<strong>Warning:</strong> This is the warning|alert-danger}} ====Info Alert==== When you need to add some info notices, use this alert * syntax <pre>{{alert|<strong>Info:</strong> This is the info|alert-info}}</pre> * output {{alert|<strong>Info:</strong> This is the info|alert-info}} ====Success Alert==== Also known as '''happy alert''' is used when you need to outline something good or useful * syntax <pre>{{alert|<strong>YAY:</strong> That is great success|alert-success}}</pre> * output {{alert|<strong>YAY:</strong> That is great success|alert-success}} ====No Class Alert==== This is the default bootstrap alert.Use it when you have something important to outline, but its not dangerous to proceed with * syntax <pre>{{alert|<strong>Default:</strong> No class|alert}}</pre> * output {{alert|<strong>Default:</strong> No class|alert}} ==Popovers== If you really want to go fancy with your articles, you can use bootstrap popovers * syntax <pre>{{pop|Whatever triggers the popover|Popover Title|Popover Content}}</pre> * output {{pop|Whatever triggers the popover|Popover Title|Popover Content}}