feat: Traditional Chinese version (#1163)

* First commit * Update mkdocs.yml * Translate all the docs to traditional Chinese * Translate the code files. * Translate the docker file * Fix mkdocs.yml * Translate all the figures from SC to TC * 二叉搜尋樹 -> 二元搜尋樹 * Update terminology. * Update terminology * 构造函数/构造方法 -> 建構子异或 -> 互斥或 * 擴充套件 -> 擴展 * constant - 常量 - 常數 * 類 -> 類別 * AVL -> AVL 樹 * 數組 -> 陣列 * 係統 -> 系統斐波那契數列 -> 費波那契數列運算元量 -> 運算量引數 -> 參數 * 聯絡 -> 關聯 * 麵試 -> 面試 * 面向物件 -> 物件導向歸併排序 -> 合併排序范式 -> 範式 * Fix 算法 -> 演算法 * 錶示 -> 表示反碼 -> 一補數補碼 -> 二補數列列尾部 -> 佇列尾部區域性性 -> 區域性一摞 -> 一疊 * Synchronize with main branch * 賬號 -> 帳號推匯 -> 推導 * Sync with main branch * First commit * Update mkdocs.yml * Translate all the docs to traditional Chinese * Translate the code files. * Translate the docker file * Fix mkdocs.yml * Translate all the figures from SC to TC * 二叉搜尋樹 -> 二元搜尋樹 * Update terminology * 构造函数/构造方法 -> 建構子异或 -> 互斥或 * 擴充套件 -> 擴展 * constant - 常量 - 常數 * 類 -> 類別 * AVL -> AVL 樹 * 數組 -> 陣列 * 係統 -> 系統斐波那契數列 -> 費波那契數列運算元量 -> 運算量引數 -> 參數 * 聯絡 -> 關聯 * 麵試 -> 面試 * 面向物件 -> 物件導向歸併排序 -> 合併排序范式 -> 範式 * Fix 算法 -> 演算法 * 錶示 -> 表示反碼 -> 一補數補碼 -> 二補數列列尾部 -> 佇列尾部區域性性 -> 區域性一摞 -> 一疊 * Synchronize with main branch * 賬號 -> 帳號推匯 -> 推導 * Sync with main branch * Update terminology.md * 操作数量（num. of operations）-> 操作數量 * 字首和->前綴和 * Update figures * 歸 -> 迴記憶體洩漏 -> 記憶體流失 * Fix the bug of the file filter * 支援 -> 支持 Add zh-Hant/README.md * Add the zh-Hant chapter covers. Bug fixes. * 外掛 -> 擴充功能 * Add the landing page for zh-Hant version * Unify the font of the chapter covers for the zh, en, and zh-Hant version * Move zh-Hant/ to zh-hant/ * Translate terminology.md to traditional Chinese
2026-08-30 03:47:14 +00:00 · 2024-04-06 02:30:11 +08:00
parent 33d7f8a2e5
commit 5f7385c8a3
1875 changed files with 102923 additions and 18 deletions
@@ -0,0 +1,107 @@
+=begin
+File: array.rb
+Created Time: 2024-03-18
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### 隨機訪問元素 ###
+def random_access(nums)
+  # 在區間 [0, nums.length) 中隨機抽取一個數字
+  random_index = Random.rand(0...nums.length)
+
+  # 獲取並返回隨機元素
+  nums[random_index]
+end
+
+
+### 擴展陣列長度 ###
+# 請注意，Ruby 的 Array 是動態陣列，可以直接擴展
+# 為了方便學習，本函式將 Array 看作長度不可變的陣列
+def extend(nums, enlarge)
+  # 初始化一個擴展長度後的陣列
+  res = Array.new(nums.length + enlarge, 0)
+
+  # 將原陣列中的所有元素複製到新陣列
+  for i in 0...nums.length
+    res[i] = nums[i]
+  end
+
+  # 返回擴展後的新陣列
+  res
+end
+
+### 在陣列的索引 index 處插入元素 num ###
+def insert(nums, num, index)
+  # 把索引 index 以及之後的所有元素向後移動一位
+  for i in (nums.length - 1).downto(index + 1)
+    nums[i] = nums[i - 1]
+  end
+
+  # 將 num 賦給 index 處的元素
+  nums[index] = num
+end
+
+
+### 刪除索引 index 處的元素 ###
+def remove(nums, index)
+  # 把索引 index 之後的所有元素向前移動一位
+  for i in index...nums.length
+    nums[i] = nums[i + 1] || 0
+  end
+end
+
+### 走訪陣列 ###
+def traverse(nums)
+  count = 0
+
+  # 透過索引走訪陣列
+  for i in 0...nums.length
+    count += nums[i]
+  end
+
+  # 直接走訪陣列元素
+  for num in nums
+    count += num
+  end
+end
+
+### 在陣列中查詢指定元素 ###
+def find(nums, target)
+  for i in 0...nums.length
+    return i if nums[i] == target
+  end
+
+  -1
+end
+
+
+### Driver Code ###
+
+# 初始化陣列
+arr = Array.new(5, 0)
+puts "陣列 arr = #{arr}"
+nums = [1, 3, 2, 5, 4]
+puts "陣列 nums = #{nums}"
+
+# 隨機訪問
+random_num = random_access(nums)
+puts "在 nums 中獲取隨機元素 #{random_num}"
+
+# 長度擴展
+nums = extend(nums, 3)
+puts "將陣列長度擴展至 8 ，得到 nums = #{nums}"
+
+# 插入元素
+insert(nums, 6, 3)
+puts "在索引 3 處插入數字 6 ，得到 nums = #{nums}"
+
+# 刪除元素
+remove(nums, 2)
+puts "刪除索引 2 處的元素，得到 nums = #{nums}"
+
+# 走訪陣列
+traverse(nums)
+
+# 查詢元素
+index = find(nums, 3)
+puts "在 nums 中查詢元素 3 ，得到索引 = #{index}"
@@ -0,0 +1,82 @@
+=begin
+File: linked_list.rb
+Created Time: 2024-03-18
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+require_relative '../utils/list_node'
+require_relative '../utils/print_util'
+
+### 在鏈結串列的節點 n0 之後插入節點 _p ###
+# Ruby 的 `p` 是一個內建函式， `P` 是一個常數，所以可以使用 `_p` 代替
+def insert(n0, _p)
+  n1 = n0.next
+  _p.next = n1
+  n0.next = _p
+end
+
+### 刪除鏈結串列的節點 n0 之後的首個節點 ###
+def remove(n0)
+  return if n0.next.nil?
+
+  # n0 -> remove_node -> n1
+  remove_node = n0.next
+  n1 = remove_node.next
+  n0.next = n1
+end
+
+### 訪問鏈結串列中索引為 index 的節點 ###
+def access(head, index)
+  for i in 0...index
+    return nil if head.nil?
+    head = head.next
+  end
+
+  head
+end
+
+### 在鏈結串列中查詢值為 target 的首個節點 ###
+def find(head, target)
+  index = 0
+  while head
+    return index if head.val == target
+    head = head.next
+    index += 1
+  end
+
+  -1
+end
+
+### Driver Code ###
+
+# 初始化鏈結串列
+# 初始化各個節點
+n0 = ListNode.new(1)
+n1 = ListNode.new(3)
+n2 = ListNode.new(2)
+n3 = ListNode.new(5)
+n4 = ListNode.new(4)
+# 構建節點之間的引用
+n0.next = n1
+n1.next = n2
+n2.next = n3
+n3.next = n4
+puts "初始化的鏈結串列為"
+print_linked_list(n0)
+
+# 插入節點
+insert(n0, ListNode.new(0))
+print_linked_list n0
+
+# 刪除節點
+remove(n0)
+puts "刪除節點後的鏈結串列為"
+print_linked_list(n0)
+
+# 訪問節點
+node = access(n0, 3)
+puts "鏈結串列中索引 3 處的節點的值 = #{node.val}"
+
+# 查詢節點
+index = find(n0, 2)
+puts "鏈結串列中值為 2 的節點的索引 = #{index}"
@@ -0,0 +1,59 @@
+=begin
+File: list.rb
+Created Time: 2024-03-18
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### Driver Code ###
+
+# 初始化串列
+nums = [1, 3, 2, 5, 4]
+puts "串列 nums = #{nums}"
+
+# 訪問元素
+num = nums[1]
+puts "訪問索引 1 處的元素，得到 num = #{num}"
+
+# 更新元素
+nums[1] = 0
+puts "將索引 1 處的元素更新為 0 ，得到 nums = #{nums}"
+
+# 清空串列
+nums.clear
+puts "清空串列後 nums = #{nums}"
+
+# 在尾部新增元素
+nums << 1
+nums << 3
+nums << 2
+nums << 5
+nums << 4
+puts "新增元素後 nums = #{nums}"
+
+# 在中間插入元素
+nums.insert(3, 6)
+puts "在索引 3 處插入元素 6 ，得到 nums = #{nums}"
+
+# 刪除元素
+nums.delete_at(3)
+puts "刪除索引 3 處的元素，得到 nums = #{nums}"
+
+# 透過索引走訪串列
+count = 0
+for i in 0...nums.length
+  count += nums[i]
+end
+
+# 直接走訪串列元素
+count = 0
+nums.each do |x|
+  count += x
+end
+
+# 拼接兩個串列
+nums1 = [6, 8, 7, 10, 9]
+nums += nums1
+puts "將串列 nums1 拼接到 nums 之後，得到 nums = #{nums}"
+
+nums = nums.sort { |a, b| a <=> b }
+puts "排序串列後 nums = #{nums}"
@@ -0,0 +1,131 @@
+=begin
+File: my_list.rb
+Created Time: 2024-03-18
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### 串列類別 ###
+class MyList
+  attr_reader :size       # 獲取串列長度（當前元素數量）
+  attr_reader :capacity   # 獲取串列容量
+
+  ### 建構子 ###
+  def initialize
+    @capacity = 10
+    @size = 0
+    @extend_ratio = 2
+    @arr = Array.new(capacity)
+  end
+
+  ### 訪問元素 ###
+  def get(index)
+    # 索引如果越界，則丟擲異常，下同
+    raise IndexError, "索引越界" if index < 0 || index >= size
+    @arr[index]
+  end
+
+  ### 訪問元素 ###
+  def set(index, num)
+    raise IndexError, "索引越界" if index < 0 || index >= size
+    @arr[index] = num
+  end
+
+  ### 在尾部新增元素 ###
+  def add(num)
+    # 元素數量超出容量時，觸發擴容機制
+    extend_capacity if size == capacity
+    @arr[size] = num
+    
+    # 更新元素數量
+    @size += 1
+  end
+
+  ### 在中間插入元素 ###
+  def insert(index, num)
+    raise IndexError, "索引越界" if index < 0 || index >= size
+
+    # 元素數量超出容量時，觸發擴容機制
+    extend_capacity if size == capacity
+
+    # 將索引 index 以及之後的元素都向後移動一位
+    for j in (size - 1).downto(index)
+      @arr[j + 1] = @arr[j] 
+    end
+    @arr[index] = num
+
+    # 更新元素數量
+    @size += 1
+  end
+
+  ### 刪除元素 ###
+  def remove(index)
+    raise IndexError, "索引越界" if index < 0 || index >= size
+    num = @arr[index]
+
+    # 將將索引 index 之後的元素都向前移動一位
+    for j in index...size
+      @arr[j] = @arr[j + 1]
+    end
+
+    # 更新元素數量
+    @size -= 1
+
+    # 返回被刪除的元素
+    num
+  end
+
+  ### 串列擴容 ###
+  def extend_capacity
+    # 新建一個長度為原陣列 extend_ratio 倍的新陣列，並將原陣列複製到新陣列
+    arr = @arr.dup + Array.new(capacity * (@extend_ratio - 1))
+    # 更新串列容量
+    @capacity = arr.length
+  end
+
+  ### 將串列轉換為陣列 ###
+  def to_array
+    sz = size
+    # 僅轉換有效長度範圍內的串列元素
+    arr = Array.new(sz)
+    for i in 0...sz
+      arr[i] = get(i)
+    end
+    arr
+  end
+end
+
+### Driver Code ###
+
+# 初始化串列
+nums = MyList.new
+
+# 在尾部新增元素
+nums.add(1)
+nums.add(3)
+nums.add(2)
+nums.add(5)
+nums.add(4)
+puts "串列 nums = #{nums.to_array} ，容量 = #{nums.capacity} ，長度 = #{nums.size}"
+
+# 在中間插入元素
+nums.insert(3, 6)
+puts "在索引 3 處插入數字 6 ，得到 nums = #{nums.to_array}"
+
+# 刪除元素
+nums.remove(3)
+puts "刪除索引 3 的元素，得到 nums = #{nums.to_array}"
+
+# 訪問元素
+num = nums.get(1)
+puts "訪問索引 1 處的元素，得到 num = #{num}"
+
+# 更新元素
+nums.set(1, 0)
+puts "將索引 1 處的元素更新為 0 ，得到 nums = #{nums.to_array}"
+
+# 測試擴容機制
+for i in 0...10
+  # 在 i = 5 時，串列長度將超出串列容量，此時觸發擴容機制
+  nums.add(i)
+end
+puts "擴容後的串列 nums = #{nums.to_array} ，容量 = #{nums.capacity} ，長度 = #{nums.size}"