华佗百科:更优秀条目写作指南

华佗百科,全民书写的医学百科全书!
跳转至: 导航搜索

本文是一系列关于如何把一个条目写得更好的建议,包括版面布局、文章格式,以及如何使条目对于读者来说内容更加清晰、准确和切题。同时,本文也会简要地提及其他必要资讯以及相关索引。

版面结构与布局

一个条目的版面结构与布局十分重要,它直接影响到条目的品质,因此应当首先确定。一个好的条目开篇会简要地介绍主题,随后用一个清晰的结构提供详细资讯,最后使用附录列出参考文献和相关链接。

导言

一篇条目的导言又可以叫做“引子”、“介绍”、“绪言”或起始段落。这一部分对整篇条目内容作出简介和概述。由于导言总是位于条目的起始部分,所以不需要加入“==導言==”或者“==緒言==”之类的段落名。一些比较长的条目在导言之后还会有一个“概述”之类的段落;当然,也可以是更加具体的段落名。我们在后面还会有更加详细的说明。

篇幅

条目应保持简短,只叙述必要内容,而不要无限制扩充。条目应保持在32千个字节(32KB)以内。倘若条目超出可读篇幅,则应该进行拆分以便改善条目可读性和可编辑性。具体的拆分措施请参考Huatuo:摘要格式。另外,条目整体的结构平衡也很重要,不要一个段落过长,其他段落则太短。如果这种情况不可避免的发生,往往意味着长段落可能需要单独成立条目了。

段落

同样,一个段落也应该尽可能短,以免累著读者的眼睛。一个长段落可以拆分成几个短段落,而在每个段落开头写一句承上启下的句子。相反的,一句话的段落也十分特殊,只有有充分的理由时才可以这么做。否则,过短的段落应该被合并到临近段落中。段落有时可以用列表或表格取代,但需要根据情况决定。不必要的列表对条目行文会其破坏作用。

章节

章节可以使条目内容清晰,并由此产生目录,参见Help:章节。章节是有层次的,开始为二级标题(== 章 == ),之后依次为三级(=== 節 ===)、四级(==== 小節 ====)等等。一些内容是否需要一个章节标题进行概括是个人风格问题,可以由编辑者自行决定或者与他人讨论。

图片

如果文章有关联的插图可用,应寻找接近关于图片的内容的文字附近加入。如果插图过多或有可能令阅读者混淆,应使用“见右图”等字眼将阅读者的眼光带到图片上。请参考图片指南

附录

一些附录可以依附在条目最后,如:

  • 参见:一些内部链接以及必要的说明
  • 注释:对条目内容的额外说明
  • 参考文献:条目内容引用的文献列表,有时也可以合并在“注释”中
  • 外部链接:一些与条目主题相关的高品质网站,不包括已经在“参考文献”中出现的网站。最典型的外部链接是条目主题的官方网站。

写作风格

华佗百科目前有两种写作风格(也叫格式):事实风格和陈述风格。

事实风格

事实风格是将自己所知道的真相全部的呈现出来,但是所表达的内容是否真相,就需要所有的华佗百科编辑者门共同监督并完善;

陈述风格

陈述风主要是陈述医学事实,用自己的语言编辑某一案例或者某一件事情。

语调

撰写条目应该使用正式、客观、第三人称的语调,并尽可能让更多读者(受教育程度不同)看懂。条目内容不应该含有大量的术语、影射、暗语,也不应该使用“我”或“你”等非第三人称代词,除非是在引用他人的原文。例如,介绍自己的家乡不应该使用“本市”或者“我国”,而应该使用“××市”、“该市”、“×国”等。仅仅在必要的情况下使用注音,而叹号“!”除引文外不可使用。

内容和表达

华佗百科是个国际性的百科。每位读者拥有不同的背景、教育程度与世界观等。编辑者应使用几乎人人也能看得懂的措辞。因于每一位读者阅读题目也是为了“学习”知识,所以应尽量保持为向“无知”或“不认识任何关于此类型”的读者的心态去撰写。

尽可能亦应许免使用有关于该类型的术语,但我们仍应考虑读者的层级。例如题目为“主成分分析在人脸识别中的应用”的条目只有精通人脸识别领域研究的读者才会浏览。但当仍要使用术语或技术性上语言,亦应使用连结标记将术语引领到术语的题目。但如果题目是“人脸识别”,则平常读者也会阅读,因此需要简单易懂的导言和概要,把专业艰深的内容以内部链接的形式“藏”起来,留给“高级”读者。如果条目涉及什么术语,则应该给出清楚的解释。

构建网络

要知道,华佗百科的每一个条目都不是孤立的,而是同一个知识网络密切连接,通过内部链接可以给读者提供这个知识网络。因为华佗百科并不如传统百科全书那样是一个有序排列条目的集合,而是一个无序但相互连接的条目集合,因此每一个条目都应连接到其他主题中以便对其归类和定位。在创建链接时,不要太浮泛,一定要注意所提供的链接是否相关。不需要在条目内容中出现12次的某主题次次都提供链接,而最好只在导言和结尾提供两次链接。同时要注意读者的兴趣,尽可能提供一些读者可能希望了解的“不重要”的链接,但不是越多越好,而是优先给出最有影响的链接。

避免自己写的条目成为孤儿条目。在撰写条目时,尽可能寻找相关条目,并提供链接指向您的新条目。这样,其他读者才可能通过其他条目点链接(而不是使用搜索)来到您的条目。否则,除非条目作者,其他读者可能永远也不知道华佗百科里还有这么一个孤独的条目存在。

陈述常识

不要省略对您来说是常识(从而是“废话”)的内容,因为其他读者并不一定了解这些“常识”。这样的内容一般可以作为导言的第一句概括,比如:

本草纲目》是李时珍于1572—1578年创作的,包括……

以上内容没有提到《本草纲目》的一个基本常识:它是一本书。编辑者假设读者知道《本草纲目》是一本书,而不是一部电影或者别的什么,而这个假设不一定成立,特别是对于不熟悉中国文学的读者来说。因此应改为:

本草纲目》是李时珍于1572—1578年创作的一本医药书集,包括……

但也不需要过分的提供冗余资讯,例如:

本草纲目》是中国作家李时珍于1572—1578年创作的医药书集,内容都是由中文写的,包括……

因此,在提供常识性资讯的同时还要注意内容的简洁。

导言

导言是第一章之前的章节。它位于目录的上方(当整个文章有超过3个章节时)。它应该包括对标题的定义、内容的概述,并告诉读者为什么它很重要

首句

作为文章的开篇,首句应该是一个简明的、概述性的定义陈述。首句应该为一个普通读者解答如下问题:条目的主题是什么?这个主题为何有足够的知名度?位于首句中的条目标题应该加粗显示,但之后则不用。同样地,不要再为题目设置内部链接,因为这样会使读者循环进入同样的页面。

  • 例如,条目查理斯·达尔文的首句不应该是这样:
查理斯·达尔文发表的《物种起源》一书引起了轩然大波。

但可以是这样:

查理斯·达尔文 (1809年–1882年) 是一位著名的博物学家、地理学家,他创立了现代科学的进化论。……
  • 同时,如果条目标题是一部艺术作品(如绘画、文学、电影等)的题目,则应在首句中加入书名号。譬如条目《再别康桥》可以这样开头:
再别康桥》是中国诗人徐志摩脍炙人口的新诗。
  • 对于缩略语,则在首句中的全名以及别名、通用名等名称均应加粗。比如条目小苏打的首句:
碳酸氢钠(化学式:NaHCO3),俗称小苏打苏打粉梳打粉(香港)、重曹,白色细小晶体,在水中的溶解度小于苏打
  • 而对于虚构的人物或地点,以霍默·辛普森为例,通常应该这样开头:
霍默·辛普森是一部电视动画中的虚构人物,……

引言段落的其他内容

接着给予一段说明。这段说明应该尽可能使任何读者清楚地明白条目主题。如果条目很长,则在导言部分应该提供一个[内容摘要。记住,即便读者理解了条目主题的基本定义,他们仍然不一定清楚这个主题的重要性。告诉他们!例如:

同行评审Peer review,在某些学术领域亦称“refereeing”)是一种审查程式,即一位元作者的学术著作或计划被同一领域的其他专家学者评审。一般学术出版单位主要以同行评审的方法来选择与筛选所投送的稿件录取与否,而学术研究资金提供机构,也广泛以同行评审的方式来决定研究是否授予资金、奖金等。同行评审程式的主要目的是确保作者的著作水平符合一般学术与该学科领域的标准。在许多领域著作的出版或者研究奖金的颁发,如果没有以同行评审的方式来进行就可能比较会遭人质疑,甚至成为某出版物、作品是否可以被称为学术出版物的主要标准。

如果条目长度需要使用多段叙述,那么第一段应当简洁并直切主题;给条目的主题以清晰的解释。

为了避免目录的显示位置过于靠下,即比一个页面的位置还要靠后,则将__TOC__语句置于希望目录所出现位置的顶部。

恰当的引言长度取决于文章的长度。作为一般准则,引言不应该超过两段或三段。推荐使用如下规则:

< 15,000 字 15,000 字 - 30,000 字 > 30,000 字
一或两段 两或三段 三段 (考虑 划分文章)

如何评判

想想这些问题,以估计你是否设置足够的说明:

  • 如果一个读者是用随机页面到此条目,他能够了解条目说什么吗?(Special:Randompage)
  • 想像你是一个位于说普通话国家的读者,你能够了解条目在说什么吗?
  • 如果只印出本条目的第一页(概要/简介部分)并四处传阅,人们能够了解条目是在说什么吗?
  • 读者想要点选某些连结作延伸阅读吗?

少用其他语言

收录外文(非中文)行话作为额外资讯并没有太大问题,不过别撰写一篇在读者了解这些外文行话的前提下才能阅读的条目。请使用这样的格式注释外文术语,例如: hyperlink (超链接)。另外, 只有在不得已的情形下才能使用外国字当做条目的标题。

原文字体对于需要准确地辨识模棱两可的拼法的研究人员而言十分有用,尤其是某些不太容易转译为罗马拼音的 tonal 语言。外文用语若有独立条目无须加上当地文字。

少用颜色

少用颜色。 每台电脑的设定与使用的浏览器不尽相同,编辑者没有可能知道有多少颜色可以被使用者的电脑显示出来。而且由于华佗百科是国际性的:不同的文化对与每个颜色的解读不同。含有过量颜色的页面看起来令有眼花撩乱,而且完全不像一本医学书籍。仅仅在警告与需要读者关注的地方使用颜色。

使用简洁而明确词语

使用短句和列表

'使用短句 不代表 使用很少字词. 使用短句意即 不用不必要的字词,有时候要用句号而非逗号来结束句子。

文笔简洁。一个句子应该不包含任何不必要的字和多余的句子,出于同样的原因,绘图应该没有多余的线条,一台机器应该没有多余的零件。这不是要求作家让他所有的句子简短或他避开所有的细节。

当你在编辑条目时,请再三阅读并用最精要字词。华丽虚饰的词语不应出现在华佗百科。避免不必要的字词,但是,这并不能成为删除文章的有效借口。

避免惊奇的内容

记往避免古怪的内容,你应该小心地计划好页面和连结并使所有东西合理和有意义地出现。如果连结会带读者去一个读者期望以外的地方,至少应该把他们带去地方一个合理的条目如消歧义页。

'是指的使用

The phrase refers to is often found near the beginning of Wikipedia articles. For example, the article Computer architecture once began by saying "Computer architecture refers to the theory behind the design of a computer." But that is not literally true; it would be better to say, "Computer architecture is the theory behind the design of a computer", as the article now does. Note that it is the words computer architecture that refer to a certain theory; computer architecture itself does not refer to any theory, it is a theory.

Sometimes it may be appropriate to say, for example, "The term Great Schism refers to either one of two schisms in the history of Christianity", but most often the simpler locution is better. If you mention the phrase Great Schism, rather than using that phrase to refer to one of the Great Schisms, then write the word in italics to indicate that.

See also: Use-mention distinction

核对事实

撰写事实: 检查你写的事实,不要虚构。你可能需要检查这些可疑的事实。

这是华佗百科的基本。就算你十分熟知关于某个医学知识条目的资料,你都必列明来源以向读者证明资料是正确的。找寻良好的参考来源,你大有可能从中得到更多新知识。

删除可能为事实的内容时请特别小心。编辑者经常在没有提供参考资料的情况下纳入大量内容。在您想要由条目删除某些内容时,请先检查其真实性。如果某个事实含有大量内容而且有提供来源, 请在删除时更加小心。百科熟的容纳库。If another editor provided a fact, there was probably a reason for it that should not be overlooked. So consider each fact provided as potentially precious. Is the context or overall presentation the issue? If the fact does not belong in one particular article, maybe it belongs in another.

Examine entries you have worked on subsequent to revision by others. Have facts been omitted or deleted? It may be the case that you failed to provide sufficient substantiation for the facts, or that the facts you incorporated may need a clearer relationship to the entry. Protect your facts, but also be sure that they are presented meaningfully.


避免笼统的语言Avoid blanket terms

  避免使用未经验证的笼统语句。举例来说,条目‘蒙哥马利县’指代的是美国的18个‘蒙哥马利县’,这之中“绝大部分”均以理查德·蒙哥马利的名字而命名。这就属于一个笼统条目。也许条目内容是真实的,但它是否可靠?上述实例中编者做了许多调查来验证信息的可靠性。没有调查,就不应该声明此事。在讨论页中描述并公式您所做的调查也许是一个不错的主意。

 

虚构的内容也需核对Check your fiction

The advice about factual articles also applies to articles on fiction subjects. Further considerations need to be made when writing about fictional topics: they are inherently not real. It is important to keep these articles verifiable and encyclopedic.

If you add fictional information, clearly distinguish fact and fiction. As with normal articles, establish context so that a reader unfamiliar with the subject can get an idea about the article's meaning without having to check several links. Instead of

避免离题

一篇最佳可读性的条目包含最少的无关(或是仅仅有点相关的)资讯。如果发觉你自己的写作开始离题,请考虑将这些额外资讯放在其他更适当的条目里。提供连至其他条目的连结方便想知道更多资料的读者钻研,也同时不会让其他对此条目不感兴趣之读者分心。

注意错字

注意错字, 尤其是刚创建的条目名称。正确的用字与文法鼓励他人贡献更多好内容。一篇正确用字的条目让其他作者更容易地连结到你的条目。错误的用字会令其他人出错。尽量做到最好。这不是什么大不了的事,但为何不改正它呢?

  • 用免费的网上字典如Yahoo!字典、, Dictionary.com
  • 在条目保存前,可以使用文字处理器对条目进行拼写检查。
  • 某些浏览器,例如类Unix系统里的KonquerorMac OS X系统里的Safari,可以自动突出显示文本框内的拼写错误。

更多的信息请参考Huatuo:格式手册

避免华而不实与模棱两可的用语(尚未达成共识)

不要华而不实:意指不含有任何实质资讯的浮夸用语。不要模棱两可意指提供没有任何证据支援, 不中立的意见。

华而不实的例子
一个重要的... 最有名望中的一个... one of the most prestigious... 其中一个最好的...
最具影响力的... 标志性的... 最伟大的...
模棱两可 的例子
某些人说... ...被认定是... ..是被广泛认同的.. ..is widely considered...
...被称为... ...has been called... 大家相信... It is believed that... 人们建议/注意到/已经决定... It has been suggested/noticed/decided...
有些人认为... Some people believe... 据说... It has been said that... 有些人会说... Some would say...
据传说... Legend has it that... 评论说... 许多人/一些人声称...

相信你的题材,让事实解释一切。

范例一

以实际证据取代华而不实的用语。

“张三是最伟大的人物之一。”
“张三下乡行医三十年,出钱资助超过600多户穷困人家的小孩上学。”

以实质的事实取代意见。

范例二

请仔细阅读以下两个不同的例句。哪句引起你的兴趣而继续阅读下去?

刘五是最伟大的人。
刘五曾经是联合国儿童基金会的创始人之一,至今已造访了埃塞俄比亚、南非、卢干达等数十余个国家,协助当地建立安全可靠的用水。

范例三

如果你想引用某个意见,首要之务是确定那个人的意见对这个话题有举足轻重的影响力,然后指出是哪个人的名言。如果能够举出名言的来源就更好了

某些人批评张三的作法是自命清高。
李四在TNN电视台的节目“56分钟”说过,张三本身财产雄厚,有能力在大量资助他人的同时过着优裕的生活。

例外

我们所说的一切并非金科玉律。当重复已经成为既定事实的观点时,相较于进一步阐明它的细节与来源,这样说会更为方便:“在尼古拉·哥白尼之前,大多数人认为太阳绕地球旋转”——特别是当这个叙述只是文章中一小部分的时候。但不要惊讶于后来者会质询来源或修改你的句子。

指出缺失的内容Make omissions explicit

Make omissions explicit when creating or editing an article. When writing an article, always aim for completeness. If for some reason you can't cover a point that should be covered, make that omission explicit. You can do this either by leaving a note on the discussion page or by leaving HTML comments within the text and adding a notice to the bottom about the omissions. This has two purposes: it entices others to contribute, and it alerts non-experts that the article they're reading doesn't yet give the full story.

That's why Wikipedia is a collaborative encyclopedia—we work together to achieve what we could not achieve individually. Every aspect that you cover means less work for someone else, plus you may cover something that someone else may not think of, but is nevertheless important to the subject. Add {{todo}} to the top of the talk page of articles for which you can establish some goals, priorities or things to do.

其他问题

不适当的题材
华佗百科不是用来宣传你的网站,乐队,产品,或是其他相关的事物。华佗百科不是用来打广告的媒体或是网页空间服务.不论你强调这样的文章有多重要, 聪明的华佗百科编辑者很快就会知道哪篇条目是纯粹的广告或是对个人的赞美。
作好分类
纸版百般全书的条目尽管数量众多,但都经过仔细分类、排序、索引,而华佗百科全书的条目却常常是分散、独立的,仅通过超链接相互联系。因此,华佗百科全书亦需作好分类,将每个条目都划分到适当的类别之中。
避免让条目边缘化
要避免让条目边缘化,你要不断地为它加上合适的链接。当你在创建新条目时,确保最少有另一条条目可链接到它(最好适当地加上更多一些链接,使得这条目在其他人或机器人重构之后不被边缘化的机会能够增加)。否则该条目脱离最近更改页面底部就形同消失在《阿瓦隆的迷雾:亚法隆之谜》传说中。从华佗百科出现的每一个链接都应是没有失效、而能顺利连到百科中的每一个条目;根据你预期要找到你的条目会怎么走,来给你一些提示决定哪一个条目应该链接到你的条目。
超链接
条目中同一个词条的超链接衹需在一处或重要的几处创建,不必全部都加链接,参见帮助:链接
专有名词
不重要的事情也很重要
阅读芝麻小事也有一番乐趣. 可以考虑加入一些有趣的连结让整篇条目更加有趣。
制作个人的副本
如果你与其他编辑者进行着编辑战或是情况更糟的回退战时,请保持冷静。试着制作此条目的个人副本, 以自己的步调编辑此条目。

外部链接