Difference between revisions of "UniWiki:Editing Guide"
Lelira cirim (talk | contribs) (improved flow based on class syllabus) |
(Change returnto= parameter of the SSO button in the Who can edit section to return to this article. Extend Special:ListUsers link to actually return a list pf administrators.) |
||
(59 intermediate revisions by 14 users not shown) | |||
Line 1: | Line 1: | ||
− | [[ | + | {{update|Note to self: update who can edit and how to login, make Sandboxes more prominent, .... [[User:Arin Mara|Arin Mara]] ([[User talk:Arin Mara|talk]]) 09:45, 23 April 2022 (UTC)}} |
− | [[ | + | |
− | [[ | + | {{hatnote|This page serves as a step-by-step guide to editing the UniWiki. For detailed editing guidelines, see [[UniWiki:Manual of Style]] and [[UniWiki:Mission formatting guidelines]].}} |
− | + | [[Wikipedia:Wiki|Wikis]] are a great way to share information within a community, since everyone can make additions to the knowledge base. This is also its greatest weakness. Wikis often rely on a relatively large active community, instead of a small group of dedicated writers. This guide explains how you can add information to our wiki. | |
− | [ | + | |
+ | == Who can edit? == | ||
+ | Everyone is welcome to contribute to the UniWiki! To begin editing you need to log in with your EVE account by clicking on the [[EVE SSO]] button [[File:Eve-sso-login-black-small.png||link=https://wiki.eveuniversity.org/index.php?title=Special:OAuth2Client/redirect&returnto=UniWiki:Editing+Guide]] in the top right corner. | ||
+ | |||
+ | Most pages on the UniWiki are editable by anyone who is logged in. Only a few [[Special:ProtectedPages|important or sensitive pages]] are restricted to being edited by [[Special:ListUsers/sysop|administrators]]. If you want to edit a restricted page, but can't, use the [[mediawikiwiki:Help:Talk pages|Talk Page]] to explain to the administrator what you want to edit. | ||
+ | |||
+ | == Preparing to Edit == | ||
+ | |||
+ | === Sandbox === | ||
+ | Want to fool around in the wiki without worrying about screwing up existing articles? [[UniWiki:Sandbox|Go play in the sandbox]]! | ||
+ | |||
+ | === Drafts and User Pages === | ||
+ | Every registered user has [[Special:MyPage|their own user page]] (you can access yours at the top-right of the screen, by clicking on your user name). This is your personal page, which you can use however you see fit. Most people use it to talk about themselves, or to save drafts of articles they are working on. This can be useful if you're working on a major new page (or are heavily rewriting an existing page), as you can work on it at your own pace without leaving the original page in a completely disjointed state. Note that this page isn't technically "private" (anyone can read and edit it), although you generally shouldn't edit other people's user pages without their consent. | ||
+ | |||
+ | You also have a "user discussion page" (the "my talk" link next to your user name, at the top-right of the screen), where other people can leave you messages. Alternatively, if you want to contact someone, you can go to the #wiki channel on the EVE Uni [[Discord]] or send them a [https://forum.eveuniversity.org/ucp.php?i=pm&folder=inbox private message] via the E-UNI forum. | ||
− | + | === Discussion Tabs === | |
+ | If you feel a certain page requires discussion prior to major changes, each page comes with its own discussion page (the link is at the top-left of a page). This is really just a regular wiki page, so adding comments to it works exactly the same way as adding to any other wiki article. To sign the message with your name, end your message with four tildes. <nowiki>( ~~~~ )</nowiki> | ||
− | + | If a page is protected and locked from editing by normal users, please use that page's Discussion tab to propose simple or obvious changes. This makes it straightforward for a manager or director to copy the wiki code, if provided. More complex discussions about page content typically occur on the EVE Uni #wiki [[Discord]] channel or [https://forum.eveuniversity.org/viewforum.php?f=54 in the Forums]. | |
− | == Creating a | + | === Creating a Page === |
[[File:wiki1.png|thumb]] | [[File:wiki1.png|thumb]] | ||
− | Before creating a new page, do a few wiki searches with relevant keywords. If there is an existing article that already ties closely to your subject, it may be better to add to the existing article instead of creating a new one. Likewise, if a subtopic in an article becomes really big, it may be worth splitting it off into | + | Before creating a new page, do a few wiki searches with relevant keywords. If there is an existing article that already ties closely to your subject, it may be better to add to the existing article instead of creating a new one. Likewise, if a subtopic in an article becomes really big, it may be worth splitting it off into its own article. |
Creating a page is very easy, as all pages exist ''in potentia''. This means in order to create a page, all you need to do is go to that page and add content. Confused? Don't worry, we have pictures! | Creating a page is very easy, as all pages exist ''in potentia''. This means in order to create a page, all you need to do is go to that page and add content. Confused? Don't worry, we have pictures! | ||
Line 25: | Line 40: | ||
Of course, just plain text doesn't make for very useful and readable wiki pages. The next part of this guide describes the wiki markup language. | Of course, just plain text doesn't make for very useful and readable wiki pages. The next part of this guide describes the wiki markup language. | ||
− | == | + | == Editing a Page == |
− | + | To edit any page, go to that page and click the 'Edit' tab at the top of the page or the 'Edit' link to the right of each section (if you don't see the 'Edit' you need to login first). | |
+ | |||
+ | If you are new to wiki editing, or mediawiki in particular, [[Wikipedia:Wikipedia:Tutorial/Editing|Wikipedia's Tutorial]] is quite useful. The [[Wikipedia:Help:Cheatsheet|Wikipedia Cheatsheet]] is also handy to keep around. | ||
− | + | === Editing Toolbar === | |
+ | The editing toolbar now in use by the UniWiki is the standard mediawiki version. | ||
+ | The previous version is [http://meta.wikimedia.org/wiki/Help:Edit_toolbar described here], and if you prefer using it, it can be re-enabled in your [[Special:Preferences|My Preferences]], under [[Special:Preferences#mw-prefsection-editing|Editing]] tab by disabling "Enable enhanced editing toolbar". | ||
− | + | The enhanced toolbar has instant Preview and Changes functionality, and the "Show" buttons below the edit window perform the same actions. Due to the style-sheets in use, the toolbar panes are configured to be compatible with the black background of the UniWiki's default theme. If you choose to use a different color scheme, the buttons below should function with better visibility for you. | |
− | |||
− | === Wiki | + | === Wiki Syntax === |
==== Headings ==== | ==== Headings ==== | ||
The use of headings not only makes for readable text but also automatically generates a table of contents. Headings are very easy to add, simply surround the title of the paragraph with equal signs ( '=' ). | The use of headings not only makes for readable text but also automatically generates a table of contents. Headings are very easy to add, simply surround the title of the paragraph with equal signs ( '=' ). | ||
Line 44: | Line 62: | ||
==== Links ==== | ==== Links ==== | ||
− | Linking is one of the most powerful aspects of a wiki, so it is important that it is understood well. First you must | + | Linking is one of the most powerful aspects of a wiki, so it is important that it is understood well. First, you must realize there is a difference between intra-wiki links (links to other articles on this wiki) and external links (links to external websites/pages). |
− | The basic intra-wiki link has the following syntax: <pre><nowiki>[[Link topic]]</nowiki></pre> where '''Link topic''' is a page on the wiki. For example, if we wish to link to [[Main Page]] we use <pre><nowiki>[[Main Page]]</nowiki></pre> These topics can include spaces, as the wiki will automatically reformat the text to the correct link. You can also link to pages that do not exist yet such as this [[ | + | The basic intra-wiki link has the following syntax: <pre><nowiki>[[Link topic]]</nowiki></pre> where '''Link topic''' is a page on the wiki. For example, if we wish to link to [[Main Page]] we use <pre><nowiki>[[Main Page]]</nowiki></pre> These topics can include spaces, as the wiki will automatically reformat the text to the correct link. You can also link to pages that do not exist yet such as this intentionally [[red link]], when you feel that subject deserves its own article. The link will then appear red instead of orange, and people will hopefully feel encouraged to create the article. |
+ | {{clear}} | ||
+ | To link to a sub-heading of a page, simply add #Heading to the topic, like so: <pre><nowiki>[[Link topic#Heading]]</nowiki></pre> | ||
− | As you can see, the text inside the double square brackets is both the destination (the page it links to) and the description (the text that shows up as link). In order to change the description you can use the pipe ('|') in the following syntax: <pre><nowiki>[[Link topic|link text]]</nowiki></pre> For example: <pre><nowiki>[[Main Page|Example]]</nowiki></pre> becomes [[Main Page|Example]] | + | As you can see, the text inside the double square brackets is both the destination (the page it links to) and the description (the text that shows up as link). In order to change the description you can use the pipe ('|') in the following syntax: <pre><nowiki>[[Link topic|link text]]</nowiki></pre> For example: <pre><nowiki>[[Main Page|Example]]</nowiki></pre> becomes [[Main Page|Example]]. |
In order to make external links, you can use single square brackets like so: <pre><nowiki>[http://www.google.com]</nowiki></pre> If you want to change the description text of your external link, separate the url from the description with a space [http://www.google.com like so]: <pre><nowiki>[http://www.google.com like so]</nowiki></pre> | In order to make external links, you can use single square brackets like so: <pre><nowiki>[http://www.google.com]</nowiki></pre> If you want to change the description text of your external link, separate the url from the description with a space [http://www.google.com like so]: <pre><nowiki>[http://www.google.com like so]</nowiki></pre> | ||
Line 75: | Line 95: | ||
==== Images ==== | ==== Images ==== | ||
− | Advanced information can be found on [ | + | {{main|UniWiki:Manual of Style/Images}} |
+ | Advanced information can be found on [[Mediawikiwiki:Help:Images]] or [[Wikipedia:Help:Pictures]]. | ||
− | + | To include images (or other files) in your article, simply link them like <pre><nowiki>[[File:filename.ext]]</nowiki></pre> For example, the first image in this guide is linked as <pre><nowiki>[[File:wiki1.png]]</nowiki></pre> | |
After saving the edit, click the file link and follow the form to upload your file. Of course, you can always look at the source of an article (click the edit link) and look up markup codes that aren't described here. | After saving the edit, click the file link and follow the form to upload your file. Of course, you can always look at the source of an article (click the edit link) and look up markup codes that aren't described here. | ||
− | To upload your image: | + | To upload your image without first creating a link to it: |
[[File:UploadFile.png]] | [[File:UploadFile.png]] | ||
− | <--Look-left--- | + | [[Special:Upload|<--Look-left---and up ^]] |
====Tables==== | ====Tables==== | ||
− | {{hatnote|For full details of tables, see [ | + | {{hatnote|For full details of tables, see [[Mediawikiwiki:Help:Tables|Mediawiki's article]]}} |
− | + | {| class="wikitable" style="width:70%" | |
− | + | | style="padding: 10px;"| <big><nowiki>{|</nowiki></big> | |
− | + | | style="padding: 5px;"| '''table start''', ''required'' | |
− | + | |- | |
− | + | | style="padding: 10px;"| <big><nowiki>|+</nowiki></big> | |
+ | | style="padding: 5px;" | table '''caption''', ''optional;'' only between '''table start''' and '''table row''' | ||
+ | |- | ||
+ | | style="padding: 10px;"| <big><nowiki>|-</nowiki></big> | ||
+ | | style="padding: 5px;" | '''table row''', ''optional on first row'' - wiki engine assumes the first row | ||
+ | |- | ||
+ | | style="padding: 10px;"| <big><nowiki>!</nowiki></big> | ||
+ | | style="padding: 5px;" | '''table header''' cell, ''optional.'' Consecutive '''table header''' cells may be added on same line separated by double marks (<code>!!</code>) or start on new lines, each with its own single mark (<code>!</code>). | ||
+ | |- | ||
+ | | style="padding: 10px;"| <big><nowiki>|</nowiki></big> | ||
+ | | style="padding: 5px;" | '''table data''' cell, ''optional''. Consecutive '''table data''' cells may be added on same line separated by double marks (<code><nowiki>||</nowiki></code>) or start on new lines, each with its own single mark (<code><nowiki>|</nowiki></code>). | ||
+ | |- | ||
+ | | style="padding: 10px;"| <big><nowiki>|}</nowiki></big> | ||
+ | | style="padding: 5px;" | '''table end''', ''required'' | ||
+ | |} | ||
Example: | Example: | ||
<pre><nowiki> | <pre><nowiki> | ||
− | {| | + | {| class="wikitable" |
− | | | + | |+ Caption text |
− | | | + | |- |
− | | | + | ! Header text 1 !! Header text 2 !! Header text 3 |
+ | |- | ||
+ | | Example 1 || Example 2 || Example 3 | ||
|- | |- | ||
− | | | + | | Example 4 || Example 5 || Example 6 |
− | | | ||
− | | | ||
|- | |- | ||
− | | | + | | Example 7 || Example 8 || Example 9 |
− | | | ||
− | | | ||
|} | |} | ||
</nowiki></pre> | </nowiki></pre> | ||
Produces: | Produces: | ||
− | {| | + | {| class="wikitable" |
− | | | + | |+ Caption text |
− | | | + | |- |
− | + | ! Header text 1 !! Header text 2 !! Header text 3 | |
|- | |- | ||
− | | | + | | Example 1 || Example 2 || Example 3 |
− | | | ||
− | | | ||
|- | |- | ||
− | | | + | | Example 4 || Example 5 || Example 6 |
− | | | + | |- |
− | | | + | | Example 7 || Example 8 || Example 9 |
|} | |} | ||
− | + | ====See Also==== | |
− | + | [[Uniwiki:Editing commands visual guide]] | |
− | + | [[Wikipedia:Wikipedia:Manual of Style#Keep markup simple|Wikipedia Foundation Manual of Style]] | |
+ | |||
+ | ===References=== | ||
If you would like to cite a source to support your text, place <nowiki><ref> </ref></nowiki> tags around the citation and add a <nowiki><references /></nowiki> tag at the end of the article. | If you would like to cite a source to support your text, place <nowiki><ref> </ref></nowiki> tags around the citation and add a <nowiki><references /></nowiki> tag at the end of the article. | ||
For example, for a single reference, use <nowiki><ref>text of the citation</ref></nowiki> | For example, for a single reference, use <nowiki><ref>text of the citation</ref></nowiki> | ||
− | For repeated citations, use the<nowiki><ref name="name"></nowiki> tag: | + | For repeated citations, use the <nowiki><ref name="name"></nowiki> tag: |
− | *For the first of multiple instances, use :<nowiki><ref name="name">text of the citation</ref></nowiki> | + | * For the first of multiple instances, use :<nowiki><ref name="name">text of the citation</ref></nowiki> |
− | *For the following uses, just use <nowiki><ref name="name" /></nowiki> | + | * For the following uses, just use <nowiki><ref name="name" /></nowiki> |
− | Place the <nowiki><references /></nowiki> tag at the bottom of the article and it will list all references used in the article. You can also use | + | Place the <nowiki><references /></nowiki> tag at the bottom of the article and it will list all references used in the article. You can also use the {{Tl|Reflist}} instead. |
− | For more examples see [ | + | For more examples see [[Wikipedia:Wikipedia:Citing sources|Wikipedia:Citing sources]] |
=== Proper categorization === | === Proper categorization === | ||
− | It is important we categorize our articles properly. This allows our | + | {{Main|UniWiki:Categorization}} |
+ | {{main|Help:Categorization}} | ||
+ | It is important we categorize our articles properly. This allows our category pages to automatically list all articles in their category, which makes it easy for people to see the collection of articles in the same category. | ||
− | Categories should be used as collection mechanic instead of custom-made pages where we have to manually add links to new articles. | + | Categories should be used as a collection mechanic instead of custom-made pages where we have to manually add links to new articles. |
You can add a category to an article by adding | You can add a category to an article by adding | ||
− | <pre><nowiki>[[Category: | + | <pre><nowiki>[[Category:CategoryName]]</nowiki></pre> anywhere in the article (categories are usually listed either at the start or end of an article). CategoryName should obviously be replaced with the name of the category. For an example, see the source of this article and note that it includes: <pre><nowiki>[[Category:Guides]]</nowiki></pre> |
If you wish to link to a category page, use the following syntax: <pre><nowiki>[[:Category:CategoryName]]</nowiki></pre> Note the first colon. Example [[:Category:Guides|Guides]]: <pre><nowiki>[[:Category:Guides|Guides]]</nowiki></pre> | If you wish to link to a category page, use the following syntax: <pre><nowiki>[[:Category:CategoryName]]</nowiki></pre> Note the first colon. Example [[:Category:Guides|Guides]]: <pre><nowiki>[[:Category:Guides|Guides]]</nowiki></pre> | ||
− | === | + | === Redirects === |
A topic could be known by different titles, therefore a Redirect on these titles to the available topic can be very useful to find it. | A topic could be known by different titles, therefore a Redirect on these titles to the available topic can be very useful to find it. | ||
Line 161: | Line 196: | ||
=== Templates === | === Templates === | ||
− | {{main| | + | {{main|UniWiki:Templates}} |
− | Templates allow us to automatically format information a certain way. For example, the Clean Up template always looks like this: {{ | + | Templates allow us to automatically format information a certain way. For example, the Clean Up template always looks like this: |
+ | {{Banner|color= #153E7E|'''This article should be cleaned up or improved.'''}} | ||
In order to include a template, place the template name between two pairs of curly brackets: | In order to include a template, place the template name between two pairs of curly brackets: | ||
<pre><nowiki>{{Cleanup}}</nowiki></pre> | <pre><nowiki>{{Cleanup}}</nowiki></pre> | ||
Line 170: | Line 206: | ||
{{Example|The example template for example!}} | {{Example|The example template for example!}} | ||
− | There are many templates | + | There are many templates that you can use to improve your pages, from status messages (e.g. {{Tl|Cleanup}}, or {{Tl|Deletion}}), to help with links (e.g. {{Tl|Sk}} for linking skills), to beautifully crafted information boxed (e.g. {{Tl|Ship}} or {{Tl|Skill}}). For help on using a particular template, click its link, which will take you to the template's documentation page. For instance, if you would like to add a new ship fitting, but are unsure how to use the {{Tl|ShipFitting}} template, go to [[Template:ShipFitting]] and read the documentation (or go to a page that currently uses the template to see what parameters they used; most are fairly self-explanatory). |
+ | |||
+ | [[UniWiki:Templates]] goes into more details about the most commonly-used templates and how to use them. Alternatively, see the [[:Category:Template|template category]] for the full collection. | ||
+ | |||
+ | === Works in progress === | ||
+ | The {{tl|Work in progress}} template is intended to mark articles that are actively being edited by one or more editors. Applying this template to an article means taking temporary responsibility for the improvement and expansion of that article. It is not simply a means of marking articles that need work; {{tl|update}}, {{tl|cleanup}}, and {{tl|merge}} can be used to indicate that an article needs work or review without committing to that work. | ||
− | + | This template should not be left on articles for more than a few days; its presence implies that work on that article represents a priority for its contributor. If you come across an article with this template and the article has not been edited in several days, please remove the template. | |
− | == Watch | + | == Watch Lists == |
Often, you will want to know the state of a particular page. This can be especially true if: | Often, you will want to know the state of a particular page. This can be especially true if: | ||
Line 180: | Line 221: | ||
* You have proposed a change | * You have proposed a change | ||
* You are actively involved in the [[Wiki How To Guide#Discussion|discussion]] of a page | * You are actively involved in the [[Wiki How To Guide#Discussion|discussion]] of a page | ||
− | * The page is a work in progress and you'd like to monitor | + | * The page is a work in progress and you'd like to monitor its development |
Luckily the wiki provides us with a very helpful tool for monitoring the last time a particular page was edited and they do this with a "[[Special:Watchlist|watch list]]". | Luckily the wiki provides us with a very helpful tool for monitoring the last time a particular page was edited and they do this with a "[[Special:Watchlist|watch list]]". | ||
Line 192: | Line 233: | ||
=== Removing === | === Removing === | ||
Should you, in the future, wish to remove a page from your watch list; simply navigate back to the page and click the "unwatch" button. | Should you, in the future, wish to remove a page from your watch list; simply navigate back to the page and click the "unwatch" button. | ||
+ | |||
+ | == Wikitext Cheatsheet == | ||
+ | {| class=wikitable | ||
+ | |- style="background-color:#222222;" | ||
+ | |||
+ | ! scope="colgroup" colspan="3" | Works anywhere in the text | ||
+ | |- style="background-color:#222222;" | ||
+ | ! Description !! You type !! You get | ||
+ | |- | ||
+ | | Italics, bold, and both || <nowiki>''italics'', '''bold''', and '''''both'''''</nowiki> || ''italics'', '''bold''', and '''''both''''' | ||
+ | |- | ||
+ | | [[UniWiki:Manual_of_Style/Linking|Link]] to another page<br> ''see [[wikipedia:Help:Interwiki linking|Interwikimedia links]] for linking to sister projects'' || <nowiki>[[Template]]</nowiki><br> <nowiki>[[Template]]s</nowiki> || [[Template]] <br>[[Template]]s | ||
+ | |- | ||
+ | | "[[wikipedia:Wikipedia:Piped_link|Pipe]]" a link to change the link's text || <nowiki>[[UniWiki:To-Do_List|Work List]]</nowiki> || [[UniWiki:To-Do_List|Work List]] | ||
+ | |- | ||
+ | | Link to a section || <nowiki>[[UniWiki:Welcome#UniWiki_ideals]]</nowiki><br> <nowiki>[[UniWiki:Welcome#UniWiki_ideals|UniWiki ideals]]</nowiki> || [[UniWiki:Welcome#UniWiki ideals]]<br> [[UniWiki:Welcome#UniWiki_ideals|UniWiki ideals]] <!-- [[Amphibian Error| cryostorage of frogs]] --> | ||
+ | |- | ||
+ | | [[wikipedia:Wikipedia:RED|Red link]]<br>''Links to pages that don't exist are automatically <br>red. Red links in articles often help by showing <br>desired [[wikipedia:Wikipedia:REDIRECT|redirects]] or [[wikipedia:Wikipedia:N|notable]] pages.'' || <nowiki>Intentionally [[red link]]</nowiki> || Intentionally [[red link]] | ||
+ | |- | ||
+ | | Plain website || <nowiki>https://wiki.eveuniversity.org</nowiki> || https://wiki.eveuniversity.org | ||
+ | |- | ||
+ | | Link a website || <nowiki>[https://wiki.eveuniversity.org]</nowiki> || [https://wiki.eveuniversity.org] | ||
+ | |- | ||
+ | | Link and name a website || <nowiki>[https://wiki.eveuniversity.org EVE University Wiki]</nowiki> || [https://wiki.eveuniversity.org EVE University Wiki] | ||
+ | |- | ||
+ | | Citations, references, and footnotes <br>''Sources in the article will appear where <br><nowiki><references /></nowiki> or <nowiki>{{reflist}}</nowiki> is put, <br>typically under a level 2 section heading <br>(see below) towards the bottom of the page; text <br>between {{}} is for a template. <br><br>N.B. If you don't use <nowiki><references /> or {{reflist}}</nowiki>, <br>references will be automatically placed <br>at the end of the page.'' || <nowiki>Hello!<ref name="MoS"></nowiki> <br><nowiki>[[UniWiki:Manual_of_Style|Manual of Style]]</nowiki><br><nowiki></ref></nowiki><br><br><nowiki>Hello again!</nowiki><br><nowiki><ref name="MoS" /></nowiki><br><nowiki><ref>Empires of Eve: A History of the Great Wars of Eve, Lightburn Industries, 2016.</ref></nowiki><br ><br><nowiki>References: <references /></nowiki> || | ||
+ | Hello!<ref name="MoS"> | ||
+ | [[UniWiki:Manual_of_Style|Manual of Style]]</ref> | ||
+ | |||
+ | Hello again!<ref name="MoS" /><ref>Empires of EVE: A History of the Great Wars of EVE, Lightburn Industries, 2016.</ref> | ||
+ | |||
+ | References: <references /> | ||
+ | |- | ||
+ | | [[wikipedia:Wikipedia:Signatures|Signature]]<br> ''sign your contributions when posting to a [[wikipedia:Wikipedia:Tutorial_(Talk_pages)|talk page]]'' || <nowiki>~~~~</nowiki><br><br>''do not sign in an article, only on talk pages'' || [[User:Danton Kelanen|Danton Kelanen]] ([[User talk:Danton Kelanen|talk]]) 09:35, 9 March 2023 (UTC) | ||
+ | |- | ||
+ | | Ping a user on a talk page <br>''so they will see your comment'' || <nowiki>[[User:Username]] </nowiki> || [[User:Evon R'al]] | ||
+ | |- | ||
+ | | [[wikipedia:Wikipedia:STRIKE|Strike]] your [[wikipedia:Help:Talk_pages#Notifications|talk page]] comment<br> ''to show your previous comment is outdated'' || <nowiki><s>This topic isn't [[wikipedia:Wikipedia:Notability|notable]].</s></nowiki> || <s>This topic isn't [[wikipedia:Wikipedia:Notability|notable]].</s> | ||
+ | |- | ||
+ | | Underline your text <br>''Generally, do not underline text or it may be <br>confused with links on a web page.'' || <nowiki><u>This topic is notable</u></nowiki> || <u>This topic is notable</u> | ||
+ | |- | ||
+ | | Hide text somewhere for editors<br> ''consensus is how things are decided'' || <nowiki><!--This had consensus, discuss at talk page--></nowiki> || | ||
+ | |- | ||
+ | | Show an image <br> ''for uploading, go to this [[Special:Upload|upload page]]'' || <nowiki>[[File:E-UNI_Emblem.png|thumb|alt="EVE Uni Emblem"|EVE Uni Emblem]]</nowiki> || [[File:E-UNI_Emblem.png|thumb|alt="EVE Uni Emblem"|EVE Uni Emblem]] <!-- alt is important for accessibility reasons e.g. reader software for visually impaired users --> | ||
+ | |- | ||
+ | | Add a page to a [[wikipedia:/Wikipedia:FAQ/Categories|category]] || <nowiki>[[Category:Category name]]</nowiki><br>''place near the bottom of a page'' || ''shows'' "Category name" ''in a bar at bottom when'' <br> ''the page is previewed or published.'' | ||
+ | |- | ||
+ | | Link to a category or file || <nowiki>[[:Category:Category name]]</nowiki><br><nowiki>[[:File:File name]]</nowiki> || [[:Category:Editing]]<br>[[:File:E-UNI_Emblem.png]] | ||
+ | |||
+ | |- style="background-color:#222222;" | ||
+ | ! scope="colgroup" colspan="3" | Works only at the beginning of lines | ||
+ | |- style="background-color:#222222;" | ||
+ | ! Description !! You type !! You get | ||
+ | |- | ||
+ | | [[wikipedia:Wikipedia:Redirect|Redirect to another page]]<br> ''redirects must be placed at the start of the first line'' || <nowiki>#REDIRECT [[UniWiki:Editing Guide]]</nowiki> <br>''Note: links to the page they are on show up as '''{{Co|white|bold white}}''''' || [[File:Uniwiki redirect arrow.png]] [[UniWiki:Editing Guide]] | ||
+ | |- | ||
+ | | [[wikipedia:Wikipedia:Redirect|Redirect to a section of another page]]<br> ''redirects must be placed at the start of the first line'' || <nowiki>#REDIRECT [[UniWiki:Editing Guide#Preparing to Edit]]</nowiki> || [[File:Uniwiki redirect arrow.png]] [[UniWiki:Editing Guide#Preparing to Edit]] | ||
+ | |- | ||
+ | | [[wikipedia:Help:Section|Section Headings]]<br> ''a Table of Contents will automatically be <br>generated when four headings are added to an <br>article'' || <nowiki>==Level 2==</nowiki><br><nowiki>===Level 3===</nowiki><br><nowiki>====Level 4====</nowiki><br><nowiki>=====Level 5=====</nowiki><br><nowiki>======Level 6======</nowiki><br><br> ''do not use <nowiki>=Level 1=</nowiki> as it is for page titles'' || [[File:Section levels.png]] | ||
+ | |- | ||
+ | | [[wikipedia:Help:List|Bulleted list]] || <nowiki>* One</nowiki><br><nowiki>* Two</nowiki><br><nowiki>** Two point one</nowiki><br><nowiki>* Three</nowiki><br> || | ||
+ | * One | ||
+ | * Two | ||
+ | ** Two point one | ||
+ | * Three | ||
+ | |- | ||
+ | | [[wikipedia:Help:List|Numbered list]] || <nowiki># One</nowiki><br><nowiki># Two</nowiki><br><nowiki>## Two point one</nowiki><br><nowiki># Three</nowiki><br> || | ||
+ | # One | ||
+ | # Two | ||
+ | ## Two point one | ||
+ | # Three | ||
+ | |- | ||
+ | | Indenting text<br> ''this is used when replying on a [[wikipedia:Wikipedia:Tutorial_(Talk_pages)|talk page]], to <br>make it easier to follow conversations. <br> After a string of indents, or to revive a <br>discussion. || <nowiki>no indent (normal)</nowiki><br><nowiki>:first indent</nowiki><br><nowiki>::second indent</nowiki><br><nowiki>:::third indent</nowiki><br><nowiki>::::fourth indent</nowiki> || no indent (normal) | ||
+ | :first indent | ||
+ | ::second indent | ||
+ | :::third indent | ||
+ | ::::fourth indent | ||
+ | |} | ||
+ | |||
+ | {{UniWikiNav}} | ||
+ | {{EVEUniversityNav}} | ||
+ | |||
+ | [[Category:Editing]] | ||
+ | [[Category:Guides]] | ||
+ | [[Category:Wiki Information]] |
Latest revision as of 12:43, 24 July 2024
Reason: Note to self: update who can edit and how to login, make Sandboxes more prominent, .... Arin Mara (talk) 09:45, 23 April 2022 (UTC)
- This page serves as a step-by-step guide to editing the UniWiki. For detailed editing guidelines, see UniWiki:Manual of Style and UniWiki:Mission formatting guidelines.
Wikis are a great way to share information within a community, since everyone can make additions to the knowledge base. This is also its greatest weakness. Wikis often rely on a relatively large active community, instead of a small group of dedicated writers. This guide explains how you can add information to our wiki.
Who can edit?
Everyone is welcome to contribute to the UniWiki! To begin editing you need to log in with your EVE account by clicking on the EVE SSO button in the top right corner.
Most pages on the UniWiki are editable by anyone who is logged in. Only a few important or sensitive pages are restricted to being edited by administrators. If you want to edit a restricted page, but can't, use the Talk Page to explain to the administrator what you want to edit.
Preparing to Edit
Sandbox
Want to fool around in the wiki without worrying about screwing up existing articles? Go play in the sandbox!
Drafts and User Pages
Every registered user has their own user page (you can access yours at the top-right of the screen, by clicking on your user name). This is your personal page, which you can use however you see fit. Most people use it to talk about themselves, or to save drafts of articles they are working on. This can be useful if you're working on a major new page (or are heavily rewriting an existing page), as you can work on it at your own pace without leaving the original page in a completely disjointed state. Note that this page isn't technically "private" (anyone can read and edit it), although you generally shouldn't edit other people's user pages without their consent.
You also have a "user discussion page" (the "my talk" link next to your user name, at the top-right of the screen), where other people can leave you messages. Alternatively, if you want to contact someone, you can go to the #wiki channel on the EVE Uni Discord or send them a private message via the E-UNI forum.
Discussion Tabs
If you feel a certain page requires discussion prior to major changes, each page comes with its own discussion page (the link is at the top-left of a page). This is really just a regular wiki page, so adding comments to it works exactly the same way as adding to any other wiki article. To sign the message with your name, end your message with four tildes. ( ~~~~ )
If a page is protected and locked from editing by normal users, please use that page's Discussion tab to propose simple or obvious changes. This makes it straightforward for a manager or director to copy the wiki code, if provided. More complex discussions about page content typically occur on the EVE Uni #wiki Discord channel or in the Forums.
Creating a Page
Before creating a new page, do a few wiki searches with relevant keywords. If there is an existing article that already ties closely to your subject, it may be better to add to the existing article instead of creating a new one. Likewise, if a subtopic in an article becomes really big, it may be worth splitting it off into its own article.
Creating a page is very easy, as all pages exist in potentia. This means in order to create a page, all you need to do is go to that page and add content. Confused? Don't worry, we have pictures!
First, you'll need to go to the page you want to create. This example shows how this guide was made. You can navigate to the page you wish to make by manually adjusting your browser URL and click 'edit', or - as shown in this example - simply do a search on our wiki for the name of the page you wish to create, and then click 'Create this page'. You can use spaces if the page you wish to create contains multiple words.
After clicking 'create this page' you should see the page editing form. All you need to do now is type the content in the text box, and hit save. It is good practice to include a short summary of the change you made to the page.
Now you have successfully created the page!
Of course, just plain text doesn't make for very useful and readable wiki pages. The next part of this guide describes the wiki markup language.
Editing a Page
To edit any page, go to that page and click the 'Edit' tab at the top of the page or the 'Edit' link to the right of each section (if you don't see the 'Edit' you need to login first).
If you are new to wiki editing, or mediawiki in particular, Wikipedia's Tutorial is quite useful. The Wikipedia Cheatsheet is also handy to keep around.
Editing Toolbar
The editing toolbar now in use by the UniWiki is the standard mediawiki version. The previous version is described here, and if you prefer using it, it can be re-enabled in your My Preferences, under Editing tab by disabling "Enable enhanced editing toolbar".
The enhanced toolbar has instant Preview and Changes functionality, and the "Show" buttons below the edit window perform the same actions. Due to the style-sheets in use, the toolbar panes are configured to be compatible with the black background of the UniWiki's default theme. If you choose to use a different color scheme, the buttons below should function with better visibility for you.
Wiki Syntax
Headings
The use of headings not only makes for readable text but also automatically generates a table of contents. Headings are very easy to add, simply surround the title of the paragraph with equal signs ( '=' ).
= Heading level 1 (top) = == Heading level 2 == === Heading level 3 === ==== Heading level 4 ====
Heading 1 is the same as the page heading, so it is recommended to start with heading level 2 on your page.
Links
Linking is one of the most powerful aspects of a wiki, so it is important that it is understood well. First, you must realize there is a difference between intra-wiki links (links to other articles on this wiki) and external links (links to external websites/pages).
The basic intra-wiki link has the following syntax:
[[Link topic]]
where Link topic is a page on the wiki. For example, if we wish to link to Main Page we use
[[Main Page]]
These topics can include spaces, as the wiki will automatically reformat the text to the correct link. You can also link to pages that do not exist yet such as this intentionally red link, when you feel that subject deserves its own article. The link will then appear red instead of orange, and people will hopefully feel encouraged to create the article.
To link to a sub-heading of a page, simply add #Heading to the topic, like so:
[[Link topic#Heading]]
As you can see, the text inside the double square brackets is both the destination (the page it links to) and the description (the text that shows up as link). In order to change the description you can use the pipe ('|') in the following syntax:
[[Link topic|link text]]
For example:
[[Main Page|Example]]
becomes Example. In order to make external links, you can use single square brackets like so:
[http://www.google.com]
If you want to change the description text of your external link, separate the url from the description with a space like so:
[http://www.google.com like so]
Regular markup
Italics
''Italics''
Bold
'''Bold'''
- Unsorted
- Lists
- Are cool
* Unsorted ** Lists ** Are cool
- Ordered
- Lists
- Are
- Cooler
#Ordered #Lists ##Are ##Cooler
Images
- Main article: UniWiki:Manual of Style/Images
Advanced information can be found on Mediawikiwiki:Help:Images or Wikipedia:Help:Pictures.
To include images (or other files) in your article, simply link them like
[[File:filename.ext]]
For example, the first image in this guide is linked as
[[File:wiki1.png]]
After saving the edit, click the file link and follow the form to upload your file. Of course, you can always look at the source of an article (click the edit link) and look up markup codes that aren't described here.
To upload your image without first creating a link to it:
Tables
- For full details of tables, see Mediawiki's article
{| | table start, required |
|+ | table caption, optional; only between table start and table row |
|- | table row, optional on first row - wiki engine assumes the first row |
! | table header cell, optional. Consecutive table header cells may be added on same line separated by double marks (!! ) or start on new lines, each with its own single mark (! ).
|
| | table data cell, optional. Consecutive table data cells may be added on same line separated by double marks (|| ) or start on new lines, each with its own single mark (| ).
|
|} | table end, required |
Example:
{| class="wikitable" |+ Caption text |- ! Header text 1 !! Header text 2 !! Header text 3 |- | Example 1 || Example 2 || Example 3 |- | Example 4 || Example 5 || Example 6 |- | Example 7 || Example 8 || Example 9 |}
Produces:
Header text 1 | Header text 2 | Header text 3 |
---|---|---|
Example 1 | Example 2 | Example 3 |
Example 4 | Example 5 | Example 6 |
Example 7 | Example 8 | Example 9 |
See Also
Uniwiki:Editing commands visual guide
Wikipedia Foundation Manual of Style
References
If you would like to cite a source to support your text, place <ref> </ref> tags around the citation and add a <references /> tag at the end of the article.
For example, for a single reference, use <ref>text of the citation</ref>
For repeated citations, use the <ref name="name"> tag:
- For the first of multiple instances, use :<ref name="name">text of the citation</ref>
- For the following uses, just use <ref name="name" />
Place the <references /> tag at the bottom of the article and it will list all references used in the article. You can also use the {{Reflist}}
instead.
For more examples see Wikipedia:Citing sources
Proper categorization
- Main article: UniWiki:Categorization
- Main article: Help:Categorization
It is important we categorize our articles properly. This allows our category pages to automatically list all articles in their category, which makes it easy for people to see the collection of articles in the same category.
Categories should be used as a collection mechanic instead of custom-made pages where we have to manually add links to new articles.
You can add a category to an article by adding
[[Category:CategoryName]]
anywhere in the article (categories are usually listed either at the start or end of an article). CategoryName should obviously be replaced with the name of the category. For an example, see the source of this article and note that it includes:
[[Category:Guides]]
If you wish to link to a category page, use the following syntax:
[[:Category:CategoryName]]
Note the first colon. Example Guides:
[[:Category:Guides|Guides]]
Redirects
A topic could be known by different titles, therefore a Redirect on these titles to the available topic can be very useful to find it.
#REDIRECT [[Target]] #REDIRECT [[Target#Section]]
Templates
- Main article: UniWiki:Templates
Templates allow us to automatically format information a certain way. For example, the Clean Up template always looks like this:
In order to include a template, place the template name between two pairs of curly brackets:
{{Cleanup}}
Some templates allow variable input. You simply put a pipe character after the template name and then put the text. A new pipe for each variable:
{{Example|The example template for example!}}
There are many templates that you can use to improve your pages, from status messages (e.g. {{Cleanup}}
, or {{Deletion}}
), to help with links (e.g. {{Sk}}
for linking skills), to beautifully crafted information boxed (e.g. {{Ship}}
or {{Skill}}
). For help on using a particular template, click its link, which will take you to the template's documentation page. For instance, if you would like to add a new ship fitting, but are unsure how to use the {{ShipFitting}}
template, go to Template:ShipFitting and read the documentation (or go to a page that currently uses the template to see what parameters they used; most are fairly self-explanatory).
UniWiki:Templates goes into more details about the most commonly-used templates and how to use them. Alternatively, see the template category for the full collection.
Works in progress
The {{Work in progress}}
template is intended to mark articles that are actively being edited by one or more editors. Applying this template to an article means taking temporary responsibility for the improvement and expansion of that article. It is not simply a means of marking articles that need work; {{update}}
, {{cleanup}}
, and {{merge}}
can be used to indicate that an article needs work or review without committing to that work.
This template should not be left on articles for more than a few days; its presence implies that work on that article represents a priority for its contributor. If you come across an article with this template and the article has not been edited in several days, please remove the template.
Watch Lists
Often, you will want to know the state of a particular page. This can be especially true if:
- You are the original author
- You have proposed a change
- You are actively involved in the discussion of a page
- The page is a work in progress and you'd like to monitor its development
Luckily the wiki provides us with a very helpful tool for monitoring the last time a particular page was edited and they do this with a "watch list".
Adding
You can add any page to your watch list by simply clicking on the "watch" button located on the same row as the "page" and "discussion" buttons but to the far right. When you click "watch" the button will change to "unwatch" and wiki will give you a notice letting you know that the page has been added to your watch list and a few details as to what it will do.
Viewing
To view if any changes have been made to those pages you have put in your watch list; you only need to click on the "my watchlist" link located in the top right hand corner of the wiki page. This page will list any and all changes applied to the pages you've defined in your watch list and highlight the ones that you have not recently visited (so that you can find them easier).
Removing
Should you, in the future, wish to remove a page from your watch list; simply navigate back to the page and click the "unwatch" button.
Wikitext Cheatsheet
Works anywhere in the text | ||
---|---|---|
Description | You type | You get |
Italics, bold, and both | ''italics'', '''bold''', and '''''both''''' | italics, bold, and both |
Link to another page see Interwikimedia links for linking to sister projects |
[[Template]] [[Template]]s |
Template Templates |
"Pipe" a link to change the link's text | [[UniWiki:To-Do_List|Work List]] | Work List |
Link to a section | [[UniWiki:Welcome#UniWiki_ideals]] [[UniWiki:Welcome#UniWiki_ideals|UniWiki ideals]] |
UniWiki:Welcome#UniWiki ideals UniWiki ideals |
Red link Links to pages that don't exist are automatically red. Red links in articles often help by showing desired redirects or notable pages. |
Intentionally [[red link]] | Intentionally red link |
Plain website | https://wiki.eveuniversity.org | https://wiki.eveuniversity.org |
Link a website | [https://wiki.eveuniversity.org] | [1] |
Link and name a website | [https://wiki.eveuniversity.org EVE University Wiki] | EVE University Wiki |
Citations, references, and footnotes Sources in the article will appear where <references /> or {{reflist}} is put, typically under a level 2 section heading (see below) towards the bottom of the page; text between {{}} is for a template. N.B. If you don't use <references /> or {{reflist}}, references will be automatically placed at the end of the page. |
Hello!<ref name="MoS"> [[UniWiki:Manual_of_Style|Manual of Style]] </ref> Hello again! <ref name="MoS" /> <ref>Empires of Eve: A History of the Great Wars of Eve, Lightburn Industries, 2016.</ref> References: <references /> |
Hello![1] References:
|
Signature sign your contributions when posting to a talk page |
~~~~ do not sign in an article, only on talk pages |
Danton Kelanen (talk) 09:35, 9 March 2023 (UTC) |
Ping a user on a talk page so they will see your comment |
[[User:Username]] | User:Evon R'al |
Strike your talk page comment to show your previous comment is outdated |
<s>This topic isn't [[wikipedia:Wikipedia:Notability|notable]].</s> | |
Underline your text Generally, do not underline text or it may be confused with links on a web page. |
<u>This topic is notable</u> | This topic is notable |
Hide text somewhere for editors consensus is how things are decided |
<!--This had consensus, discuss at talk page--> | |
Show an image for uploading, go to this upload page |
[[File:E-UNI_Emblem.png|thumb|alt="EVE Uni Emblem"|EVE Uni Emblem]] | |
Add a page to a category | [[Category:Category name]] place near the bottom of a page |
shows "Category name" in a bar at bottom when the page is previewed or published. |
Link to a category or file | [[:Category:Category name]] [[:File:File name]] |
Category:Editing File:E-UNI_Emblem.png |
Works only at the beginning of lines | ||
Description | You type | You get |
Redirect to another page redirects must be placed at the start of the first line |
#REDIRECT [[UniWiki:Editing Guide]] Note: links to the page they are on show up as bold white |
UniWiki:Editing Guide |
Redirect to a section of another page redirects must be placed at the start of the first line |
#REDIRECT [[UniWiki:Editing Guide#Preparing to Edit]] | UniWiki:Editing Guide#Preparing to Edit |
Section Headings a Table of Contents will automatically be generated when four headings are added to an article |
==Level 2== ===Level 3=== ====Level 4==== =====Level 5===== ======Level 6====== do not use =Level 1= as it is for page titles |
|
Bulleted list | * One * Two ** Two point one * Three |
|
Numbered list | # One # Two ## Two point one # Three |
|
Indenting text this is used when replying on a talk page, to make it easier to follow conversations. After a string of indents, or to revive a discussion. |
no indent (normal) :first indent ::second indent :::third indent ::::fourth indent |
no indent (normal)
|
|