fix: resolve broken internal links under /go-tutorial/ subpath

- Enable canonifyURLs so Hugo prefixes absolute paths with baseURL
- Rewrite 30 reference-style link definitions from .md to site paths

Author: appleboy

content/best-practices.md

@@ -45,7 +45,7 @@ weight = 3
 
 選擇函式或方法名稱時,要考慮這個名字將被閱讀的情境。下列建議可協助避免在呼叫端出現多餘的[重複][repetition]:
 
-[repetition]: decisions.md#repetition
+[repetition]: /decisions/#repetition
 
 - 下列資訊通常可從函式或方法名稱中省略:
 
@@ -166,7 +166,7 @@ func (c *Config) WriteBinaryTo(w io.Writer) (int64, error)
 
 底下範例多以 stub 為主。如果你的程式碼用的是 fake 或其他種類的測試替身,請相應地調整名稱。
 
-[naming]: guide.md#naming
+[naming]: /guide/#naming
 [test doubles]: https://abseil.io/resources/swe-book/html/ch13.html#basic_concepts
 
 假設你有一個焦點明確、提供生產程式碼的套件,內容類似下列:
@@ -492,7 +492,7 @@ func LongFunction() {
 ```
 
 [short variable declarations]: https://go.dev/ref/spec#Short_variable_declarations
-[import renaming]: decisions.md#import-renaming
+[import renaming]: /decisions/#import-renaming
 
 <a id="util-packages"></a>
 
@@ -962,7 +962,7 @@ err2 := fmt.Errorf("couldn't find fortune database: %v: %w", err, ErrInternal)
 - [Go Tip #48: Error Sentinel Values]
 - [Go Tip #106: Error Naming Conventions]
 
-[commentary]: decisions.md#commentary
+[commentary]: /decisions/#commentary
 [Go Tip #48: Error Sentinel Values]: https://google.github.io/styleguide/go/index.html#gotip
 [Go Tip #106: Error Naming Conventions]: https://google.github.io/styleguide/go/index.html#gotip
 
@@ -1049,7 +1049,7 @@ log.V(2).Infof("Handling %v", sql.Explain())
 標準函式庫會對 API 誤用 panic。例如 [`reflect`] 在許多看起來像被誤解誤用的存取場景時會 panic。這類似於語言核心 bug 的 panic,例如越界存取 slice。Code review 與測試應該要找到這些 bug,它們不該出現在正式環境中。這些 panic 起到的是不變條件檢查的作用,且不依賴任何函式庫,因為標準函式庫無法存取 Google 程式碼庫使用的[分等級的 `log`][levelled `log`] 套件。
 
 [`reflect`]: https://pkg.go.dev/reflect
-[levelled `log`]: decisions.md#logging
+[levelled `log`]: /decisions/#logging
 
 另一個雖然少見、但 panic 可能有用的情況是:作為某個套件內部實作的細節,且呼叫鏈中一定有對應的 `recover`。剖析器與類似的深度遞迴、緊密耦合的內部函式群,可以從這種設計中獲益,因為在這類程式中傳遞錯誤回傳值會增加複雜度卻沒有實質價值。
 
@@ -1125,7 +1125,7 @@ func answer(i int) string {
 
 採用熟悉風格撰寫文件的 Go 程式碼,比起寫得不對或完全沒寫文件的程式碼,更容易閱讀,也較不容易被誤用。可執行的[範例][examples]會出現在 Godoc 與 Code Search 中,是說明如何使用程式碼的絕佳方式。
 
-[examples]: decisions.md#examples
+[examples]: /decisions/#examples
 
 <a id="documentation-conventions-params"></a>
 
@@ -1172,7 +1172,7 @@ func Sprintf(format string, data ...any) string
 - [GoTip #41: Identify Function Call Parameters]
 - [GoTip #51: Patterns for Configuration]
 
-[commentary]: decisions.md#commentary
+[commentary]: /decisions/#commentary
 [GoTip #41: Identify Function Call Parameters]: https://google.github.io/styleguide/go/index.html#gotip
 [GoTip #51: Patterns for Configuration]: https://google.github.io/styleguide/go/index.html#gotip
 
@@ -1507,7 +1507,7 @@ Go 提供[文件伺服器](https://pkg.go.dev/golang.org/x/pkgsite/cmd/pkgsite)
 
 [Godoc]: https://pkg.go.dev/
 [format documentation]: https://go.dev/doc/comment
-[runnable examples]: decisions.md#examples
+[runnable examples]: /decisions/#examples
 
 <a id="signal-boost"></a>
 
@@ -1762,8 +1762,8 @@ func sum(values chan int) (out int) {
 
 [option struct]: #option-structure
 [variadic options]: #variadic-options
-[clarity]: guide.md#clarity
-[least mechanism]: guide.md#least-mechanism
+[clarity]: /guide/#clarity
+[least mechanism]: /guide/#least-mechanism
 
 <a id="option-structure"></a>
 
@@ -2019,10 +2019,10 @@ Go 對「測試 helper」與「assertion helper」加以區分:
 
 測試的目的是回報受測程式碼的成敗狀態。讓測試失敗的理想位置是在 `Test` 函式本身內,因為這能確保[失敗訊息][failure messages]與測試邏輯都很清楚。
 
-[mark them as a test helper]: decisions.md#mark-test-helpers
+[mark them as a test helper]: /decisions/#mark-test-helpers
 [error handling in test helpers]: #test-helper-error-handling
-[not considered idiomatic]: decisions.md#assert
-[failure messages]: decisions.md#useful-test-failures
+[not considered idiomatic]: /decisions/#assert
+[failure messages]: /decisions/#useful-test-failures
 
 當測試程式碼成長時,有時必須把部分功能抽出獨立函式。一般軟體工程的考量仍然適用,因為*測試程式碼也是程式碼*。如果這些功能不與測試框架互動,所有平常的規則都適用。但當共用程式碼會與框架互動時,就要小心避免常見陷阱,以免最後得到沒有資訊量的失敗訊息與難以維護的測試。
 
@@ -2082,10 +2082,10 @@ func FuzzFencepost(f *testing.F) {
 
 **注意:** 測試 helper 與一般函式庫程式碼有相似之處。函式庫中的程式碼通常[不應 panic][not panic],除非在罕見情況;從測試呼叫的程式碼除非[沒必要繼續][no point in proceeding],否則不應終止測試。
 
-[table-driven test]: decisions.md#table-driven-tests
-[useful test failures]: decisions.md#useful-test-failures
+[table-driven test]: /decisions/#table-driven-tests
+[useful test failures]: /decisions/#useful-test-failures
 [package `cmp`]: https://pkg.go.dev/github.com/google/go-cmp/cmp
-[not panic]: decisions.md#dont-panic
+[not panic]: /decisions/#dont-panic
 [no point in proceeding]: #t-fatal
 
 <a id="test-validation-apis"></a>
@@ -2258,7 +2258,7 @@ func TestAcceptance(t *testing.T) {
 
 **注意:** 本節討論的[測試 helper][test helpers] 是 Go 用語意義下的:做測試 setup 與 cleanup 的函式,而不是常見的 assertion 工具。更多討論請參考[測試函式](#test-functions)一節。
 
-[test helpers]: decisions.md#mark-test-helpers
+[test helpers]: /decisions/#mark-test-helpers
 
 測試 helper 執行的操作有時會失敗。例如:設定一個含檔案的目錄需要 I/O,可能失敗。當測試 helper 失敗時,通常代表測試無法繼續,因為某個 setup 前提條件失敗了。發生這種情況時,在 helper 內呼叫 `Fatal` 系列函式之一是較好的做法:
 
@@ -2878,7 +2878,7 @@ Go 測試預設依序執行,因此上面的測試會以下列順序跑:
 
 [全域狀態有多種形式](#globals-forms),也有一些[判定何時安全的試紙測試](#globals-litmus-tests)可用。
 
-[Unit Testing Practices on Public APIs]: index.md#unit-testing-practices
+[Unit Testing Practices on Public APIs]: /#unit-testing-practices
 
 <a id="globals-forms"></a>
 

content/decisions.md

@@ -87,7 +87,7 @@ Go 套件名稱不應有底線。如果你必須匯入名稱含底線的套件 (
 [`tabwriter`]: https://pkg.go.dev/text/tabwriter
 [`k8s`]: https://pkg.go.dev/k8s.io/client-go/kubernetes
 [`oauth2`]: https://pkg.go.dev/golang.org/x/oauth2
-[shadowed]: best-practices.md#shadowing
+[shadowed]: /best-practices/#shadowing
 
 避免使用 `util`、`utility`、`common`、`helper`、`model`、`testhelper` 之類沒有資訊量的套件名稱,這會誘使套件使用者[在匯入時改名](#import-renaming)。請參考:
 
@@ -140,7 +140,7 @@ const (
 )
 ```
 
-[MixedCaps]: guide.md#mixed-caps
+[MixedCaps]: /guide/#mixed-caps
 [Exported]: https://tour.golang.org/basics/3
 
 不要使用非 MixedCaps 的常數命名,也不要使用 `K` 前綴。
@@ -226,8 +226,8 @@ const (
 - 大 scope 通常執行一個或數個大操作,大約 15-25 行。
 - 非常大的 scope 是超過一頁的範圍 (例如超過 25 行)。
 
-[clarity]: guide.md#clarity
-[concision]: guide.md#concision
+[clarity]: /guide/#clarity
+[concision]: /guide/#concision
 
 在小 scope 中可能完全清楚的名稱 (例如 `c` 表示 counter),在更大的 scope 中可能就不夠用,需要進一步澄清以便讀者沿著程式碼往下讀時想起它的用途。在含有許多變數、或變數代表類似值或概念的 scope 中,可能需要比 scope 大小所暗示的更長的變數名稱。
 
@@ -409,16 +409,16 @@ func (db *DB) UserCount() (int, error) {
 
 **提示:** Godoc 使用的特殊格式很少;清單與程式碼片段通常應縮排以避免折行。除了縮排外,通常應避免裝飾。
 
-[doc preview]: best-practices.md#documentation-preview
-[documentation conventions]: best-practices.md#documentation-conventions
+[doc preview]: /best-practices/#documentation-preview
+[documentation conventions]: /best-practices/#documentation-conventions
 
 <a id="comment-line-length"></a>
 
 ### 註解行長度
 
 Go 中的註解沒有固定的[行長度][line length]。
 
-[line length]: guide.md#line-length
+[line length]: /guide/#line-length
 
 長註解行應折行,以確保在不會自動折行的工具中也能閱讀原始碼。如果不確定要折在哪,80 或 100 欄是常見選擇。但這不是硬性截斷;在某些情況下,把長文字折開反而有害。對折行的特定欄寬不作要求。請力求在同一份檔案內保持[一致](/guide/#consistency)。
 
@@ -1845,7 +1845,7 @@ func (w *Worker) Run() {
 [rethinking-slides]: https://drive.google.com/file/d/1nPdvhB0PutEJzdCq5ms6UI58dp50fcAN/view
 [rethinking-video]: https://www.youtube.com/watch?v=5zXAHh5tJqQ
 [When Go programs end]: https://changelog.com/gotime/165
-[Documentation Conventions: Contexts]: best-practices.md#documentation-conventions-contexts
+[Documentation Conventions: Contexts]: /best-practices/#documentation-conventions-contexts
 
 <a id="interfaces"></a>
 
@@ -2177,8 +2177,8 @@ Flag 只能定義在 `package main` 或同等位置。
 - [Go Tip #80: Dependency Injection Principles](https://google.github.io/styleguide/go/index.html#gotip)
 
 [standard `flag` package]: https://golang.org/pkg/flag/
-[mixed caps]: guide.md#mixed-caps
-[complex CLIs]: best-practices.md#complex-clis
+[mixed caps]: /guide/#mixed-caps
+[complex CLIs]: /best-practices/#complex-clis
 [totw-45]: https://abseil.io/tips/45
 
 <a id="logging"></a>
@@ -3084,7 +3084,7 @@ Go 標準函式庫提供 [`testing` 套件][`testing` package]。在 Google 程
 [`testing` package]: https://pkg.go.dev/testing
 [composite literal]: https://go.dev/ref/spec#Composite_literals
 [if-with-initializer]: https://go.dev/ref/spec#If_statements
-[清晰、可讀且可維護的測試]: guide.md#clarity
+[清晰、可讀且可維護的測試]: /guide/#clarity
 
 <a id="non-decisions"></a>
 

content/guide.md

@@ -167,7 +167,7 @@ if err := doSomething(); err == nil { // if NO error
 
 [表格驅動測試 (Table-driven testing)]: https://go.dev/wiki/TableDrivenTests
 [錯誤處理]: https://go.dev/blog/errors-are-values
-[boost]: best-practices.md#signal-boost
+[boost]: /best-practices/#signal-boost
 
 <a id="maintainability"></a>
 

hugo.toml

@@ -4,6 +4,7 @@ title = 'Go 風格指南（繁體中文）'
 theme = 'book'
 
 enableGitInfo = true
+canonifyURLs = true
 
 [params]
   BookTheme = 'auto'