Difference between revisions of "Template:Ship"

From EVE University Wiki
Jump to: navigation, search
m
(added information about ship faction selection)
Line 99: Line 99:
 
|</nowiki><span style='color:yellow'>ship_name</span><nowiki>={{ShipSelector|mode={{{2}}}</nowiki><br>
 
|</nowiki><span style='color:yellow'>ship_name</span><nowiki>={{ShipSelector|mode={{{2}}}</nowiki><br>
 
&nbsp;&nbsp;&nbsp;&nbsp;<nowiki>|shipimg=</nowiki><span style='color:yellow'>ship_image_file</span><nowiki> </nowiki><br>
 
&nbsp;&nbsp;&nbsp;&nbsp;<nowiki>|shipimg=</nowiki><span style='color:yellow'>ship_image_file</span><nowiki> </nowiki><br>
&nbsp;&nbsp;&nbsp;&nbsp;<nowiki>|caption=</nowiki><span style='color:yellow'>ship_name</span><nowiki> |shipname=</nowiki><span style='color:yellow'>ship_name</span><nowiki> |class=</nowiki><span style='color:yellow'>ship_class</span><nowiki></nowiki><br>
+
&nbsp;&nbsp;&nbsp;&nbsp;<nowiki>|caption=</nowiki><span style='color:yellow'>ship_name</span><nowiki> |shipname=</nowiki><span style='color:yellow'>ship_name</span><nowiki> |class=</nowiki><span style='color:yellow'>ship_class</span><nowiki> |faction=</nowiki><span style='color:yellow'>ship_faction</span><br>
 
&nbsp;&nbsp;&nbsp;&nbsp;<nowiki>|highs=</nowiki><span style='color:yellow'>0</span><nowiki> |turrets=</nowiki><span style='color:yellow'>0</span><nowiki> |launchers=</nowiki><span style='color:yellow'>0</span><nowiki> |mediums=</nowiki><span style='color:yellow'>0</span><nowiki> |lows=</nowiki><span style='color:yellow'>0</span><nowiki></nowiki><br>
 
&nbsp;&nbsp;&nbsp;&nbsp;<nowiki>|highs=</nowiki><span style='color:yellow'>0</span><nowiki> |turrets=</nowiki><span style='color:yellow'>0</span><nowiki> |launchers=</nowiki><span style='color:yellow'>0</span><nowiki> |mediums=</nowiki><span style='color:yellow'>0</span><nowiki> |lows=</nowiki><span style='color:yellow'>0</span><nowiki></nowiki><br>
 
&nbsp;&nbsp;&nbsp;&nbsp;<nowiki>|cargohold=</nowiki><span style='color:yellow'>0 m3</span><nowiki> |dronebay=</nowiki><span style='color:yellow'>0 m3</span><nowiki> |bandwidth= </nowiki><span style='color:yellow'>0 Mbit/sec</span><nowiki></nowiki><br>
 
&nbsp;&nbsp;&nbsp;&nbsp;<nowiki>|cargohold=</nowiki><span style='color:yellow'>0 m3</span><nowiki> |dronebay=</nowiki><span style='color:yellow'>0 m3</span><nowiki> |bandwidth= </nowiki><span style='color:yellow'>0 Mbit/sec</span><nowiki></nowiki><br>
Line 115: Line 115:
 
*<span style='color:yellow'>ship_image_file</span> = the ship's image file, if you're adding a new ship which has no image present on the wiki, you'll have to upload one yourself. example : Drake.jpg
 
*<span style='color:yellow'>ship_image_file</span> = the ship's image file, if you're adding a new ship which has no image present on the wiki, you'll have to upload one yourself. example : Drake.jpg
 
*<span style='color:yellow'>ship_class</span> = the ship's class or hull class, example : Battlecruiser
 
*<span style='color:yellow'>ship_class</span> = the ship's class or hull class, example : Battlecruiser
 +
*<span style='color:yellow'>ship_faction</span> = the ship's faction selection, there are only six type available at this time (they are all <u>case sensitive</u> and must be <u>typed exactly</u> like these), please choose only one:
 +
**<span style='color:orange'>Amarr Empire</span>
 +
**<span style='color:orange'>Caldari State</span>
 +
**<span style='color:orange'>Gallente Federation</span>
 +
**<span style='color:orange'>Minmatar Republic</span>
 +
**<span style='color:orange'>Outer Ring Excavations</span>
 +
**<span style='color:orange'>Khanid Kingdom</span>
 
*the highs, turrets, mediums and lows <span style='color:yellow'>0 values</span> = the number of the slots available for the ship, example : 7
 
*the highs, turrets, mediums and lows <span style='color:yellow'>0 values</span> = the number of the slots available for the ship, example : 7
 
*cargohold, dronebay and bandwith <span style='color:yellow'>0 values</span> = the values of each parameter, with their appropriate dimension/size, example : 150 m3 (for cargohold), 150 Mbit/sec (for bandwith)
 
*cargohold, dronebay and bandwith <span style='color:yellow'>0 values</span> = the values of each parameter, with their appropriate dimension/size, example : 150 m3 (for cargohold), 150 Mbit/sec (for bandwith)
Line 137: Line 144:
  
 
Adding a new data safely is what we should go for. To do this, copy the codes on the '''Ship Data : How Is It Written?''' subsection above to notepad or text editor of your choice and edit the parameters there so you can make sure you don't miss any of the tags or closing brackets. If you do this correctly, all you have to do then is copy again from the text editor into the appropriate section on the [[Template:ShipDatabase]].
 
Adding a new data safely is what we should go for. To do this, copy the codes on the '''Ship Data : How Is It Written?''' subsection above to notepad or text editor of your choice and edit the parameters there so you can make sure you don't miss any of the tags or closing brackets. If you do this correctly, all you have to do then is copy again from the text editor into the appropriate section on the [[Template:ShipDatabase]].
 +
 +
To help you with the data used for the attributes, the initial data should always be the one from CCP latest Datadump, if you do not have access to them or do not know how to get them, try using the information available on the [http://wiki.eveonline.com] ship articles instead.
 
==Notes==
 
==Notes==
 
This template is the main and entry point for the Ship Template & Database. The contents and behaviour of this template directly affected by contents of the following templates :
 
This template is the main and entry point for the Ship Template & Database. The contents and behaviour of this template directly affected by contents of the following templates :

Revision as of 12:10, 9 September 2011

The main purpose of this template is to produce something like this Template:ShipDatabase (you can try hovering the text to see what i mean) or his bigger brother, the box mode (you can see one on the example section below). With just typing something as simple as this

{{Ship|Drake|tooltip}} for the tooltip-look, and

{{Ship|Drake|box}} for the bigger box-styled version

As you can see this template works differently than other templates you'll find in the wiki. By using this template we don't need to write any additional ship information to produce something more informative, as long as the ship information is written on the Template:ShipDatabase. This should cut down the time needed for editors and/or contributors to write articles which includes any particular ship information, not to mention the tooltip mode will enable users to put a hoverable ship information text on their articles. The tooltip mode can be used on any place on any form of wiki stylings or locations, for example inside a table or a list, since the hoverable text would be treated as a normal link by the wiki.

How To Use

Using the template is quite easy. The syntax is written below :

{{Ship|name_of_the_ship|mode_selection}}

  • Ship : this is the name of this template in which you would have to call, there are no other alternatives or options for this, so just write it this way.
  • name_of_the_ship : this is the name of the ship you want displayed, just type a ship's name and the wiki will automatically link them to an existing database entry. Note : Since there's no way to list what ship is already available on the database, you just have to try calling the ship name yourself and see whether it displays anything or not. If nothing comes up or the result shows that the entry cannot be found, then you have to add a new entry to the database.
  • mode_selection : there are two modes available right now..
    • tooltip : this is the tooltip-styled one
    • box : this is the big box-styled one



Examples

There are several way we can use the template, below are some examples :

Embedding Inside a Paragraph

If you have a paragraph text like this :

The Ferox is the most commonly flown ship in all of EVE, effective in both PvE and PvP combat. PvE load-outs sport an insane passive regeneration shield tank while in PvP the Ferox is fitted with a huge buffer tank (sometimes achieving a number of effective hit points equal to Battleships). While its DPS is not as effective as those of other races Battlecruisers its awesome tank means that it will often be the last ship standing on a battlefield.

and you want to change the Ferox text to a hoverable ship information box, just write them like these.

The Code

The {{Ship|Ferox|tooltip}} is the most commonly flown ship in all of EVE, effective in both PvE and PvP combat. PvE load-outs sport an insane passive regeneration shield tank while in PvP the Ferox is fitted with a huge buffer tank (sometimes achieving a number of effective hit points equal to Battleships). While its DPS is not as effective as those of other races Battlecruisers its awesome tank means that it will often be the last ship standing on a battlefield.

This is the result :

The Template:ShipDatabase is the most commonly flown ship in all of EVE, effective in both PvE and PvP combat. PvE load-outs sport an insane passive regeneration shield tank while in PvP the Ferox is fitted with a huge buffer tank (sometimes achieving a number of effective hit points equal to Battleships). While its DPS is not as effective as those of other races Battlecruisers its awesome tank means that it will often be the last ship standing on a battlefield.

Embedding Inside a Table

The Code

{| border="1" align="center" style="text-align:center;"
|{{Ship|Ferox|tooltip}}
|PvE/PvP ship
|312,333.00
|-
|This is a {{Ship|Drake|tooltip}}
|Pie
|5111100.00
|}


This is the result :

Template:ShipDatabase

PvE/PvP ship 312,333.00
This is a

Template:ShipDatabase

Pie 5111100.00

Box Style for More Complete Information

The Code

Battlecruisers are sometimes considered as a more powerful version of Destroyer class ships, they fit the same sized weapons as Cruisers and more widely used as a damage dealing ship than Destroyers. One of the most notable Battlecruiser class ship is probably the Caldari Drake, which is well known for it's tanking capabilities.
{{Ship|Drake|box}}

This is the result :

Battlecruisers are sometimes considered as a more powerful version of Destroyer class ships, they fit the same sized weapons as Cruisers and more widely used as a damage dealing ship than Destroyers. One of the most notable Battlecruiser class ship is probably the Caldari Drake, which is well known for it's tanking capabilities.

Template:ShipDatabase



Editing the Database

If the ship information you requested does not exist in the database, you could add them yourself, or if you want to update a certain information on a specific ship or just removing a ship information entirely (please contact the ship curator or wiki manager if you want to delete any ship data entry). Since all the ship data are stored in a wiki article format, it should be easy for anyone to add/edit the entries. Please read the remaining sections below if you're planning on adding/editing the database entries.

The Database

All the ship informations are stored in this page (wiki template article page) : Template:ShipDatabase You won't see anything by just viewing to page, to actually see the database contents, you'll have to edit the page by clicking the Edit button on the top of the article. There are things you must understand before trying to make any changes to the database, first of all, the article structure itself.

Database Sections : Where Should I Put The Data?

The database article is divided in three sections,

  • Header Section
  • Data Section
  • Footer Section

Under no circumstances should you change the Header or Footer Section!, if you made a mistake on doing so, click on View History - Click Undo on the last work you've done until that point.

<!--HEADER SECTION START-->Header codes<!--HEADER SECTION END-->

<!--DATA SECTION START-->

This is where we put all the ship datas, it's sorted alphabetically so if you wanted to add a new ship info, try placing them in the appropriate alphabetical section.

<!--DATA SECTION END-->


<!--FOOTER SECTION START-->Footer codes<!--FOOTER SECTION END-->


Ship Data : How Is It Written?

Below is the basic format of an empty ship data, you could copy the codes and paste them on the appropriate data section on the database and change the values of the texts colored in yellow. Do not change anything else!

|ship_name={{ShipSelector|mode={{{2}}}
    |shipimg=ship_image_file
    |caption=ship_name |shipname=ship_name |class=ship_class |faction=ship_faction
    |highs=0 |turrets=0 |launchers=0 |mediums=0 |lows=0
    |cargohold=0 m3 |dronebay=0 m3 |bandwidth= 0 Mbit/sec
    |roles=ship_general_role
    |variations=ship_variations
    |bonuses=ship_bonuses
    |info=ship_information_or_description
    |shieldhp=0 |shieldem=0 |shieldexp=0 |shieldkin=0 |shieldtherm=0
    |armorhp=0 |armorem=0 |armorexp=0 |armorkin=0 |armortherm=0
    |targetrange=0 km |sigradius=0 m |maxvelocity=0 m/sec
    |forumlinks=}}

You should replace each of the yellow texts to their appropriate values based on the name of texts. Each one correlates to different parts of the info box :

  • ship_name = the ship's name, example : Drake
  • ship_image_file = the ship's image file, if you're adding a new ship which has no image present on the wiki, you'll have to upload one yourself. example : Drake.jpg
  • ship_class = the ship's class or hull class, example : Battlecruiser
  • ship_faction = the ship's faction selection, there are only six type available at this time (they are all case sensitive and must be typed exactly like these), please choose only one:
    • Amarr Empire
    • Caldari State
    • Gallente Federation
    • Minmatar Republic
    • Outer Ring Excavations
    • Khanid Kingdom
  • the highs, turrets, mediums and lows 0 values = the number of the slots available for the ship, example : 7
  • cargohold, dronebay and bandwith 0 values = the values of each parameter, with their appropriate dimension/size, example : 150 m3 (for cargohold), 150 Mbit/sec (for bandwith)
  • ship_general_role = the role of the ship, this was meant to be a basic guideline on what new players should see what the use for this ship, example : Missions, Tackler
  • ship_variations = other variants of the ship, you can write them as links, separated by comma, example : [http://wiki.eveonline.com/en/wiki/Crow Crow], [http://wiki.eveonline.com/en/wiki/Raptor Raptor]
  • ship_bonuses = the bonuses or role bonuses for the ship, please separate each new line with a <br> tag.
  • ship_information_or_description = short (or long, if you prefer) description about the ship, you can write a short paragraph for the description.
  • shieldhp, shieldem, shieldexp, shieldexp and shieldtherm 0 values = shieldhp is the base shield hp value of the ship, while the other is the base shield resistance value of the ship, use numerical values only WITHOUT percentage symbol!
  • armorhp, armorem, armorexp, armorexp and armortherm 0 values = armorhp is the base armor hp value of the ship, while the other is the base armor resistance value of the ship, use numerical values only WITHOUT percentage symbol!
  • targetrange, sigradius and maxvelocity 0 values = the values of each parameter, with their appropriate dimension/size, example : 30 km (for targetrange), 500 m/sec (for maxvelocity)
  • forumlinks = you can add forum links here or you can just leave them empty but if you decide to add more than one, you don't have to separate them using a <br> tag, just use comma.


If you're editing or adding a new ship information, please make sure that no symbols, starting/closing tags, punctuation is left behind. You'll see that if you made a mistake the ship information boxes on this page and others wont render correctly, if you encountered this problem, just undo your work from the View History on the Database page.


Editing a Ship Details

To edit a ship info/details/attributes, simply visit this article : Template:ShipDatabase, and click on the edit button. For safety reasons, please copy the article to a notepad or other editor you prefer (i recommend Notepad++ or EditPlus), but i don't recommend the use of word processors such as Ms Word since they often mess up with some of the encoding. Search the ship you'd like to edit by scrolling down through its alphabetical section, for example Ferox should be located in the D-F section.

Rewrite/modify/add the things you want to edit, and make sure you close all tags and did not erase or add additional tags such as {, }, |, [, ], etc. by accident. If you feel something is wrong, undo your work, and start again.

Adding New Ship Information

To add a new ship information, the first thing to do is making sure that the ship image is available, if it's not, you will have to upload a new one yourself. If you have one ready, upload them into the wiki by typing the file name like this on your browser's url box : wiki.eveuniversity.org/File:image_name.jpg then upload the image.

Adding a new data safely is what we should go for. To do this, copy the codes on the Ship Data : How Is It Written? subsection above to notepad or text editor of your choice and edit the parameters there so you can make sure you don't miss any of the tags or closing brackets. If you do this correctly, all you have to do then is copy again from the text editor into the appropriate section on the Template:ShipDatabase.

To help you with the data used for the attributes, the initial data should always be the one from CCP latest Datadump, if you do not have access to them or do not know how to get them, try using the information available on the [1] ship articles instead.

Notes

This template is the main and entry point for the Ship Template & Database. The contents and behaviour of this template directly affected by contents of the following templates :

  • Template:ShipDatabase : this is where the ship database is stored
  • Template:ShipSelector ¹
  • Template:ShipBoxLarge ¹
  • Template:ShipBoxTooltip ¹
¹ these three templates are not meant to be edited, unless absolutely necessary.

All these five templates were designed to be work in conjunction to each other, meaning if one of them is missing, all five and especially this ship template won't work!

Troubleshooting

If you have any problems using this template or you see a problem on the wiki related to this template that requires an immediate action, please contact Sarah Schneider ingame or via forum PM, if not available, see the current maintainer of this page by viewing the history and contact that person instead.

Template:ShipDatabase