CSWE:寫作格式建議

以下是我們建議在CSWE中，條目的寫作格式。

基本結構

每個條目都必須要有以下幾個部份。

• 首句
• 本文
• 參考文獻

進階結構

當文章中引用了較為豐富的資料時，可能會需要比較複雜的結構。當使用時，我們建議出現的順序如下。

• 首句
• 本文
• 相關條目
• 注釋
• 參考文獻
• 延伸閱讀
• 外部連結

解說

首句

首句是頁面中的第一個段落，其功能在於簡短且清楚的給與這條目一個定義。原則上首句的開頭，是以條目的名字做為起始。如「社會工作」這個條目，其首句應是「社會工作是....」。

• 首句應盡可能以條目名稱做為開始。而條目名稱，應使用粗體強調。（使用''' XXX '''）
• 不要怕遺落細節，首句的目的在給予一個簡短清楚的定義，提供讀者一個大致的輪廓。
• 在某些情況下，首句可能會有兩小段，甚至是三小段。一般來說，在第一個標題或是目錄之前，都可以稱做是首句。

本文

本文的功能在提供這條目的相關說明。當資料充足時，一般來說會使用段落標題來編排文章結構。如果在三小節以上，系統會自動產生一個目錄，介於首句及第一個標題中間。

• 在使用一級標題來分段時，您是使用兩個等號(=)在標題文字的二側，即== XXX ==。比如說，在本節的標題「解說」，即是用一級標題。請注意，不要使用一個等號(=)的方式來做標題。
• 如果在這段落中，您仍有需要再做分段，可以使用二級標題，即使用三個等號(=)在標題文字的二側。比如說，在本節的標題「本文」，即是用二級標題。
• 請注意，不要將標題當做是列點的工具。每個標題下，最好是有兩個段落以上。
• 如果您的本文部份較合適以「類型」做為區分，則建議您在分段之前，先有小一段的文字敘述，而不要直接的就用標題來分段，這樣易使讀者困惑。比如說，「社區組織實務之模式」，可於首句就介紹其可以分為三種模式，或是在本文中先說明其可分為三種模式，再用標題分段。
• 如果您想要在標題分段之前先以文字說明，但又希望這段文字可以出現在「目錄」之後，可以使用 __TOC__ 的方式來指定其出現的位置。

相關條目

相關條目指的是與本條目有密切相關性，且在本網站上有出現的條目。

• 相關條目並非必要的，除非你知道兩者的關係密切，否則無須列出。
• 如果在內文中有出現其他在本網站上之條目，原則上在出現的地方使用「連結」的功能即可（即[[ XXX ]]），在此不需重覆的條列。如果在內文中並沒有合適出現的機會，同時又與本條目有密切的相關，就應放在這個區域。
• 請以「符號列表」的方式條列出相關的條目，同時也要使用「連結」的功能（即* [[ XXX ]] ），方便他人點選閱讀。

注釋

注釋的目的，在說明內文中某一個部份，可能是因為在內文中敘述會太過繁雜、相關性較低但仍有其重要性、補充說明、或是為了文體的流暢等因素。

• 注釋並非必要的，除非你沒有更好的方式來表達，否則都應盡可能的將訊息寫入內文。
• 注釋使用的方法請參考[1]。
• 某些的寫作格式，要求將參考文獻使用注釋（注腳）的方式來呈現，在CSWE中原則上使用APA格式，所以請不要使用注釋來呈現參考文獻。

參考文獻

參考文獻是展現文章可信、確實的重要指標之一。只要在內文中有使用到由其他文獻得來的訊息，都應加以記錄。在CSWE中原則上使用APA格式，該格式的規範可以參考APA手冊，在網路上也有大略的介紹。

• 參考文獻，與內文有同樣的重要性，沒有參考文獻的條目會被視為有重大的缺失。
• 請以「符號列表」的方式條列出參考文獻。
• 如果你在內文中有使用網路的資料，也應該列在此處，而非置於延伸閱讀或是外部連結。比如說，使用了Wikipedia中某條目之資訊。

延伸閱讀

延伸閱讀在提醒讀者一些值得閱讀的文獻或書本。

• 延伸閱讀並非必要的，除非你深知該書的價值，否則無須列出。
• 使用時，除了列出書名之外，請給予該書簡略的介紹，包括它涵括的範圍及其重要性。
• 使用延伸閱讀時，原則上以紙本的資訊為主，線上資訊可以放在外部連結中。
• 注意，在此的訊息，是沒有直接出現在內文中，但又具有其重要性的訊息。若是在內文中有使用到的訊息，應置於參考文獻中。

外部連結

外部連結在提供與此條目有密切相關性之網路連結。

• 外部連結並非必要的，除非你深知該連結的價值，否則無須列出。
• 注意，在此的訊息，是沒有直接出現在內文中，但又具有其重要性的訊息。若是在內文中有使用到的訊息，應置於參考文獻中。