Template:是日好文/doc

概要

Wikipedia:是日好文靠一柞模嚟做到每日自動換畫嘅效果。呢柞模包括：

• {{是日好文}}：攞個好文展品分頁出嚟。下面會講有咩參數。
• {{是日好文/今日文章號}}：係「是日好文」嘅運作部件，參數同「是日好文」一樣，但淨係出一個數字，用嚟決定攞第幾號文章。
• {{是日好文/數字隊總數}}：自動數住Category:維基百科是日好文數字隊‎有幾多版，冇參數，唔使人手更新。
• {{是日好文/文章推後}}：每次有新文嘅時候都應該人手更新一次，決定邊篇文出先。
• {{是日好文/文章推後更新}}：幫你自動計定，如果今日有新文上畫嘅話，「文章推後」應該改做咩數，等新上畫嗰篇文可以即刻出街。

參數同用法

{{是日好文}} 同 {{是日好文/今日文章號}}有以下兩個參數：

• offset：以日為單位，用嚟睇未來或者過去會出咩文。Wikipedia:是日好文個「聽日好文」同「後日好文」就係噉整出嚟嘅。例如 {{是日好文|offset=2}} 會出後日好文，{{是日好文|offset=-1}} 會出尋日好文（假設冇新文上畫同冇郁過「文章移後」）。預設值：0（即係出今日好文）
• rotate：以幾多篇文章為單位，用嚟將條隊上面嘅文章推前推後。例如今日本來係出第 110 號文章嘅，將 rotate 由 85 變成 87 就會變成出第 112 號文章。預設值：用 {{是日好文/文章推後}} 嘅值。

{{是日好文}}有多一個參數：

• id：如果畀咗 id，個模就會直接攞 id 號文章，無視 offset 同 rotate。{{是日好文|id=2}} 同 {{Wikipedia:是日好文/2}} 嘅分別，係前者多咗右下角嗰幾個帶路掣。

範例

{{是日好文}}

開放世界（Open world）係源於廿世紀、喺廿一世紀初開始風行嘅一種電子遊戲機制。喺一隻開放世界遊戲入面，玩家可以探索一個遊戲世界，並且自由噉選擇幾時完成遊戲嘅各任務－唔似得廿世紀嘅主流遊戲噉，好多時吓吓都係「進入關卡，做過關要做嘅任務，然後過關」咁線性。

{{是日好文|offset=1}}（聽日好文）

射擊遊戲係動作遊戲嘅一種，特徵係隻遊戲強調俾玩家控制住自己嘅角色，喺遊戲嘅虛擬世界裏面用手持嘅長距離武器打低對手，通常仲會俾玩家配備一啲可以攞嚟掟嘅爆炸品（好似係手榴彈噉）同埋有返一定嘅近身戰鬥能力。响廿一世紀初，射擊遊戲嘅出名例子有《食雞》（PUBG）同《使命召喚系列》（Call of Duty）。

{{是日好文|offset=-1}}（尋日好文）

電腦程式編寫（Computer programming），簡稱程式編寫或者編程，係指整同設計能夠執行得到嘅電腦程式嘅過程，由編程員用程式語言向電腦俾命令。喺廿一世紀初，程式編寫係好多科技產品當中不可或缺嘅一環，例如人工智能同視像遊戲等大受歡迎嘅技術都會用到程式編寫嘅技術。程式編寫亦因為呢啲廣泛嘅應用而成為咗一種相當有市場價值嘅技能。

{{是日好文|id=2}}（2號好文）

組合語言（Assembly language，簡稱「asm」）係指一類低階嘅程式語言，特徵係用佢哋寫成嘅源碼會用啲羅馬字母嚟表達佢哋啲指令俾個用家睇，而要處理嗰啲輸入就會用數字代表。組合語言喺啲指示嘅結構上同機械語言好接近，但係唔似得機械語言噉，吓吓都淨係用「1」同「0」嘅數值代表嗮所有嘢。

{{是日好文|rotate=3}}

如果將「文章推後」值改做 3 嘅話，是日好文會變成...

人類發展指數（HDI）係聯合國開發計劃署由1990年開始發佈，透過預期壽命、教育同人均收入等因素，用嚟衡量各國社會同經濟發展程度嘅標準，可以劃分做極高、高、中、低四組。

技術細節

{{是日好文/今日文章號}}會攞而家嘅時間，將佢變成一個日數（1970年1月1號到而家嘅日數，睇Unix timestamp），然後除以好文巡迴展覽隊上面嘅文章總數，攞個餘數。呢個餘數就用嚟決定每日出邊篇文。因為日數會每日自動上升，所以就有每日自動換畫嘅效果。當所有文都展覽過一次，排到隊尾，就會返返隊頭再嚟過。

但因為攞餘數呢個數學運算嘅特質，每次改個除數嘅時候，個餘數都會跳咗去第度，所以就有 {{是日好文/文章推後}} 呢個模嚟做設定參數，等每次有新文上畫，都可以人手調校喺邊篇文度繼續展覽。

另外又有 offset 呢個參數，用嚟預告定之後幾日有咩文會上頭版。

上畫指引

排一篇文上呢個巡迴展覽，開一版新版同一個跳轉就得。

首先，開《Wikipedia:是日好文/文章名》。基本上係要有百零字，最好有一張圖，同埋要擺落Category:維基百科是日好文隊。示例（Wikipedia:是日好文/紅葉）：

[[File:西渓公園 - panoramio - mahlervv.jpg|left|130px]]
'''[[紅葉]]'''係一種自然現象：唔少植物嘅葉會喺[[秋天]]嘅幾個禮拜之間由緑色變成紅色。喺[[華北]]、[[華東]]、以至[[日本|日]][[朝鮮半島|韓]]等地，九月至十月秋天來臨樹葉會大批噉變紅，形成漫山遍野一片紅扑扑嘅景象，有好多人都興特登趁秋天呢個時間去行山，[[欣賞紅葉]]。

<noinclude>[[Category:維基百科是日好文隊]]</noinclude>

跟住，開《Wikipedia:是日好文/數字》跳轉。呢個數字係順序數上去嘅。而家條隊有 125 篇文，所以下一篇文嘅跳轉應該開喺 Wikipedia:是日好文/126。個跳轉嘅格式係：

#redirect[[Wikipedia:是日好文/文章名]]
[[Category:維基百科是日好文數字隊]]

個類好重要：要擺咗入Category:維基百科是日好文數字隊，個模先識將篇文排上條隊。範例可以睇Category:維基百科是日好文數字隊。

最後，去更新{{是日好文/文章推後}}，等新上畫嗰篇文即刻上頭版。

落畫指引

如果要落畫（例如因為有篇文燉咗冬菇，唔再係好文或者正文），噉就要搵指去嗰篇文嘅《Wikipedia:是日好文/數字》版出嚟，將佢指向另一篇文。《Wikipedia:是日好文/文章名》唔使郁，可以留底。留意唔可以刪咗《Wikipedia:是日好文/數字》，因為條數字隊斷號數嘅話會造成程式錯誤。具體提議可以係將條跳轉改成指向號數最大嗰篇文，跟住最大嗰個號數嘅跳轉就刪咗佢（要用管理員權限）。

參看

• Wikipedia:是日好文