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