Protospace Wiki:Adding new tools: Difference between revisions

From Protospace Wiki
Jump to navigation Jump to search
No edit summary
 
(34 intermediate revisions by 5 users not shown)
Line 1: Line 1:
==General==
If a tool has been donated, semi-permanently loaned, or brought into the space for a specific short-term, it is encouraged to add the tool to the "[[tools we have]]" gallery page. This will help avoid damage due to other members being uninformed about the tool's operation, maintenance, ownership, etc. Follow this procedure to achieve that.


If a tool has been donated, semi-permanently loaned, or brought into the space for a specific short-term, it is encouraged to add the tool to the [[Tools We Have]] page. This will help prevent people from tampering, moving, modifying, or improperly using them. Follow this procedure.
<blockquote>If a tool has been donated, semi-permanently loaned, or brought into the space for a specific short-term, it is encouraged to add the tool to the "[[tools we have]]" gallery page. This will help avoid damage due to other members being uninformed about the tool's operation, maintenance, ownership, etc. Follow this procedure to achieve that.
</blockquote>


==Preparing to add a tool==
==Adding a tool page==
Each tool is assigned a Wiki ID.  This ID's are assigned in a chronological order.<br />
The first step when adding a tool is to chose the next available ID number, which will be used when assigning the picture name, as well as creating a redirect page for short URL's.


To view the next available WIKI ID ( and the ID's that have been assigned) <a ref="/0" target="_numbers">see this page</a>
1. Decide on a '''tool name'''
* Try to follow the format: <code>[tool type], [distinguishing characteristics separated by commas] ([make/model])</code>. If the tool was made by a member and therefore has no make/model, use the member's name in possessive form. '''Don't add an ID number at the end yet.'''
*  Examples:
*:* Laser cutter, large (Rabbit Laser RL-80-1290)
*:* Counter (Fluke 1910A Multi-Counter)
*:* Function generator (John's)
*:* Power supply, bench, 2-channel (TENMA 72-7245)
*:* Vise, wood (Travis's)
*:* Magnifier lamp, large, without lid
*:* Forge, propane (Jim's)
2. Enter that exact name in the '''search box'''


==Adding the Picture==
3. '''Press Enter'''


* It is easiest to add the picture first. While encouraged, it's not necessary, a single text line with basic info is acceptable instead of an individual tool page.
3. In the middle of the search results, '''click the link''': <span style="color:red">'''"Create the page ___________ on this wiki!"'''</span>.


* When taking the picture, try to take it in good lighting in a blank (or cardboard/plywood) background. Then crop it accordingly.
4. Check that '''"Create source"''' tab is selected at the top. You can come back later and edit in visual mode.
**Add a picture file, click the [[Special:Upload]] link on the left menu (or the one I just linked).
**Give the picture the unique filename based on the WIKI ID chosen above. example "106.jpg"
**Give the picture a short description and upload it.  


* Copy/remember the filename or leave that tab open, you'll need it right away.
5. '''Paste the following''' into the text area:


Then you're ready to create a tool page.


==Creating a Tool Page==
<pre>
{{Equipment page
| toolname =  
| model =  
| serial =  
| owner =  
| loanstatus =
| arrived =
| location =
| status =
| permission =
| certification =
| photo =
| caption =
| id =
}}


* Edit the [[Tools We Have]] page and insert a line to the appropriate alphabetical place. Copy and paste this, change it for your specific info:
==Specs==
**<nowiki>File:Filename.jpg|[[Toolpage Name]]</nowiki>
TBD


* It's easy to figure out, just copy the ones above or below it in the list except for the changes.
==Usage==
* Preview, leave a comment on what you did, and then click Save Page.
TBD


The new tool page has now been created and linked in the Tools We Have document.
==Troubleshooting==
TBD


==Adding Content to the Tool Page==
==Documentation==
TBD
</pre>


* Scroll until you find your tool in the list. The thumbnail should show up and the text below should be the red toolname page.
6. '''Fill in''' the template.


* Click the red toolname page.
* Leave <code>photo</code>, <code>caption</code>, and <code>id</code> blank for now. With the other fields, enter a question mark or leave it blank if you don't know that information. <code>toolname</code> is not supposed to be in the same format as the page title (what you decided on in step 1); instead, it should be more of a natural-sounding but still detailed name, such as "Tormach PCNC 1100 CNC mill" or "red 12" hacksaw". For help with the other fields, see the descriptions at [[Template:Equipment page]].
* Add the appropriate information on each line, after the equals sign.
* (Optional) Add all appropriate tool categories. The current tool categories can be found listed in the "Subcategories" section of [[:Category:Tools]]. Add links to the categories (e.g., <code><nowiki>[[Category:Showcase tools]]</nowiki></code>), at the very bottom of the page's code.
7. Click the '''"Show preview"''' button at the bottom of the editor to check that the page appears correctly. You should see an infobox on the right side of the preview, with the info you entered. If not, try to fix it so you do. If you don't, proceed anyway, and somebody else will probably fix it soon.


* There is a [[Template:Equipment page|template]] made (you can click that link to see more). Don't edit the Template. Use it. Copy and paste the following code into the edit box of the new tool page:
8. Click the blue "'''Save page'''" button at the bottom of the editor to publish your addition.
<pre><nowiki>
 
{{Template:Equipment page
9. '''Assign a wiki-ID''' number to the tool according to [[0#I want to assign a wiki-ID number to a tool or other item|the instructions for that]].
|toolname=
|model=
|serial=
|owner=
|loanstatus=
|arrived=
|location=
|status=
|permission=
|certification=
|itemphoto=[[File:.jpg|350px|thumb|right|]]
}}
==Specs==
</nowiki></pre>


* Then fill in the missing info. Anything not applicable write N/A, anything unknown leave ?? so someone in the future can know it needs filing in.
10. '''[[Special:Upload|Upload a photo]]''' with the wiki-ID number as the filename, such as <code>512.jpg</code>.
** If uncertain, look at other tool pages to get an idea, or read the [[Template:Equipment page|template]] page.
** Don't forget to insert the picture filename again (last line, between <nowiki>[[File:]]</nowiki> and <nowiki>.jpg|</nowiki> ).
** Add in tool specs and explain briefly what the tool is and what it's used for.


* Add sections below if relevant. Often "<nowiki>==Usage Notes==</nowiki>", "<nowiki>==Repair Notes==</nowiki>", are helpful.
11. Edit the tool page you created to '''add the photo'''. Copy and paste the filename into the <code>photo</code> field of the equipment page template: <code><nowiki>| photo = 512.jpg</nowiki></code>.


* Preview and see if it looks right. Save page.
12. '''Preview and save''' the page again, preferably with an edit summary saying you added a photo.


==Seeing Your Results==
All done! Now that the tool page is created, feel free to edit in visual mode by pressing "Edit" instead of "Edit source".


* Click to return to Tools We Have, your red link should now be blue (or purple), and clicking it should bring you back to the tool page.
==(Optional) Adding your tool to the gallery==


* If this doesn't work, or you screwed up, ask someone for help.
* Go to the [[tools we have]] gallery, find the appropriate section, and click the edit button on that section so you can insert an entry. Find the appropriate place in the section according to where the name you chose in step 1 fits in alphabetical order.
** If editing in source mode, copy and paste the following code:
**: <pre>File:FILENAME        |link=TOOLDESCRIPTION            |[[TOOLDESCRIPTION]]</pre>
** If editing in visual mode, double-click the gallery in the appropriate section (or click once to select it and then click the "Edit" button that appears), then click "+ Add new image" at the bottom-left of the popup window. In the search box, type in the filename of the image, including the filename extension. When the image appears, click it. It will join the others in the column on the left; drag it to the appropriate alphabetical position. Don't close the popup window yet.
* Fill in the info:
** If editing in source mode, edit the line with <code>FILENAME</code> after the name of the image you uploaded, such as <code>File:512.jpg</code> or <code>File:Red hacksaw.jpg</code>, and replace the words "TOOLDECRIPTION" with the page you wish to link.  Example: replace <code>link=TOOLDESCRIPTION</code> with <code>link=Hacksaw, 12", red ID:512</code> and <code><nowiki>[[TOOLDESCRIPTION]]</nowiki></code> with <code><nowiki>[[Hacksaw, 12", red ID:512]]</nowiki></code>.  Be careful to not delete the pipes (<code>|</code>), and make sure there are no spaces between the second pipe and the beginning of the link code (<code><nowiki>[[</nowiki></code>).  It should look like this: <pre>File:512.jpg|link=Hacksaw, 12", red ID:512 |[[Hacksaw, 12", red ID:512]]</pre>
** If editing in visual mode, click the link button (with the chain icon) at the top of the caption field below the image on the right side of the popup window. Start typing the title of the page you created, and click it when it appears in the suggestions. Now click the blue "Apply changes" button at the top-right of the popup window. Editing visually, you can't set the <code>link=</code> parameter; somebody else might do that, or you can add it yourself by editing again in source mode.
* If editing in source mode, click the "Show preview" button at the bottom of the editor to check that your addition appears correctly. (In visual mode, the editor itself serves as the preview.) If not, try to fix it so it does. If you can't, proceed anyway, and somebody else will probably fix it soon.
* Click the "Save changes".

Latest revision as of 20:03, 20 April 2024

If a tool has been donated, semi-permanently loaned, or brought into the space for a specific short-term, it is encouraged to add the tool to the "tools we have" gallery page. This will help avoid damage due to other members being uninformed about the tool's operation, maintenance, ownership, etc. Follow this procedure to achieve that.

If a tool has been donated, semi-permanently loaned, or brought into the space for a specific short-term, it is encouraged to add the tool to the "tools we have" gallery page. This will help avoid damage due to other members being uninformed about the tool's operation, maintenance, ownership, etc. Follow this procedure to achieve that.

Adding a tool page

1. Decide on a tool name

  • Try to follow the format: [tool type], [distinguishing characteristics separated by commas] ([make/model]). If the tool was made by a member and therefore has no make/model, use the member's name in possessive form. Don't add an ID number at the end yet.
  • Examples:
    • Laser cutter, large (Rabbit Laser RL-80-1290)
    • Counter (Fluke 1910A Multi-Counter)
    • Function generator (John's)
    • Power supply, bench, 2-channel (TENMA 72-7245)
    • Vise, wood (Travis's)
    • Magnifier lamp, large, without lid
    • Forge, propane (Jim's)

2. Enter that exact name in the search box

3. Press Enter

3. In the middle of the search results, click the link: "Create the page ___________ on this wiki!".

4. Check that "Create source" tab is selected at the top. You can come back later and edit in visual mode.

5. Paste the following into the text area:


{{Equipment page
| toolname = 
| model = 
| serial = 
| owner = 
| loanstatus = 
| arrived = 
| location = 
| status = 
| permission = 
| certification = 
| photo = 
| caption = 
| id = 
}}

==Specs==
TBD

==Usage==
TBD

==Troubleshooting==
TBD

==Documentation==
TBD

6. Fill in the template.

  • Leave photo, caption, and id blank for now. With the other fields, enter a question mark or leave it blank if you don't know that information. toolname is not supposed to be in the same format as the page title (what you decided on in step 1); instead, it should be more of a natural-sounding but still detailed name, such as "Tormach PCNC 1100 CNC mill" or "red 12" hacksaw". For help with the other fields, see the descriptions at Template:Equipment page.
  • Add the appropriate information on each line, after the equals sign.
  • (Optional) Add all appropriate tool categories. The current tool categories can be found listed in the "Subcategories" section of Category:Tools. Add links to the categories (e.g., [[Category:Showcase tools]]), at the very bottom of the page's code.

7. Click the "Show preview" button at the bottom of the editor to check that the page appears correctly. You should see an infobox on the right side of the preview, with the info you entered. If not, try to fix it so you do. If you don't, proceed anyway, and somebody else will probably fix it soon.

8. Click the blue "Save page" button at the bottom of the editor to publish your addition.

9. Assign a wiki-ID number to the tool according to the instructions for that.

10. Upload a photo with the wiki-ID number as the filename, such as 512.jpg.

11. Edit the tool page you created to add the photo. Copy and paste the filename into the photo field of the equipment page template: | photo = 512.jpg.

12. Preview and save the page again, preferably with an edit summary saying you added a photo.

All done! Now that the tool page is created, feel free to edit in visual mode by pressing "Edit" instead of "Edit source".

(Optional) Adding your tool to the gallery

  • Go to the tools we have gallery, find the appropriate section, and click the edit button on that section so you can insert an entry. Find the appropriate place in the section according to where the name you chose in step 1 fits in alphabetical order.
    • If editing in source mode, copy and paste the following code:
      File:FILENAME        |link=TOOLDESCRIPTION            |[[TOOLDESCRIPTION]]
    • If editing in visual mode, double-click the gallery in the appropriate section (or click once to select it and then click the "Edit" button that appears), then click "+ Add new image" at the bottom-left of the popup window. In the search box, type in the filename of the image, including the filename extension. When the image appears, click it. It will join the others in the column on the left; drag it to the appropriate alphabetical position. Don't close the popup window yet.
  • Fill in the info:
    • If editing in source mode, edit the line with FILENAME after the name of the image you uploaded, such as File:512.jpg or File:Red hacksaw.jpg, and replace the words "TOOLDECRIPTION" with the page you wish to link. Example: replace link=TOOLDESCRIPTION with link=Hacksaw, 12", red ID:512 and [[TOOLDESCRIPTION]] with [[Hacksaw, 12", red ID:512]]. Be careful to not delete the pipes (|), and make sure there are no spaces between the second pipe and the beginning of the link code ([[). It should look like this:
      File:512.jpg|link=Hacksaw, 12", red ID:512 |[[Hacksaw, 12", red ID:512]]
    • If editing in visual mode, click the link button (with the chain icon) at the top of the caption field below the image on the right side of the popup window. Start typing the title of the page you created, and click it when it appears in the suggestions. Now click the blue "Apply changes" button at the top-right of the popup window. Editing visually, you can't set the link= parameter; somebody else might do that, or you can add it yourself by editing again in source mode.
  • If editing in source mode, click the "Show preview" button at the bottom of the editor to check that your addition appears correctly. (In visual mode, the editor itself serves as the preview.) If not, try to fix it so it does. If you can't, proceed anyway, and somebody else will probably fix it soon.
  • Click the "Save changes".