Based on: Editing Modules by Mark Husband, Adan Galvan
Summary: 此模組顯示如何編輯一個模組的資料,包括文字內容、檔案、以及一個模組的詮釋資料。
This module contains Connexions documentation which is out-of-date. The contents of this module are provided here for historical purposes only and should not be considered accurate for the current version of the Connexions website. The current (English-language) version of this module can be located at http://cnx.org/content/m10887/latest/. If you have any additional questions or cannot find the answer to your question, please contact techsupport@cnx.org and we will be happy to assist in any way we can.
If you would like to assist Connexions by helping us update this module with an appropriate translation from the current English version, please contact us at cnx@cnx.org as we would appreciate your help with improving our support for non-English-speaking users.
模組是一個Connexions課程的基本構建區塊。您可以把它想像成一個資料夾,裏面包含文字、圖片、以及CNXML檔案,標示一個單一主題,或一個主題的一個特殊觀念。模組的編輯者決定模組的大小。如果有必要,每一個模組應該包含可以獨立支撐的足夠資訊。對於一個學生觀看一個課程,一個模組是一個簡單的網頁,含有一個特定主題的資訊。模組可以讓學生在一個課程裏跟著資訊的路徑,而這路徑是由課程編輯者所安排的;或者也可以打破原本規則而讓學生們擁有他們自己的路徑。對於一個課程編輯者將資料一起放在一個課程裏,在不同的模組裡有不同的主題,則易於選擇及安排這些資訊。建構一個課程時,課程編輯者可以把別的課程裏所存在的模組包含進來,或者其他的學科領域,只要這對於課程主題的呈現是重要的。
如Figure 1所示,為一個新模組的資料舉例,顯示「Manage Files」(管理檔案)視窗的「File」(檔案)標籤。
![]() |
對於模組編輯者有利用性質的工作,模組狀態書籤具有與模組及數個連結有關的重要狀態資訊。書籤出現在模組資料右側,含有下列數項:
![]() |
一旦您已經建立一個新的模組,或者增加一個已存在的模組至您的工作區域,您將需要編輯此模組以增加資料、檔案及圖片等。這些操作是以連結進行,以及由「Manage Files」(管理檔案)視窗或「Module Status」(模組狀態)書籤上的按鍵來進行操作。對於執行這些操作的建議,將在此模組裏做說明,以及下列的一些操作:
編輯模組的這些操作項目將在下列各段中討論。對於模組的「Edit」(編輯)標籤顯示「index.cnxml」檔案的內容。此檔案包含出現在模組裏的文字,以及CNXML的指示說明,包含任何圖片、聲音、或其他出現在模組裏的檔案。預設是以Edit-In-Place(當場編輯)編輯器顯示資料及進行編輯。或者,您可以點擊Switch to Editing Full Source(轉換至編輯全部原始檔),而以「Full Source」(全部原始檔)編輯器顯示及編輯資料。從這標籤您可以對檔案進行下列動作:
![]() |
要輸入資料至index.cnxml檔案裏,請依下列步驟:
Import輸入按鍵旁,請從下拉選單中選擇您所要輸入的檔案格式,可用的格式為:Microsoft Word、OpenOffice Writer、XMLSpy/Authentic 及 Plain XML。 Import輸入按鍵,將會有一個視窗顯示一個文字方格,讓您填上想要輸入檔案的路徑名。 Browse瀏覽以在文字方格裡顯示檔案路徑名。 Import輸入按鍵,您所指定檔案的資料將複製至您模組裏的index.cnxml檔案裏。
Import輸入按鍵時,index.cnxml檔案的資料將會被輸入檔案的資料所覆蓋。您可以輸出index.cnxml檔案,讓您可以使用編輯XML檔案的軟體套件進行編輯。index.cnxml檔案必須轉換至讓XML編輯器可以讀取。而且一旦您已經完成編輯,必須再次轉換檔案以改變編輯器的可讀性。Connexions的輸出及輸入功能,會自動增加及移除編輯器可讀性的改變。目前,Connexions只支援XML編輯器,使用Altova xmlspy® 編輯器,或Altova authentic® 編輯器。
要輸出index.cnxml檔案至一個外部的XML編輯器,請依下列步驟:
Export輸出按鍵旁,請從下拉選單中選擇您所要引出的檔案格式,可用的格式為:XMLSpy/Authentic 及 Plain XML。
Export輸出,將會顯示一個對話方格,詢問您是否要開啟此檔案或儲存至磁碟。 要輸入檔案回去至Connexions裏,請依此模組中上方所提及內容,從Connexions外部輸入資料的介紹。
Edit-In-Place編輯器是在「Edit」(編輯)標籤上所預設的編輯器。您可以插入新的文字及媒體物件至一個模組裏,或使用此編輯器修正一個模組已存在的資料。您不必熟悉CNXML標籤以使用Edit-In-Place。當您在檔案裡輸入一個新的項目時,它會為您插入適合的CNXML標籤。此外,有說明文字,用以描述您所插入的項目或者編輯時的CNXML標籤。
要插入文字及媒體物件至一個空的新模組裏,請依下列步驟:
![]() |
![]() |
Save儲存以儲存您所鍵入的文字,藍色編輯方格將由一個灰色方格所取代,以顯示您的輸入。要編輯一個模組的資料,請依下列步驟:
![]() |
Save儲存以儲存輸入的文字,或者點擊Cancel取消以清除藍色編輯方格中輸入的文字。 您可以使用Edit-In-Place增加新的資料項目至一個模組,您可以增加的項目形式有:文字段落、數列、期刊目錄、式子、作業、圖片、編碼、筆記、及例子等等。Edit-In-Place在項目旁會開啟及關閉CNXML標籤,將產生一個唯一的項目ID。要增加新項目,請依下列步驟:
Add Here此處增加按鍵,在已存在項目的上方或下方處輸入新項目。 Add Here此處增加按鍵旁,請從下拉選單中選擇您所要輸入的項目形式,預設為「Paragraph」(文字段落);這些項目有說明文字,可以從下拉選單中選擇「Other Elements」(其他項目)來讀取。 Add Here此處增加,對於您所選的項目將出現一個空的藍色編輯方格;您可以藉由在藍色方格右上角中點擊Help editing xxx 編輯說明,顯示您所選項目的說明文字,其中xxx是您所選項目的CNXML標籤。 Save儲存以儲存輸入,或者點擊Cancel取消以清除輸入。 您可以使用Full Source編輯器,在Connexions的index.cnxml檔案裏編輯資料及CNXML標籤;建議編輯的方法僅適用於快速變更內容。這是簡單的文字編輯器,並沒有商業文字編輯器進階的功能,例如拼字檢查及文字搜尋。要使用Full Source編輯器編輯檔案,請依下列步驟:
Switch to Editing Full Source 轉換至編輯全部編碼源,index.cnxml檔案裏的資料將會顯示在Full Source編輯器模式下。
![]() |
Save儲存以儲存您的更改。當您編輯index.cnxml檔案時,請適時點擊Save儲存以儲存您的更改。在每次您儲存您的更改時,頁面會讀取及讓您的CNXML審定動作生效。如果沒有CNXML標籤錯誤,您的審定是有效的,「Saved」(已儲存)會出現在標籤上方的資訊方格中。如果在您的CNXML審定中有錯誤,會列在檔案資料上方。
您發佈在Connexions資料庫裏的任何index.cnxml檔案,必須是一個有效的CNXML文件,以及檔案必須結構完整且沒有CNXML錯誤;如果有錯誤,當您點擊Save儲存時將會出現每一個錯誤的敘述。直到所有錯誤都已修正,您才可以儲存您的改變。
![]() |
錯誤的敘述出現在資料上方的資訊方格中。
另一種編輯index.cnxml檔案的方法是使用一個外部文件編輯器,並不特別設計於用作XML編輯器。請注意,當您在「Files」(檔案)標籤上觀看模組時,一個小的鉛筆按鍵會出現在index.cnxml檔案檔名右方;請點擊此按鍵,以在一個外部文件編輯器上執行編輯index.cnxml檔案。此編輯方法是為您下載及上載index.cnxml檔案,但它只是一個文件編輯器,您必須手動輸入所有的CNXML標籤。如果您不熟悉CNXML,此方法較慢且笨拙;此方法在您使用之前,也需要您或您的系統管理員設定外部編輯器以作為.cnxml型式檔案的預設編輯器。此外,您或您的系統管理員必須在Windows環境中安裝Zope ExternalEditor,或者在Macintosh環境中安裝Zope EditManager。
除了index.cnxml檔案,一個模組可包含其他的檔案,例如與模組有關聯的圖片、檔案、及CNXML文件。您可以從「Files」(檔案)標籤增加這些檔案;在您增加至模組之前,這些檔案必須存在。您可以在額外的步驟中建立CNXML文件。當您增加這些項目時,您在Connexions裏已建立這些項目的存在。
在您增加一個關聯檔案至一個模組前,請注意下列檔案及檔名的管理要領:
要增加一個圖片至一個模組,請依下列步驟:
Add New Item增加新項目旁的文字方格中的向下箭頭,將會出現一個有效項目的下拉列表。 Add New Item增加新項目,將會出現「Edit Image」(編輯圖片)標籤。 Browse瀏覽,將會顯示「File Upload」(上傳檔案)對話方格。
Open開啟,圖片檔名將會出現在Browse瀏覽旁的文字方格中。 Save儲存以上傳圖片檔案至Connexions,將會顯示一個確認訊息及圖片預視。要增加一個檔案至一個模組,請依下列步驟:
Add New Item增加新項目旁的文字方格中的向下箭頭,將會出現一個有效項目的下拉列表。 Add New Item增加新項目,將會出現「Edit File」(編輯檔案)標籤。 Browse瀏覽,將會顯示「File Upload」(上傳檔案)對話方格。
Open開啟,檔案名稱將出現在Browse瀏覽旁的文字方格中。 Save儲存以上傳檔案至Connexions,將會顯示一個確認訊息及檔案的資訊。要增加一個CNXML文件至一個模組,請依下列步驟:
Add New Item增加新項目旁的文字方格中的向下箭頭,將會出現一個有效項目的下拉列表。 Add New Item增加新項目,將會出現「Edit CNXML File」(編輯CNXML檔案)標籤。 Save儲存,將會顯示一個確認訊息及關於CNXML檔案的資訊。您可以重新命名、剪下、複製、或移除任何項目至一個模組。這些操作在模組等級中完成,如同在工作區域中的等級。請看從一個工作區域移除項目、在一個工作區域裏重新命名項目、以及在一個工作區域裏剪貼或複製項目,以瞭解如何在工作區域裏進行那些操作。
為了能夠讓使用者在Connexions資料公共園地搜尋模組,Connexions必須有模組的一些相關資訊;因此您插入詮釋資料至模組裏是非常重要的。
![]() |
要插入詮釋資料,請依下列步驟:
Save儲存,將會顯示一個訊息說明詮釋資料已被更新,在視窗標題裏模組的名字會取代「New Module」(新模組)。作為一個模組的建立者,預設中您擁有所有三個角色:編輯者、資料維護者、及版權持有者。您可以授權給其他Connexions帳號持有者一個或多個角色,只要您想要讓他參與此模組。底部表格的「Roles」(角色)標籤顯示使用者名稱及他們目前的角色。在「Author」(編輯者)、「Maintainer」(資料維護者)、或「Copyright Holder」(版權持有者)欄中的確認方格會指出被授權此角色的人。
![]() |
要授權其他使用者角色,請依下列步驟:
Search搜尋旁的確認方格中鍵入您想要授權角色的使用者名字。 Search搜尋,將會搜尋Connexions帳號裏符合搜尋字串的所有使用者出來。 Add People增加人員,將會有一個「Roles Pending Approval」(角色未定認可)表顯示在「Roles」(角色)表格下方。 Update Roles更新角色。 在授權或更新另一個使用者的角色時,這個變更並不會生效,直到其他使用者已經接受這個角色的變更;一旦使用者認可這變更,他們新的角色將會反映在「Roles」(角色)列表裏。請查閱認可角色要求以獲得更多認可要求的資訊。
Connexions讓教育材料的共同合作更為容易,其中一個方法是分享一個模組或課程的創作權或持有權。如果另一個編輯者在他們的模組或課程中授權您一個角色,您可以與他們一起合作,「Pending」(未定)書籤將出現在您Connexions網頁的右上方。
![]() |
請點擊Role Request角色要求連結,以顯示「Collaboration Requests」(共同合作要求)視窗。從這視窗您可以:
![]() |
如果另一個Connexions的編輯者在他們的模組或課程上授權您一個角色,成為編輯者、資料維護者、或版權持有者,將會在「Collaboration Requests」(共同合作要求)視窗的「Request Awaiting Your Approval」(要求等候您的認可)處下方出現一個入口。若要接受要求,請選擇在您希望接受要求的表格裏的確認方格,並點擊Accept接受。
若要拒絕要求,請選擇在您希望拒絕要求的表格裏的確認方格,並點擊Reject拒絕。
如果您在您的一個模組或課程中已經要求某人增加角色,成為編輯者、資料維護者、或版權持有者,將會在「Collaboration Requests」(共同合作要求)視窗的「Request You Have Made」(您已發出要求)處下方出現一個入口,直到其他編輯者啟動它。您可以從這裏取消未定的要求。
任何您已經發出的要求,不管是被接受或被拒絕,都會列在「Collaboration Requests」(共同合作要求)視窗的「Request You Have Made -- Completed」(您已發出要求 – 完成)處。當您不再需要保留此記錄時,您可以刪除它。
要增加或編輯與一個模組有關的連結,請點擊編輯界面上的「Links」(連結)標籤,將會顯示「Edit Links」(編輯連結)視窗。
![]() |
從「Links」(連結)標籤,您可以:
這些連結可以在「Links」(連結)標籤裏看到,顯示每一個模組。連結出現在特定的分類型式底下,例如,輔助的連結列在「Supplemental」(輔助)標題底下。要增加一個新連結至一個模組,請依下列步驟:
Add增加以增加連結。如果模組已經含有連結,連結將出現在視窗的上半部。要編輯已存在的連結,請依下列步驟:
Update Links更新連結以完成您的更改。要刪除一個存在的連結,請在存在的連結列表中的「Delete」(刪除)欄裏選擇確認方格,然後點擊Update Links更新連結以刪除連結。
編輯模組之後,您應該預視模組以確認您所要出現在模組上的東西。您可以依下列方式從「Preview」(預視)標籤觀看模組:
要線上觀看一個模組,請依下列步驟:
一個模組的列印版本的格式,與線上版本不同。此差異性是必要的,因為線上媒介及列印媒介並不相同。要觀看一個模組的列印版本,請依下列步驟:
OK同意,將會顯示模組的列印版本。 編輯一個已存在的模組時,您可以觀看最後發佈模組版本以及您目前編輯版本之間的差異總結。請點擊Changes更改連結以觀看更改總結。當您要檢查一個很久以前的模組而不記得您做過什麼更改時,這個選項相當有用。
![]() |
「Change To」(更改)摘要列出模組的更改,包含角色的指定,以及任何已更改檔案的名稱,增加的檔案,以及移除的檔案。請點擊檔名以顯示更改的簡短描述。
有時候觀看一個模組的編碼源是較為方便的。要觀看模組的編碼源,請點擊在「Module Status」(模組狀態)書籤裏的「View」(觀看)標題底下的Source編碼源連結,將會顯示已經儲存的最新編碼源。
當您希望將編輯的模組回到原來的狀態時,此狀態是在您開始編輯它之前,此情況可能會發生。如要拋棄您的更改,請點擊在「Module Status」(模組狀態)書籤裏的「Actions」(動作)標題底下的Discard拋棄連結,模組將會返回到您開啟它時的狀態。
要讓您的模組或您所做的更改能夠使任何人在網路上可以觀看,您必須將模組發佈在Connexions裏。要發佈一個模組,請依下列步驟:
Publish發佈,您對於模組所做的工作將輸入至Connexions資料公共園地。一旦進入資料公共園地,在網路上的任何人都可以觀看此模組。![]() |
一個新的模組並沒有編輯上的更改,因此在「Description of Changes」(更改說明)文字方格裏您必須輸入一個註解,例如「Created a new module」(建立一個新模組)。
Save儲存按鍵,當您儲存您的更改時,只有您以及可以存取您工作群組的人可以看到您的更改。當您發佈一個模組時,整個世界都可以在網路上看到您的工作。