Before you continue, please take a moment to configure your archetypes.
Task list: :smile:
因為 docdock 太久沒有更新,更新到新版的 hugo 後, tags 出問題,所以換成 hugo-theme-learn
pass
pass
設定在 config.toml
https://learn.netlify.app/en/basics/configuration/
這邊可以修改 learn theme 的一些細部設定,logo, favicon, 配色可改 red, green, blue。
或是修改 blog 根目錄下的 layouts/partials
learn
有兩種頁面形式, Default, Chapter,差別在:
Chapter 是用來引入子頁面的頁面,有點像封面? 只要在頁面的 yaml 加上 chapter=true
+++
# Table of content (toc) is enabled by default. Set this parameter to true to disable it.
# Note: Toc is always disabled for chapter pages
disableToc = "false"
# If set, this will be used for the page's menu entry (instead of the `title` attribute)
menuTitle = ""
# The title of the page in menu will be prefixed by this HTML content
pre = ""
# The title of the page in menu will be postfixed by this HTML content
post = ""
# Set the page as a chapter, changing the way it's displayed
chapter = false
# Hide a menu entry by setting this to true
hidden = false
# Display name of this page modifier. If set, it will be displayed in the footer.
LastModifierDisplayName = ""
# Email of this page modifier. If set with LastModifierDisplayName, it will be displayed in the footer
LastModifierEmail = ""
+++
加入 icon
+++
title = "Github repo"
pre = "<i class='fab fa-github'></i> "
+++
改變頁面在選單上的順序
+++
title = "My page"
weight = 5
+++
改選單上的標題
+++
title = "Install on Linux"
menuTitle = "Linux"
+++
Homepage
content
下的 _index.md
static
目錄下的 index.html
預設的頁面模板
預設的頁面有兩種:Default, Chapter(封面)
hugo new --kind chapter <name>/_index.md
# Either
hugo new <chapter>/<name>/_index.md
# Or
hugo new <chapter>/<name>.md
pass
pass
設定選單上的項目
設定 Icon, logo
多語設定
pass
可以把目錄下的檔案,以連結貼出。
按鈕
子頁,目錄結構
可以摺疊的內容
流程圖
內建的提示視窗
目前有的是 editURL
,提供直接編輯的連結。
頁籤
可收起隱藏內容
Note
A notice disclaimer
Info
An information disclaimer
Tip
A tip disclaimer
Warning
An warning disclaimer
樣式可以用 星號* 或是 底線_
斜體 emphasis, aka italics, with asterisks or underscores.
粗體 Strong emphasis, aka bold, with asterisks or underscores.
合併 Combined emphasis with asterisks and underscores.
刪除線 Strikethrough uses two tildes. Scratch this.
孔子說:
說什麼
是什麼
第一種是手工的目錄
內文地方加上 概述的連結
第二種是 After-Dark 內建目錄,在
標頭上加上 toc: = true
,程式會把大的標題生成目錄
** List **
Setext 形式是用底線的形式,利用 =
(最高階標題)和 -
(第二階標題),例如:
This is an H1
=============
This is an H2
-------------
任何數量的 =
和 -
都可以有效果。
Atx 形式則是在行首插入 1 到 6 個 #
,對應到標題 1 到 6 階,例如:
# This is an H1
## This is an H2
###### This is an H6
行首的井字數量決定標題的階數,行尾的#可不加
Markdown 支援兩種形式的連結語法: 行內和參考兩種形式。
[連結文字](連結目標)
絕對路徑 Google
相對路徑 post
連結到文章內的id example 或是空白隔著 [2 example] id
Footer
That’s some text with a footnote.1
行內和參考
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")
參考式的圖片語法則長得像這樣:
![Alt text][id]
「id」是圖片參考的名稱,圖片參考的定義方式則和連結參考一樣:
[id]: url/to/image "Optional title attribute"
markdown預設 H1,H2的 id就是 text
<h1 id="MyAnchorName">My Title</h1>
自定錨
<a id="MyAnchorName">My Title</a>
連結語法
<a href="#MyAnchorName">My Content</a>
[create an anchor](#MyAnchorName)
要指定高度的話,也可以用 <img>
分兩個,行內,整段
行內像文中會提到的func name print()
cast
def()
整段用 三個 ``` 包起,第一個後面放語言的名字
for i in 10:
print("heloo,world")
如果要的syntax highlighting的話,要用hugo內的 shortcode
1var a string
2var b string
3var c string
4var d string
And that’s the footnote.
That’s the second paragraph. ↩︎