Hugo #

$ brew install hugo

$ GITHUB_USERNAME=xxxx
$ GIT_REPOSITORY=sample

$ hugo new site ${GIT_REPOSITORY}
$ cd ${GIT_REPOSITORY}
$ echo "# ${GIT_REPOSITORY}" >> README.md

$ git init

$ git config --local --list
$ git config --local user.name xxxx
$ git config --local user.email xxxx

$ git add .
$ git commit -m "Build a site using hugo"
$ git branch -M main
$ git remote add origin https://github.com/${GITHUB_USERNAME}/${GIT_REPOSITORY}.git
$ git push -u origin main

$ vi .gitignore

public/
resources/_gen/
.DS_Store
*.swp

$ git add .
$ git commit -m "Add .gitignore"

$ git submodule add https://github.com/alex-shpak/hugo-book themes/hugo-book
$ git add .
$ git commit -m "Add a theme as a submodule"

baseURL = "/sample/" # Write your git repository as a directory
languageCode = "en-us"
title = "Sample"
publishDir = "docs"
theme = "hugo-book"
# Add a line break on the last line. 

$ git add .
$ git commit -m "Change config.toml"

---
date: 2021-01-01
lastmod: ["lastmod"]
title: "Hello world"
tags: ["Foo","Bar"]
---

# Hello world!

$ git add .
$ git commit -m "Add a page of hello world"

$ hugo

$ hugo --minify

$ git add .
$ git commit -m "Generate static contents"

$ hugo server --minify -p 3000

$ echo http://localhost:3000/${GIT_REPOSITORY}/hello-world/

$ git push -u origin main

$ echo https://github.com/${GITHUB_USERNAME}/${GIT_REPOSITORY}/settings/pages

$ echo https://${GITHUB_USERNAME}.github.io/${GIT_REPOSITORY}/hello-world/

[params]
  BookMenuBundle = '/menu'

---
headless: true
---

- **Sample**
  - [Hello world]({{< ref "hello-world" >}})
  - Please write your link here as above.

<ol  class="breadcrumb">
    {{ template "breadcrumbnav" (dict "p1" . "p2" .) }}
</ol>

{{ define "breadcrumbnav" }}
{{ if .p1.Parent }}
{{ template "breadcrumbnav" (dict "p1" .p1.Parent "p2" .p2 )  }}
{{ else if not .p1.IsHome }}
{{ template "breadcrumbnav" (dict "p1" .p1.Parent "p2" .p2 )  }}
{{ end }}
<li{{ if eq .p1 .p2 }} class="active"{{ end }}>
  <a href="{{ .p1.Permalink }}">{{ .p1.LinkTitle }}</a>
</li>
{{ end }}

{{ partial "docs/breadcrumb" . }}

/* Breadcrumb */
.breadcrumb {
    padding: 8px 15px;
    margin-bottom: 20px;
    list-style: none;
    background-color: var(--gray-100);
    border-radius: 4px;
    ol {
        display: block;
        list-style-type: decimal;
        margin-block-start: 1em;
        margin-block-end: 1em;
        margin-inline-start: 0px;
        margin-inline-end: 0px;
        padding-inline-start: 40px;
    }
    li {
        display: inline-block;
    }
    li+li:before {
        padding: 0 5px;
        color: #ccc;
        content: "/\00a0";
    }
    a {
        color: var(--color-link);
    }
}

defaultContentLanguage = "en"
defaultContentLanguageInSubdir = true

[languages]
  [languages.en]
    languageName = "English"
    languageCode = "en"
    # contentDir = "content/en"
    weight = 1
    #[languages.en.params]
    #  key1 = value1
  [languages.ja]
    languageName = "日本語"
    languageCode = "ja"
    # contentDir = "content/ja"
    weight = 2
    #[languages.ja.params]
    #  key1 = value1

<!-- Merge home and current page translations -->
{{ $bookTranslatedOnly := default false .Site.Params.BookTranslatedOnly }}
{{ $translations := dict }}
{{ if (eq $bookTranslatedOnly false ) }}
  {{ range .Site.Home.AllTranslations }}
    {{ $translations = merge $translations (dict .Language.Lang .) }}
  {{ end }}
{{ end }}
{{ range .Translations }}
  {{ $translations = merge $translations (dict .Language.Lang .) }}
{{ end }}

<div class="book-languages" tabindex="0" aria-haspopup="true">
  <ul>
    <li class="flex align-center">
      <img src="{{ "svg/translate.svg" | relURL }}" class="book-icon" alt="Languages" />
      {{ $.Site.Language.LanguageName }}
    </li> 
  </ul>

  <ul class="book-languages-list">
    {{ range .Site.Languages }}{{ with index $translations .Lang }}
      {{ if (ne $.Site.Language .Language) }}
      <li>
      <a href="{{ .Permalink }}" class="flex align-center">
          <img src="{{ "svg/translate.svg" | relURL }}" class="book-icon" alt="Languages" />
          {{ .Language.LanguageName }}
      </a>
      </li>
    {{ end }}{{ end }}{{ end }}
  </ul>
</div>

{{ partial "docs/languages" . }}

{{ if default true .Site.Params.BookSearch }}
<div class="book-search">
  <input type="text" id="book-search-input" placeholder="{{ i18n "Search" }}" aria-label="{{ i18n "Search" }}" maxlength="64" data-hotkeys="s/" />
  <div class="book-search-spinner hidden"></div>
  <ul id="book-search-results"></ul>
</div>
{{ end }}

/* Multilingual Mode */
.book-languages {
    .book-languages-list {
        bottom: 74%;
    }
    .book-languages-list a {
        padding: .3rem 1rem;
    }
}

.book-menu-content {
    .book-languages {
        img {
            height: 1em;
            width: 1em;
            margin-inline-end: .5rem;
        }
        .book-languages-list {
            padding: 0;
            bottom: 68%;
        }
        .book-languages-list a {
            padding: 0 1rem;
        }
    }
}

<h2>Tags</h2>

{{ with .Params.tags }}
  <ul class="tags">
    {{- range . -}}
      <li><a href="{{ "/tags/" | relLangURL }}{{ . | urlize }}">{{ . }}</a>
    {{- end -}}
  </ul>
{{ end }}

{{ partial "docs/tags" . }}

{{ partial "docs/inject/toc-before" . }}
<h2>Table of Contents</h2>
{{ .TableOfContents }}
{{ partial "docs/inject/toc-after" . }}

/* Table of Contents */
.book-toc-content {
    ul.tags {
        padding-inline-start: 0;
        li {
            line-height: 2;
            list-style: none;
        }
    }
}

```go {linenos=table,hl_lines=["4-5",9],linenostart=1}
package main

import (
	"fmt"
	"time"
)

func main() {
	fmt.Println("The time is", time.Now())
}
```

{{<mermaid>}}
graph LR
    A[Square Rect] -- Text --> B((Circle))
    A --> C(Round Rect)
    B --> D{Rhombus}
    C --> D
{{</mermaid>}}

baseURL = ""
# Omission
googleAnalytics = "" # Set empty.

baseURL = "https://sample.com/"
# Omission
googleAnalytics = "G-XXXXXXXXXX" # Set your Google Analytics ID.

{{ if not .Site.IsServer }}
{{ with .Site.GoogleAnalytics }}
<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id={{ . }}"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', '{{ . }}');
</script>
{{ end }}
{{ end }}

{{ partial "analytics" . }}

[markup]
    defaultMarkdownHandler = "goldmark"
	
  [markup.goldmark]
    [markup.goldmark.renderer]
      unsafe = true

|Language|Sentence|
|---|---|
|English|Hello,<br>world|