refactor: change theme to docsy

Author: jiacai2050

.github/workflows/gh-pages.yml

@@ -30,7 +30,7 @@ jobs:
           submodules: recursive
       - uses: peaceiris/actions-hugo@v2
         with:
-          hugo-version: "0.111.3"
+          hugo-version: "latest"
           extended: true
       - name: Setup Pages
         id: pages
@@ -41,6 +41,8 @@ jobs:
           HUGO_ENVIRONMENT: production
           HUGO_ENV: production
         run: |
+          npm i -D postcss postcss-cli autoprefixer
+          hugo mod get
           hugo \
             --minify \
             --baseURL "${{ steps.pages.outputs.base_url }}/"

.gitignore

@@ -1,6 +1,7 @@
 *.lock
 .DS_Store
-public
+/public
+/resources
 
 # zig
 zig-cache/

README.org

@@ -4,5 +4,22 @@
 - [[https://ziglang.cc]]
 - 如果没有特殊声明，本网站内容均采用 [[https://creativecommons.org/licenses/by-nc-nd/4.0/][CC BY-NC-ND 4.0]] 协议
 
-* 社区供稿
-参见：[[https://ziglang.cc/post/2023/09/05/hello-world/]]
+#+BEGIN_EXPORT html
+<center>
+<p>欢迎来到 Zig 语言中文社区！（Zig Chinese Community，简称：ZigCC）</p>
+<a href="https://discord.gg/UraRxD6WXD">
+<img src="https://img.shields.io/discord/1155469703846834187?label=Chat at Discord" />
+</a>
+<a href="/index.xml">
+<img src="https://img.shields.io/badge/rss-F88900.svg?style=flat&logo=RSS&logoColor=white&label=网站" />
+</a>
+<a href="https://ask.ziglang.cc/atom.xml">
+<img src="https://img.shields.io/badge/rss-F88900.svg?style=flat&logo=RSS&logoColor=white&label=论坛" />
+</a>
+</center>
+#+END_EXPORT
+
+
+#+begin_quote
+Zig Chinese Community is dedicated to sharing and spreading the use of Zig language among Chinese users.
+#+end_quote

config.toml

@@ -2,66 +2,102 @@ baseURL = 'https://ziglang.cc'
 languageCode = 'en'
 defaultContentLanguage = 'zh-cn'
 title = 'Zig 语言中文社区'
+description = 'Zig 语言中文社区'
 
-[[menu.main]]
-  name = "主页"
-  weight = 10
-  url = "/"
 [[menu.main]]
   name = "学习"
   weight = 11
   url = "/learn"
-[[menu.main]]
-  name = "日报"
-  weight = 15
-  url = "https://github.com/zigcc/forum/issues"
 [[menu.main]]
   name = "月刊"
   weight = 20
   url = "/monthly"
 [[menu.main]]
-  name = "文章"
+  name = "博客"
   weight = 21
   url = "/post"
 [[menu.main]]
-  name = "新闻"
-  weight = 22
-  url = "/news"
-[[menu.main]]
-  name = "论坛"
-  weight = 30
-  url = "https://ask.ziglang.cc"
-# [[menu.main]]
-#   name = "关于"
-#   weight = 4
-#   url = "/about"
-# [[menu.main]]
-#   name = "RSS"
-#   weight = 50
-#   url = "/index.xml"
+  name = "社区"
+  weight = 40
+  url = "/community"
 
 [params]
-  description = ""
+  github_repo = "https://github.com/zigcc/zigcc.github.io"
+  offlineSearch = true
   dateFormat = "Jan 2, 2006"
-  gitRepo = "https://github.com/zigcc/zigcc.github.io"
   twitterCardEnabled = true
   [params.giscus]
     repo = "zigcc/zigcc.github.io"
     repoId = "R_kgDOHr7nSg"
     category = "Announcements"
     categoryId = "DIC_kwDOHr7nSs4CQUsK"
 
+[params.ui]
+navbar_logo = false
+showLightDarkModeMenu = true
+
+[params.copyright]
+  authors = """
+  | [BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/)
+  | <a rel="me" href="https://mastodon.social/@liujiacai">Mastodon</a>
+  | [RSS](/index.xml)
+  """
+  from_year = 2022
+[params.links]
+# End user relevant links. These will show up on left side of footer and in the community page if you have one.
+[[params.links.user]]
+  name = "GitHub Discussion"
+  url = "https://github.com/orgs/zigcc/discussions"
+  icon = "fab fa-github"
+[[params.links.user]]
+  name = "Discord"
+  url = "https://discord.gg/UraRxD6WXD"
+  icon = "fab fa-discord"
+[[params.links.user]]
+  name = "Telegram"
+  url = "https://t.me/ZigChinese"
+  icon = "fab fa-telegram"
+[[params.links.user]]
+  name = "微信群"
+  url = "https://github.com/orgs/zigcc/discussions/134"
+  icon = "fab fa-weixin"
+[[params.links.user]]
+  name = "微信公众号"
+  url = "https://github.com/zigcc/.github/blob/main/zig_mp.png"
+  icon = "fab fa-weixin"
+[[params.links.user]]
+  name = "邮件"
+  url = "mailto:hello@ziglang.cc"
+  icon = "fa fa-envelope"
+  desc = "有任何疑问、建议，欢迎通过邮件与我们交流"
+
+[[params.links.developer]]
+  name = "文章供稿"
+  url = "/post/2023/09/05/hello-world/"
+  icon = "fab fa-blogger"
+  desc = "分享 Zig 使用经验"
+[[params.links.developer]]
+  name = "Zig 圣经"
+  url = "https://course.ziglang.cc/"
+  icon = "fa fa-book"
+  desc = "完善、改进圣经内容"
+[[params.links.developer]]
+  name = "线上会议"
+  url = "/post/news"
+  icon = "fa-brands fa-meetup"
+  desc = "我们会定期举行线上会议，畅聊 Zig 中的一切"
+
 [module]
+proxy = "https://goproxy.cn,direct"
   [[module.imports]]
-    path = "github.com/jiacai2050/hugo-xmin"
+    path = "github.com/google/docsy"
 
 [frontmatter]
   date = [":filename", ":default", ":fileModTime"]
   lastmod = ['lastmod', ':git', ':fileModTime', ':default']
 
 [permalinks]
   post = "/post/:year/:month/:day/:slug/"
-  news = "/news/:year/:month/:day/:slug/"
 
 [markup]
   [markup.tableOfContents]
@@ -70,7 +106,9 @@ title = 'Zig 语言中文社区'
   [markup.goldmark]
     [markup.goldmark.renderer]
       unsafe = true
+    [markup.goldmark.parser.attribute]
+      block = true
   # https://gohugo.io/getting-started/configuration-markup/#highlight
   [markup.highlight]
     style = "pygments"
-    linenos = true
+    linenos = true

content/_index.md

@@ -0,0 +1,32 @@
+---
+title: Zig 语言中文社区
+description: 欢迎来到 Zig 语言中文社区！（Zig Chinese Community，简称：ZigCC）
+---
+
+{{% blocks/cover height="full" %}}
+
+<img height="300px" src="https://ziglang.cc/logo/zigcc-logo-2.svg"/>
+
+{{% param description %}}
+
+> Zig Chinese Community is dedicated to sharing and spreading the use of Zig language among Chinese users.
+
+<a class="btn btn-lg btn-primary" href="https://github.com/zigcc">GitHub<i class="fab fa-github ms-2 "></i></a>
+<a class="btn btn-lg btn-primary" href="learn">
+学习<i class="fas fa-arrow-alt-circle-right ms-2"></i>
+</a>
+
+
+{{% blocks/link-down color="info" %}}
+{{% /blocks/cover %}}
+
+{{% blocks/lead color="primary" %}}
+
+我们是一群对 Zig 编程语言充满热情的开发者、学习者和爱好者。我们致力于：
+1. 分享 Zig 相关的知识和经验
+2. 翻译 Zig 官方文档和重要资源
+3. 组织线上线下的学习活动和讨论
+4. 推广 Zig 语言在中文开发者中的应用
+
+无论你是 Zig 专家还是初学者，[我们都欢迎你的加入](/community)！
+{{% /blocks/lead %}}

content/_index.org

@@ -1,6 +1,12 @@
 #+TITLE: 学习 Zig
 #+DATE: 2024-08-04T08:51:07+0800
-#+LASTMOD: 2024-08-04T08:55:33+0800
+#+LASTMOD: 2024-08-18T11:48:26+0800
+{{% blocks/cover title="学习 Zig" image_anchor="bottom" height="auto" %}}
+
+
+{{% /blocks/cover %}}
+
+{{% blocks/section %}}
 
 * 资料
 由于 Zig 目前还处于快速迭代，因此最权威的资料无疑是官方的 [[https://ziglang.org/documentation/master/][Zig Language Reference]]，遇到语言的细节问题，基本都可以在这里找到答案。
@@ -29,3 +35,12 @@ asdf install zig latest
 asdf global zig latest
 zig version
 #+end_src
+
+{{% /blocks/section %}}
+
+{{% blocks/section %}}
+
+# This is another section
+{.text-center}
+
+{{% /blocks/section %}}

content/learn.org renamed to content/about/_index.org

@@ -0,0 +1,20 @@
+---
+title: 博客
+---
+
+{{% blocks/section %}}
+让我们一起探索 Zig 的魅力，推动 Zig 在中文开发者社区的发展!
+{.text-center}
+
+{{% /blocks/section %}}
+
+{{% blocks/section color="white" %}}
+
+# 网站更新日志
+
+- **2024-08-18:** 切换主题 [docsy](https://github.com/google/docsy)
+- **2024-07-14:** 启用 Zig 社区微信 2 群
+- **2024-03-29:** 使用自定义域名 ziglang.cc
+- **2022-12-10:** 切换主题 [cupper-hugo](https://github.com/zwbetz-gh/cupper-hugo-theme) –> [hugo-xmin](https://github.com/yihui/hugo-xmin)
+- **2022-07-20:** 首次上线
+{{% /blocks/section %}}

content/community/_index.md

@@ -0,0 +1,42 @@
+---
+title: "学习 Zig"
+---
+
+{{% blocks/cover title="如何学习 Zig ？" image_anchor="bottom" height="auto" %}}
+
+{{% /blocks/cover %}}
+
+{{% blocks/section color="white" %}}
+
+由于 Zig 目前还处于快速迭代，因此最权威的资料无疑是官方的 [Zig Language Reference](https://ziglang.org/documentation/master/)，遇到语言的细节问题，基本都可以在这里找到答案。 其次是社区的一些高质量教程，例如：
+
+- **[Zig Guide](https://zig.guide/):** 英文资料， [Sobeston](https://github.com/Sobeston) 用户编写
+- **[Zig in 30 minutes](https://gist.github.com/ityonemo/769532c2017ed9143f3571e5ac104e50):**
+- **[Zig 日报](https://github.com/zigcc/forum/issues):**
+- **[学习 Zig](https://learn.ziglang.cc):** 该系列教程最初由 Karl Seguin 编写，该教程行文流畅，讲述的脉络由浅入深，深入浅出，是入门 Zig 非常不错的选择
+- **[Zig 语言圣经](https://course.ziglang.cc):** 一份内容全面、深入浅出介绍 Zig 的教程
+- **[ziglings/exercises](https://codeberg.org/ziglings/exercises/):** Learn the Zig programming language by fixing tiny broken programs.
+- **[Zig Cookbook](https://cookbook.ziglang.cc/):** A collection of simple Zig programs that demonstrate good practices to accomplish common programming tasks
+- **[Awesome Zig](https://github.com/zigcc/awesome-zig):** A collection of some awesome public Zig programming language projects.
+
+# 版本管理
+
+推荐使用版本管理工具 [asdf](/post/2023/10/14/zig-version-manager/) 来安装 Zig，具体步骤：
+
+```bash
+git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.14.0
+cat <<'EOF' >> $HOME/.bashrc
+source "$HOME/.asdf/asdf.sh"
+source "$HOME/.asdf/completions/asdf.bash"
+EOF
+
+asdf plugin-add zig https://github.com/zigcc/asdf-zig.git
+
+# 安装最新版
+asdf install zig latest
+asdf global zig latest
+zig version
+```
+
+
+{{% /blocks/section %}}

content/learn.md

@@ -0,0 +1,8 @@
+---
+title: 月刊
+type: blog
+cascade:
+- type: blog
+---
+
+社区内的最新进展，信息来源：[Zig NEWS](https://zig.news/top/month)、[Zig monthly](https://zigmonthly.org/)、[Lobsters](https://lobste.rs/t/zig)、[Reddit](https://www.reddit.com/r/Zig/)、[Zig weekly newsletter](https://discu.eu/weekly/zig/)、[Ziggit](https://ziggit.dev/)、[用户推荐](https://github.com/orgs/zigcc/discussions/new?category=%E4%BD%9C%E5%93%81%E5%88%86%E4%BA%AB)