Difference between revisions of "HowTo:Add Descriptions"

From VsWiki
Jump to: navigation, search
m (fixing nav links)
m
 
(4 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
{{NAV_Manual |
 
{{NAV_Manual |
 
| previous=[[HowTo:Take Screenshots|Take Screenshots]]
 
| previous=[[HowTo:Take Screenshots|Take Screenshots]]
| up=[[HowTo]]
+
| up=[[HowTos]]
 
| next=[[HowTo:Add Conversations|Add Conversations]]
 
| next=[[HowTo:Add Conversations|Add Conversations]]
 
}}
 
}}
 
----
 
----
= ADDING DESCRIPTIONS =
+
=Adding Item Descriptions=
  
Anything a player can buy in Vega Strike can have a text description.  These are contained in the '''[http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/vegastrike/data4.x/master_part_list.csv?rev=HEAD&content-type=text/vnd.viewcvs-markup Master Part List]''' file.
+
Anything a player can buy in Vega Strike can have a text description.  These are contained in the {{SVN:MasterPartList}} file.
  
== Master Parts List File ==
+
==Master Parts List File==
The '''[http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/vegastrike/data4.x/master_part_list.csv?rev=HEAD&content-type=text/vnd.viewcvs-markup Master Part List]''' is a csv (comma delimited text) file which can be edited with any spreadsheet program.
+
The {{SVN:MasterPartList}} is a csv (comma separated values) text file which can be edited with a good text processing program.
  
'''NOTE''': Microsoft Works has problems with the long description columns.  For a free alternative, use [http://www.openoffice.org OpenOffice].
 
  
=== Steps to add a new item ===
+
{{warning_text |
* Open the '''[http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/vegastrike/data4.x/master_part_list.csv?rev=HEAD&content-type=text/vnd.viewcvs-markup Master Part List]''' file in a spreadsheet application and if you are adding a new item, add a new line. {{Fixme}} ''What's the meaning of this sentence?''
+
| text=Please note that Microsoft Office tools and Windows tools in general (like Windows Notepad) alter the csv files invisibly by adding hidden characters. We also don't recommend Open Office Calc for csv editing, as this tool adds unwanted characters, like the apostrophe to some fields. '''This can render the files unusable and even corrupt your entire game.''' For editing csv files, we recommend a text based editor, e.g. the libre [http://notepad-plus-plus.org/ Notepad++], which keeps the required format across Windows and Linux.}}
* Fill the ''discription'' field with your description.
+
 
* To have a picture show up next to your description, preface the description with  a texture (square, powers of two sides (16,64,128,256,etc)) in the following format: <code>@'''path/to/'''texture.png@</code>
+
 
 +
===Steps to add a new item===
 +
* Open the [http://vegastrike.svn.sourceforge.net/viewvc/vegastrike/trunk/data/master_part_list.csv?revision=HEAD&view=markup master_part_list.csv] file in a spreadsheet application and, if you are adding a new item, add a new line containing the required number of columns, separated by commas - "," as explained here:
 +
** The '''file''' column contains the unit name as specified in units.csv
 +
** Fill in the upgrade, cargo, or starship '''category''', e.g. "upgrades/Sensors/Confed".
 +
** Fill the numbers for base '''price''', '''mass''', and '''volume'''.
 +
** Fill the '''discription''' field with your description. To have a picture show up next to your description, preface the description with  a texture (square, powers of two sides (16,64,128,256,etc)) in the following format: <code>@'''path/to/'''texture.png@</code>, where the path to texture starts from the ''data/textures'' folder.
 
* Save the file as a csv file.
 
* Save the file as a csv file.
  
== Example row ==
+
 
 +
{{Fixme}} ''What role has the file data/units/units_description.csv?''
 +
 
 +
==Example row==
 
<pre>
 
<pre>
 
"file","categoryname","price","mass","volume","description"
 
"file","categoryname","price","mass","volume","description"
Line 28: Line 36:
 
</pre>
 
</pre>
  
= See also =
+
=See also=
* '''[http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/vegastrike/data4.x/master_part_list.csv?rev=HEAD&content-type=text/vnd.viewcvs-markup Master Part List]''' in CVS   
+
* {{CVS:MasterPartList}} in CVS   
 
* [[HowTo:Add Cargo|Adding Cargo]]
 
* [[HowTo:Add Cargo|Adding Cargo]]
 
* [[HowTo:Add Upgrades|Adding Upgrades]]
 
* [[HowTo:Add Upgrades|Adding Upgrades]]
Line 38: Line 46:
 
{{NAV_Manual |
 
{{NAV_Manual |
 
| previous=[[HowTo:Take Screenshots|Take Screenshots]]
 
| previous=[[HowTo:Take Screenshots|Take Screenshots]]
| up=[[HowTo]]
+
| up=[[HowTos]]
 
| next=[[HowTo:Add Conversations|Add Conversations]]
 
| next=[[HowTo:Add Conversations|Add Conversations]]
 
}}
 
}}
  
[[Category:HowTo|Add Descriptions]]
+
[[Category:HowTos|Add Descriptions]]
 
[[Category:Development|Add Descriptions]]
 
[[Category:Development|Add Descriptions]]

Latest revision as of 17:08, 1 March 2011

arrow_left.png Take Screenshots arrow_up.png HowTos Add Conversations arrow_right.png

Adding Item Descriptions

Anything a player can buy in Vega Strike can have a text description. These are contained in the Master Part List file.

Master Parts List File

The Master Part List is a csv (comma separated values) text file which can be edited with a good text processing program.



Steps to add a new item

  • Open the master_part_list.csv file in a spreadsheet application and, if you are adding a new item, add a new line containing the required number of columns, separated by commas - "," as explained here:
    • The file column contains the unit name as specified in units.csv
    • Fill in the upgrade, cargo, or starship category, e.g. "upgrades/Sensors/Confed".
    • Fill the numbers for base price, mass, and volume.
    • Fill the discription field with your description. To have a picture show up next to your description, preface the description with a texture (square, powers of two sides (16,64,128,256,etc)) in the following format: @path/to/texture.png@, where the path to texture starts from the data/textures folder.
  • Save the file as a csv file.


FIXME What role has the file data/units/units_description.csv?

Example row

"file","categoryname","price","mass","volume","description"

"IntaTouch","Entertainment/Aera",50,0.01,1,
"@cargo/cargo-hud.png@A tactile simulator that provides an Aera with relaxing sensations."

See also


arrow_left.png Take Screenshots arrow_up.png HowTos Add Conversations arrow_right.png