今天我們來介紹如何在表格中：

• 加入標題（GT.tab_header()）。
• 加入參考資料來源（GT.tab_source_note()）。
• 加入註腳（GT.tab_footnote()）。

以下將繼續使用df_demo為範例說明：

md()與html()

在開始之前，我想先介紹md()與html()這兩個好用的helper function，它們可以告知gt將給定的字串視為Markdown或HTML格式，是使用GT.tab_header()或GT.tab_source_note()等時，不可或缺的好幫手。

舉例來說，如果您想表示粗體的的話，可以使用Markdown語法：

md("**Title**")

又或者使用HTML語法：

html("<b>Title</b>")

GT.tab_header()

GT.tab_header(self, title, subtitle=None, preheader=None)

GT.tab_header()可以讓使用者指定標題：

(GT(df_demo).tab_header(title="Title"))

或同時指定標題及副標題：

(GT(df_demo).tab_header(title="Title", subtitle="Subtitle"))

又或者透過md()與html()來幫忙：

(
    GT(df_demo).tab_header(
        title=md("**Title**"), subtitle=html("<i>Subtitle</i>")
    )
)

這裡我們的「"Title"」字串是以Markdown語法將其呈現為粗體，而「"Subtitle"」字串則以HTML的<i>tag將其呈現為斜體。

至於preheader這個參數，似乎尚未開發完成，即使給定也不會改變表格呈現結果。

GT.tab_source_note()

GT.tab_source_note(self, source_note)

GT.tab_source_note()可以讓使用者指定參考資料來源。例如：

(GT(df_demo).tab_source_note("Source: From xxx"))

如果有多個source note的話，可以多次呼叫GT.tab_source_note()。例如：

(
    GT(df_demo)
    .tab_source_note("Source1: From xxx")
    .tab_source_note("Source2: From ooo")
)

GT.tab_footnote()

GT.tab_footnote()是一個正在開發中的功能，可以讓使用者指定註腳。在此功能推出前，我們可以巧妙地使用tab_source_note()來呈現註腳的效果。例如：

(
    GT(df_demo)
    .cols_label(**{"datetime": html("datetime<i><sup>1</sup></i>")})
    .tab_source_note(html("<i><sup>1 </sup></i>UTC Timezone"))
)

這裡我們使用GT.cols_label()將「"datetime"」欄的名稱重新命名為html("datetime<i><sup>1</sup></i>")，使其在表格中呈現上標的功能。接著依照同樣的手法，在GT.tab_source_note()中加入此上標的註腳。

Code

本日程式碼傳送門。