本文将介绍WordPress Codex中的常用标签及代码使用方法。这需要大家对HTML,CSS和MediaWiki有所了解。
整体样式
WordPress Codex中的文章布局通常都遵循以下简单套路。首先以一段描述性段落开篇（有时标题下也会有导言部分），然后文章才铺展开来，并分成信息、实例、图像等不同部分以帮助用户真正理解文章内容。
文章结尾通常还附有 Resources（资源） ，有时也会包括外部链接。但外部链接应可靠且和文章内容相关，如有可能，非商业网站最佳。
Codex的文章标题采用了MediaWiki语法，使用等号标记。一级标题左右两侧分别使用两个等号。等号与内容之间是否有间隔并不影响输出结果。
二级标题应使用三个等号(===)，三级标题使用四个等号(====)，四级标题使用五个等号(=====)。很少有文章使用四级以上的标题。
有兴趣的话，可以比较下Styling Lists with CSS和WordPress术语这两篇文章，前者使用了所有布局样式，而后者文中则没有引用任何代码。
目录表格
当文章含有三个以上标题时，系统会自动在第一个标题右侧生成目录表格。如需定制目录显示位置，或强制显示目录而不管标题数量，可加入__TOC__ 标记。
在Codex中使用代码
HTML和CSS代码是WordPress Codex常用的程序代码。它们通常有以下几种使用方式：
- 在文本中使用代码
- 若在文章中显示代码，如列出 index.php模板文件，可以使用<tt>标签来包装句子中的代码。虽然<code>标签也有此项功能，但是它常带有蓝色背景。因此，这里建议使用<tt>标签。
- 在PRE 标签中使用代码
- 若让代码与文本分离并让其置于蓝色背景的方框中，可使用<pre>标签包装代码。但除非需要显示<tt> 或 <code>标签，否则不要在PRE标签中使用它们。另外，如果在PRE标签中使用链接，记得要用<nowiki>以禁用链接。
- PRE快捷键
- 编写小段代码时，只要在代码前置入空格，系统就会自动生成<pre>标签包围代码。
- PRE缺陷
- 虽然<pre>标签可用来高亮文本，但它和HTML的<pre>标签功能相同，并没有什么优势。 <pre>标签内部的代码，如制表符，空格和长线（long lines）都比较明显。长线如果超过页面宽度就会溢出页面。因此，如有可能，要手动强行切断长行代码以减少宽度。若无法手动修改（例如，如果复制粘贴手写代码就就会中断原有代码），你就要自行使用最佳解决办法了。此外，缩进代码时应使用两个或更多空格，要避免使用较大缩进和制表符。
- 包装代码
- 使用以下代码，就可创建CSS的div样式，它和<pre>标签有相似效果，但是这里的代码更像方框中的文本，使用<tt> and changing >， < into > and < 才使其看起来像代码， <br />用来中断行。这个样式的优势是当使用空格时，代码会被自动包装且能显示长行代码。
<h2><a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to <?php the_title(); ?>"><?php the_title(); ?></a></h2>
<small><?php the_time('F jS, Y') ?> <!-- by <?php the_author() ?> --></small>
代码是以下样式：
<div style="padding: 1em; border: 1px dashed #2f6fab;
color: Black; background-color: #f9f9f9; line-height: 1.1em">
<tt>
<div class="post" id="post-<?php the_ID(); ?>"><br />
<h2><a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to <?php the_title(); ?>"><?php the_title(); ?></a></h2><br />
<small><?php the_time('F jS, Y') ?> <!-- by <?php the_author() ?> --></small>
</tt>
</div>
在文档中使用字符实体或代码的更多信息，请查看Writing Code in Your Posts。
实例
Codex用户在尝试使用代码前都喜欢先查看下最终显示结果。以下就会向大家展示Codex中可能使用的“真实”代码。
真实代码
当有人要求查看下文章实际显示的代码时，我就会使用拿出以下内容，并根据需要稍作修改，如改变内容，宽度或颜色。一般来说，我会改变字体，但不会使用字型组参考，而是使用Codex的默认字体以避免不同浏览器和计算机系统可能产生的字体问题。
- A List Item in Small Caps
- List Item in Italic and Bold
- Change Size and Color
当然，它也有自己的不足，如不能创建悬停，但在多数情况下，所有的内嵌CSS样式都可以在Codex中作为使用效果来展示。
代码如下：
<div style="border:1px solid blue; width:50%; margin: 20px; padding:20px"> Box in which to provide demonstration of what a code looks like when used in the "real world". I can use <span style="color:red; font-weight:bold">spans to style sections</span> and other CSS inline styles to customize the look like for this list: <ul> <li style="color:green; font-variant:small-caps">A List Item in Small Caps</li> <li style="color:blue; font-style:italic; font-weight: bold">List Item in Italic and Bold</li> <li style="color:maroon; font-weight:bold; font-size: 120%">Change Size and Color</li></ul> There are limits, like you can't recreate a hover, but for the most part, all inline CSS styles can be used on the Codex to recreate a realistic example of what the usage will generate.</div>
显示无指向的链接
若不显示示例中的链接如 http://example.com/index.php，可使用<nowiki>：
<a title="example" href="<nowiki>http://example.com/</nowiki>">
创建可用的链接示例
若创建可用的示例链接，就要链接示例的标题。如果在名为"Using WordPress"的文章中显示"List Categories"下的链接示例，那么这个categories（分类）的示例链接应为：
* [[#List_Categories|My Life Stories]] * [[#List_Categories|My Family]] * [[#List_Categories|Sharing]] * [[#List_Categories|Facts and Fiction]]
使用以上代码就会显示如下结果：
显示真正的链接
创建外观为示例链接而不必实际表现得像个链接的链接，可使用span标签和下划线：
See <span style="color:blue"><u>this article</u></span> for more information
在Codex使用图像
Codex欢迎大家使用与WordPress 和WordPress 文章相关的图像，但是要遵循以下规则：
- 文件名中不要使用空格，可使用破折号。
- 直接指明图像名称而不要用其用法或描述。如, this-is-a-screen-shot-of-link-manager.png并不能清楚表达具体是哪一个图像，应该使用link-manager-panel.png。
- 尽量把图像宽度限制在 600像素以内。
- 尽量把图像大小控制在60K以下。
- 图像类型最好是 jpg 和png格式，尤以png为优。
- 裁剪图像后，在保存和上传之前要对其锐化。
- 如果你不小心上传了错误的图像，请重新上传新版本，并告知开发人员让其删除错误图像。
当然，也可在Codex使用原图或缩略图。
在Codex使用图像时，若输入
[[Image:Kubrick_Single.jpg|right|thumbnail|WordPress Default Theme]]
WordPress Default Theme – Single Post Look
系统就会创建悬浮在屏幕右侧且带有说明文字的缩略图。
若创建非缩略图的图像并让其悬浮在右侧或左侧，输入：
[[Image:leaf.gif|left]]
以上输入会把树叶图像置于文章左侧，且其周围没有任何链接或边框。它仅是用来展示把图像悬浮在文本左侧或右侧的实例，具体应用可参考Wrapping Text Around Images。
创建带有说明文字的非缩略图图像并让其悬浮在右侧或左侧：
[[Image:leaf.gif|right|frame|Image of a leaf]]
这个代码在非缩略图图像周围添加了边框，这样文本就包围了图像。图像和说明文字被置于边框中，但并没有可放大图像的链接图标。虽然可点击图像单独查看，但是它仍保持原样大小，并不能放大。这主要适用于需要说明文字的小图像。
参考资源
- WordPress Codex Sandbox
- Codex Guidelines
- MediaWiki Handbook
- HTML in WikiText
- MediaWiki Linking
- Wikipedia Picture Tutorial
- Wikipedia Extended Image Syntax
- Help with Images and Other Uploaded Files
分类：中文手册