Author Guidelines
This document outline the guidelines that authors should follow when writing new articles for dev-archive.net
Tina Holmboe
-
The character set used is
UTF-8
. -
The markup language used is
XHTML 1.1
. We transform it toHTML 4.01 Strict
during the publication process. - All code must be well-formed - this is paramount, as the XSLT processing used will not accept anything else - syntactically, and semantically correct.
-
All instances of "..." should be encoded as
…
, that is "…" -
"foo - bar" should be encoded as
"foo — bar"
, that is "foo — bar". -
"foo-bar" should be encoded as
"foo–bar"
, that is "foo–bar" -
"quote" should be encoded as
“quote”
, that is “quote” -
"It's" should be encoded as
"It’"
, that is "It’s" -
Links are written as
<a href="..."><span class="hyperLink">...</span></a>
-
References to external documents should be written as in this example:
<li> <a href="http://www.w3.org/MarkUp/2004/xhtml-faq"> <span class="hyperLink"> HTML and XHTML Frequently Answered Questions</span></a> —— W3C; July 2004.</li>
-
Date and timestamps should be written either on the long form
Wednesday, 23rd of May 20007, 11:13 GMT
, or on the short form23rd May 2007
. These correspond to the Wmake functions<wmake type="function" name="longEnglish"></wmake>
and<wmake type="function" name="shortEnglish"></wmake>
respectively. - Images for decoration in text should be treated in the following manner: using Gimp, select Script-Fu, Decor, Rounded Corners. Edge Radius=15, Add Drop Shadow=true, Shadow X-Offset=8, Shadow Y-Offset=8, Blur Radius=15, Add Background=true. Convert to greyscale, and scale to no more than 120px width.