CSWE:寫作格式建議
出自 Caseru Social Work Encyclopedia
以下是我們建議在CSWE中,條目的寫作格式。
基本結構
每個條目都必須要有以下幾個部份。
- 首句
- 本文
- 參考文獻
進階結構
當文章中引用了較為豐富的資料時,可能會需要比較複雜的結構。當使用時,我們建議出現的順序如下。
- 首句
- 本文
- 相關條目
- 注釋
- 參考文獻
- 延伸閱讀
- 外部連結
解說
首句
首句是頁面中的第一個段落,其功能在於簡短且清楚的給與這條目一個定義。原則上首句的開頭,是以條目的名字做為起始。如「社會工作」這個條目,其首句應是「社會工作是....」。
- 不要怕遺落細節,首句的目的在給予一個簡短清楚的定義,提供讀者一個大致的輪廓。
- 首句應盡可能以條目名稱做為開始。而條目名稱,應使用粗體強調。(使用''' XXX ''')
- 在某些情況下,首句可能會有兩小段,甚至是三小段。一般來說,在第一個標題或是目錄之前,都可以稱做是首句。
本文
本文的功能在提供這條目的相關說明。當資料充足時,一般來說會使用段落標題來編排文章結構。如果在三小節以上,系統會自動產生一個目錄,介於首句及第一個標題中間。
- 在使用一級標題來分段時,您是使用兩個等號(=)在標題文字的二側,即== XXX ==。比如說,在本節的標題「解說」,即是用一級標題。請注意,不要使用一個等號(=)的方式來做標題。
- 如果在這段落中,您仍有需要再做分段,可以使用二級標題,即使用三個等號(=)在標題文字的二側。比如說,在本節的標題「本文」,即是用二級標題。
- 請注意,不要將標題當做是列點的工具。每個標題下,最好是有兩個段落以上。
- 如果您的本文部份較合適以「類型」做為區分,則建議您在分段之前,先有小一段的文字敘述,而不要直接的就用標題來分段,這樣易使讀者困惑。比如說,「社區組織實務之模式」,可於首句就介紹其可以分為三種模式,或是在本文中先說明其可分為三種模式,再用標題分段。
- 如果您想要在標題分段之前先以文字說明,但又希望這段文字可以出現在「目錄」之後,可以使用 __TOC__ 的方式來指定其出現的位置。
相關條目
相關條目指的是與本條目有密切相關性,且在本網站上有出現的條目。
- 如果在內文中有出現其他在本網站上之條目,原則上在出現的地方使用「連結」的功能即可(即[[ XXX ]]),在此不需重覆的條列。如果在內文中並沒有合適出現的機會,同時又與本條目有密切的相關,就應放在這個區域。
- 請以「符號列表」的方式條列出相關的條目,同時也要使用「連結」的功能(即* [[ XXX ]] ),方便他人點選閱讀。
- 請適度的列出有密切相關條目即可,不要太過浮濫。
注釋
注釋的目的,在說明內文中某一部份,可能是因為在內文中敘述會太過繁雜、相關性較低但仍有其重要性、補充說明、或是為了文體的流暢等因素。