DLXS Style Guide

From DLXS Documentation

(Difference between revisions)
Jump to: navigation, search
m (Linking)
Current revision (14:59, 20 October 2010) (edit) (undo)
(DLXS Custom Styles)
 
(45 intermediate revisions not shown.)
Line 1: Line 1:
-
= Using this DLXS wiki =
+
= Using the DLXS Documentation wikis =
* See [[Using_the_DLXS_Wiki]] for instructions on obtaining editing privileges.
* See [[Using_the_DLXS_Wiki]] for instructions on obtaining editing privileges.
-
* We encourage edits and contributions from DLXS members!  
+
* We encourage edits and contributions from DLXS members! See the [[DLXS_style_guide#DLXS_Custom_Styles|Custom Styles]] section for styles designed specifically for use by DLXS members.
 +
 +
 +
 +
= Wiki Basics =
== Basic Navigation ==
== Basic Navigation ==
-
Once you've logged in, you'll see the personal navigation bar in the upper right:
+
=== Upper right navigation bar ===
* '''Username''': This is your User page, where you can put personal information about yourself.
* '''Username''': This is your User page, where you can put personal information about yourself.
Line 21: Line 25:
* '''log out''': logs you out
* '''log out''': logs you out
-
= Basic Wiki Formatting =
 
-
== Creating New Pages ==
+
===Left-hand Navigation===
-
To create a new page, simply begin by editing a current page and enter the markup to link to the page you want to create. <nowiki>[[Name of page]]</nowiki>. Save the current page and then click on the red link to go directly to the edit mode of the new page.
+
 +
* '''navigation'''
 +
** '''Main Page''': Takes you to the Wiki's main page
 +
** '''Recent Changes''': Shows the most recent changes to the Wiki
 +
** '''Random Page''': Do you feel lucky?
 +
** '''Help''': Links to a help page specific to that Wiki
 +
 +
*'''search'''
 +
**'''Go'''—the default—will take you directly to a page if it exactly matches your search, otherwise it does a regular search:
 +
**'''Search''' searches for your text, with page title matches coming first
 +
 +
*'''toolbox'''
 +
**'''What Links Here''' shows which other pages on the Wiki point to the one you are currently on
 +
**'''Special Pages''' lists the various special pages of the Wiki, including ''Most linked to pages'', ''Orphaned pages'' (pages without any incoming links), ''File list'', ''Wanted pages'', and many others.
 +
 +
 +
===Article Tabs===
 +
 +
The tabs at the top of the article allow you to interact with the page:
 +
 +
*'''article''' - shows you the current version of the article
 +
*'''discussion''' - a discussion page for this article. This is where editors will talk about what should or should not be in a particular article. (Can sometimes make for fascinating reading, esp. on WikiPedia)
 +
*'''edit''' - click this to edit the content of an article (see below)
 +
*'''history''' - shows in reverse chronological order the edits made to a page. From here you can see past versions of the page, and compare versions to see where the changes were made
 +
*'''move''' - changes the name of an article (and therefore it's URL/location). A redirect is normally created to link the old location to the new
 +
*'''watch''' adds an article to your watchlist
 +
 +
 +
==Practicing Editing==
 +
 +
Create a Sandbox page for yourself at <code>User:''Uniqname''/Sandbox</code>. You can use this Sandbox to play around with editing pages and not bother anyone.
 +
 +
Try creating headers, formatting texts, creating lists and linking to other pages.
 +
 +
 +
 +
== Creating New Pages ==
-
== Page Titles ==
 
For consistency, major words in all page titles should be in capital letters.
For consistency, major words in all page titles should be in capital letters.
Pages pertaining to specific classes should include that class in their page title. Ex. “Mounting the Collection Online” should be "Mounting the Text Class Collection Online."
Pages pertaining to specific classes should include that class in their page title. Ex. “Mounting the Collection Online” should be "Mounting the Text Class Collection Online."
 +
 +
There are many ways to create new pages. A few of the most common are:
 +
 +
* If you see a red link, that signifies that the article has not been made yet. Simply click on the red link, and it will direct you to an Edit page. From there, you can type up whatever information you please.
 +
 +
* If you search for a page that doesn't exist, there will be a link to create that page.
 +
 +
* Begin by editing a current page and enter the markup to link to the page you want to create. <nowiki>[[Name of page]]</nowiki> like this [[Name of page]]. Save the current page and then click on the red link to go directly to the edit mode of the new page.
 +
 +
Note that page/file names for MediaWiki ''are caps-sensitive'', so ''Mlibrary'' is a different page from ''MLibrary''. Also, all pages must start with a capital letter. For consistency, major words in all page titles should be in capital letters.
 +
 +
 +
==Editing Wikis==
 +
 +
To edit a page, click on the '''edit''' link in the top navigation. Alternately, to edit just a secion of a page, click on the '''edit''' link over to the right of the section heading.
 +
 +
At the bottom of the edit page, you'll have the following options:
 +
 +
*Use the '''Summary:''' field to indicate the changes you've made (optional).
 +
 +
*Check the '''This is a minor edit''' box to indicate that the edit is minor, e.g. a spelling or punctuation correction.
 +
 +
*It is highly recommended that you use the '''Show preview''' button first so that you can look over your changes to make sure you haven't made any formatting mistakes. Then you can click the '''Save page''' button to save your changes.
 +
 +
 +
= Basic Wiki Formatting =
 +
 +
==Using HTML==
 +
You can use most basic HTML code in your pages as well. However, it is considered to be good wiki form to use the Wiki mark-up language when it is available.
 +
== Sections & Paragraphs ==
== Sections & Paragraphs ==
Line 52: Line 119:
Line two</nowiki></pre>
Line two</nowiki></pre>
|}
|}
-
 
== Text Formatting ==
== Text Formatting ==
Line 120: Line 186:
|<blockquote>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Integer eget sapien eu libero porttitor eleifend. Mauris ornare nunc a ligula. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos hymenaeos.</blockquote>
|<blockquote>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Integer eget sapien eu libero porttitor eleifend. Mauris ornare nunc a ligula. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos hymenaeos.</blockquote>
|}
|}
 +
== Linking ==
== Linking ==
Line 153: Line 220:
|-
|-
|}
|}
 +
== Lists ==
== Lists ==
Line 272: Line 340:
== Images ==
== Images ==
-
[[Special:Upload|DLXS wiki upload page]]
+
Upload images here: [[Special:Upload|DLXS wiki upload page]]
-
[[Special:Imagelist|DLXS wiki list of uploaded images]]
+
View list of previously uploaded images: [[Special:Imagelist|DLXS wiki list of uploaded images]]
{| cellpadding="15" cellspacing="0" border="1"
{| cellpadding="15" cellspacing="0" border="1"
Line 298: Line 366:
|}
|}
 +
==Signing==
 +
Sometimes it is helpful to sign your name to your edits (DLXS_member comments and talk pages). To add a "signature" (i.e. username and timestamp) use the following code.
 +
:
 +
 +
<tt><nowiki>--~~~~</nowiki></tt>
 +
 +
turns into --[[User:Suzchap|suz]] 16:05, 30 July 2008 (EDT)
== Hidden Comments ==
== Hidden Comments ==
Line 309: Line 384:
= DLXS Custom Styles =
= DLXS Custom Styles =
 +
If anyone has ideas for additional custom styles - please let us know.
 +
 +
[for use by DLXS staff: [[MediaWiki:Common.css|this page]] allows you to add a new style or change other styles]
{| cellpadding="15" cellspacing="0" border="1"
{| cellpadding="15" cellspacing="0" border="1"
Line 315: Line 393:
! Markup
! Markup
! Example
! Example
 +
|-
 +
|release 15
 +
|[for use by DLXS staff only] Release 15 documentation should be added to any relevant pages as a new paragraph. '''Be sure to include the word 'Release_15'''' (15 being the release number) for easy searching and integration.
 +
|<nowiki><div class="release_15">
 +
'''Release_15:'''
 +
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent velit.
 +
</div></nowiki>
 +
|<div class="release_15">
 +
'''Release_15:'''
 +
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent velit.
 +
</div>
|-
|-
|future release
|future release
Line 330: Line 419:
|Use to describe a note, tip or warning for a particular procedure.  
|Use to describe a note, tip or warning for a particular procedure.  
'''Be sure to include the label 'DLXS_Tip', 'DLXS_Warning', or 'DLXS_Note' to make searching for these items easier.'''
'''Be sure to include the label 'DLXS_Tip', 'DLXS_Warning', or 'DLXS_Note' to make searching for these items easier.'''
-
<span class="redtext">For use by U-M DLXS staff only</span>.  
+
<span class="greentext">For use by U-M DLXS staff only</span>.  
|<nowiki><div class="tip">'''DLXS_Tip:''' Make sure you first blah blah blah. </div></nowiki>
|<nowiki><div class="tip">'''DLXS_Tip:''' Make sure you first blah blah blah. </div></nowiki>
|<div class="tip">'''DLXS_Tip:''' Make sure you first blah blah blah.</div>
|<div class="tip">'''DLXS_Tip:''' Make sure you first blah blah blah.</div>
|-
|-
|note
|note
-
|Use to describe a note or tip for a particular procedure. Use of this style is highly encouraged - especially by DLXS partners. '''Note the use of tilda (<nowiki>~~~</nowiki>) to indicate author'''.
+
|Use to describe a note or tip for a particular procedure. Use of this style is highly encouraged - especially by DLXS members. '''Note the use of tilde (<nowiki>~~~</nowiki>) to indicate author'''.
|<nowiki><div class="note">'''Note:''' I found that by doing x first blah blah blah. ~~~</div></nowiki>
|<nowiki><div class="note">'''Note:''' I found that by doing x first blah blah blah. ~~~</div></nowiki>
|<div class="note">'''Note:''' I found that by doing x first blah blah blah. [[User:Suzchap|Suzchap]]</div>
|<div class="note">'''Note:''' I found that by doing x first blah blah blah. [[User:Suzchap|Suzchap]]</div>
Line 343: Line 432:
|<nowiki><div class="workshop">'''Workshop:''' Go to directory foobar blah blah blah.</div></nowiki>
|<nowiki><div class="workshop">'''Workshop:''' Go to directory foobar blah blah blah.</div></nowiki>
|<div class="workshop">'''Workshop:''' Go to directory foobar blah blah blah.</div>
|<div class="workshop">'''Workshop:''' Go to directory foobar blah blah blah.</div>
-
|-
 
-
|Red Text
 
-
|Make text red so it stands out (usually useful for key elements in a code snippet)
 
-
|<nowiki>Here's what I have to say about <span class="redtext">this</span> and that's all.</nowiki>
 
-
|Here's what I have to say about <span class="redtext">this</span> and that's all.
 
|-
|-
|Green Text
|Green Text
Line 355: Line 439:
|}
|}
-
= Templates for page status =
+
= DLXS Custom Templates for Page Status =
There are currently 2 templates that can be applied to any page to signal a page's status.
There are currently 2 templates that can be applied to any page to signal a page's status.
Line 379: Line 463:
</div>
</div>
 +
 +
 +
 +
[[Category:Help]]

Current revision

Contents

[edit] Using the DLXS Documentation wikis

  • See Using_the_DLXS_Wiki for instructions on obtaining editing privileges.
  • We encourage edits and contributions from DLXS members! See the Custom Styles section for styles designed specifically for use by DLXS members.



[edit] Wiki Basics

[edit] Basic Navigation

[edit] Upper right navigation bar

  • Username: This is your User page, where you can put personal information about yourself.
  • my talk: This is your Talk page, to be used for carrying on conversations with other users on the Wiki. If someone edits your talk page, you'll receive a notification then next time you login to the wiki.
  • my preferences: here you can set many preferences, such as personal info, date & time formats, skins, editing preferences, etc.
  • my watchlist: changes to pages you've marked as 'watch' (see below)
  • my contributions: lists edits you've made to the wiki
  • log out: logs you out


[edit] Left-hand Navigation

  • navigation
    • Main Page: Takes you to the Wiki's main page
    • Recent Changes: Shows the most recent changes to the Wiki
    • Random Page: Do you feel lucky?
    • Help: Links to a help page specific to that Wiki
  • search
    • Go—the default—will take you directly to a page if it exactly matches your search, otherwise it does a regular search:
    • Search searches for your text, with page title matches coming first
  • toolbox
    • What Links Here shows which other pages on the Wiki point to the one you are currently on
    • Special Pages lists the various special pages of the Wiki, including Most linked to pages, Orphaned pages (pages without any incoming links), File list, Wanted pages, and many others.


[edit] Article Tabs

The tabs at the top of the article allow you to interact with the page:

  • article - shows you the current version of the article
  • discussion - a discussion page for this article. This is where editors will talk about what should or should not be in a particular article. (Can sometimes make for fascinating reading, esp. on WikiPedia)
  • edit - click this to edit the content of an article (see below)
  • history - shows in reverse chronological order the edits made to a page. From here you can see past versions of the page, and compare versions to see where the changes were made
  • move - changes the name of an article (and therefore it's URL/location). A redirect is normally created to link the old location to the new
  • watch adds an article to your watchlist


[edit] Practicing Editing

Create a Sandbox page for yourself at User:Uniqname/Sandbox. You can use this Sandbox to play around with editing pages and not bother anyone.

Try creating headers, formatting texts, creating lists and linking to other pages.


[edit] Creating New Pages

For consistency, major words in all page titles should be in capital letters.

Pages pertaining to specific classes should include that class in their page title. Ex. “Mounting the Collection Online” should be "Mounting the Text Class Collection Online."

There are many ways to create new pages. A few of the most common are:

  • If you see a red link, that signifies that the article has not been made yet. Simply click on the red link, and it will direct you to an Edit page. From there, you can type up whatever information you please.
  • If you search for a page that doesn't exist, there will be a link to create that page.
  • Begin by editing a current page and enter the markup to link to the page you want to create. [[Name of page]] like this Name of page. Save the current page and then click on the red link to go directly to the edit mode of the new page.

Note that page/file names for MediaWiki are caps-sensitive, so Mlibrary is a different page from MLibrary. Also, all pages must start with a capital letter. For consistency, major words in all page titles should be in capital letters.


[edit] Editing Wikis

To edit a page, click on the edit link in the top navigation. Alternately, to edit just a secion of a page, click on the edit link over to the right of the section heading.

At the bottom of the edit page, you'll have the following options:

  • Use the Summary: field to indicate the changes you've made (optional).
  • Check the This is a minor edit box to indicate that the edit is minor, e.g. a spelling or punctuation correction.
  • It is highly recommended that you use the Show preview button first so that you can look over your changes to make sure you haven't made any formatting mistakes. Then you can click the Save page button to save your changes.


[edit] Basic Wiki Formatting

[edit] Using HTML

You can use most basic HTML code in your pages as well. However, it is considered to be good wiki form to use the Wiki mark-up language when it is available.


[edit] Sections & Paragraphs

Sections: using four or more headers on a page will create a table of contents (TOC) to appear in front of the first header.
= Section =

== Sub-section ==

=== Sub-sub-section ===

==== Sub-sub-sub-section ====
Paragraphs: leave a blank line between paragraphs
Line one

Line two

[edit] Text Formatting

Style When to use Markup Example
Bold '''Bold text''' Bold text
Italic ''Italicized text'' Italicized text
Bold & Italic '''''Italicized & Bold text''''' Italicized & Bold text
Inline code Use when displaying in line code (code embedded in other text) and names of scripts This is a sentence with <code>a bit of code</code> in it. This is a sentence with a bit of code in it.
Blocks of code Use when you want to display large blocks of code and keep original formatting. <code> should always go outside <pre> <code><pre><ul> <li class="list">list item 1</li> <li class="list">list item 2</li> </ul></pre></code>
<ul>
  <li class="list">list item 1</li>
  <li class="list">list item 2</li>
</ul>
Keep original formatting of text (not for code) Use when displaying non-code text that you want to set apart from rest of text. (This can also be done with leading spaces, but is not recommended). <pre>lorem ipsum</pre>
lorem 
     ipsum
Show wiki markup Use when you need to display code that is used by the wiki. <nowiki><markup>lorem ipsum</markup></nowiki> <markup>lorem ipsum</markup>
strikethrough Use when you want to indicate that something no longer applies, but don't want to delete it yet. <strikethrough>lorem ipsum</strikethrough> lorem ipsum
Citations Use when you cite another source. <cite>lorem ipsum</cite> lorem ipsum
block quote For a long citation (not for code) that you want indented. <blockquote>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Integer eget sapien eu libero porttitor eleifend. Mauris ornare nunc a ligula. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos hymenaeos.</blockquote>
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Integer eget sapien eu libero porttitor eleifend. Mauris ornare nunc a ligula. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos hymenaeos.


[edit] Linking

Style Markup Example
Link to another wiki page Go to [[Installing_DLXS]] Installing_DLXS
Link to another wiki page but have the link say something different Go to [[Installing_DLXS|DLXS installation]] DLXS installation
Link to a section within another wiki page [[Installing_DLXS#Installation_Instructions]] Installing_DLXS#Installation_Instructions
Link to a section on the current page [[DLXS_style_guide#DLXS_Custom_Styles]] DLXS_style_guide#DLXS_Custom_Styles
Link to a section on the current page but have the link say something different [[DLXS_style_guide#DLXS_Custom_Styles|Custom]] Custom
Link to an external (non-wiki) source [http://en.wikipedia.org Wikipedia] Wikipedia


[edit] Lists

Type Markup Example
Bullet list
* Item 1
** Item 1.1
** Item 1.2
* Item 2
** Item 2.1
*** Item 2.1.1
*** Item 2.1.2
*** Item 2.1.3
** Item 2.2
* Item 3
  • Item 1
    • Item 1.1
    • Item 1.2
  • Item 2
    • Item 2.1
      • Item 2.1.1
      • Item 2.1.2
      • Item 2.1.3
    • Item 2.2
  • Item 3
Numbered list
# Item 1
## Item 1.1
## Item 1.2
# Item 2
## Item 2.1
### Item 2.1.1
### Item 2.1.2
### Item 2.1.3
## Item 2.2
# Item 3
  1. Item 1
    1. Item 1.1
    2. Item 1.2
  2. Item 2
      1. Item 2.1
      2. Item 2.1.1
      3. Item 2.1.2
      4. Item 2.1.3
    1. Item 2.2
  3. Item 3


[edit] Tables

You can use wiki table formatting or html table formatting

<table cellpadding="5" cellspacing="0" border="1">
  <tr>
    <th>heading 1</th>
    <th>heading 2</th>
  </tr>
  <tr>
    <td>cell 1</td>
    <td>cell 2</td>
  </tr>
</table>
heading 1 heading 2
cell 1 cell 2
{| cellpadding="15" cellspacing="0" border="1"
|-
!heading 1
!heading 2
|-
|cell 1
|cell 2
|}

OR

{| cellpadding="15" cellspacing="0" border="1"
|-
!heading 1 !! heading 2
|-
|cell 1 || cell 2
|}
heading 1 heading 2
cell 1 cell 2


[edit] Images

Upload images here: DLXS wiki upload page

View list of previously uploaded images: DLXS wiki list of uploaded images

Style Markup Example
Basic image w/custom alt text [[Image:DLXSlogo.gif|The DLXS logo]] The DLXS logo
Image w/custom alt text & floated to write [[Image:DLXSlogo.gif|right|The DLXS logo]] Here is the DLXS logo floated to the right, if you put the image before the text, the text should wrap around it like this.
The DLXS logo
Here is the DLXS logo floated to the right, if you put the image before the text, the text should wrap around it like this.
Resize image [[Image:DLXSlogo.gif|100px|The DLXS logo]] The DLXS logo
Link directly to an image without displaying it: [[:media:DLXSlogo.gif|Image of the DLXS logo]] Image of the DLXS logo

[edit] Signing

Sometimes it is helpful to sign your name to your edits (DLXS_member comments and talk pages). To add a "signature" (i.e. username and timestamp) use the following code.

--~~~~

turns into --suz 16:05, 30 July 2008 (EDT)

[edit] Hidden Comments

You can comment in the wiki the same way you would comment in html. Use when you want to leave comments that can only be seen when editing the page.

<!-- comment here -->


[edit] DLXS Custom Styles

If anyone has ideas for additional custom styles - please let us know.

[for use by DLXS staff: this page allows you to add a new style or change other styles]

Style When to use Markup Example
release 15 [for use by DLXS staff only] Release 15 documentation should be added to any relevant pages as a new paragraph. Be sure to include the word 'Release_15' (15 being the release number) for easy searching and integration. <div class="release_15"> '''Release_15:''' Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent velit. </div>

Release_15: Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent velit.

future release [for use by DLXS staff only] Additions about a forthcoming release should just be added to any relevant pages as a new paragraph. Be sure to include the word 'Release_X' (X being the release number) for easy searching and integration when the release is ready. <div class="release"> '''Release_X:''' Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent velit. </div>

Release_X: Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent velit.

DLXS staff only note Use to describe a note, tip or warning for a particular procedure.

Be sure to include the label 'DLXS_Tip', 'DLXS_Warning', or 'DLXS_Note' to make searching for these items easier. For use by U-M DLXS staff only.

<div class="tip">'''DLXS_Tip:''' Make sure you first blah blah blah. </div>
DLXS_Tip: Make sure you first blah blah blah.
note Use to describe a note or tip for a particular procedure. Use of this style is highly encouraged - especially by DLXS members. Note the use of tilde (~~~) to indicate author. <div class="note">'''Note:''' I found that by doing x first blah blah blah. ~~~</div>
Note: I found that by doing x first blah blah blah. Suzchap
workshop Used by DLXS staff only to indicate that content is applies to the workshop only <div class="workshop">'''Workshop:''' Go to directory foobar blah blah blah.</div>
Workshop: Go to directory foobar blah blah blah.
Green Text Make text green so it stands out (usually useful for key elements in a code snippet) Here's what I have to say about <span class="greentext">this</span> and that's all. Here's what I have to say about this and that's all.

[edit] DLXS Custom Templates for Page Status

There are currently 2 templates that can be applied to any page to signal a page's status.

To assign a template to a page, enter the markup below to the top of the page.


{{WorkInProgress}} will display:

progress icon
This page is a work in progress. It is actively being worked on.
So don't worry if it looks kinda weird.


{{NeedsReview}} will display:

warning icon
This page has been flagged by DLXS or DLXS Users as needing to be reviewed.
Until it is fully reviewed, it may contain inaccurate or difficult to follow information.


Tip: To find wiki articles that use these templates - use the following URL's:

Special:Whatlinkshere/Template:NeedsReview

Special:Whatlinkshere/Template:WorkInProgress


Personal tools