DLXS Style Guide
From DLXS Documentation
(→DLXS Custom Styles) |
(→DLXS Custom Styles) |
||
Line 313: | Line 313: | ||
|- | |- | ||
|tip | |tip | ||
- | |Use to describe a tip for a particular procedure | + | |Use to describe a tip for a particular procedure. Use of this style is highly encouraged - especially DLXS partners. |
|<nowiki><div class="tip">'''Tip:''' I found that doing x first really helps ~~~</div></nowiki> | |<nowiki><div class="tip">'''Tip:''' I found that doing x first really helps ~~~</div></nowiki> | ||
|<div class="tip">'''Tip:''' I found that doing x first really helps [[User:Suzchap|Suzchap]]</div> | |<div class="tip">'''Tip:''' I found that doing x first really helps [[User:Suzchap|Suzchap]]</div> |
Revision as of 19:41, 12 October 2007
So don't worry if it looks kinda weird.
Contents |
Basic Wiki Formatting
Creating New Pages
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. [[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.
Page Titles
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."
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 |
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> |
|
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> | |
Citations | Use when you need to display code that is used by the wiki | <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. |
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#Advanced_Markup]] | DLXS_style_guide#Advanced_Markup |
Link to a section on the current page but have the link say something different | [[DLXS_style_guide#Advanced_Markup|Advanced]] | Advanced |
Link to an external (non-wiki) source | [http://en.wikipedia.org Wikipedia] | Wikipedia |
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 |
|
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 |
|
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> |
| ||||
{| 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 |} |
|
Images
DLXS wiki list of uploaded images
Style | Markup | Example |
---|---|---|
Basic image w/custom alt text | [[Image:DLXSlogo.gif|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. | 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]] | |
Link directly to an image without displaying it: | [[:media:DLXSlogo.gif|Image of the DLXS logo]] | Image of the DLXS logo |
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 -->
DLXS Custom Styles
Style | When to use | Markup | Example |
---|---|---|---|
bug | [for use by DLXS staff only] use to alert users that there is a known bug in the software. Be sure to include the word 'Bug' for easy searching. | <div class="bug">'''Bug:''' We're working on it.</div> | Bug: We're working on it.
|
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. |
tip | Use to describe a tip for a particular procedure. Use of this style is highly encouraged - especially DLXS partners. | <div class="tip">'''Tip:''' I found that doing x first really helps ~~~</div> | Tip: I found that doing x first really helps Suzchap
|
note | Use if you just want to describe something and have it stand out a bit more | <div class="note">'''Note:''' Make sure you first blah blah blah.</div> | Note: Make sure you first blah blah blah.
|
Red Text | Make text red so it stands out (usually useful for key elements in a code snippet) | Here's what I have to say about <span class="redtext">this</span> and that's all. | Here's what I have to say about this and that's all. |
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. |
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:
So don't worry if it looks kinda weird.
{{NeedsReview}} will display:
Until it is fully reviewed, it may contain inaccurate or difficult to follow information.