Difference between revisions of "Quickie Wiki Intro"

From Second Life Wiki
Jump to navigation Jump to search
m (torley's wiki tut added)
m (→‎Related Topics: Remoção de link inexistente)
 
(19 intermediate revisions by 11 users not shown)
Line 1: Line 1:
{{Multi-lang}}
{{Help|Wiki=*}} {{Navbox/Wiki}}
 
{|
{|
|-
|-
Line 7: Line 6:
==Welcome!==
==Welcome!==
<div style="padding: 0.5em">
<div style="padding: 0.5em">
We encourage new and existing Mentors and Apprentices arriving to create a Wiki Profile Page for yourself on the Second Life Wiki so people can always find you.  ''This is particularly useful for those with language abilities or other skills.''
This article explains how to create an article as well as some basic editing techniques and wiki etiquette.  Read the main article text first; refer to footnotes for additional details.
 
In case you feel totally lost with editing a page, please contact (list to be updated soon) or add all your content and then write
:<font color="black"><nowiki>{{wikify}}</nowiki></font>
on top of your page. A more experienced editor will try to fix the style of your article afterward.
 
We encourage Wiki contributors arriving to create a Wiki Profile Page for yourself on the Second Life Wiki so people can always find you.  ''This is particularly useful for those with language abilities or other skills.''
   
   
You can detail information about yourself above and beyond what you normally would send out via SL Volunteer mailing list. Additionally, you can incorporate simple templates into your page which will automatically "register" your group role or abilities.
You can detail information about yourself above and beyond your inworld profile. Additionally, you can incorporate simple templates into your page that automatically "register" your group role or abilities.


Watch [http://www.youtube.com/watch?v=dCpzZWH_mas Torley's Wiki Video Tutorial @ YouTube].
Also watch [http://www.youtube.com/watch?v=dCpzZWH_mas Torley's Wiki Video Tutorial @ YouTube].
</div>
</div>
</div>
</div>
|valign="top" width=30%|
|valign="top" align="center" width=30%|
__TOC__
__TOC__
|}
|}
Line 24: Line 29:
;If you haven't already you must first Log In to the Second Life Wiki.  
;If you haven't already you must first Log In to the Second Life Wiki.  


*Click the '''LOG IN/CREATE ACCOUNT''' link at the top right of this page.  Use your ''IN-WORLD'' name and your ''IN-WORLD'' password.  
*Click the '''Log in''' link at the top right of this page.  Use your ''IN-WORLD'' name and your ''IN-WORLD'' password.  


*Once logged in, your name will appear at the top of the page.  Click your name.  It is a hyperlink which will take you to a page such as:  <font color="blue"><u><nowiki>https://wiki.secondlife.com/wiki/User:Your_Name</nowiki></u></font> and you will placed into EDIT mode (if the page doesn't exist).   
*Once logged in, your name will appear at the top of the page.  Click your name.  It is a hyperlink which will take you to a page such as:  <font color="blue"><u><nowiki>https://wiki.secondlife.com/wiki/User:Your_Name</nowiki></u></font> and you will placed into EDIT mode (if the page doesn't exist).   
Line 31: Line 36:
;Create Your Content
;Create Your Content


* If you are familiar with Wiki's, begin creating your Profile Page. Even if you're not familiar with Wiki's, put something in there that you can think of and is pertinent to your role as a mentor.  You can work on the formatting later.
* If you are familiar with Wiki's, begin creating your Profile Page. Even if you're not familiar with Wiki's, put something in there that you can think of and is pertinent to your Second Life.  You can work on the formatting later.


* In the very least, include the section on "Templates" below to register your skills and language abilities.
* In the very least, include the [[Quickie Wiki Intro/Usercategories]] to register your skills and language abilities.


* Review the [[Quickie Wiki Intro#What To Put Into Your Page|next section]] for a sample wiki content.  You can then customize from that point on.
* Review the [[Quickie Wiki Intro/Usercategories#What To Put Into Your Page|next section]] for a sample wiki content.  You can then customize from that point on.




Line 44: Line 49:


*If you are not able to figure out the wiki markup, contact the any number of [[:Category:SL Mentor Scribes|SL Mentor Scribes]] and ask them if they'll help you with your page.  Please note that there will need to be "sweat equity" on your part.  '''You''' will provide the content and the Mentor Scribes will help create your page in a nice, Wiki format. You can also add <font color="blue"><nowiki>{{wikify}}</nowiki></font> on top of your page to request a makeover of the current content of your page by an experienced Wiki user.
*If you are not able to figure out the wiki markup, contact the any number of [[:Category:SL Mentor Scribes|SL Mentor Scribes]] and ask them if they'll help you with your page.  Please note that there will need to be "sweat equity" on your part.  '''You''' will provide the content and the Mentor Scribes will help create your page in a nice, Wiki format. You can also add <font color="blue"><nowiki>{{wikify}}</nowiki></font> on top of your page to request a makeover of the current content of your page by an experienced Wiki user.
*You can categorize your userpage. Have a look at [[Quickie Wiki Intro/Usercategories]] for a manual.
</div></div>
</div></div>


<div id="box">
<div id="box">
==What To Put Into Your Page==
== How To Create A New Article ==
<div style="padding: 0.5em">
<div style="padding: 0.5em">
You'll need to think about what you're going to tell the other mentors and commit it in writing so it can be ''wiki-fied.'' Here is a sample markup
=== Create An Article In 3 Steps ===
:<font size="3" color="blue" face="courier" padding="1.0 em">I'm <b>YOUR NAME</B> from Germany. I am dedicated to the Second Life Volunteer program.  
 
:My goal is to help make the Second Life Volunteers second to none.  
So in case you'd like to create an article in the Wiki, you'd need to ensure that an article with the same topic isn't already in existence. To do so, you can either use the Wiki search{{footnote|Besides the basic search in the left sidebar, there is also a more advanced Wiki search at [[Special:Search]].}} or - recommended - use [http://www.google.com Google] for it. You can filter Google search results to the ones connected to the SL Wiki by entering
:I speak English and German and can script in LSL.
:<font color="black">site:wiki.secondlife.com KEYWORD</font>
:<nowiki>{{ISO_639-3/cat-speaking/Volunteers|eng}}</nowiki>
in the searchbar of [http://www.google.com google.com] with KEYWORD being the word or phrase you're searching for. So in case you'd like to write an article about ''Linden Bears'', you'd browse to Google and enter
:<nowiki>{{ISO_639-3/cat-speaking/Volunteers|deu}}</nowiki>
:<font color="black">site:wiki.secondlife.com Linden Bears</font>
:<nowiki>{{visl</nowiki>
You can now have a look at the search results and browse to the pages to <font color="blue">edit</font> them in case they are '''not''' in someones userspace. We'll come back to that [[#userspace_etiquette|later]].<br>
:<nowiki>|Mentors=*</nowiki>
If there is no article about your particular topic and you're sure that your article belongs here{{footnote|Please refrain from advertisement or spam.}}, you'll need to decide on the right ''namespace'' for it, depending on the content you'd like to contribute. For beginners, there are only two interesting namespaces: main namespace and userspace. So a general rule is: ''Userpages in userspaces''. Your page would count as a userpage in case it's somehow personalized to you.<br>
:<nowiki>|}}</nowiki>
For example: If [[User:Mia Linden|Mia Linden]] would want to write an article with the name: ''Mia's guide on how to create a Linden Bear'' she'd need to place it in her userspace. However, an article ''just'' about Linden Bears would be best in the mainspace.<br>
:<nowiki>{{skills</nowiki>
Depending on the namespace you chose, you can enter one of the following URLs in your web browsers navigation bar:
:<nowiki>|Builder=</nowiki>  
:<font color="black">mainspace:</font> <font color="blue"><nowiki>https://wiki.secondlife.com/wiki/</nowiki></font><font color="red">Your_Articlename</font>
:<nowiki>|Scripter=* </nowiki>
:<font color="black">userspace:</font> <font color="blue"><nowiki>https://wiki.secondlife.com/wiki/User:Your_Username/</nowiki></font><font color="red">Your_Articlename</font>
:<nowiki>|}}</nowiki>
with <font color="red">Your_Articlename</font> - you guessed it - beeing the name of your article, with underscores instead of blanks. The Wiki will tell you that the page you're trying to access hasn't got any text to display, but that you're able to edit - and therefore create - it. Press the provided <font color=blue><u>edit this page</u></font> link to access the editor and to start with your article.
</font>
 
This markup will give you a short and sweet introduction about yourself and state in words what your language abilities are and that you can script.
Procedure in short:
#Search if your proposed article is already existing
#Decide on the right namespace
#Create the article


The strange markups allow you to be automatically registered in the various pages. The markups themselves are not visible, but they produce a nice navigation at the bottom of the page, with your name registered. The example shows that you are a
=== Link And Categorize ===
{|
 
|-
While there is always the possibility to find your article via the internal or an external search engine, it is highly recommended to link it at related articles too. Visitors who are interested in one topic might also be interested in a related topic and therefor easily stumble upon it, in case it's linked. Have a look at [[Help:Contents]] on how to create links in the Wiki{{footnote|Note that there is a different syntax for internal and external links.}}.
|&nbsp;&nbsp;&nbsp;
 
|* Second Life Mentor
A nice way to sort and list articles of a certain topic are categories. You read about them in the ''Quickie Wiki Intro'' already and used templates to add your userpage to them. Categories will be displayed at the bottom of a page and list all pages which are in the same category, trying to sort them by name{{footnote|The sorting by articlename is only the default option. You can force your article beeing treated differently by defining a sort parameter. Read more at [http://www.mediawiki.org/wiki/Help:Categories MediaWiki Help:Categories].}}. Besides the use of specially designed templates, you can always register your page to a category by just writing
|&nbsp;&nbsp;&nbsp;
:<font color="black"><nowiki>[[Category:NAME OF THE CATEGORY]]</nowiki></font>
|* English speaking Resident
Although it looks like the syntax for a internal Wiki link, this code will '''not''' result in a simple link to the category{{footnote|You would need to write <nowiki>[[:Category:NAME OF THE CATEGORY]]</nowiki> in order to just create a link.}} but will register your page and display the category on the bottom of it. Therefore, it doesn't matter where to place the code on your page. However, it is considered as a good style to add it down on the bottom, so future editors can easily find it. To find the right category for your article, you can browse related articles and look at which categories they are registered, so they might fit for your article as well. There is also a [[Special:Categories|list of all current categories]] in the Wiki{{footnote|1=You can of course create your own ones as well. The right namespace would be the ''Category'' namespace: {{NoWrap|1=<font color="blue"><nowiki>https://wiki.secondlife.com/wiki/</nowiki></font><font color="red">Category:Your_Category</font>}}|2=You can of course create your own ones as well. The right namespace would be the ''Category'' namespace: https://wiki.secondlife.com/wiki/Category:Your_Category}}.
|-
|&nbsp;&nbsp;&nbsp;
|* English speaking Volunteer
|&nbsp;&nbsp;&nbsp;
|* German speaking Resident
|-
|&nbsp;&nbsp;&nbsp;
|* German speaking Volunteer
|&nbsp;&nbsp;&nbsp;
|* Scripter
|}


The above markup would produce a page that looks something like the following.
=== Move And Redirect ===
<div style="border: 1px solid #333333;">
{|
|-
|&nbsp;
|
<font color="black" size="+1"><b>User: Your Name</b></font>
----
<br/>
I'm Your Name from Germany. I am dedicated to the Second Life Volunteer program.  My goal is to help make the Second Life Volunteers second to none.  I speak English and German and can script in LSL.
<br/>
<div style="background-color: #EEEEEE; text-align: left; margin-right: 1em; border-right: 1px solid white; border-bottom: 1px solid white">
<div style="border: 1px solid #AAAAAA">
<div style="border-top: 1px solid white; border-left: 1px solid white">
<font color="blue"><u>Categories</u> | <u>Second Life Mentors</u> | <u>English speaking Volunteers</u> |  <u>English speaking Residents</u> | <u>German speaking Volunteers</u> |  <u>German speaking Residents</u> | <u>Scripter</u></font>
</div>
</div>
</div>
|}</div>


Even after some thoughtful thinking, it might happen that you missplace an article or find a name which describes it better. So you got the ability to move your (and almost any other){{footnote|There are only a few articles which aren't allowed to be edited or moved from normal users. These pages are listed at [[Special:Protectedpages]].|handle=protect}} article with the <font color="blue">move</font> link right next to the <font color="blue">history</font> link on top of the page. This will result in the whole page, including it's [[#History|editing history]], beeing moved. A redirect to the new spot will be created on the old page, so users who don't know the new article name will automatically be redirected to the new one. You can also manually create redirects from one page to another by entering
:<font color="black"><nowiki>#REDIRECT [[NAME]]</nowiki></font>
with ''NAME'' beeing the name where the page is supposed to redirect to. Please use this code only on empty pages.
</div></div>
</div></div>
<div id="box">
<div id="box">
==Templates==
== On Article Editing ==
<div style="padding: 0.5em">
<div style="padding: 0.5em">
When you include these special templates and categories at the bottom of your wiki content on your page, it will automatically register your User Profile Page as belonging to certain groups. For example:
===Tracking Changes===
:<font face="courier" color="blue"><nowiki>{{ISO 639-3/cat-speaking/Volunteers|eng}}</nowiki></font>
For basic users, there are three ways on how to track changes in the Wiki. All most recent changes are listed in the [[Special:Recentchanges|Recent Changes Log]]. You can filter this log so it only shows a particular namespace, hides minor edits, hides your own edits, etc. to be able to better keep track of what's going on. Since only a few users are interested in tracking ''all'' changes in the Wiki, it also has the so called ''Watchlist'' feature. Every page displays a <font color="blue">watch</font> button on top of the page which you can click to add the page to [[Special:Watchlist|your watchlist]].{{footnote|1=[[Special:Specialpages|Special pages]] are the only pages without a history, a discussion page and the ability to add them to the watchlist.|2=Special pages are the only pages without a history, a discussion page and the ability to add them to the watchlist|handle=specialpage}} In case a page on your watchlist has been changed, the Wiki will list the most recent change on that page in your watchlist. Pages on your watchlist will also be written in '''bold''' letters in the recent changes log. If you would like to remove a page from your watchlist again, just browse to that page and press the <font color="blue">unwatch</font> button.  
will register your User Profile Page as belonging on the [https://wiki.secondlife.com/wiki/Category:English_speaking_Volunteers English speaking Volunteers] and [https://wiki.secondlife.com/wiki/Category:English_speaking_Residents English speaking Residents] pages. It will also create the navigation bar at the bottom of your page that link to those pages.


====History====
As we learned before, any user can edit almost any page in the Wiki.{{footnote|handle=protect}} This might scare people from editing pages, since an edit isn't necessarily an improvement for an article. Therefor, the Wiki stores ''any'' edit ''ever saved'' to the page and logs them in the articles history. It logs ''date'', ''contributor'' and ''changes'', allows to <u>compare</u> versions and also allows to <u>undo</u> edits. You can find the blue <font color="blue">history</font> button on top of almost any page in the Wiki.{{footnote|handle=specialpage}} Have a look at [https://wiki.secondlife.com/w/index.php?title={{FULLPAGENAMEE}}&action=history this pages history] to become familiar with the feature.


;Language Templates
A list of common language codes [[Template:ISO_639-3/cat-speaking#Commonly used_language codes|can be found here.]]  There are two common ways to form this template:


:{| width="80%"
===Discussion Pages===
|-
Having the ability to edit and undo anything can lead to some frustration when two (or more) editors have different opinions on how an article should look like. In a worst case cenario, this can lead to an unwanted course of events known as ''editwar'' in the Wiki culture. Therefor, any Wiki page has a so called <font color="blue">discussion</font> page.{{footnote|handle=specialpage}} This page is supposed to provide a forum for suggestions on how to improve the article, as well as to handle disputes about it. Please use these pages to explain the intentions behind an edit, in case it might cause curriosity by another editor. The etiquette at a Wiki discussion page is a little different then at other articles. There are two main rules you need to have an eye on. These are
!Template
#Sign your edits with four tildes <nowiki>~~~~</nowiki> or the signature button [[Image:Button_sig.png]].<br>These will automatically be converted into your username and a timestamp once you saved the edit.{{footnote|You can change the way your signature looks like in the ''Nickname:'' box of [[Special:Preferences|your preferences]].}}
!Description
#'''<u>Never ever</u> change someone elses discussion entry'''.{{footnote|2=Changing of style, in order to fit the layout of the discussion page is O.K. but refrain from editing '''any''' content. In case you'd like to edit an old discussion entry of yours, because you have changed your mind on something, please use <nowiki><strike>old entry</strike></nowiki> to strike your old entry and write a short new note that you changed it (signed with four tildes again).|1=Changing of style, in order to fit the layout of the discussion page is O.K. but refrain from editing '''any''' content. In case you'd like to edit an old discussion entry of yours, because you have changed your mind on something, please use <nowiki><strike>old entry</strike></nowiki> to <strike>strike</strike> your old entry and write a short new note that you changed it (signed with four tildes again).}}
|-
These two rules are very important to ensure that people can keep track of the discussion. There are also other editing etiquette suggestions - called: ''ediquette'' - which you can find [[Template:Ediquette|here]].
|<font face="courier" color="blue"><nowiki>{{ISO&nbsp;639-3/cat-speaking|</nowiki><font color="red"><b>XXX</b></font>}}</font>
|This will establish your page as belonging to '''XXX-Speaking Residents''' group.  Substitute XXX with the appropriate language code found on [[Template:ISO_639-3/cat-speaking#Commonly used_language codes|this page.]]
|- style="background:#F8F8F8;"
|<font face="courier" color="blue"><nowiki>{{ISO&nbsp;639-3/cat-speaking/Volunteers|</nowiki><font color="red"><b>XXX</b></font>}}</font>
|This will establish your page as belonging to '''XXX-Speaking Residents''' AND '''XXX-Speaking Volunteers''' groups.  Substitute XXX with the appropriate language code found on [[Template:ISO_639-3/cat-speaking#Commonly used_language codes|this page.]]
|}
If your language doesn't appear on the list of common languages, follow this link to to the [[Template:ISO_639-3/cat-speaking/code generator|Code Generator]] by [[User:SignpostMarv Martin]].




;Bulk Group Templates (visl)
===Uploading Pictures===
This template is simple to use and is described in the following table. Simply copy the entire blue section into your profile page, and add an asterisk to the elements that pertain to you.
Unlike some other websites, the SL Wiki can not display external images.{{footnote|1=This is for security reasons, rather then being a limitation of the Wiki itself. See {{Jira|WEB-11}}.|2=This is for security reasons, rather then being a limitation of the Wiki itself. See WEB-11.}} However, you are allowed to upload your images to the Wiki in order to display them in your article.{{footnote|Note that you need the copyrights on the image you'd like to upload. With every edit and upload, you automatically agree with the [[Project:Contribution Agreement|Contribution Agreement]].}} The toolbox in the left sidebar provides a link called [[Special:Upload|Upload file]]. Just browse there, search the picture on your HD and then upload it to the Wiki. Note that there is a recommended file size limitation of 150kb per file, in order to save load on the database and to keep Wiki sites fast. Remember that every user who browses to your article will need to download the file to the browsers cache and not everyone has a fast internet connection which can handle it in a reasonable amount of time.<br>
:{|  width="80%"
Add a picture to your page with
|-
:<font color="black"><nowiki>[[Image:Your_Image.jpg]]</nowiki></font>
!Code
with <font color="black">Your_Image.jpg</font> being the name of your image. It is also possible to change the width of the image to a certain amount of pixels or to align it left, right or in the center. Your picture with the width of 100 pixels and aligned to the right would need the following code:
!Description
:<font color="black"><nowiki>[[Image:Your_Image.jpg|100px|right]]</nowiki></font>
|-
You can even display the picture as a thumbnail of a certain width and add describing text beneath it via
|<font face="courier" color="blue"><nowiki>{{visl</nowiki></font>
:<font color="black"><nowiki>[[Image:Your_Image.jpg|thumb|100px|some describing text]]</nowiki></font>
|Opening tag - required
All these are combinable, so play around with them to become a feeling for it. Don't forget to use the ''Show preview'' button, rather then the ''Save page'' button, in order to keep the recent changes log and the database clean. It's part of the previously mentioned [[Template:Ediquette|ediquette]].
|- style="background:#F8F8F8;"
</div></div>
|<font face="courier" color="blue"><nowiki>|Greeters=</nowiki></font>
|Adds your User Profile Page to the '''Second Life Greeters''' group.
|-
|<font face="courier" color="blue"><nowiki>|Mentors=</nowiki></font>
|Adds your User Profile Page to the '''Second Life Mentors''' group
|- style="background:#F8F8F8;"
|<font face="courier" color="blue"><nowiki>|Helpers=</nowiki></font>
|Adds your User Profile Page to the '''Live Helpers''' group
|-
|<font face="courier" color="blue"><nowiki>|Instructors=</nowiki></font>
|Adds your User Profile Page to the '''Second Life Instructors''' group
|- style="background:#F8F8F8;"
|<font face="courier" color="blue"><nowiki>|Scribe=</nowiki></font>
|Adds your User Profile Page to the '''SL Mentor Scribes''' group
|-
|<font face="courier" color="blue"><nowiki>|Linguist=</nowiki></font>
|Adds your User Profile Page to the '''SL Mentor Linguists''' group
|- style="background:#F8F8F8;"
|<font face="courier" color="blue"><nowiki>|Buddy=</nowiki></font>
|Adds your User Profile Page to the '''SL Mentor Buddy''' group
|-
|<font face="courier" color="blue"><nowiki>|ApprenticeBuddy=</nowiki></font>
|Adds your User Profile Page to the '''Apprentice Buddy''' group
|-
|<font face="courier" color="blue"><nowiki>|Coach=</nowiki></font>
|Adds your User Profile Page to the '''SL Mentor Coach''' group
|-
|<font face="courier" color="blue"><nowiki>|OrientationCoach=</nowiki></font>
|Adds your User Profile Page to the '''Orientation Coach''' group
|-
|<font face="courier" color="blue"><nowiki>|}}</nowiki></font>
|Closing tag - required
|}


For example, the following template will add you to the '''Second Life Mentors''' and '''SL Mentor Linguist''' groups.  This is done by adding the asterirsk "<b>*</b>" symbol after each of the lines that apply to you.  The lines without asterisks will by ignored by the system.  You can choose to keep or omit the non-asterisked lines.
:<font face="courier" color="blue"><nowiki>{{visl</nowiki>
:|Greeters=
:|Mentors=*
:|Helpers=
:|Instructors=
:|Scribe=
:|Linguist=*
:|Buddy=
:|ApprenticeBuddy=
:|Coach=
:|OrientationCoach=
:<nowiki>|}}</nowiki></font>
'''NOTE:''' It is very important to remember that addition of your User Profile Page to the various groups DOES NOT affect your Second Life Mentor group status.  That is, if you are not a '''SL Mentor Buddy''' in-world, designating yourself as one in your user profile page does not automatically add you as a '''SL Mentor Buddy''' in-world.  You must apply for that status separately.  Also, please do not mis-represent yourselves.  If you are not sure whether you belong to a group or not - ask another experienced Mentor (such as a Mentor Buddy).


<div id="box">


;Skills Template
== Footnotes ==
There are only two skills, but it must be specified in its own list
<div style="padding: 0.5em">
:{|  width="80%"
{{footnotes}}
|-
</div></div>
!Code
!Description
|-
|<font face="courier" color="blue"><nowiki>{{skills</nowiki></font>
|Opening tag - required
|- style="background:#F8F8F8;"
|<font face="courier" color="blue"><nowiki>|Builder=</nowiki></font>
|Adds your User Profile Page to the '''Builders''' group.
|-
|<font face="courier" color="blue"><nowiki>|Scripter=</nowiki></font>
|Adds your User Profile Page to the '''Scripters''' group
|- style="background:#F8F8F8;"
|<font face="courier" color="blue"><nowiki>|}}</nowiki></font>
|Closing tag - required
|}
The following template markup will establish you as a '''Scripter'''.
:<font face="courier" color="blue"><nowiki>{{skills</nowiki>
:|Builder=
:|Scripter=*
:<nowiki>|}}</nowiki></font>




;Specialty and Single Line Templates
<div id="box">
Some groups do not follow the above templates, but are valid groups nonetheless.  They can be specified individually (without the asterisks) as follows:
== Related Topics ==
:{| width="80%"
<div style="padding: 0.5em">
|-
*[[:Category:Help/Wiki]]
!Template
*[[Help:Contents]]
!Description
*[[Template:Ediquette]]
|-
*[http://www.mediawiki.org/wiki/Help:Contents MediaWiki Help:Contents]
|- style="background:#F8F8F8;"
|<font face="courier" color="blue"><nowiki>[[Category:I18n&nbsp;project&nbsp;members|{{PAGENAME}}]]</nowiki></font>
|Directly adds your User Profile Page to the '''i18n Project Members''' group.
|-
|<font face="courier" color="blue"><nowiki>[[Category:Jira&nbsp;Reporters|{{PAGENAME}}]]</nowiki></font>
|Directly adds your User Profile Page to the '''Jira Reporters''' group.  This is a group of people who have reported bugs on the [https://jira.secondlife.com Second Life Jira] bug tracking site.
|}
 
 
;Linden Templates
These templates are reserved for Linden Labs employees.  As a resident, ''do not add these to your profile.''  They are merely listed for completeness.
:{|  width="80%"
|-
!Code
!Description
|-
|<font face="courier" color="blue"><nowiki>{{llEmployee</nowiki></font>
|Opening tag - required. Establishes the Linden Lab Employee roles.
|- style="background:#F8F8F8;"
|<font face="courier" color="blue"><nowiki>|executive=</nowiki></font>
|
|-
|<font face="courier" color="blue"><nowiki>|vol-manager=</nowiki></font>
|
|- style="background:#F8F8F8;"
|<font face="courier" color="blue"><nowiki>|com-manager=</nowiki></font>
|
|-
|<font face="courier" color="blue"><nowiki>|liaison=</nowiki></font>
|
|- style="background:#F8F8F8;"
|<font face="courier" color="blue"><nowiki>|concierge=</nowiki></font>
|
|-
|<font face="courier" color="blue"><nowiki>|CommMonkey=</nowiki></font>
|
|- style="background:#F8F8F8;"
|<font face="courier" color="blue"><nowiki>|GridMonkey=</nowiki></font>
|
|-
|<font face="courier" color="blue"><nowiki>|QA=</nowiki></font>
|
|- style="background:#F8F8F8;"
|<font face="courier" color="blue"><nowiki>|dev=</nowiki></font>
|
|-
|<font face="courier" color="blue"><nowiki>|main=</nowiki></font>
|
|- style="background:#F8F8F8;"
|<font face="courier" color="blue"><nowiki>|teen=</nowiki></font>
|
|-
|<font face="courier" color="blue"><nowiki>|ex=</nowiki></font>
|
|- style="background:#F8F8F8;"
|<font face="courier" color="blue"><nowiki>|}}</nowiki></font>
|Closing tag - required
|}
</div></div>
</div></div>
[[Category:SL Mentor Scribes| ]]

Latest revision as of 08:20, 11 November 2011

Welcome!

This article explains how to create an article as well as some basic editing techniques and wiki etiquette. Read the main article text first; refer to footnotes for additional details.

In case you feel totally lost with editing a page, please contact (list to be updated soon) or add all your content and then write

{{wikify}}

on top of your page. A more experienced editor will try to fix the style of your article afterward.

We encourage Wiki contributors arriving to create a Wiki Profile Page for yourself on the Second Life Wiki so people can always find you. This is particularly useful for those with language abilities or other skills.

You can detail information about yourself above and beyond your inworld profile. Additionally, you can incorporate simple templates into your page that automatically "register" your group role or abilities.

Also watch Torley's Wiki Video Tutorial @ YouTube.

Log In To Create Your Profile Page

If you haven't already you must first Log In to the Second Life Wiki.
  • Click the Log in link at the top right of this page. Use your IN-WORLD name and your IN-WORLD password.
  • Once logged in, your name will appear at the top of the page. Click your name. It is a hyperlink which will take you to a page such as: https://wiki.secondlife.com/wiki/User:Your_Name and you will placed into EDIT mode (if the page doesn't exist).


Create Your Content
  • If you are familiar with Wiki's, begin creating your Profile Page. Even if you're not familiar with Wiki's, put something in there that you can think of and is pertinent to your Second Life. You can work on the formatting later.
  • Review the next section for a sample wiki content. You can then customize from that point on.


Seek Help
  • You can also view the wiki markups of other people's pages, to see what they did to make their pages look the way they do. Edit the other mentor's page to view the markups, 'but do not save your changes to their pages!!!'.
  • If you are not able to figure out the wiki markup, contact the any number of SL Mentor Scribes and ask them if they'll help you with your page. Please note that there will need to be "sweat equity" on your part. You will provide the content and the Mentor Scribes will help create your page in a nice, Wiki format. You can also add {{wikify}} on top of your page to request a makeover of the current content of your page by an experienced Wiki user.


How To Create A New Article

Create An Article In 3 Steps

So in case you'd like to create an article in the Wiki, you'd need to ensure that an article with the same topic isn't already in existence. To do so, you can either use the Wiki search[1] or - recommended - use Google for it. You can filter Google search results to the ones connected to the SL Wiki by entering

site:wiki.secondlife.com KEYWORD

in the searchbar of google.com with KEYWORD being the word or phrase you're searching for. So in case you'd like to write an article about Linden Bears, you'd browse to Google and enter

site:wiki.secondlife.com Linden Bears

You can now have a look at the search results and browse to the pages to edit them in case they are not in someones userspace. We'll come back to that later.
If there is no article about your particular topic and you're sure that your article belongs here[2], you'll need to decide on the right namespace for it, depending on the content you'd like to contribute. For beginners, there are only two interesting namespaces: main namespace and userspace. So a general rule is: Userpages in userspaces. Your page would count as a userpage in case it's somehow personalized to you.
For example: If Mia Linden would want to write an article with the name: Mia's guide on how to create a Linden Bear she'd need to place it in her userspace. However, an article just about Linden Bears would be best in the mainspace.
Depending on the namespace you chose, you can enter one of the following URLs in your web browsers navigation bar:

mainspace: https://wiki.secondlife.com/wiki/Your_Articlename
userspace: https://wiki.secondlife.com/wiki/User:Your_Username/Your_Articlename

with Your_Articlename - you guessed it - beeing the name of your article, with underscores instead of blanks. The Wiki will tell you that the page you're trying to access hasn't got any text to display, but that you're able to edit - and therefore create - it. Press the provided edit this page link to access the editor and to start with your article.

Procedure in short:

  1. Search if your proposed article is already existing
  2. Decide on the right namespace
  3. Create the article

Link And Categorize

While there is always the possibility to find your article via the internal or an external search engine, it is highly recommended to link it at related articles too. Visitors who are interested in one topic might also be interested in a related topic and therefor easily stumble upon it, in case it's linked. Have a look at Help:Contents on how to create links in the Wiki[3].

A nice way to sort and list articles of a certain topic are categories. You read about them in the Quickie Wiki Intro already and used templates to add your userpage to them. Categories will be displayed at the bottom of a page and list all pages which are in the same category, trying to sort them by name[4]. Besides the use of specially designed templates, you can always register your page to a category by just writing

[[Category:NAME OF THE CATEGORY]]

Although it looks like the syntax for a internal Wiki link, this code will not result in a simple link to the category[5] but will register your page and display the category on the bottom of it. Therefore, it doesn't matter where to place the code on your page. However, it is considered as a good style to add it down on the bottom, so future editors can easily find it. To find the right category for your article, you can browse related articles and look at which categories they are registered, so they might fit for your article as well. There is also a list of all current categories in the Wiki[6].

Move And Redirect

Even after some thoughtful thinking, it might happen that you missplace an article or find a name which describes it better. So you got the ability to move your (and almost any other)[7] article with the move link right next to the history link on top of the page. This will result in the whole page, including it's editing history, beeing moved. A redirect to the new spot will be created on the old page, so users who don't know the new article name will automatically be redirected to the new one. You can also manually create redirects from one page to another by entering

#REDIRECT [[NAME]]

with NAME beeing the name where the page is supposed to redirect to. Please use this code only on empty pages.


On Article Editing

Tracking Changes

For basic users, there are three ways on how to track changes in the Wiki. All most recent changes are listed in the Recent Changes Log. You can filter this log so it only shows a particular namespace, hides minor edits, hides your own edits, etc. to be able to better keep track of what's going on. Since only a few users are interested in tracking all changes in the Wiki, it also has the so called Watchlist feature. Every page displays a watch button on top of the page which you can click to add the page to your watchlist.[8] In case a page on your watchlist has been changed, the Wiki will list the most recent change on that page in your watchlist. Pages on your watchlist will also be written in bold letters in the recent changes log. If you would like to remove a page from your watchlist again, just browse to that page and press the unwatch button.

History

As we learned before, any user can edit almost any page in the Wiki.[7] This might scare people from editing pages, since an edit isn't necessarily an improvement for an article. Therefor, the Wiki stores any edit ever saved to the page and logs them in the articles history. It logs date, contributor and changes, allows to compare versions and also allows to undo edits. You can find the blue history button on top of almost any page in the Wiki.[8] Have a look at this pages history to become familiar with the feature.


Discussion Pages

Having the ability to edit and undo anything can lead to some frustration when two (or more) editors have different opinions on how an article should look like. In a worst case cenario, this can lead to an unwanted course of events known as editwar in the Wiki culture. Therefor, any Wiki page has a so called discussion page.[8] This page is supposed to provide a forum for suggestions on how to improve the article, as well as to handle disputes about it. Please use these pages to explain the intentions behind an edit, in case it might cause curriosity by another editor. The etiquette at a Wiki discussion page is a little different then at other articles. There are two main rules you need to have an eye on. These are

  1. Sign your edits with four tildes ~~~~ or the signature button Button sig.png.
    These will automatically be converted into your username and a timestamp once you saved the edit.[9]
  2. Never ever change someone elses discussion entry.[10]

These two rules are very important to ensure that people can keep track of the discussion. There are also other editing etiquette suggestions - called: ediquette - which you can find here.


Uploading Pictures

Unlike some other websites, the SL Wiki can not display external images.[11] However, you are allowed to upload your images to the Wiki in order to display them in your article.[12] The toolbox in the left sidebar provides a link called Upload file. Just browse there, search the picture on your HD and then upload it to the Wiki. Note that there is a recommended file size limitation of 150kb per file, in order to save load on the database and to keep Wiki sites fast. Remember that every user who browses to your article will need to download the file to the browsers cache and not everyone has a fast internet connection which can handle it in a reasonable amount of time.
Add a picture to your page with

[[Image:Your_Image.jpg]]

with Your_Image.jpg being the name of your image. It is also possible to change the width of the image to a certain amount of pixels or to align it left, right or in the center. Your picture with the width of 100 pixels and aligned to the right would need the following code:

[[Image:Your_Image.jpg|100px|right]]

You can even display the picture as a thumbnail of a certain width and add describing text beneath it via

[[Image:Your_Image.jpg|thumb|100px|some describing text]]

All these are combinable, so play around with them to become a feeling for it. Don't forget to use the Show preview button, rather then the Save page button, in order to keep the recent changes log and the database clean. It's part of the previously mentioned ediquette.


Footnotes

  1. ^ Besides the basic search in the left sidebar, there is also a more advanced Wiki search at Special:Search.
  2. ^ Please refrain from advertisement or spam.
  3. ^ Note that there is a different syntax for internal and external links.
  4. ^ The sorting by articlename is only the default option. You can force your article beeing treated differently by defining a sort parameter. Read more at MediaWiki Help:Categories.
  5. ^ You would need to write [[:Category:NAME OF THE CATEGORY]] in order to just create a link.
  6. ^ You can of course create your own ones as well. The right namespace would be the Category namespace: https://wiki.secondlife.com/wiki/Category:Your_Category
  7. ^ There are only a few articles which aren't allowed to be edited or moved from normal users. These pages are listed at Special:Protectedpages.
  8. ^ Special pages are the only pages without a history, a discussion page and the ability to add them to the watchlist.
  9. ^ You can change the way your signature looks like in the Nickname: box of your preferences.
  10. ^ Changing of style, in order to fit the layout of the discussion page is O.K. but refrain from editing any content. In case you'd like to edit an old discussion entry of yours, because you have changed your mind on something, please use <strike>old entry</strike> to strike your old entry and write a short new note that you changed it (signed with four tildes again).
  11. ^ This is for security reasons, rather then being a limitation of the Wiki itself. See WEB-11.
  12. ^ Note that you need the copyrights on the image you'd like to upload. With every edit and upload, you automatically agree with the Contribution Agreement.