As of August 2020 the site you are on (wiki.newae.com) is deprecated, and content is now at rtfm.newae.com. |
Difference between revisions of "Style Guide"
Line 1: | Line 1: | ||
− | When editing the ChipWhisperer wiki, there | + | When editing the ChipWhisperer wiki, there are some general guidelines that should be followed. This page covers most of these guidelines. |
{{TOC|limit=3}} | {{TOC|limit=3}} |
Latest revision as of 12:42, 1 May 2018
When editing the ChipWhisperer wiki, there are some general guidelines that should be followed. This page covers most of these guidelines.
Heading Organization
- Do not use
<h1>
tags, this includes the mediawiki syntax= H1 Title =
because this should be reserved for the title of the page. - Use
<h2>
tags for the main groupings as these will be rendered as the highest level color sections.
Use h2 - h6 as you would normally and usually the styling will look just fine. Only when using collapsible sections is it important to read Collapsible Sections
== Title of the highest level colored section == Some awesome content of this higher level
Collapsible Sections
- If you plan on including a page as a collapsible section use
<h4>
This will render a slightly darker colored section that is contained within the larger colored section. -
<h3>
is not left out, it is used for the header that is displayed as the collapsible section's header.
{{CollapsibleSection |intro = === Collapsible Section === |content= Style Guide/Example Collapsible Section}}
will render as:
Collapsible Section
Section inside a collapsible section
Some cool and interesting stuff within this section.
Second section inside the same collapsible section
The second coolest stuff within the second section.
Collapsible Section === ==== Section inside a collapsible section =
Some cool and interesting stuff within this section.
Second section inside the same collapsible section
The second coolest stuff within the second section.
Including Related Links
All tutorials include the tutorials info box at the end of the page using
== Links == {{Template:Tutorials}}
All target pages include the target info box at the end of the page using
== Hardware == {{Template:Hardware}}
Alert boxes
To add a warning/caution box within you content use{{Warningbox|Approach this with caution}}
which will render as:
Approach this with caution
{{Greenbox|A quick note for something that is important to read/do}}
this will render as:
A quick note for something that is important to read/do
Info Boxes
Target should include an info box on top right side of the page. See CW308T-MSP430FR5 for an example.