change hugo theme to doks

.editorconfig

@@ -0,0 +1,11 @@
+# editorconfig.org
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true

.eslintignore

@@ -0,0 +1,2 @@
+assets/js/vendor
+node_modules

.eslintrc.json

@@ -0,0 +1,31 @@
+{
+  "env": {
+    "browser": true,
+    "commonjs": true,
+    "es6": true,
+    "node": true
+  },
+  "extends": "eslint:recommended",
+  "globals": {
+    "Atomics": "readonly",
+    "SharedArrayBuffer": "readonly"
+  },
+  "parserOptions": {
+    "ecmaVersion": 2018,
+    "sourceType": "module"
+  },
+  "rules": {
+    "no-console": 0,
+    "quotes": ["error", "single"],
+    "comma-dangle": [
+      "error",
+      {
+        "arrays": "always-multiline",
+        "objects": "always-multiline",
+        "imports": "always-multiline",
+        "exports": "always-multiline",
+        "functions": "ignore"
+      }
+    ]
+  }
+}

.github/workflows/gh-pages.yml

@@ -1,29 +1,35 @@
-name: github pages
+name: deploy github pages
 
 on:
+  workflow_dispatch:
   push:
     branches:
-      - main # Set a branch name to trigger deployment
+      - main
 
 jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-        with:
-          submodules: true # Fetch Hugo themes (true OR recursive)
-          fetch-depth: 0 # Fetch all history for .GitInfo and .Lastmod
+    - name: Checkout
+      uses: actions/checkout@v3
+
+    - name: Setup node
+      uses: actions/setup-node@v3
+      with:
+        node-version: 18
 
-      - name: Setup Hugo
-        uses: peaceiris/actions-hugo@v2
-        with:
-          hugo-version: '0.80.0'
+    - name: Install dependencies
+      run: npm ci
 
-      - name: Build
-        run: hugo --minify --baseURL https://l10178.github.io/
+    - name: Run linters
+      run: npm run lint --if-present
 
-      - name: Deploy
-        uses: peaceiris/actions-gh-pages@v3
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./public
+    - name: Build site
+      run: npm run build
+
+    - name: Deploy github pages
+      uses: peaceiris/actions-gh-pages@v3
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: ./public
+        cname: www.nxest.com

.gitignore

@@ -1,17 +1,13 @@
-######################
-## Hugo
-#######################
-public/
+.eslintcache
+.stylelintcache
+.netlify
 .hugo_build.lock
+yarn-error.log
+node_modules/
+public
+resources
+pnpm-lock.yaml
 
-######################
-## Intellij
-#######################
-.idea/
-*.iml
-
-#######################
-## Visual Studio Code
-#######################
-.vscode/
-.gradle/
+.idea
+.vscode
+.impl

.markdownlint-cli2.jsonc

@@ -0,0 +1,14 @@
+{
+  "config": {
+    "default": true,
+    "MD013": false,
+    "MD022": false,
+    "MD024": false,
+    "MD025": false,
+    "MD026": false,
+    "MD033": false,
+    "MD034": false,
+    "MD036": false
+  },
+  "ignores": ["node_modules", "CHANGELOG.md", "README.md"]
+}

.npmignore

@@ -0,0 +1,6 @@
+node_modules
+public
+resources
+.netlify
+.hugo_build.lock
+yarn-error.log

.npmrc

@@ -0,0 +1,4 @@
+enable-pre-post-scripts = true
+auto-install-peers = true
+node-linker = hoisted
+prefer-symlinked-executables = false

.stylelintignore

@@ -0,0 +1,2 @@
+assets/scss/vendor
+node_modules

.stylelintrc.json

@@ -0,0 +1,37 @@
+{
+  "extends": "stylelint-config-standard-scss",
+  "rules": {
+    "no-empty-source": null,
+    "string-quotes": "double",
+    "scss/comment-no-empty": null,
+    "max-line-length": null,
+    "scss/at-extend-no-missing-placeholder": null,
+    "at-rule-no-unknown": [
+      true,
+      {
+        "ignoreAtRules": [
+          "extend",
+          "at-root",
+          "debug",
+          "warn",
+          "error",
+          "if",
+          "else",
+          "for",
+          "each",
+          "while",
+          "mixin",
+          "include",
+          "content",
+          "return",
+          "function",
+          "tailwind",
+          "apply",
+          "responsive",
+          "variants",
+          "screen"
+        ]
+      }
+    ]
+  }
+}

README.md

@@ -1,5 +1,38 @@
 # l10178.github.io
 
-This is the source of nxest.com.
+This is the source of [nxest.com][].
 
 基于 Hugo 搭建的个人网站。
+
+## 本地开发
+
+本项目使用 [Hugo](https://gohugo.io/) 开发，使用 [Doks](https://github.com/gethyas/doks) 作为 Hugo 主题。
+
+本地开发时先安装 Nodejs，然后使用 pnpm（或 npm） 安装 Hugo bin，本地不需要提前安装 Hugo。
+
+```bash
+
+# 安装 npm 依赖包，注意网络连接
+pnpm install
+
+# 启动 Web，然后浏览器访问 http://localhost:1313/即可浏览效果
+pnpm run dev
+
+# 代码提交前先检查
+pnpm run lint
+
+# 编译结果
+pnpm run build
+
+# 创建新页面
+pnpm run create docs/guides/faq.md
+pnpm run create blog/k8s.md
+
+```
+
+## License
+
+本文档采用 [CC BY-NC 4.0][] 许可协议。
+
+[nxest.com]: https://www.nxest.com
+[CC BY-NC 4.0]: https://creativecommons.org/licenses/by-nc/4.0/

assets/scss/_styles_project.scss

@@ -0,0 +1,7 @@
+
+// disable docs links, see https://www.docsy.dev/docs/adding-content/repository-links/
+// .td-page-meta--view { display: none !important; }
+// .td-page-meta--edit { display: none !important; }
+// .td-page-meta--child { display: none !important; }
+// .td-page-meta--issue { display: none !important; }
+// .td-page-meta--project-issue { display: none !important; }