Changes

Jump to: navigation, search

Format Guidelines for PSUGCAL

No change in size, 11:24, 12 April 2018
no edit summary
These are guidelines to making PSUGCal.org pages look consistent and to help with Wiki formatting in general. For more complete MediaWiki formatting help, visit https://www.mediawiki.org/wiki/Help:Formatting
 
== Creating a new page ==
A page (also known in MediaWiki as an "article") is very easy to create.
 
=== Using Wikilinks ===
MediaWiki makes it very easy to link wiki pages using a standard syntax (see Links section below). Example: <nowiki>[[Hobbies]]</nowiki>
 
If you (or anyone else) create a link to an article that doesn't exist yet, the link will be colored red, <span style="color: #ba0000">like this</span>.
 
Clicking a red link will take you to the edit page for the new article.
 
Simply type your text, click save and the new page will be created.
 
Once the page has been created, the link will change from <span style="color: #ba0000">red</span> to <span style="color: #002bb8;">blue</span> (<span style="color: #5a3696;">purple</span> for pages you've visited) indicating that the article now exists.
 
Usually this is the best way to create a new page, because it means that right from the start, the page will be linked from at least one other place on the wiki.
 
For many wikis, normally there is no reason to create a page without first creating a red link to it. However, for PSUGCal, if you add <nowiki>[[Category:Contents]]</nowiki> anywhere on your new page, it WILL be automatically listed in the "Content Directory" we feature as the 2nd link in the left navigation menu.
 
=== From the search box ===
 
If you search for a page that doesn't exist (using the search box at the top) then you will be provided with a link to create the new page.
 
=== Using the URL ===
 
You can use the wiki's URL for creating a new page.
 
The URL to an article of the PSUGCal.org wiki is usually something like this:
*<code><nowiki>https://www.psugcal.org/index.php?title=</nowiki>'''GPA'''</code>
 
If you replace <code>'''GPA'''</code> with the name of the page you wish to create, you will be taken to a blank page which indicates that no article of that name exists yet.
 
Clicking the "edit" tab at the top of the page will take you to the edit page for that article, where you can create the new page by typing your text, and clicking submit.
 
== Page Names and Titles ==
Pages will automatically inherit the page name as their title and main heading at the top of the page. If you're creating a new page, choose a name with that in mind. The pages will automatically alphabetize in the Content Directory, so choose names that users would logically expect to find in an alphabetical sort. '''Bad'''=Examples of sqlReports. '''Good'''=sqlReports.<br />
Examples:
*Customization
*Health
*GPA
 
== Adding pages to the Content Directory ==
To automatically have a page be listed in the Content Directory, add this code to any part of your page:
<pre>[[Category:Contents]]</pre>
 
== Sidebar/Left Navigation Editing ==
You can edit the left navigation or "Sidebar" with a special link:
* [[MediaWiki:Sidebar]]
or
* https://www.psugcal.org/index.php?title=MediaWiki:Sidebar
 
Find the "Quick Links" section and add an additional link with a special format consisting of:
* two asterisks + the page title + the pipe (|) symbol + the link text. You MUST have both the title and link text combo, even if they are identical, for the sidebar link to work correctly.
*Example: <code><nowiki>** Customization|Customization</nowiki></code>
== Basic Formatting ==
== Files ==
More content coming soon.
 
== Creating a new page ==
A page (also known in MediaWiki as an "article") is very easy to create.
 
=== Using Wikilinks ===
MediaWiki makes it very easy to link wiki pages using a standard syntax (see Links section below). Example: <nowiki>[[Hobbies]]</nowiki>
 
If you (or anyone else) create a link to an article that doesn't exist yet, the link will be colored red, <span style="color: #ba0000">like this</span>.
 
Clicking a red link will take you to the edit page for the new article.
 
Simply type your text, click save and the new page will be created.
 
Once the page has been created, the link will change from <span style="color: #ba0000">red</span> to <span style="color: #002bb8;">blue</span> (<span style="color: #5a3696;">purple</span> for pages you've visited) indicating that the article now exists.
 
Usually this is the best way to create a new page, because it means that right from the start, the page will be linked from at least one other place on the wiki.
 
For many wikis, normally there is no reason to create a page without first creating a red link to it. However, for PSUGCal, if you add <nowiki>[[Category:Contents]]</nowiki> anywhere on your new page, it WILL be automatically listed in the "Content Directory" we feature as the 2nd link in the left navigation menu.
 
=== From the search box ===
 
If you search for a page that doesn't exist (using the search box at the top) then you will be provided with a link to create the new page.
 
=== Using the URL ===
 
You can use the wiki's URL for creating a new page.
 
The URL to an article of the PSUGCal.org wiki is usually something like this:
*<code><nowiki>https://www.psugcal.org/index.php?title=</nowiki>'''GPA'''</code>
 
If you replace <code>'''GPA'''</code> with the name of the page you wish to create, you will be taken to a blank page which indicates that no article of that name exists yet.
 
Clicking the "edit" tab at the top of the page will take you to the edit page for that article, where you can create the new page by typing your text, and clicking submit.
 
== Page Names and Titles ==
Pages will automatically inherit the page name as their title and main heading at the top of the page. If you're creating a new page, choose a name with that in mind. The pages will automatically alphabetize in the Content Directory, so choose names that users would logically expect to find in an alphabetical sort. '''Bad'''=Examples of sqlReports. '''Good'''=sqlReports.<br />
Examples:
*Customization
*Health
*GPA
 
== Adding pages to the Content Directory ==
To automatically have a page be listed in the Content Directory, add this code to any part of your page:
<pre>[[Category:Contents]]</pre>
 
== Sidebar/Left Navigation Editing ==
You can edit the left navigation or "Sidebar" with a special link:
* [[MediaWiki:Sidebar]]
or
* https://www.psugcal.org/index.php?title=MediaWiki:Sidebar
 
Find the "Quick Links" section and add an additional link with a special format consisting of:
* two asterisks + the page title + the pipe (|) symbol + the link text. You MUST have both the title and link text combo, even if they are identical, for the sidebar link to work correctly.
*Example: <code><nowiki>** Customization|Customization</nowiki></code>
[[Category:Contents]]

Navigation menu