DLXS Style Guide
From DLXS Documentation
(Difference between revisions)
(→Release markup) |
(→Release markup) |
||
| Line 63: | Line 63: | ||
= Advanced Markup = | = Advanced Markup = | ||
== Release markup == | == Release markup == | ||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
{| cellpadding="15" cellspacing="0" border="1" | {| cellpadding="15" cellspacing="0" border="1" | ||
| Line 89: | Line 74: | ||
|<nowiki><div class="bug">There is a bug. We're working on it.</div></nowiki> | |<nowiki><div class="bug">There is a bug. We're working on it.</div></nowiki> | ||
|<div class="bug">There is a bug. We're working on it.</div> | |<div class="bug">There is a bug. We're working on it.</div> | ||
| + | |- | ||
| + | |tip | ||
| + | |[for use by anyone] use to describe a tip for a particular procedure | ||
| + | |<nowiki><div class="tip">Tip: Do this right or it will break!</div></nowiki> | ||
| + | |<div class="tip">Tip: Do this right or it will break!</div> | ||
| + | |- | ||
| + | |note | ||
| + | |[for use by anyone] use if you just want to describe something and have it stand out a bit more | ||
| + | |<nowiki><div class="note">Note: Make sure you first blah blah blah.</div></nowiki> | ||
| + | |<div class="note">Note: Make sure you first blah blah blah.</div> | ||
| + | |- | ||
| + | |release | ||
| + | |[for use by DLXS staff only] use | ||
| + | |Additions about a forthcoming release should just be added to any relevant pages as a new paragraph. Header tags should also be used and the paragraph should be given a title "Release X" so it can be easily searched and integrated when the release is ready. | ||
| + | |<nowiki><div class="release"> | ||
| + | '''Release X''' | ||
| + | Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent velit. Curabitur non turpis sit amet nulla viverra feugiat. Ut sit amet pede. In hac habitasse platea dictumst. | ||
| + | </div></nowiki> | ||
| + | |<div class="release"> | ||
| + | '''Release X''' | ||
| + | Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent velit. Curabitur non turpis sit amet nulla viverra feugiat. Ut sit amet pede. In hac habitasse platea dictumst. | ||
| + | </div> | ||
|} | |} | ||
Revision as of 15:04, 10 October 2007
(DRAFT! a work in progress)
Contents |
Basics
Text Formatting
| Style | When to use | Markup | Example |
|---|---|---|---|
| Citation | Use when you need to display code that is used by the wiki | <cite>lorem ipsum</cite> | lorem ipsum |
| pre | Use when displaying large chunks of code that you want to set apart from rest of text | <pre>lorem ipsum</pre> | lorem ipsum |
| code | Use when displaying in line code (code embedded in other text) | <code>lorem ipsum</code> | This is a sentence with a bit of code
|
| tt | Use when ??? | <tt>lorem ipsum</tt> | lorem ipsum |
| nowiki | Use when you need to display code that is used by the wiki | <nowiki><code>lorem ipsum</code></nowiki> | <code>lorem ipsum</code> |
Linking
The preferable way of linking to a file is:
[[Sample Makefile.html|Makefile.html click here]]
(everything before the pipe won't show)
and NOT:
"For more information about the [[Makefile.html click here]]."
This isn't the best way to create a new page, it names the page whatever is in the brackets, and then forevermore you have to remember that it's not called "Sample Makefile.html" or something more intuitive when you want to link to it.
Lists
Comments
Advanced Markup
Release markup
| 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 | <div class="bug">There is a bug. We're working on it.</div> | There is a bug. We're working on it.
| |
| tip | [for use by anyone] use to describe a tip for a particular procedure | <div class="tip">Tip: Do this right or it will break!</div> | Tip: Do this right or it will break!
| |
| note | [for use by anyone] 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.
| |
| release | [for use by DLXS staff only] use | Additions about a forthcoming release should just be added to any relevant pages as a new paragraph. Header tags should also be used and the paragraph should be given a title "Release X" so it can be easily searched and integrated when the release is ready. | <div class="release"> '''Release X''' Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent velit. Curabitur non turpis sit amet nulla viverra feugiat. Ut sit amet pede. In hac habitasse platea dictumst. </div> | Release X Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Praesent velit. Curabitur non turpis sit amet nulla viverra feugiat. Ut sit amet pede. In hac habitasse platea dictumst. |
