Difference between revisions of "Format Guidelines for PSUGCAL"

From California PowerSchool User Group
Jump to: navigation, search
(Tables)
(Tables)
Line 160: Line 160:
 
| Example || Example || Example
 
| Example || Example || Example
 
|-
 
|-
| Example
+
|
 +
A table row doesn't have to be one line of code
 
||
 
||
 
You can use line breaks for easier coding
 
You can use line breaks for easier coding

Revision as of 20:42, 11 April 2018

These are guidelines to making PSUGCal.org pages look consistent and to help with Wiki formatting in general. For more complete WikiMedia formatting help, visit https://www.mediawiki.org/wiki/Help:Formatting

Page Names and Titles

Pages will automatically inherit the page name as their title. 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.
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:

[[Category:Contents]]

Basic Formatting

Code Result
''italic'' italic
'''bold''' bold
'''''bold and italic''''' bold and italic
<nowiki>no ''markup''</nowiki> no ''markup''

Single line breaks
are ignored.

Use the html tag <br />
for single line breaks.

Single line breaks are ignored.

Use the html tag
for single line breaks.

Use a blank line for a new paragraph.

Here is a 2nd paragraph.

Use a blank line for a new paragraph.

Here is a 2nd paragraph.

Headings

Wiki pages look best when organized with headings, like the one above this line. Use at most Level 2 and Level 3 headers. (Consider the Title of the Page Level 1). Here is the wiki code for creating the headings:

Code Result
== Heading Level 2 == 
Some text here
=== Heading Level 3 ===
Some more text here

Heading Level 2

Some text here

Heading Level 3

Some more text here

A page with 4 or more headings will automatically create a table of contents

Bullets and Numbering

Code Result

* For bullets start each line
* with an asterisk (*).
** More asterisks give deeper
*** and deeper levels.

  • For bullets start each line
  • with an (*).
    • More asterisks give deeper
      • and deeper levels.

# Start each line
# with a number sign (#).
## More number signs give deeper
### and deeper
### levels.

  1. Start each line
  2. with a number sign (#).
    1. More number signs give deeper
      1. and deeper
      2. levels.

Links

Description Code Result
Internal Link

[[Main Page]]
[[Main Page|Alternate Link Text]]

Main Page
Alternate Link Text

Bare External Link http://www.psugcal.org http://www.psugcal.org
External Link with Link Text
Note the single bracket and the space between the link and the link text

[http://www.psugcal.org PSUGCal.org]

PSUGCal.org

For consistency, most links will display best as a bullet item, with the link followed by a description. So for this:

  • PSUGCal.org - Home of the California PowerSchool User Groups.

Type this:

* [http://www.psugcal.org PSUGCal.org] - Home of the California PowerSchool User Groups.

Posting Code

Use <pre>Insert Code here</pre> to post code. Example:

<script>
$j(function() {
    /* place the family id row at the beginning of the table */
    $j("table:first").prepend($j("#familyidrow"));
....

Tables

The "Advanced" toolbar in the editor can help with table formatting. But here is an example:

{| class="wikitable"
|-
! Column 1 !! Column 2 !! Column 3
|-
| Example || Example || Example
|-
|
A table row doesn't have to be one line of code
||
You can use line breaks for easier coding
||
It doesn't make a difference
|}

Will produce this:

Column 1 Column 2 Column 3
Example Example Example

A table row doesn't have to be one line of code

You can use line breaks for easier coding

It doesn't make a difference

Files

More content coming soon.