Article Style Guide
Here is a style for your documents. Feel free to delete anything you will not use, but please adhere to the standards herein to ease the work of the layout editor.
Use Heading Styles
After headings, include some text before next level of heading.
Second Level Heading
If you need more levels, please consider your outline carefully and talk to your lead editor about the outline.
General Formatting
Please use as simple formatting as possible. For example, use strong, em to highlight important parts your text, but do not use font tags or inline styles. The layout editor will remove any extraneous formatting.
Do not colorize your content at all.
Outline using <ul> for unnumbered lists and <ol> for numbered lists. Don’t use other methods for lists.
Images
Images should be uploaded with a maximum width of 680 pixels. Use PNG or JPEG format. Do not add picture captions. Avoid taking screenshots of text, if at all possible (looks bad when printed).
Place images immediately after or before the text that references them, and always reference the images. For example, if I want to illustrate uploading of images, I would show the image below.

Do not use copyrighted material. If you need to use images from external sources, contact the author of the image and ask for permission to use the images.
Use the Upload/Insert options or the Media section in WordPress to upload your images. If you are using LiveWriter, inserting images will upload correctly.
Always use Alt text on your images. Never link to external images, but always upload images.
Do not annotate images (put text or drawing on top of ut) unless absolutely necessary.
Posting Code
Use <pre escaped=”true” lang=”csharp” line=”1″> </pre> around your code like this:
<pre escaped=”true” lang=”csharp” line=”1″>public class Class1
{
void Test()
{
StringBuilder b = new StringBuilder();
b.Capacity = 10;
b.ToString(); // Add comments inline
}
}
</pre>
Result:
1 2 3 4 5 6 7 8 9 | public class Class1 { void Test() { StringBuilder b = new StringBuilder(); b.Capacity = 10; b.ToString(); // Add comments inline } } |
DO NOT use the LiveWriter code paste or any other method for format your code.
Tips and Notes
SharePoint Magazine supports inline notes and preformatted content by using WordPress tags. To use, add one of the tags below in square brackets, just like you would for an HTML tag:
[ tag]Content[ /tag]
(Note: that due to WordPress handling of these tags, there is an extra space added to the example above).
The following note tags are supported:
Tip, Help, Disclaimer, Note, Warning, Important
Here are live examples:
