XSLTForms/貢獻

本頁為有興趣幫助完成和維護此華夏公益教科書的人員提供資訊。它描述了本書的風格指南，概述了目前對本書進行改進的路線圖，並提供了一份看起來需要做的任務清單。

與 XSLTForms 本身一樣，此華夏公益教科書的使用者群相對較小，但生命週期很長。小型的社群意味著書中的缺陷和漏洞可能需要一段時間才能得到解決；然而，它的長壽表明這本書對某些人來說確實起到了有用的作用。此頁面旨在讓本書的工作更容易協調和有效。

風格指南

不要使頁面過於擁擠。將不同的主題分成不同的頁面（請記住，頁面和章節比收縮更常增長：維基上的合作者更願意新增新材料，而不是刪除他人貢獻的材料）。

提供具體的例子。使用 syntaxhighlight 元素對它們進行標記。並提供解釋和評論，以清楚地說明示例所展示的要點。

使用“命名約定”部分中列出的名稱空間字首；如果您需要某個名稱空間超過三次，那麼可能值得在那裡新增一個條目。顯式名稱空間宣告始終是可以的，只要示例保持易讀。

如果您在一個討論中留下了空白（因為您沒有時間完整地處理所有事情，或者因為您知道某個主題需要涵蓋但您對此瞭解不足，無法自行處理），在方括號中新增一個註釋，例如“[此處需要對 XYZ 進行更詳細的討論]”，是一種向讀者表明覆蓋範圍不完整，並向其他貢獻者表明此處需要填補空白的合理方法。

為了保持一致性，函式和元素的文章最好具有大致相同的結構，幷包含以下子標題：

1. 描述
2. 語法 / 簽名
3. 示例和用法
4. 已知問題和問題
5. 更多資訊（獲取更多詳細資訊的地方）

（模板可能會有所幫助。）

當您建立新頁面時，請記住確保頁面底部出現 {{BookCat}}。

[此處需要更多詳細資訊。]

路線圖

在不久的將來，那些參與本書工作的人的主要任務是填補明顯的空白。

• 在目錄中提到（從目錄連結）但目前不存在的頁面應該建立，幷包含相應的內容。
• 在目錄中提到的，但目前沒有連結到頁面的主題，應該在其自己的頁面上進行描述。
• 由方括號註釋標識的散文中的空白應該填補（並刪除註釋）。
• 應該為應該涵蓋但尚未涵蓋的主題建立新頁面。在第一次近似中：任何讓 XSLTForms 的新使用者（或不太熟悉的使用者）感到困惑超過一小時的問題（理想情況下）應該在“入門”部分（也許在“常見問題”下）中得到解決。當前覆蓋範圍中的一些明顯差距包括
  • 如何除錯 XForms；開發複雜表單的技術
  • 使用多個例項
  • 管理使用者介面配置（新增“ui”例項）
  • 資料型別的基礎知識
  • 在 XSLTForms 中與檔案系統互動；使用 Java applet 讀取和儲存檔案

任何讓 XSLTForms 的經驗使用者感到困惑超過半天或一天的問題（理想情況下）應該在“進一步主題”或“狀態”部分中得到解決。明顯的候選者包括

• XSLTForms 中的子表單
• 使檔案上傳在 XSLTForms 中工作；使多部分表單提交工作
• XSLTForms 中的基本建立/檢索/更新/刪除（CRUD）操作
• 在 XSLTForms 中使用事件

從長遠來看，可能需要為清晰起見對本書進行一些結構調整，並擴充套件其覆蓋範圍。有關建議，請參閱本書目錄的討論頁面。

需要做的事情

如果您沒有時間或技能來完成以下任何任務，但您看到了需要做的事情，您可以透過將其新增到此列表中來提供幫助！

• 關於僅 XSLTForms 的擴充套件頁面的內容應該分成多個頁面，每個擴充套件一個頁面；該頁面本身應該本質上是一個詳細的目錄，列出擴充套件並超連結到其描述。

• XSLT 轉換 xsltforms.xsl 應該使用 XSLTdoc 之類的工具進行註釋，並且文件應該在從“貢獻者資訊”部分的目錄連結的頁面中提供。

• Javascript 文件可能需要重新生成（僅在與 Alain Couthures 協商後）。

• XSLTForms 擴充套件的列表應該變得更加系統化和完整；這可能需要系統地閱讀支援列表的過去檔案。

• 如果本網站上可以有可用的表單，那就太好了。任何有知識和毅力來仔細閱讀有關華夏公益教科書的技術和政策資訊的人，如果可以找到是否可能，以及如何做到這一點，並在這裡記錄答案，將為人們提供很大的幫助。