init

Author: zero2hj

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "themes/hugo-lithium"]
+	path = themes/hugo-lithium
+	url = git@github.com:draveness/hugo-lithium.git

.hugo_build.lock

@@ -0,0 +1,6 @@
+---
+title: "{{ replace .Name "-" " " | title }}"
+date: {{ .Date }}
+draft: true
+---
+

archetypes/default.md

@@ -0,0 +1,41 @@
+baseurl = "https://yanhj93.github.io/"
+languageCode = "en-us"
+title = "A Hugo website"
+theme = "hugo-lithium"
+googleAnalytics = ""
+disqusShortname = ""
+ignoreFiles = ["\\.Rmd$", "\\.Rmarkdown$", "_files$", "_cache$"]
+
+[permalinks]
+#    post = "/:year/:month/:day/:slug/"
+    posts = "/:slug"
+
+
+[taxonomies]
+  category = 'categories'
+  tag = 'tags'
+
+[[menu.main]]
+    name = "demo"
+    url = "/pl/"
+
+[params]
+    description = "A website built through Hugo and blogdown."
+
+    # options for highlight.js (version, additional languages, and theme)
+    highlightjsVersion = "9.12.0"
+    highlightjsCDN = "//cdnjs.cloudflare.com/ajax/libs"
+    highlightjsLang = ["r", "yaml"]
+    highlightjsTheme = "github"
+
+    MathJaxCDN = "//cdnjs.cloudflare.com/ajax/libs"
+    MathJaxVersion = "2.7.5"
+
+    # path to the favicon, under "static"
+    favicon = "favicon.ico"
+
+    [params.logo]
+    url = "hugo-logo.png"
+    width = 50
+    height = 50
+    alt = "Logo"

config.toml

@@ -0,0 +1,42 @@
+---
+title: "Blog_setup"
+date: 2022-10-02T21:36:07+08:00
+draft: false
+---
+
+# hugo quick start
+跟着 [quick start doc](https://gohugo.io/getting-started/quick-start/) 初始化站点,  theme 选择 [hugo-lithium](https://github.com/draveness/hugo-lithium)
+
+# theme config
+替换 config.toml 为主题example site 的config.
+修改如下:
+- 修改posts permlink 为 baseURL/post_name.
+- 修改single page template, 增加 tag 显示区域.
+- 避免 `_index.md` 使用list page 模板渲染. 因为要自定义索引页.
+- 配置 archetype.
+- 配置菜单
+
+# content organization
+如果需要发表系类文章, 系列名为demo, 陆续发表两篇文章 Go, Java.
+过程如下:
+- `hugo new posts/demo/_index.md`, 作为系列文章首页包含概述和文章索引. 发布后的URL为demo
+- posts 间的引用语法[link](https://gohugobrasil.netlify.app/content-management/cross-references/). 
+- `hugo new posts/demo/Java.md`. 发布后的URL为 /java
+- `hugo new posts/demo/Go.md`. 发布后的URL为 /Go
+- 添加菜单
+   ```
+    [[menu.main]]
+    name = "demo"
+    url = "/pl/"
+   ```
+# deploy 
+use github action and github pages.
+action refer this [repo](https://github.com/peaceiris/actions-hugo).
+rename your baseURL in config.toml with the value `https://<USERNAME>.github.io`
+Go to repo settings->pages->source branch drop down, select branch `gh-pages` as page's source.
+After a while, action automation finished successfully, visit your page's address.
+
+# references
+- hugo content organization and how hugo parse posts url. [link1](https://gohugobrasil.netlify.app/content-management/organization/)
+- single page(article) vs list page(_index.md, tag.md, categories.md) and their templates. [link2](https://gohugo.io/templates/introduction/)
+- hugo variables and scope bind. [link3](https://gohugo.io/variables/)

content/posts/blog_setup.md

@@ -0,0 +1,7 @@
+---
+title: "Go"
+date: 2022-10-01T12:24:46+08:00
+draft: false
+---
+
+# Go

content/posts/demo/Go.md

@@ -0,0 +1,10 @@
+---
+title: "Java"
+date: 2022-10-01T12:24:46+08:00
+draft: false
+tags:
+ - "pl"
+ - "java"
+---
+
+# Java

content/posts/demo/Java.md

@@ -0,0 +1,16 @@
+---
+title: "title in front matter"
+date: 2022-10-01T12:24:46+08:00
+draft: false
+slug: "pl"
+url: "/pl"
+non_ls_tpl: true
+---
+
+# h1 in content
+
+## h2
+- [Java]({{< ref "Java" >}})
+
+## h2
+- [Go]({{< ref "go" >}})