风格指南

目录

一般注意事项

betway体育注册发表文章列表除了使用非正式的、对话式的语气,但不要以不清楚或不正确为代价。专家们不需要过分拘谨也不需要过分随意来表达他们的权威。如果你用阿拉在你的思想和声音上都像你自己的读者,你基本上已经做到了。

与活泼的前奏简明betway体育注册文章

我们的文章篇幅有意限制为单页。没有余地蜿蜒的百科全书式的完整性没有空间。您需要获得,得分,并全身而退。清晰,快速地说出你的想法。如果您的教程解决问题,状态问题。不要用概括它前面热身你的主题。你并不需要告诉我们的读者,蒂姆·伯纳斯 - 李得到你点之前发明了网络。

让读者记住

经验丰富的网络专业人士阅读阿拉。如果你哑巴了你的文章,你会得罪这些读者。但是,我们的读者来自不同背景,一个谁知道所有317点CSS的解决方法不一定听说过爱德华的读者塔夫特,所以需要时间来定义你的条件和提供的有关背景资料,如果只为一个链接。

隐喻

扩展隐喻可以提供温和的提升和支持,但它们使救生艇变差。除非你能以一种真正新奇和令人愉快的方式完成它,否则不要使用长时间的烹饪和拼写隐喻。他们可能很聪明,但毫无疑问工作过度。

净度第一

避免不必要的行话,时尚的建筑,模糊性和流行语。省略不必要的字句。确保代词点的方式来其指示像整齐的路标他们。力争轻快的节奏和准确的解释。限制使用不透明的成语和非基本点流行文化的;没有读者需要熟悉与特定的歌曲或电影来了解您的中心论点。

图片

图片宽度不应超过696px;所有图片都将在文章的主栏中居中。

如果您的图片高DPI,请发送标准和高DPI的版本。例如,如果你有一个视网膜设备上进行屏幕截图意味着在全列宽要显示,请发送一个是696px宽,还有一个是1392px宽。

您还可以使用代码片段图像要点Github上。

PNGGIF格式,和JPEG都是可接受的提交格式。GIF格式PNG对于文本特征突出的图像首选。(不使用JPEG为字体的图库或网页的截图。)如果保存为GIF格式请选择知觉选择性的, 要么自适应色彩空间,没有抖动,和不透明度;针对磨砂#FFF(白色)。请给我们高分辨率图像,我们会根据需要进行压缩。

作者简介及照片

所有的最终草案,应该由作者简介和照片陪同。作者BIOS应
长度为40到50个单词,可能包含链接。他们应该是敏捷的,信息丰富的,简短的。

示例:

Mat“Wilto”Marquis是一名设计师兼开发者长丝组在波士顿。Mat是the的成员jQuery移动团队,是开源社区,并享受与HTML5“dialog”标签的复杂关系。他可能在为什么事发疯在Twitter上因为我们说话。(50个字)

凯文康奈尔是一位来自宾夕法尼亚州费城的插画/设计师。他大部分时间都在维护他的网站,并起草虚冲突的条约。据传他是过敏腰果,但在很大程度上是未经证实的。凯文是员工插画列表除了. (47字)

作者的照片不需要是专业的肖像,但应该看起来光鲜亮丽。列表除了将为发布做好准备,因此请将它们作为未调整的文件发送,最小大小为400px x x 400px。

住宅风格

一般情况下,我们使用根据美国英语芝加哥格式手册,与福勒的现代英语用法在棘手的情况下接管。

文章标题、标题和副标题

文章标题(每个主要单词都是大写的)。句子格文章标题(只有首字母是大写)。除非需要问号,否则不要使用结尾标点。文章标题不要使用连续逗号,用&号代替“and”。文章标题使用连续逗号并使用“and”。

将文章标题标记为H2而作为副标题H3H4根据需要。大多数文章标题在概念和修辞上都处于相同的水平;避免不必要的复杂性,并将它们标记为H2除非它们是真正的副标题。H1被保留用于作为页标题。

文章标题或文件标题

大,斯塔克和矮胖

文章标题或副标题

又大又粗

分子

内联元素应该以小写表示,以保持与后XHTML最佳实践的一致性,并提高可读性。

然后提取的内容DIV并将其添加到列表中。

运用

你使用的任何代码内嵌位应该被包裹在代码标签。任何独立的代码块都应该另外包装在标签。

代码块

对于行缩进请使用标签。每个嵌套线是从父缩进一个选项卡。

控制结构(如圆括号)只需要在外部设置间距:

如果(富巴){//做一些事情}

左大括号应该在使用它的命令行。收盘人应该在自己的行(或如果是类似的部分其他的声明中,对与行其他的

如果(foo bar){/做某事}其他{/做不同的事情}

…要么:

如果(富巴){//做一些事情}否则,如果(富RAE){//做不同的事情}

功能

段函数和方法的引用应该始终有其相关的(),除非被特别处理的函数或方法:

在本节中,我们将变量传递给做一点事()而且我们去比赛。

…要么:

在本节中,我们将变量传递给做一点事我们去参加比赛。

内联CSS

CSS属性应该被包裹在代码。内嵌属性分配不应包括分号。

然后我们开始颜色:#000继续我们的生意。

或者,你可以说:

然后我们开始颜色#000个继续我们的生意。

…如果你比较喜欢。

如果你讨论的是宽度或高度,不要用代码. 如果你指的是宽度高度财产,使用代码

然后,我们设置宽度为200像素。

然后,我们设置宽度属性为200像素。

CSS块

除了按照上述格式的准则,CSS块应当与每个属性在另一条线路,并用在不同的行的每个选择器写入。

p{颜色:#000;字体粗体;}em,强{字体大小:1.1em;}

列表

  • 如果在列表(有序与否)的任何项目形成一个完整的句子,所有项目必须以大写字母和结束与终端标点符号开始。
  • 如果在一个无序列表中没有产品形成一个完整的句子,跳过资本和终端标点符号。
  • 如果列表中的项目完成了一个未完成的介绍性句子,则用分号结束除最后一个项目外的所有项目,在最后一个项目前添加“和”,并用结束标点结束。

链接

选择简洁地指示链接文档性质的链接文本。不要链接终端标点符号。喜欢短的链接而不是长的。

Alt属性文本

在每个说明性图像中附带alt属性文本,这些文本简明地描述了那些看不见图像的人的图像。

示例:

良好:插图示出浮动DIV A.后的div A和​​B的重叠

坏:图像显示例子。

ALT属性文字使用的句子外壳。

标题属性文本

可以将标题文本附加到一些标记元素以传递附加信息。当用户的光标悬停在链接上时,许多web浏览器都会显示这些信息。对于出站链接,一个有用的title属性可能是:

普莱恩2004年法律文书通俗英语研究结果。

标题属性文本使用句子大小写。

标点符号

  • 缩略语和缩写:该首字母缩略词元素已过时。使用简称
  • &符号:避免使用符号,除了在文章和页面标题。
  • 引用:书名和其他主要著作,以及杂志和报纸的标题都标有引用元件。其他文章和短篇作品的标题都用betway体育注册引号括起来。
  • 逗号:使用串行逗号(前的逗号“和”在列表的最后一个元素之前)除了在文章标题。
  • 公司和出版物名称:除非他们开始一个句子,在这种情况下,他们必须是大写字母大写根据每个公司的偏好公司的名字。不要大写或出版物,甚至纽约时报的名字之前,否则强调定冠词。
  • 长破折号字体在破折号的两边不要留空。对枚举的日期范围使用en破折号。
  • 连字符用作形容词的复合名词短语,除非该名词短语使用得非常普遍,使用连字符显得有些笨拙。以副词为第一成分的复合形容词短语不要使用连字符。记住——就像那个人说的,“如果你把连字符看得那么严重,你肯定会发疯的。”(在这种情况下,正如在其他许多情况下一样,这个人是牛津大学出版社的文体手册。)
  • 报价单:根据芝加哥规则放置标点符号(句点位于内部等)。用块引号代替更实质性的引号。使用正确的(“卷曲”)符号,而不是双素数。附录A中提供了首选编码。尽管如此,在列表除了除了报价中标定的报价。

资本化详细信息

当单词“internet”、“net”、“web”和“website”出现在以句子为大小写的文本中时,应该像这里看到的那样大写(也就是说,不要大写)。电子邮件和电子商务使用连字符,而不是大写的“E”

使用标题大小写时,首字母大写,尾字母大写,其他主要单词大写。小写的" and ", " but ", " for ", " or "和" nor ",除非它们在特定的标题中被强调。

示例:

嵌入式字体的新希望

支持和反对杉木反击的论据

当标题样式的标题包含连字符短语时,请始终将第一个元素大写。将第二个元素大写,除非它是冠词、介词或上面提到的任何协调连词。例外:如果第一个元素是pre、post或anti等前缀,或者如果短语是一个写出的数字,则不要将第二个元素大写。

在使用句子大小写时,只将第一个单词和专有名称大写。