Difference between revisions of "Code generator guide"

From Discovery Wiki
Jump to navigationJump to search
m (Space moved page User:Space/Code Generator to Code generator guide without leaving a redirect: Should be good to go.)
(Added "Other pages" guide.)
Line 36: Line 36:
 
#Click “Show preview”.  Does the page look like it should? Compare it with [[:Category:Guns|another equipment page]].
 
#Click “Show preview”.  Does the page look like it should? Compare it with [[:Category:Guns|another equipment page]].
 
##Does the equipment image show up like it should? If not, check what the image name was in the previous revision of the page <nowiki>("| image = filename</nowiki>" inside the [[Template:Weapon|<nowiki>{{Weapon/gun}}</nowiki> template]], again on the left hand side of the view you get after clicking “Show changes”) and copy it over.
 
##Does the equipment image show up like it should? If not, check what the image name was in the previous revision of the page <nowiki>("| image = filename</nowiki>" inside the [[Template:Weapon|<nowiki>{{Weapon/gun}}</nowiki> template]], again on the left hand side of the view you get after clicking “Show changes”) and copy it over.
 +
#If everything’s looking good by now, add a short summary stating that you have updated the page, and click "Save page".
 +
#Done!
 +
==Other pages==
 +
#Find the page that you wish to update on the Wiki.
 +
#Find the entry for that page in the code generator, and copy the generated Wiki code into the editor. Make sure that you replace all code that is there from before.
 +
#Add <nowiki>[[wikilinks]]</nowiki> where appropriate, such as for factions and ship names.
 +
#Click “Show preview”.  Does the page look like it should? Compare it with another page of the same type.
 +
##If you are updating a base: does the base image show up like it should? If not, check what the image name was in the previous revision of the page <nowiki>("| image = filename</nowiki>" inside the [[Template:Base Infobox|<nowiki>{{Base Infobox}}</nowiki> template]], again on the left hand side of the view you get after clicking “Show changes”) and copy it over.
 
#If everything’s looking good by now, add a short summary stating that you have updated the page, and click "Save page".
 
#If everything’s looking good by now, add a short summary stating that you have updated the page, and click "Save page".
 
#Done!
 
#Done!

Revision as of 08:10, 4 March 2015

Link to the code generator

cshake's Wiki code generator is one of the most helpful tools that Wiki editors have for keeping ship, commodity and equipment pages up to date, but it is unfortunately not quite automatic as the output code requires a bit of manual editing, proofreading and verification before it can be added to the Wiki. To help you through this process, there are a few checklists and usage instructions below for each of the most common types below, but the most important guideline of all is to hit the preview button and compare the page you are editing with another page of the same type: If they look about the same, you should be good to go to hit the "Save page" button.

Another important tip is the "Show changes" button, which can help you if you're unsure about what you are changing or removing on a page after importing generated code from the code generator.

Code generator checklists

ID pages

  1. Find the ID page that you wish to update on the Wiki.
  2. Find the entry for that page in the code generator, and copy the generated Wiki code into the editor. Make sure that you replace all code that is there from before.
  3. Add [[wikilinks]] where appropriate, such as for factions and ship names.
  4. Click “Show preview”. Does the page look like it should? Compare it with another ID page.
    1. There should for example be no dashes after each bullet point on lists on the ID page.
  5. If everything’s looking good by now, add a short summary stating that you have updated the page, and click "Save page".
  6. Done!

Ship pages

A preview of what it looks like when you're about to remove a review. The highlighted red code should be copied into the new page to avoid losing the review.
  1. Find the ship page that you wish to update on the Wiki.
  2. Find the entry for that page in the code generator, and copy the generated Wiki code into the editor. Make sure that you replace all code that is there from before.
  3. Click the “show changes” button, and look for any red text with a minus sign in front of it on the left hand side to see if you’ve removed any reviews. If so, copy these over to the editor window under the ==Handling== title.
  4. Add [[wikilinks]] where appropriate, such as for factions and base names.
  5. Click “Show preview”. Does the page look like it should? Compare it with another ship page.
    1. Does the ship image show up like it should? If not, check what the image name was in the previous revision of the page ("| image = filename" inside the {{Ship Infobox}} template, again on the left hand side of the view you get after clicking “Show changes”) and copy it over.
  6. If everything’s looking good by now, add a short summary stating that you have updated the page, and click "Save page".
  7. Done!

Commodity pages

  1. Find the commodity page that you wish to update on the Wiki.
  2. Find the entry for that page in the code generator, and copy the generated Wiki code into the editor. Make sure that you replace all code that is there from before.
  3. Add [[wikilinks]] where appropriate, such as for factions and base names.
  4. Click “Show preview”. Does the page look like it should? Compare it with another commodity page.
  5. If everything’s looking good by now, add a short summary stating that you have updated the page, and click "Save page".
  6. Done!

Equipment pages

  1. Find the equipment page that you wish to update on the Wiki.
  2. Find the entry for that page in the code generator, and copy the generated Wiki code into the editor. Make sure that you replace all code that is there from before.
  3. Add [[wikilinks]] where appropriate, such as for factions and ship names.
  4. Click “Show preview”. Does the page look like it should? Compare it with another equipment page.
    1. Does the equipment image show up like it should? If not, check what the image name was in the previous revision of the page ("| image = filename" inside the {{Weapon/gun}} template, again on the left hand side of the view you get after clicking “Show changes”) and copy it over.
  5. If everything’s looking good by now, add a short summary stating that you have updated the page, and click "Save page".
  6. Done!

Other pages

  1. Find the page that you wish to update on the Wiki.
  2. Find the entry for that page in the code generator, and copy the generated Wiki code into the editor. Make sure that you replace all code that is there from before.
  3. Add [[wikilinks]] where appropriate, such as for factions and ship names.
  4. Click “Show preview”. Does the page look like it should? Compare it with another page of the same type.
    1. If you are updating a base: does the base image show up like it should? If not, check what the image name was in the previous revision of the page ("| image = filename" inside the {{Base Infobox}} template, again on the left hand side of the view you get after clicking “Show changes”) and copy it over.
  5. If everything’s looking good by now, add a short summary stating that you have updated the page, and click "Save page".
  6. Done!