Edit Guide: Difference between revisions
added instructions for file upload |
removed heading counter cuz i've managed to enable auto heading counting |
||
Line 1: | Line 1: | ||
== | ==Account creation== | ||
You do not need an account to edit the wiki, but please keep in mind that your current public IP address will be visible once you publish a change. | You do not need an account to edit the wiki, but please keep in mind that your current public IP address will be visible once you publish a change. | ||
== | ==Formatting== | ||
=== | ===Disable markup=== | ||
Mediawiki uses a custom markup language know as Wikitext which is simmiliar to Markdown. It allows users to format text, create links, build tables and structure content using plain text syntax. | Mediawiki uses a custom markup language know as Wikitext which is simmiliar to Markdown. It allows users to format text, create links, build tables and structure content using plain text syntax. | ||
==== | ====<nowiki><nowiki></nowiki></nowiki>==== | ||
You can write the text that you dont want formated by Wikitext between two nowiki tags. For example<br> | You can write the text that you dont want formated by Wikitext between two nowiki tags. For example<br> | ||
Line 23: | Line 23: | ||
[https://www.google.com/ https://www.google.com/] | [https://www.google.com/ https://www.google.com/] | ||
==== | ====Indentation==== | ||
If you want your text to be segregated because you want to draw extra attention to it, you can write that important text in a new line and insert a space before your text. Mediawiki will draw a rectangle around your text and change the font to make it stand out more. | If you want your text to be segregated because you want to draw extra attention to it, you can write that important text in a new line and insert a space before your text. Mediawiki will draw a rectangle around your text and change the font to make it stand out more. | ||
Line 29: | Line 29: | ||
Some very important and interesting text. | Some very important and interesting text. | ||
=== | ===Headings=== | ||
==== | ====Spacing==== | ||
Always leave one empty line before and after each heading, like this: | Always leave one empty line before and after each heading, like this: | ||
Text<br> | Text<br> | ||
== | ==New Heading==<br> | ||
Text | Text | ||
==== | ====Heading Counter==== | ||
The Balisong Wiki supports automatic counting of the headings. There is no need to manually number them. Once you are done with editing an article, the heading numbers will automatically be applied. | |||
==== | ====Creating Headings==== | ||
To create headings, write the text of the heading between = like this:<br> | To create headings, write the text of the heading between = like this:<br> | ||
<nowiki>== | <nowiki>==First Heading==</nowiki> | ||
You can make Sub-Headings by increasing the number of =<br> | You can make Sub-Headings by increasing the number of =<br> | ||
<nowiki>=== | <nowiki>===Sub-Heading for first Heading===</nowiki> | ||
<nowiki>==== | <nowiki>====Sub-Sub-Heading for first Heading====</nowiki> | ||
=== | ===Break=== | ||
Sometimes it is necessarry to make multiple newlines. In that case the <nowiki><br></nowiki> tag can be used. Here is an example: | Sometimes it is necessarry to make multiple newlines. In that case the <nowiki><br></nowiki> tag can be used. Here is an example: | ||
Line 62: | Line 62: | ||
Text | Text | ||
== | ==Linking== | ||
In order to create a link to a different article, or a different website, you will need to use square brackets | In order to create a link to a different article, or a different website, you will need to use square brackets | ||
Line 68: | Line 68: | ||
<nowiki>[]</nowiki> | <nowiki>[]</nowiki> | ||
=== | ===Spaces=== | ||
If an article you want to link to has spaces, for example the Balisong List, just use underscores for those spaces<br> | If an article you want to link to has spaces, for example the Balisong List, just use underscores for those spaces<br> | ||
Line 78: | Line 78: | ||
[[Balisong_List]] | [[Balisong_List]] | ||
=== | ===Internal=== | ||
If you want to link to another article within the Balisong Wiki, write the name of the article between two square brackets like this: | If you want to link to another article within the Balisong Wiki, write the name of the article between two square brackets like this: | ||
Line 88: | Line 88: | ||
[[Sandbox]] | [[Sandbox]] | ||
==== | ====Specific section==== | ||
<!-- This stays empty--> | <!-- This stays empty--> | ||
===== | =====To another article===== | ||
If you want to link to a specific section, write the name of the article, then a pound symbol (#) then the name of the section. | If you want to link to a specific section, write the name of the article, then a pound symbol (#) then the name of the section. | ||
<nowiki>[[Pin_System# | <nowiki>[[Pin_System#Screw_Zen]]</nowiki> | ||
And it will be rendered like this: | And it will be rendered like this: | ||
[[Pin_System# | [[Pin_System#Screw_Zen]] | ||
===== | =====To the same article===== | ||
If you want to link to a same section of the article that you are currently editing, you can leave the linking of the article part out, and just write the pund symbol (#) with the name of the section.<br> | If you want to link to a same section of the article that you are currently editing, you can leave the linking of the article part out, and just write the pund symbol (#) with the name of the section.<br> | ||
This will link to the first section of this article<br> | This will link to the first section of this article<br> | ||
<nowiki>[[# | <nowiki>[[#Account_creation]]</nowiki> | ||
And it will be rendered like this: | And it will be rendered like this: | ||
[[# | [[#Account_creation]] | ||
=== | ===Pipe=== | ||
Adding a pipe symbol (|) to the end of your internal linking enables you to write a custom name for the linking. This can be useful to slightly adjust the name of the link so that sentences flow better, or to remove the underscore that is caused by linking | Adding a pipe symbol (|) to the end of your internal linking enables you to write a custom name for the linking. This can be useful to slightly adjust the name of the link so that sentences flow better, or to remove the underscore that is caused by linking | ||
Line 123: | Line 123: | ||
[[Balisong_list|Balisong List]] | [[Balisong_list|Balisong List]] | ||
=== | ===External=== | ||
If you want to link to a different website, for example to show the reader where they can buy a specific bushing, put your link in only 1 set of square brackets | If you want to link to a different website, for example to show the reader where they can buy a specific bushing, put your link in only 1 set of square brackets | ||
Line 141: | Line 141: | ||
[https://thetruelink.com/products/250-od-x-188-id-bushing-xp 6.35mm OD bushings] | [https://thetruelink.com/products/250-od-x-188-id-bushing-xp 6.35mm OD bushings] | ||
== | ==Naming Conventions== | ||
These naming conventions have been created to make page names more consistent, make it easiert for users to find pages and and to make linking easier.<br> | These naming conventions have been created to make page names more consistent, make it easiert for users to find pages and and to make linking easier.<br> | ||
Line 154: | Line 154: | ||
- Avoid unnecessary words. For example "About The Zen Pin Mechanism" | - Avoid unnecessary words. For example "About The Zen Pin Mechanism" | ||
== | ==Creating a new Page== | ||
Before you create a new article, please check whether that article already exists or not. The search bar at the top and be a good tool for that. | Before you create a new article, please check whether that article already exists or not. The search bar at the top and be a good tool for that. | ||
Line 164: | Line 164: | ||
After that you have to decide if you want to use the visual editor (not recommended), or the source editor. If you want to use the visual editor, click on "Create". If you want to use the source editor, click on "Create source". The next steps are almost identical with just editing an article, so we recommend you to continue reading the next section. | After that you have to decide if you want to use the visual editor (not recommended), or the source editor. If you want to use the visual editor, click on "Create". If you want to use the source editor, click on "Create source". The next steps are almost identical with just editing an article, so we recommend you to continue reading the next section. | ||
== | ==Editing an article== | ||
If you want to edit an article, you need to click on the "Edit" or "Edit Source" button. They are usually somewhere on the top right of your screen. | If you want to edit an article, you need to click on the "Edit" or "Edit Source" button. They are usually somewhere on the top right of your screen. | ||
=== | ===Source Editor=== | ||
If you have clicked the "Edit source" button, a big box will appear in which you can write everything that you know about the topic of the article. If you want to see the changes to the article, scroll to the bottom of the page and click on the "Show preview" button. This will reload the article and show you the text with all the rendered Wikitext code that you have written. | If you have clicked the "Edit source" button, a big box will appear in which you can write everything that you know about the topic of the article. If you want to see the changes to the article, scroll to the bottom of the page and click on the "Show preview" button. This will reload the article and show you the text with all the rendered Wikitext code that you have written. | ||
After you have filled the article with information, scroll to the bottom of the page, and write a summary in the "Summary" block like "First edit of the Banana page" and click on "Save page". You might also need to fill out an easy captcha for the changes to to live. | After you have filled the article with information, scroll to the bottom of the page, and write a summary in the "Summary" block like "First edit of the Banana page" and click on "Save page". You might also need to fill out an easy captcha for the changes to to live. | ||
=== | ===Visual Editor=== | ||
The visual editor is not recommended since it has not been tested. | The visual editor is not recommended since it has not been tested. | ||
Line 180: | Line 180: | ||
After you have filled the article with information, click the "Save" button, add a summary message like "First edit of the Banana page" and click on "Save Page". You might also need to fill out an easy captcha for the changes to to live. | After you have filled the article with information, click the "Save" button, add a summary message like "First edit of the Banana page" and click on "Save Page". You might also need to fill out an easy captcha for the changes to to live. | ||
== | ==File Uploads== | ||
The Balisong Wiki supports uploading of media. If you want to upload a picture, click on the "Upload file" field, or just click this link: [[Special:Upload]]. | The Balisong Wiki supports uploading of media. If you want to upload a picture, click on the "Upload file" field, or just click this link: [[Special:Upload]]. | ||
=== | ===Limits=== | ||
Please only upload files that are 1920x1080 or smaller. Large pictures take up a lot of ram, potentially making the Balisong Wiki go [https://en.wikipedia.org/wiki/Out_of_memory out of memory]. If you see a screen like this: | Please only upload files that are 1920x1080 or smaller. Large pictures take up a lot of ram, potentially making the Balisong Wiki go [https://en.wikipedia.org/wiki/Out_of_memory out of memory]. If you see a screen like this: | ||
Line 190: | Line 190: | ||
Please immediately contact the server owner [[Main_Page#3Contacting_the_owner]]. | Please immediately contact the server owner [[Main_Page#3Contacting_the_owner]]. | ||
=== | ===Embedding=== | ||
Instructions for how to embed files on a page are on the file upload page [[Special:Upload]], but in case you want something clearer:<br> | Instructions for how to embed files on a page are on the file upload page [[Special:Upload]], but in case you want something clearer:<br> | ||
Line 198: | Line 198: | ||
<nowiki>[[File:Balisong_Kraken_Blue.png]]</nowiki> | <nowiki>[[File:Balisong_Kraken_Blue.png]]</nowiki> | ||
== | ==Measurements== | ||
All measurementes must be provided in metric with an optional measurement in imperial in parenthesis. You are allowed to break this rule if you are citing a source (see the next sub-heading [[#7.1_Only_submit_your_own_measurements]] for more information). | All measurementes must be provided in metric with an optional measurement in imperial in parenthesis. You are allowed to break this rule if you are citing a source (see the next sub-heading [[#7.1_Only_submit_your_own_measurements]] for more information). | ||
Line 212: | Line 212: | ||
6.35 (0.25) | 6.35 (0.25) | ||
=== | ===Only submit your own measurements=== | ||
While manifacturers may provide measurements for their products, they are often times inaccurate. For example: Squid Industries lists their [https://www.squidindustries.co/products/oversized-bushings?variant=44002598682796 Nautilus bushings] as having an OD of 0.2482" +/- .0002 OD = 6.30428mm +/- 0.00508, yet actual measurements show an OD of 6.326mm (0.2490551in). Similiarly, Nabalis markets their [https://nabalis.com/cdn/shop/files/VULP_0f6d9ff8-34ba-4c2b-8775-15e20801042f.jpg?v=1746763288&width=700 bushings as 7mm OD], but actual measurements show an OD of 6.985mm. | While manifacturers may provide measurements for their products, they are often times inaccurate. For example: Squid Industries lists their [https://www.squidindustries.co/products/oversized-bushings?variant=44002598682796 Nautilus bushings] as having an OD of 0.2482" +/- .0002 OD = 6.30428mm +/- 0.00508, yet actual measurements show an OD of 6.326mm (0.2490551in). Similiarly, Nabalis markets their [https://nabalis.com/cdn/shop/files/VULP_0f6d9ff8-34ba-4c2b-8775-15e20801042f.jpg?v=1746763288&width=700 bushings as 7mm OD], but actual measurements show an OD of 6.985mm. | ||
Line 218: | Line 218: | ||
Because such discrepancies are common, we ask that you only submit measurements that you have personally verified. | Because such discrepancies are common, we ask that you only submit measurements that you have personally verified. | ||
== | ==Tables== | ||
Tables can be either edited by hand (not recommended), or a table generator can be used. We recommend this [https://www.tablesgenerator.com/mediawiki_tables# table generator]. | Tables can be either edited by hand (not recommended), or a table generator can be used. We recommend this [https://www.tablesgenerator.com/mediawiki_tables# table generator]. | ||
If you wish to edit this table, copy it, go to the mentioned website, click "File" in the top left, click "Paste table data..." and paste it in. Then click the blue "Load" button. After that feel free to make any changes you deem neccessary. After you've adjusted the table, scroll all the way down and click on "Generate" button which is on the left hand side of the screen. After that click on the green "Copy to clipboard" button which is on the right hand side of your screen, or just copy the whole code which is in the window right under the gray "Result (click "Generate" to refresh)" text. After that, delete the old table from this wiki and paste in your newly edited wiki. | If you wish to edit this table, copy it, go to the mentioned website, click "File" in the top left, click "Paste table data..." and paste it in. Then click the blue "Load" button. After that feel free to make any changes you deem neccessary. After you've adjusted the table, scroll all the way down and click on "Generate" button which is on the left hand side of the screen. After that click on the green "Copy to clipboard" button which is on the right hand side of your screen, or just copy the whole code which is in the window right under the gray "Result (click "Generate" to refresh)" text. After that, delete the old table from this wiki and paste in your newly edited wiki. | ||
== | ==Comments== | ||
If you want to add text that is only visible when editing the Balisong Wiki, for example when you want to tell another editor why you have done what you did, you can write a comment like so: | If you want to add text that is only visible when editing the Balisong Wiki, for example when you want to tell another editor why you have done what you did, you can write a comment like so: |
Revision as of 13:30, 27 June 2025
Account creation
You do not need an account to edit the wiki, but please keep in mind that your current public IP address will be visible once you publish a change.
Formatting
Disable markup
Mediawiki uses a custom markup language know as Wikitext which is simmiliar to Markdown. It allows users to format text, create links, build tables and structure content using plain text syntax.
<nowiki></nowiki>
You can write the text that you dont want formated by Wikitext between two nowiki tags. For example
<nowiki>https://www.google.com/</nowiki>
will look like this:
https://www.google.com/
instead of being a clickable link to Google like this:
Indentation
If you want your text to be segregated because you want to draw extra attention to it, you can write that important text in a new line and insert a space before your text. Mediawiki will draw a rectangle around your text and change the font to make it stand out more.
Some very important and interesting text.
Headings
Spacing
Always leave one empty line before and after each heading, like this:
Text
==New Heading==
Text
Heading Counter
The Balisong Wiki supports automatic counting of the headings. There is no need to manually number them. Once you are done with editing an article, the heading numbers will automatically be applied.
Creating Headings
To create headings, write the text of the heading between = like this:
==First Heading==
You can make Sub-Headings by increasing the number of =
===Sub-Heading for first Heading===
====Sub-Sub-Heading for first Heading====
Break
Sometimes it is necessarry to make multiple newlines. In that case the <br> tag can be used. Here is an example:
Text<br><br>
Text
Linking
In order to create a link to a different article, or a different website, you will need to use square brackets
[]
Spaces
If an article you want to link to has spaces, for example the Balisong List, just use underscores for those spaces
[[Balisong_List]]
And it will be rendered like this:
Internal
If you want to link to another article within the Balisong Wiki, write the name of the article between two square brackets like this:
[[Sandbox]]
And it will be rendered like this:
Specific section
To another article
If you want to link to a specific section, write the name of the article, then a pound symbol (#) then the name of the section.
[[Pin_System#Screw_Zen]]
And it will be rendered like this:
To the same article
If you want to link to a same section of the article that you are currently editing, you can leave the linking of the article part out, and just write the pund symbol (#) with the name of the section.
This will link to the first section of this article
[[#Account_creation]]
And it will be rendered like this:
Pipe
Adding a pipe symbol (|) to the end of your internal linking enables you to write a custom name for the linking. This can be useful to slightly adjust the name of the link so that sentences flow better, or to remove the underscore that is caused by linking
[[Balisong_list|Balisong List]]
Will be rendered as
External
If you want to link to a different website, for example to show the reader where they can buy a specific bushing, put your link in only 1 set of square brackets
[https://thetruelink.com/products/250-od-x-188-id-bushing-xp]
And it will be rendered like this:
If you want to give your link a name, add a space after the link and add a name.
[https://thetruelink.com/products/250-od-x-188-id-bushing-xp 6.35mm OD bushings]
And it will be rendered like this:
Naming Conventions
These naming conventions have been created to make page names more consistent, make it easiert for users to find pages and and to make linking easier.
These rules apply to page titles and headings, although headings follow a slightly looser version of these rules.
- Every word must be capitalized, even small words like "of" or "and", unless a name is intentionally written in lowecase, for example "iPhone".
- Always use singular instead of plural. For example "Washer" instead of "Washers".
- Use nouns, not verbs. Instead of "Tuning", use "Tune". A good rule of thumb for this is "Name the thing, not the action".
- Avoid unnecessary words. For example "About The Zen Pin Mechanism"
Creating a new Page
Before you create a new article, please check whether that article already exists or not. The search bar at the top and be a good tool for that.
If you have made sure that the page you want to create doesnt already exist, you can create the article by opening the base link of this wiki (balisong.info) and append a forward slash (/) and append the name of the article you want to create. For example if you want to create an article called Banana, you would open this link:
After that you have to decide if you want to use the visual editor (not recommended), or the source editor. If you want to use the visual editor, click on "Create". If you want to use the source editor, click on "Create source". The next steps are almost identical with just editing an article, so we recommend you to continue reading the next section.
Editing an article
If you want to edit an article, you need to click on the "Edit" or "Edit Source" button. They are usually somewhere on the top right of your screen.
Source Editor
If you have clicked the "Edit source" button, a big box will appear in which you can write everything that you know about the topic of the article. If you want to see the changes to the article, scroll to the bottom of the page and click on the "Show preview" button. This will reload the article and show you the text with all the rendered Wikitext code that you have written. After you have filled the article with information, scroll to the bottom of the page, and write a summary in the "Summary" block like "First edit of the Banana page" and click on "Save page". You might also need to fill out an easy captcha for the changes to to live.
Visual Editor
The visual editor is not recommended since it has not been tested.
If you have clicked the "Edit" buttonm you can just start writing down everything you know about the topic of the article. After you have filled the article with information, click the "Save" button, add a summary message like "First edit of the Banana page" and click on "Save Page". You might also need to fill out an easy captcha for the changes to to live.
File Uploads
The Balisong Wiki supports uploading of media. If you want to upload a picture, click on the "Upload file" field, or just click this link: Special:Upload.
Limits
Please only upload files that are 1920x1080 or smaller. Large pictures take up a lot of ram, potentially making the Balisong Wiki go out of memory. If you see a screen like this:Please immediately contact the server owner Main_Page#3Contacting_the_owner.
Embedding
Instructions for how to embed files on a page are on the file upload page Special:Upload, but in case you want something clearer:
If you want to embeda picture, write 2 brackets, then "File:" followed by the name of the file, including its file extension.
For example like this:
[[File:Balisong_Kraken_Blue.png]]
Measurements
All measurementes must be provided in metric with an optional measurement in imperial in parenthesis. You are allowed to break this rule if you are citing a source (see the next sub-heading #7.1_Only_submit_your_own_measurements for more information).
6.35mm (0.25in)
or just
6.35mm
The unit of measurement is not neccessary, but should still be added if there is enough space for it. If there is no unit after the number, assume Millimeters or Grams depending on context. For example:
6.35 (0.25)
Only submit your own measurements
While manifacturers may provide measurements for their products, they are often times inaccurate. For example: Squid Industries lists their Nautilus bushings as having an OD of 0.2482" +/- .0002 OD = 6.30428mm +/- 0.00508, yet actual measurements show an OD of 6.326mm (0.2490551in). Similiarly, Nabalis markets their bushings as 7mm OD, but actual measurements show an OD of 6.985mm.
Because such discrepancies are common, we ask that you only submit measurements that you have personally verified.
Tables
Tables can be either edited by hand (not recommended), or a table generator can be used. We recommend this table generator. If you wish to edit this table, copy it, go to the mentioned website, click "File" in the top left, click "Paste table data..." and paste it in. Then click the blue "Load" button. After that feel free to make any changes you deem neccessary. After you've adjusted the table, scroll all the way down and click on "Generate" button which is on the left hand side of the screen. After that click on the green "Copy to clipboard" button which is on the right hand side of your screen, or just copy the whole code which is in the window right under the gray "Result (click "Generate" to refresh)" text. After that, delete the old table from this wiki and paste in your newly edited wiki.
Comments
If you want to add text that is only visible when editing the Balisong Wiki, for example when you want to tell another editor why you have done what you did, you can write a comment like so:
<!--This is a comment and will only be visible when editing the wiki-->