模組:書名/doc

概要

{{#invoke:書名 |Syu1meng2 [ |mode=chapter ] }}
{{#invoke:書名 |Zyun1ming4 [ |mode=dotted ] }}
{{#invoke:書名 |Zoek6zung6}}

p .auto_build_citable( 書名, 篇名 );
p .cvs( 值 );
p .ref( 值 );
p .cjk_p( 字串 );
p .array_p( 值 );

用途

呢個模組係幾個模嘅真身，用來排一啲比較難處理嘅中文標點，目前處理嘅有書名號、專名號同着重號。模組嘅輸出儘量保持同文字式網頁瀏覽器同螢幕閱讀器嘅兼容。

模組嘅正常輸出係以印刷嘅常規為準，所以就算係排乙式書名號都嘗試會做 kerning，做出來嘅效果係好似書名號有半形版咁。呢種做法係類似標點（例如引號）嘅傳統排法。模組本身並唔會做任何嘅格式化，但係會將輸入加結構同足夠嘅 class，等樣式表可以將輸出格式化。

模組會直接喺 frame 個阿媽（parent）度攞模嘅參數。例外嘅係一個入口（entry point）被兩個或以上模用嘅時候用來認邊個模用緊佢嘅參數會喺 frame 攞，目前呢種參數有書名號嘅 mode=chapter（篇名號模式）同專名號嘅 mode=dotted（翻譯人名模式）。

直接叫用

其他模組載入呢個模組之後可以直接叫用 auto_build_citable 函數，呢個函數輸入一至兩個字串（可以係 nil），輸出字串，相等於 {{#invoke:書名|Syu1meng2}}，但係輸出唔會串（lang3）埋張樣式表。

輔助函數

其他模組可以載入呢個模組之後用幾個輔助函數，呢幾個係

• cvs：輸入任何值，輸出字串，係輸入值比較合理嘅字串版本（類似 PostScript 嘅 cvs 算子）
• cjk_p：輸入字串，輸出布林值，係輸入嘅字串似唔似全部係全形中日韓字
• array_p：輸入仼何值，輸出布林值，係輸入嘅值似唔似係陣列

另外仲有一個 ref 函數可以直接叫用，輸入仼何值，輸出字串，類似 type 算子嘅輸出，但係如果輸入睇落似一個陣列，輸出會係 ｢array｣；如果似 parse_title（一個內部函數）嘅輸出，輸出會係 ｢parsed-title｣。但係因為係唔係 parsed-title 其實係靠估，呢個函數可能唔係太有用。

本地化

呢個模組係粵維嘅原創（原作者用開嘅 Javascript+PHP 譯做 Lua，再改到喺維基用到），唔係喺第個維基抄返來再本地化。

模組嘅編輯說明

呢個模組整合咗落引模嘅模組（用來排中文書名）同官網模嘅模組度（用來檢查使唔使喺篇名後便加空格），所以呢個模死咗會整死埋引模同官網模，所以一定唔可以出大錯。發佈之前一定要用 ｢睇下改咗呢個模之後，用到個模嘅版嘅效果｣ 嘅功能試清楚冇問題先可以撳發佈掣。

個模組用來排版用嘅樣式表喺模組:書名/styles.css。改完樣式表之後要改埋引模嘅樣式表嘅對應部分。

睇埋

• 模:書名
• 模:篇名
• 模:專名
• 模:着重
• 模組:Citation/CS1/Utilities，持別係 wrap_style 函數
• 模組:Citation/CS1/styles.css
• 模組:Official website，_main 函數