====== 編輯須知 ======

本站採 [[doku>zh-tw:dokuwiki|DokuWiki]] [[wp>Wiki]] 系統管理。

基本語法可以參照 [[wiki:syntax|Wiki 語法]]。

===== 擴充語法 =====

除 DokuWiki 原生語法外，本站還有額外的一些語法。

==== 註解 ====

[[doku>plugin:commentsyntax]]

這是給編輯者在編輯模式下看得註解，在實際頁面上不會顯示出來。

本站註解統一如下格式：

註解以 ''%%/*%%'' 開始並且以 ''%%*/%%'' 結束。註解起始符號 ''%%/*%%'' 必須在行的開頭或者空白之後。註解也可以多行：

  /* 這是註解 */

  /* 這是
  多行
  註解 */

另外你可以用註解來暫時隱藏某些列表項目：

<file>
  - 項目 1 /* 註解起始符號前必須有空白 */
/*- 項目 2    這個項目會被隱藏 */
  - 項目 3 /* 這個會被顯示為第二項 */ 
</file>

  - 項目 1 /* 註解起始符號前必須有空白 */
/*- 項目 2    這個項目會被隱藏 */
  - 項目 3 /* 這個會被顯示為第二項 */ 

注意註解會以最接近的 ''%%*/%%'' 來結束。所以請不要再註解內用註解符號。

  內文 /* 這是註解 /* 這是註解內的註解 */ **這邊會錯誤的被排除在註解外** */

內文 /* 這是註解 /* 這是註解內的註解 */ **這邊會錯誤的被排除在註解外** */

==== poem ====

[[doku>plugin:poem]]

poem 會保留區塊內的換行。但代碼、表格、項目列表、註解、引用等無法在 poem 內使用。

  <poem>
  第一行
  第二行
  第三行
  可使用 **粗體**、//斜體//、__底線__、''英文等寬體''及[[:start|連結]]。
  
  
  
  上面空了三行
  </poem>

<poem>
第一行
第二行
第三行
可使用 **粗體**、//斜體//、__底線__、''英文等寬體''及[[:info|連結]]。



上面空了三行
</poem>

另外在 %%<poem>%% 後的第一個換行會自動被忽略掉。

===== 架構 =====

簡單說下，DokuWiki有所謂的 namespace ，簡單說類似資料夾（實際上確實是）。
網址裡 <nowiki>http://novel.saru.moe/editor:readme</nowiki> 其中 ''editor:readme'' 這部分稱為頁面名稱，
實際上不管用中文英文還是其他語言都行，不過個人比較偏好全英文。
而頁面名稱裡用 : 分隔的前面部分就是所謂 namespace （可以理解成分隔資料夾的 / ）。

本站大致上主要 namespace 如下：
^namespace^說明^
|discussion|討論版區|
|editor|編輯者相關資料|
|novel|小說存放區|
|playground|測試區/核爆場|
|tpl|模板|
|user|使用者個人namespace|
|wiki|wiki系統本身相關文件|

user 部分，其中 ''user:<使用者名稱>'' 為個人可自由新增/編輯頁面的 namespace，而且僅個人有編輯權限，其他使用者無法編輯。
其中 ''user:<使用者名稱>:info'' 為個人首頁，主要功能大概就填翻譯作者時用到而已吧？

而 novel 裡架構則如下：

  * novel
    * this_is_book_1 (namespace) (話數跨章節連續時)
      * info (頁面：作品資訊)
      * index (頁面：作品章節目錄)
      * ch0 (第0章：楔子、序之類的)
        * ep0 (楔子、序的內文)
      * ch1 (第1章)
        * ep1 (第1話)
        * ep2
        * ep3
      * ch2
        * ep4
        * ep5
    * this_is_book_2 (namespace) (話數各章節獨立時)
      * info (頁面：作品資訊)
      * index (頁面：作品章節目錄)
      * ch0 (第0章：楔子之類的)
        * ep1 (楔子的內文)
      * ch1 (第1章)
        * ep0 (第1章序)
        * ep1 (第1章第1話)
        * ep2
        * ep3
      * ch2
        * ep1
        * ep2

===== 小說頁面格式 =====

====作品介紹頁====

頁面名稱為 ''novel:book_name_here:info'' ，建立頁面時會自動套用模板。
模板大致上有註解，照著格式填寫就好。
至於註解可刪除可保留。

模板內容可以登入[[tpl:novel_info|點此]]後點選看原始碼來看。

====作品章節目錄頁====

頁面名稱為 ''novel:book_name_here:index'' ，建立頁面時會自動套用模板。
模板大致上有註解，照著格式填寫就好。
至於註解可刪除可保留。

模板內容可以登入[[tpl:novel_index|點此]]後點選看原始碼來看。

====正文頁面====

頁面名稱為 ''novel:book_name_here:ch1:ep1'' ，建立頁面時會自動套用模板。
模板大致上有註解，照著格式填寫就好。
至於註解可刪除可保留。

模板內容可以登入[[tpl:novel_ep|點此]]後點選看原始碼來看。