Protospace Wiki:Adding new tools - Revision history

Dmitra.stupak: /* Adding a tool page */

2024-04-20T20:03:08Z

Adding a tool page

← Older revision		Revision as of 20:03, 20 April 2024
Line 1:		Line 1:
	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.

			<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>

	==Adding a tool page==		==Adding a tool page==

	~~It's easiest to create the tool page in "source mode", then come back after and edit it in "visual mode"~~.		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.'''
	~~Procedure:~~		* Examples:

	* Decide on a name ~~for the wiki to refer to the tool by.~~ 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)		: Laser cutter, large (Rabbit Laser RL-80-1290)
	: Counter (Fluke 1910A Multi-Counter)		: Counter (Fluke 1910A Multi-Counter)
Line 16:		Line 16:
	: Magnifier lamp, large, without lid		: Magnifier lamp, large, without lid
	: Forge, propane (Jim's)		: Forge, propane (Jim's)
	* Enter that exact name in the search box. '''Press Enter'''.		2. Enter that exact name in the '''search box'''
	* In the middle of the search results, ~~you should see (in Red)~~: "Create the page ___________ on this wiki!"~~. '''Click this red link~~'''.
	* You should see that '''"Create source"''' is selected at the top. You can come back later and edit in visual mode.		3. '''Press Enter'''
	* Paste ~~this~~ into the text ~~box~~:
			3. In the middle of the search results, '''click the link''': <span style="color:red">'''"Create the page ___________ on this wiki!"'''</span>.

			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:


	<pre>		<pre>
Line 51:		Line 57:
	</pre>		</pre>

	* Fill in the template. ~~'''~~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]].		6. '''Fill in''' the template.

			* 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.		* 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.		* (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.
	* 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.		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.
	* Click the blue "'''Save page'''" button at the bottom of the editor to publish your addition.
	* 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]].		8. Click the blue "'''Save page'''" button at the bottom of the editor to publish your addition.
	* [[Special:Upload\|Upload a photo]] with the wiki-ID number as the filename, such as <code>512.jpg</code>.
	* 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>.		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]].
	* Preview and save the page again, preferably with an edit summary saying you added a photo.
			10. '''[[Special:Upload\|Upload a photo]]''' with the wiki-ID number as the filename, such as <code>512.jpg</code>.

			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>.

			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".		All done! Now that the tool page is created, feel free to edit in visual mode by pressing "Edit" instead of "Edit source".

Pat.spencer: /* Adding a tool page */

2023-12-03T05:25:58Z

Adding a tool page

← Older revision		Revision as of 05:25, 3 December 2023
Line 16:		Line 16:
	: Magnifier lamp, large, without lid		: Magnifier lamp, large, without lid
	: Forge, propane (Jim's)		: Forge, propane (Jim's)
	* Enter that exact name in the search box. Press Enter.		* Enter that exact name in the search box. '''Press Enter'''.
	* In the middle of the search results, you should see (in Red): "Create the page ___________ on this wiki!". Click this red link.		* In the middle of the search results, you should see (in Red): "Create the page ___________ on this wiki!". '''Click this red link'''.
	* You should see that '''"Create source"''' is selected at the top. You can come back later and edit in visual mode.		* You should see that '''"Create source"''' is selected at the top. You can come back later and edit in visual mode.
	* Paste this into the text box:		* Paste this into the text box:
Line 55:		Line 55:
	* (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.		* (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.
	* 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.		* 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.
	* Click the blue "Save page" button at the bottom of the editor to publish your addition.		* Click the blue "'''Save page'''" button at the bottom of the editor to publish your addition.
	* 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]].		* 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]].
	* [[Special:Upload\|Upload a photo]] with the wiki-ID number as the filename, such as <code>512.jpg</code>.		* [[Special:Upload\|Upload a photo]] with the wiki-ID number as the filename, such as <code>512.jpg</code>.

Pat.spencer at 19:56, 2 December 2023

2023-12-02T19:56:56Z

← Older revision		Revision as of 19:56, 2 December 2023
Line 18:		Line 18:
	* Enter that exact name in the search box. Press Enter.		* Enter that exact name in the search box. Press Enter.
	* In the middle of the search results, you should see (in Red): "Create the page ___________ on this wiki!". Click this red link.		* In the middle of the search results, you should see (in Red): "Create the page ___________ on this wiki!". Click this red link.
	* ~~Make sure~~ '''"Create source"''' is selected at the top. You can come back later and edit in visual mode.		* You should see that '''"Create source"''' is selected at the top. You can come back later and edit in visual mode.
	* Paste this into the text box:		* Paste this into the text box:

Pat.spencer at 19:55, 2 December 2023

2023-12-02T19:55:30Z

← Older revision		Revision as of 19:55, 2 December 2023
Line 16:		Line 16:
	: Magnifier lamp, large, without lid		: Magnifier lamp, large, without lid
	: Forge, propane (Jim's)		: Forge, propane (Jim's)
	* Enter that exact name in the search box. Press Enter. In the middle of the search results, you should see: "Create the page ___________ on this wiki!". Click ~~the~~ red link.		* Enter that exact name in the search box. Press Enter.
			* In the middle of the search results, you should see (in Red): "Create the page ___________ on this wiki!". Click this red link.
	* Make sure '''"Create source"''' is selected at the top. You can come back later and edit in visual mode.		* Make sure '''"Create source"''' is selected at the top. You can come back later and edit in visual mode.
	* Paste this into the text box:		* Paste this into the text box:

Tanner.collin: /* Adding a tool page */

2023-01-20T18:38:05Z

Adding a tool page

← Older revision		Revision as of 18:38, 20 January 2023
Line 3:		Line 3:
	==Adding a tool page==		==Adding a tool page==

	It's easiest to create the page in "source mode", then come back after and edit it in "visual mode".		It's easiest to create the tool page in "source mode", then come back after and edit it in "visual mode".

	Procedure:		Procedure:

Tanner.collin at 18:35, 20 January 2023

2023-01-20T18:35:13Z

← Older revision		Revision as of 18:35, 20 January 2023
Line 52:		Line 52:
	* Fill in the template. '''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]].		* Fill in the template. '''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.		* 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~~. They won't appear as links once you save the page~~.		* (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.
	* 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.		* 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.
	* Click the blue "Save page" button at the bottom of the editor to publish your addition.		* Click the blue "Save page" button at the bottom of the editor to publish your addition.

Tanner.collin at 18:31, 20 January 2023

2023-01-20T18:31:38Z

← Older revision		Revision as of 18:31, 20 January 2023
Line 2:		Line 2:

	==Adding a tool page==		==Adding a tool page==

			It's easiest to create the page in "source mode", then come back after and edit it in "visual mode".

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

	==Adding your tool to the gallery==		==(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.		* 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.
Line 71:		Line 73:
	* 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.		* 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".		* Click the "Save changes".

	~~==Assigning a wiki-ID to a tool that doesn't have one==~~
	~~:''Main article: [[0#I want to assign a wiki-ID number to a tool or other item]]~~
	~~:''Prerequisite: an equipment page, created as described under 'Option 2' or 'Upgrading a tool from just a gallery entry (option 1) to a page (option 2)' (above)'''~~

	~~Procedure:~~

	~~''[not written yet; you can probably figure it out if you need to]''~~

Tanner.collin at 20:40, 19 January 2023

2023-01-19T20:40:18Z

← Older revision		Revision as of 20:40, 19 January 2023
Line 15:		Line 15:
	: Forge, propane (Jim's)		: Forge, propane (Jim's)
	* Enter that exact name in the search box. Press Enter. In the middle of the search results, you should see: "Create the page ___________ on this wiki!". Click the red link.		* Enter that exact name in the search box. Press Enter. In the middle of the search results, you should see: "Create the page ___________ on this wiki!". Click the red link.
	* Make sure '''"Create source"''' is selected at the top.		* Make sure '''"Create source"''' is selected at the top. You can come back later and edit in visual mode.
	* Paste this into the text box:		* Paste this into the text box:

Tanner.collin: Simplify more

2023-01-19T19:38:51Z

Simplify more

← Older revision		Revision as of 19:38, 19 January 2023
Line 50:		Line 50:
	* Fill in the template. '''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]].		* Fill in the template. '''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.		* Add the appropriate information on each line, after the equals sign.
	* Add any other information you want to below the template. (Reminder: the code for a section heading is <code>==Section title==</code>, with more equals signs for further levels.) If you don't have this information now, it can of course be added later.
	* (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. They won't appear as links once you save the page.		* (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. They won't appear as links once you save the page.
	* 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.		* 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.
Line 58:		Line 57:
	* 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>.		* 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 save the page again, preferably with an edit summary saying you added a photo.		* 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".

			==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.		* 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:		** If editing in source mode, copy and paste the following code:

Tanner.collin: Simplify tool procedure

2023-01-19T19:33:43Z

Simplify tool procedure

Show changes