update: new github page && lots of docs

Author: adoyle-h

.github/workflows/jekyll-gh-pages.yml

@@ -0,0 +1,52 @@
+name: Deploy GitHub Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["master"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v3
+
+      - name: Build with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./
+          destination: ./_site
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v1
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v1

.github/workflows/local.yml

@@ -0,0 +1,17 @@
+name: Build Github Pages in local
+
+on:
+  workflow_dispatch:
+
+jobs:
+  build-local:
+    runs-on: macos-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Build with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./
+          destination: ./_site

.jekyll/assets/favicon.ico

@@ -0,0 +1,6 @@
+{% if site.logo %}
+<div class="site-logo"></div>
+<div class="site-logo-title">{{ site.title }}</div>
+{% else %}
+{{ site.title }}
+{% endif %}

.jekyll/includes/title.html

@@ -0,0 +1,15 @@
+.site-logo {
+  max-width: 40px;
+  margin-right: 10px;
+}
+
+.site-logo-title {
+  font-size: 0.6em;
+  max-width: 60%;
+  line-height: 1.2;
+}
+
+.search-result-highlight {
+  color: #fa2c2c;
+  text-decoration: underline;
+}

.jekyll/sass/custom/custom.scss

@@ -1,4 +1,4 @@
-Copyright (c) 2016-2022 ADoyle
+Copyright (c) 2016-2023 ADoyle ([email protected])
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

LICENSE

@@ -1,3 +1,9 @@
+---
+title: Home
+nav_order: 1
+---
+
+
 # 今天我学了什么 (Today I Learned)
 
 > 博观而约取，厚积而薄发。
@@ -29,7 +35,7 @@ ADoyle 的碎片化知识笔记。
 
 ## 版权声明
 
-Copyright (c) 2016-2022 ADoyle ([email protected]). The project is licensed under the **BSD 3-clause License**.
+Copyright (c) 2016-2023 ADoyle ([email protected]). The project is licensed under the **BSD 3-clause License**.
 
 See the [LICENSE][] file for the specific language governing permissions and limitations under the License.
 
@@ -140,12 +146,15 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 - [ContainerD OverlayFS](docker/containerd-overlayfs.md)
 - [Containerd](docker/containerd.md)
 - [容器里的 Core Dump](docker/core-dump-in-container.md)
+- [容器里的 CPU 信息](docker/cpu-in-container.md)
 - [device or resource busy](docker/device-or-resource-busy.md)
 - [docker-compose 启动容器顺序](docker/docker-compose-startup-order.md)
 - [Docker 容器与 Cgroup](docker/docker-container-and-cgroup.md)
 - [进入 docker for mac 的虚拟机](docker/docker-for-mac-tty.md)
+- [docker for mac](docker/docker-for-mac.md)
 - [学习 Docker](docker/docker-learning.md)
 - [Docker OverlayFS](docker/docker-overlayfs.md)
+- [Docker 的坑](docker/docker-pitfalls.md)
 - [Docker Run With Namespace](docker/docker-run-with-namespace.md)
 - [Docker Tag/Id/Digest](docker/docker-tag-id-digests.md)
 - [docker 小技巧](docker/docker-tricks.md)
@@ -154,6 +163,8 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 - [修正 alpine 镜像的时区问题](docker/fix-timezone-in-alpine-image.md)
 - [修正 Docker for mac 时区问题](docker/fix-timezone-in-docker-for-mac.md)
 - [Docker for Mac 中磁盘文件占用过大](docker/large-disk-space-usage-in-docker-for-mac.md)
+- [构建多架构镜像](docker/multi-arch-build.md)
+- [docker 多阶段构建 (Multi-Stage Build)](docker/multi-stage-build.md)
 - [nerdctl 容器](docker/nerdctl-container.md)
 - [nerdctl 网络](docker/nerdctl-network.md)
 - [nerdctl](docker/nerdctl.md)
@@ -234,8 +245,11 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 - [git 小技巧](git/git-tricks.md)
 - [git credentials](git/gitcredentials.md)
 - [gitignore 与 gitkeep](git/gitignore-with-gitkeep.md)
+- [grafted commit](git/grafted-commit.md)
 - [忽略 Git submodule](git/ignore-git-submodule.md)
 - [--ours vs --theirs](git/ours-vs-theirs.md)
+- [git proxy](git/proxy.md)
+- [Git sign-off](git/sign-off.md)
 
 ## Go
 
@@ -252,6 +266,7 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 
 - [固件 (Firmware)](hardware/firmware.md)
 - [网件 R6900 刷梅林固件](hardware/netgear-R6900-asuswrt-merlin.md)
+- [网络交换机](hardware/network-switch.md)
 - [USB](hardware/usb.md)
 
 ## Javascript
@@ -270,6 +285,7 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 
 ## K8S
 
+- [OCI、CNI](k8s/OCI-spec.md)
 - [Cilium](k8s/cilium.md)
 - [调试 CrashLoopBackOff 状态的 Pod](k8s/debug-CrashLoopBackOff-pod.md)
 - [Helm](k8s/helm.md)
@@ -293,9 +309,13 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 
 记录编程语言的内部设计与思想
 
+- [CFLAGS](language/CFLAGS.md)
 - [Actor 并发模型](language/actor.md)
+- [编译器](language/compiler.md)
 - [协程 (Coroutine)](language/coroutine.md)
 - [CSP 并发模型](language/csp.md)
+- [Debuger](language/debuger.md)
+- [栈帧](language/stack-frame.md)
 
 ## Linux
 
@@ -306,6 +326,7 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 - [ABI](linux/abi.md)
 - [用户线程，内核线程，CPU 超线程技术](linux/about-multi-thread.md)
 - [用户增加用户组](linux/add-group-to-user.md)
+- [ag 和 rg](linux/ag-and-rg.md)
 - [Alfred 找不到文件](linux/alfred-cannot-find-files.md)
 - [anon_inode](linux/anon_inode.md)
 - [ansible 部署到 centos7 时，不能找到 service](linux/ansible-deploy-fault-with-centos7-and-service.md)
@@ -477,6 +498,7 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 记录网络相关知识
 
 - [ARP](network/arp.md)
+- [自治系统 (Autonomous System)](network/autonomous-system.md)
 - [组播地址](network/boardcast-ip.md)
 - [网桥 (Bridge)](network/bridge.md)
 - [DHCP](network/dhcp.md)
@@ -487,6 +509,7 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 - [NAT](network/nat.md)
 - [pfctl](network/pfctl.md)
 - [Samba](network/samba.md)
+- [SDN](network/sdn.md)
 - [TCP Buffer 大小](network/tcp-buffer-size.md)
 - [vxlan](network/vxlan.md)
 
@@ -542,10 +565,12 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 - [永久链接](others/archive-webpage.md)
 - [脱字符 (caret)](others/caret.md)
 - [Chrome 小技巧](others/chrome-tricks.md)
+- [复制粘贴好过手写](others/copy-paste-better-than-handwriting.md)
 - [Mac 文件系统的剪切快捷键](others/cut-in-mac-file-system.md)
 - [YAML 中的 Date 类型陷阱](others/date-trap-in-yaml.md)
 - [文件命名，下划线还是中划线？](others/file-naming-with-underscores-and-dashes.md)
 - [github 中 markdown 折叠文本](others/fold-text-in-github.md)
+- [fzf](others/fzf.md)
 - [从微信公众号提取原图](others/get-raw-image-from-weixin.md)
 - [Github Template (模板)](others/github-template.md)
 - [gRPC](others/grpc.md)
@@ -555,6 +580,7 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 - [如何在 github 项目里搜索代码](others/how-to-use-github-to-browse-codes.md)
 - [Hyper.js 中文问题](others/hyper-js-chinese-problems.md)
 - [无法在 Tmux 显示图片](others/imgcat-not-work-in-tmux.md)
+- [Jekyll](others/jekyll.md)
 - [Jinja2](others/jinja2.md)
 - [Language Server Protocol](others/language-server-protocol.md)
 - [箴言](others/maxim.md)
@@ -627,13 +653,20 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 
 ## Shell
 
+- [多行字符串赋值给变量](shell/assign-multi-lines-string-to-variable.md)
+- [bash completion](shell/bash-completion.md)
 - [Bash 镜像有 bug](shell/bash-docker-image-has-bug.md)
 - [bash error exit](shell/bash-error-exit.md)
 - [bash history](shell/bash-history.md)
 - [bash 开启 vi 模式](shell/bash-in-vi-mode.md)
 - [学习 Bash](shell/bash-learning.md)
 - [Bash 的坑](shell/bash-pitfalls.md)
 - [Bash 小技巧](shell/bash-tricks.md)
+- [`printf '%s\n' $@` 为何可以打印多行？](shell/printf-array.md)
+- [Readline](shell/readline.md)
+- [学习 Shell](shell/shell-learning.md)
+- [Bash 的 subshell 与子进程](shell/subshell-and-child-process.md)
+- [Bash xtrace](shell/xtrace.md)
 
 ## Startup
 
@@ -667,6 +700,7 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 记录我的碎片式思考
 
 - [CLD 图](thinking/causal-loop-diagram.md)
+- [声明式配置 vs 编程式配置](thinking/declarable-vs-programmable.md)
 - [项目代码如何组织](thinking/how-to-make-code-organization.md)
 - [如何编程](thinking/how-to-programming.md)
 - [不完整的函数](thinking/non-total-function.md)
@@ -681,6 +715,7 @@ See the [LICENSE][] file for the specific language governing permissions and lim
 
 ## Vim
 
+- [<C-I> 在 nvim 里等同于 <Tab>](vim/ctrl-i-in-neovim.md)
 - [学习 Neovim](vim/neovim-learning.md)
 - [在 vim 中执行 shell 命令，同时将结果输出到 buffer](vim/pipe-shell-output-to-buffer.md)
 - [vim 插件教程](vim/plugins-tutorial.md)

README.md

@@ -1 +1,59 @@
-theme: jekyll-theme-cayman
+includes_dir: .jekyll/includes
+sass:
+  sass_dir: .jekyll/sass
+
+plugins:
+  - jekyll-remote-theme
+  - jekyll-include-cache
+  - jekyll-sitemap
+  - jekyll-feed
+
+include: []
+
+exclude:
+  - README.md
+  - .github
+
+remote_theme: just-the-docs/just-the-docs
+
+# Default config: https://github.com/just-the-docs/just-the-docs/blob/main/_config.yml
+url: https://adoyle.me
+baseurl: /Today-I-Learned/
+title: 今天我学了什么
+description: 博观而约取，厚积而薄发。ADoyle 的碎片化知识笔记。
+logo: https://media.githubusercontent.com/media/adoyle-h/_imgs/master/assets/logo.png
+favicon_ico: ./.jekyll/assets/favicon.ico
+permalink: none
+footer_content:
+  Copyright 2016-2023 ADoyle ([email protected]). The project is licensed under <b>BSD 3-clause License</b>.<br>
+  Source code at <a href="https://github.com/adoyle-h/my-development-tools">https://github.com/adoyle-h/Today-I-Learned</a>
+
+last_edit_timestamp: true
+color_scheme: dark
+back_to_top: true
+back_to_top_text: "Back to Top"
+
+search_enabled: true
+search:
+  # Split pages into sections that can be searched individually
+  # Supports 1 - 6, default: 2
+  heading_level: 2
+  # Maximum amount of previews per search result
+  # Default: 3
+  previews: 3
+  # Maximum amount of words to display before a matched word in the preview
+  # Default: 5
+  preview_words_before: 5
+  # Maximum amount of words to display after a matched word in the preview
+  # Default: 10
+  preview_words_after: 10
+  # Set the search token separator
+  # Default: /[\s\-/]+/
+  # Example: enable support for hyphenated search words
+  tokenizer_separator: /[\s/]+/
+  # Display the relative url in search results
+  # Supports true (default) or false
+  rel_url: true
+  # Enable or disable the search button that appears in the bottom right corner of every page
+  # Supports true or false (default)
+  button: false

_config.yml

@@ -1,6 +1,6 @@
 ## 版权声明
 
-Copyright (c) 2016-2022 ADoyle ([email protected]). The project is licensed under the **BSD 3-clause License**.
+Copyright (c) 2016-2023 ADoyle ([email protected]). The project is licensed under the **BSD 3-clause License**.
 
 See the [LICENSE][] file for the specific language governing permissions and limitations under the License.
 

_docs/license.md

@@ -0,0 +1,4 @@
+---
+title: Home
+nav_order: 1
+---

_docs/meta.md

@@ -134,7 +134,7 @@ ${tocStr}
 
 async function getTitle(path) {
     const content = await readFile(path, {encoding: 'utf8'});
-    const matched = content.match(/^##? ?(.+)/);
+    const matched = content.match(/##? (.+)/);
     if (!matched) return '';
 
     let title = matched[1];
@@ -220,6 +220,7 @@ async function build() {
 
 
     const structure = [
+        {md: absPath('_docs/meta.md')},
         {h1: '今天我学了什么 (Today I Learned)'},
         {blockquote: pkg.description},
         {md: absPath('_docs/intro.md')},

build

@@ -17,3 +17,9 @@
 RGB 每个颜色单位的范围是 0~255，也就是说只能表达 256 种颜色的组合，这显然是太少了。
 HSL、HSB 的颜色精度比 RGB 还低，能表达的颜色更少。
 当前的硬件不断升级，可能已经超过了理论能表达颜色范围和精度。
+
+### 如果你使用 Sketch
+
+Sketch 会显示`该文档目前使用的是 sRGB 颜色配置。可以通过以下路径进行更改：...`
+
+https://www.sketch.com/docs/designing/color-profiles/

design/color-space.md

@@ -0,0 +1,3 @@
+## 容器里的 CPU 信息
+
+containerd 支

docker/cpu-in-container.md

@@ -0,0 +1,9 @@
+# docker for mac
+
+> 在 2021 年 4 月时，Docker for Mac（Docker Desktop）发布了对 Apple Silicon 的实验性支持，它会使用 QEMU 运行一个 ARM 架构的 Linux 虚拟机，默认运行 ARM 架构的镜像，但也支持运行 x86 的镜像。
+
+[为什么在 Apple Silicon 上装 Docker 这么难](https://juejin.cn/post/7068481074736660494)
+
+## 修改配置导致 docker 无法启动
+
+docker for mac 的配置在 `~/Library/Group\ Containers/group.com.docker/settings.json`，修复配置即可。

docker/docker-for-mac.md

@@ -0,0 +1,9 @@
+## Docker 的坑
+
+### COPY/ADD 的目标路径不能有 ~
+
+`COPY . ~/` 或者 `COPY . ~`，构建不会报错，但是 `~/` 下没有文件。
+
+`COPY . /root/` 或者 `COPY . /root` 才对。
+
+`RUN mkdir -p ~/abc` 却是能创建成功 `~/abc` 的。