Add ru version (#1865)

* Add Russian docs site baseline

* Add Russian localized codebase

* Polish Russian code wording

* Update ru code translation.

* Update code translation and chapter covers.

* Fix pythontutor extraction.

* Add README and landing page.

* placeholder of profiles

* Use figures of English version

* Remove chapter paperbook

ru/codes/ruby/chapter_stack_and_queue/array_deque.rb

@@ -0,0 +1,145 @@
+=begin
+File: array_deque.rb
+Created Time: 2024-04-05
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+# ## Двусторонняя очередь на основе кольцевого массива ###
+class ArrayDeque
+  # ## Получение длины двусторонней очереди ###
+  attr_reader :size
+
+  # ## Конструктор ###
+  def initialize(capacity)
+    @nums = Array.new(capacity, 0)
+    @front = 0
+    @size = 0
+  end
+
+  # ## Получить вместимость двусторонней очереди ###
+  def capacity
+    @nums.length
+  end
+
+  # ## Проверка, пуста ли двусторонняя очередь ###
+  def is_empty?
+    size.zero?
+  end
+
+  # ## Добавление в голову очереди ###
+  def push_first(num)
+    if size == capacity
+      puts 'Двусторонняя очередь заполнена'
+      return
+    end
+
+    # Указатель головы сдвигается на одну позицию влево
+    # С помощью операции взятия по модулю front после выхода за начало массива возвращается в хвост
+    @front = index(@front - 1)
+    # Добавить num в голову очереди
+    @nums[@front] = num
+    @size += 1
+  end
+
+  # ## Добавление в хвост очереди ###
+  def push_last(num)
+    if size == capacity
+      puts 'Двусторонняя очередь заполнена'
+      return
+    end
+
+    # Вычислить указатель хвоста, указывающий на индекс хвоста + 1
+    rear = index(@front + size)
+    # Добавить num в хвост очереди
+    @nums[rear] = num
+    @size += 1
+  end
+
+  # ## Извлечение из головы очереди ###
+  def pop_first
+    num = peek_first
+    # Указатель головы сдвигается на одну позицию назад
+    @front = index(@front + 1)
+    @size -= 1
+    num
+  end
+
+  # ## Извлечение из хвоста очереди ###
+  def pop_last
+    num = peek_last
+    @size -= 1
+    num
+  end
+
+  # ## Доступ к элементу в начале очереди ###
+  def peek_first
+    raise IndexError, 'двусторонняя очередь пуста' if is_empty?
+
+    @nums[@front]
+  end
+
+  # ## Доступ к элементу в хвосте очереди ###
+  def peek_last
+    raise IndexError, 'двусторонняя очередь пуста' if is_empty?
+
+    # Вычислить индекс хвостового элемента
+    last = index(@front + size - 1)
+    @nums[last]
+  end
+
+  # ## Вернуть массив для вывода ###
+  def to_array
+    # Преобразовывать только элементы списка в пределах фактической длины
+    res = []
+    for i in 0...size
+      res << @nums[index(@front + i)]
+    end
+    res
+  end
+
+  private
+
+  # ## Вычислить индекс в кольцевом массиве ###
+  def index(i)
+    # С помощью операции взятия по модулю соединить начало и конец массива
+    # Когда i выходит за конец массива, он возвращается в начало
+    # Когда i выходит за начало массива, он возвращается в конец
+    (i + capacity) % capacity
+  end
+end
+
+### Driver Code ###
+if __FILE__ == $0
+  # Инициализация двусторонней очереди
+  deque = ArrayDeque.new(10)
+  deque.push_last(3)
+  deque.push_last(2)
+  deque.push_last(5)
+  puts "Двусторонняя очередь deque = #{deque.to_array}"
+
+  # Доступ к элементу
+  peek_first = deque.peek_first
+  puts "Первый элемент peek_first = #{peek_first}"
+  peek_last = deque.peek_last
+  puts "Последний элемент peek_last = #{peek_last}"
+
+  # Добавление элемента в очередь
+  deque.push_last(4)
+  puts "После добавления элемента 4 в хвост deque = #{deque.to_array}"
+  deque.push_first(1)
+  puts "После добавления элемента 1 в хвост deque = #{deque.to_array}"
+
+  # Извлечение элемента из очереди
+  pop_last = deque.pop_last
+  puts "Извлечен элемент из хвоста = #{pop_last}, deque после извлечения из хвоста = #{deque.to_array}"
+  pop_first = deque.pop_first
+  puts "Извлечен элемент из головы = #{pop_first}, deque после извлечения из головы = #{deque.to_array}"
+
+  # Получение длины двусторонней очереди
+  size = deque.size
+  puts "Длина двусторонней очереди size = #{size}"
+
+  # Проверка, пуста ли двусторонняя очередь
+  is_empty = deque.is_empty?
+  puts "Пуста ли двусторонняя очередь = #{is_empty}"
+end

ru/codes/ruby/chapter_stack_and_queue/array_queue.rb

@@ -0,0 +1,107 @@
+=begin
+File: array_queue.rb
+Created Time: 2024-04-05
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+# ## Очередь на основе кольцевого массива ###
+class ArrayQueue
+  # ## Получение длины очереди ###
+  attr_reader :size
+
+  # ## Конструктор ###
+  def initialize(size)
+    @nums = Array.new(size, 0) # Массив для хранения элементов очереди
+    @front = 0 # Указатель head, указывающий на первый элемент очереди
+    @size = 0 # Длина очереди
+  end
+
+  # ## Получить вместимость очереди ###
+  def capacity
+    @nums.length
+  end
+
+  # ## Проверка, пуста ли очередь ###
+  def is_empty?
+    size.zero?
+  end
+
+  # ## Добавление в очередь ###
+  def push(num)
+    raise IndexError, 'очередь заполнена' if size == capacity
+
+    # Вычислить указатель хвоста, указывающий на индекс хвоста + 1
+    # С помощью операции взятия по модулю вернуть rear к началу после выхода за конец массива
+    rear = (@front + size) % capacity
+    # Добавить num в хвост очереди
+    @nums[rear] = num
+    @size += 1
+  end
+
+  # ## Извлечение из очереди ###
+  def pop
+    num = peek
+    # Указатель head сдвигается на одну позицию назад; если он выходит за конец, то возвращается в начало массива
+    @front = (@front + 1) % capacity
+    @size -= 1
+    num
+  end
+
+  # ## Доступ к элементу в начале очереди ###
+  def peek
+    raise IndexError, 'очередь пуста' if is_empty?
+
+    @nums[@front]
+  end
+
+  # ## Вернуть список для вывода ###
+  def to_array
+    res = Array.new(size, 0)
+    j = @front
+
+    for i in 0...size
+      res[i] = @nums[j % capacity]
+      j += 1
+    end
+
+    res
+  end
+end
+
+### Driver Code ###
+if __FILE__ == $0
+  # Инициализация очереди
+  queue = ArrayQueue.new(10)
+
+  # Добавление элемента в очередь
+  queue.push(1)
+  queue.push(3)
+  queue.push(2)
+  queue.push(5)
+  queue.push(4)
+  puts "Очередь queue = #{queue.to_array}"
+
+  # Доступ к элементу в начале очереди
+  peek = queue.peek
+  puts "Первый элемент peek = #{peek}"
+
+  # Извлечение элемента из очереди
+  pop = queue.pop
+  puts "Извлеченный элемент pop = #{pop}"
+  puts "queue после извлечения = #{queue.to_array}"
+
+  # Получение длины очереди
+  size = queue.size
+  puts "Длина очереди size = #{size}"
+
+  # Проверка, пуста ли очередь
+  is_empty = queue.is_empty?
+  puts "Пуста ли очередь = #{is_empty}"
+
+  # Проверка кольцевого массива
+  for i in 0...10
+    queue.push(i)
+    queue.pop
+    puts "После #{i}-го цикла enqueue + dequeue queue = #{queue.to_array}"
+  end
+end

ru/codes/ruby/chapter_stack_and_queue/array_stack.rb

@@ -0,0 +1,78 @@
+=begin
+File: array_stack.rb
+Created Time: 2024-04-06
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+# ## Стек на основе массива ###
+class ArrayStack
+  # ## Конструктор ###
+  def initialize
+    @stack = []
+  end
+
+  # ## Получить длину стека ###
+  def size
+    @stack.length
+  end
+
+  # ## Проверка, пуст ли стек ###
+  def is_empty?
+    @stack.empty?
+  end
+
+  # ## Помещение в стек ###
+  def push(item)
+    @stack << item
+  end
+
+  # ## Извлечение из стека ###
+  def pop
+    raise IndexError, 'стек пуст' if is_empty?
+
+    @stack.pop
+  end
+
+  # ## Доступ к верхнему элементу стека ###
+  def peek
+    raise IndexError, 'стек пуст' if is_empty?
+
+    @stack.last
+  end
+
+  # ## Вернуть список для вывода ###
+  def to_array
+    @stack
+  end
+end
+
+### Driver Code ###
+if __FILE__ == $0
+  # Инициализация стека
+  stack = ArrayStack.new
+
+  # Помещение элемента в стек
+  stack.push(1)
+  stack.push(3)
+  stack.push(2)
+  stack.push(5)
+  stack.push(4)
+  puts "Стек stack = #{stack.to_array}"
+
+  # Доступ к верхнему элементу стека
+  peek = stack.peek
+  puts "Верхний элемент peek = #{peek}"
+
+  # Извлечение элемента из стека
+  pop = stack.pop
+  puts "Извлеченный элемент pop = #{pop}"
+  puts "stack после извлечения = #{stack.to_array}"
+
+  # Получение длины стека
+  size = stack.size
+  puts "Длина стека size = #{size}"
+
+  # Проверка на пустоту
+  is_empty = stack.is_empty?
+  puts "Пуст ли стек = #{is_empty}"
+end

ru/codes/ruby/chapter_stack_and_queue/deque.rb

@@ -0,0 +1,42 @@
+=begin
+File: deque.rb
+Created Time: 2024-04-06
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### Driver Code ###
+if __FILE__ == $0
+  # Инициализировать двустороннюю очередь
+  # В Ruby нет встроенной двусторонней очереди, поэтому Array можно использовать как двустороннюю очередь
+  deque = []
+
+  # Элемент помещается в очередь
+  deque << 2
+  deque << 5
+  deque << 4
+  # Обратите внимание: поскольку используется массив, временная сложность метода Array#unshift равна O(n)
+  deque.unshift(3)
+  deque.unshift(1)
+  puts "Двусторонняя очередь deque = #{deque}"
+
+  # Доступ к элементу
+  peek_first = deque.first
+  puts "Первый элемент peek_first = #{peek_first}"
+  peek_last = deque.last
+  puts "Последний элемент peek_last = #{peek_last}"
+
+  # Элемент извлекается из очереди
+  # Обратите внимание: поскольку используется массив, временная сложность метода Array#shift равна O(n)
+  pop_front = deque.shift
+  puts "Извлечен элемент из головы pop_front = #{pop_front}, deque после извлечения из головы = #{deque}"
+  pop_back = deque.pop
+  puts "Извлечен элемент из хвоста pop_back = #{pop_back}, deque после извлечения из хвоста = #{deque}"
+
+  # Получение длины двусторонней очереди
+  size = deque.length
+  puts "Длина двусторонней очереди size = #{size}"
+
+  # Проверка, пуста ли двусторонняя очередь
+  is_empty = size.zero?
+  puts "Пуста ли двусторонняя очередь = #{is_empty}"
+end

ru/codes/ruby/chapter_stack_and_queue/linkedlist_deque.rb

@@ -0,0 +1,168 @@
+=begin
+File: linkedlist_deque.rb
+Created Time: 2024-04-06
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+# ## Узел двусвязного списка
+class ListNode
+  attr_accessor :val
+  attr_accessor :next # Ссылка на узел-преемник
+  attr_accessor :prev # Ссылка на узел-предшественник
+
+  # ## Конструктор ###
+  def initialize(val)
+    @val = val
+  end
+end
+
+# ## Двусторонняя очередь на основе двусвязного списка ###
+class LinkedListDeque
+  # ## Получение длины двусторонней очереди ###
+  attr_reader :size
+
+  # ## Конструктор ###
+  def initialize
+    @front = nil  # Головной узел front
+    @rear = nil   # Хвостовой узел rear
+    @size = 0     # Длина двусторонней очереди
+  end
+
+  # ## Проверка, пуста ли двусторонняя очередь ###
+  def is_empty?
+    size.zero?
+  end
+
+  # ## Операция добавления в очередь ###
+  def push(num, is_front)
+    node = ListNode.new(num)
+    # Если связный список пуст, пусть front и rear оба указывают на node
+    if is_empty?
+      @front = @rear = node
+    # Операция добавления в голову очереди
+    elsif is_front
+      # Добавить node в голову списка
+      @front.prev = node
+      node.next = @front
+      @front = node # Обновить головной узел
+    # Операция добавления в хвост очереди
+    else
+      # Добавить node в хвост списка
+      @rear.next = node
+      node.prev = @rear
+      @rear = node # Обновить хвостовой узел
+    end
+    @size += 1 # Обновить длину очереди
+  end
+
+  # ## Добавление в голову очереди ###
+  def push_first(num)
+    push(num, true)
+  end
+
+  # ## Добавление в хвост очереди ###
+  def push_last(num)
+    push(num, false)
+  end
+
+  # ## Операция извлечения из очереди ###
+  def pop(is_front)
+    raise IndexError, 'двусторонняя очередь пуста' if is_empty?
+
+    # Операция извлечения из головы очереди
+    if is_front
+      val = @front.val # Временно сохранить значение головного узла
+      # Удалить головной узел
+      fnext = @front.next
+      unless fnext.nil?
+        fnext.prev = nil
+        @front.next = nil
+      end
+      @front = fnext # Обновить головной узел
+    # Операция извлечения из хвоста очереди
+    else
+      val = @rear.val # Временно сохранить значение хвостового узла
+      # Удалить хвостовой узел
+      rprev = @rear.prev
+      unless rprev.nil?
+        rprev.next = nil
+        @rear.prev = nil
+      end
+      @rear = rprev # Обновить хвостовой узел
+    end
+    @size -= 1 # Обновить длину очереди
+
+    val
+  end
+
+  # ## Извлечение из головы очереди ###
+  def pop_first
+    pop(true)
+  end
+
+  # ## Извлечение из головы очереди ###
+  def pop_last
+    pop(false)
+  end
+
+  # ## Доступ к элементу в начале очереди ###
+  def peek_first
+    raise IndexError, 'двусторонняя очередь пуста' if is_empty?
+
+    @front.val
+  end
+
+  # ## Доступ к элементу в хвосте очереди ###
+  def peek_last
+    raise IndexError, 'двусторонняя очередь пуста' if is_empty?
+
+    @rear.val
+  end
+
+  # ## Вернуть массив для вывода ###
+  def to_array
+    node = @front
+    res = Array.new(size, 0)
+    for i in 0...size
+      res[i] = node.val
+      node = node.next
+    end
+    res
+  end
+end
+
+### Driver Code ###
+if __FILE__ == $0
+  # Инициализация двусторонней очереди
+  deque = LinkedListDeque.new
+  deque.push_last(3)
+  deque.push_last(2)
+  deque.push_last(5)
+  puts "Двусторонняя очередь deque = #{deque.to_array}"
+
+  # Доступ к элементу
+  peek_first = deque.peek_first
+  puts "Первый элемент peek_first = #{peek_first}"
+  peek_last = deque.peek_last
+  puts "Последний элемент peek_last = #{peek_last}"
+
+  # Добавление элемента в очередь
+  deque.push_last(4)
+  puts "После добавления элемента 4 в хвост deque = #{deque.to_array}"
+  deque.push_first(1)
+  puts "После добавления элемента 1 в голову deque = #{deque.to_array}"
+
+  # Извлечение элемента из очереди
+  pop_last = deque.pop_last
+  puts "Извлечен элемент из хвоста = #{pop_last}, deque после извлечения из хвоста = #{deque.to_array}"
+  pop_first = deque.pop_first
+  puts "Извлечен элемент из головы = #{pop_first}, deque после извлечения из головы = #{deque.to_array}"
+
+  # Получение длины двусторонней очереди
+  size = deque.size
+  puts "Длина двусторонней очереди size = #{size}"
+
+  # Проверка, пуста ли двусторонняя очередь
+  is_empty = deque.is_empty?
+  puts "Пуста ли двусторонняя очередь = #{is_empty}"
+end

ru/codes/ruby/chapter_stack_and_queue/linkedlist_queue.rb

@@ -0,0 +1,101 @@
+=begin
+File: linkedlist_queue.rb
+Created Time: 2024-04-06
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+require_relative '../utils/list_node'
+
+# ## Очередь на основе связного списка ###
+class LinkedListQueue
+  # ## Получение длины очереди ###
+  attr_reader :size
+
+  # ## Конструктор ###
+  def initialize
+    @front = nil  # Головной узел front
+    @rear = nil   # Хвостовой узел rear
+    @size = 0
+  end
+
+  # ## Проверка, пуста ли очередь ###
+  def is_empty?
+    @front.nil?
+  end
+
+  # ## Добавление в очередь ###
+  def push(num)
+    # Добавить num после хвостового узла
+    node = ListNode.new(num)
+
+    # Если очередь пуста, сделать так, чтобы и head, и tail указывали на этот узел
+    if @front.nil?
+      @front = node
+      @rear = node
+    # Если очередь не пуста, добавить этот узел после хвостового узла
+    else
+      @rear.next = node
+      @rear = node
+    end
+
+    @size += 1
+  end
+
+  # ## Извлечение из очереди ###
+  def pop
+    num = peek
+    # Удалить головной узел
+    @front = @front.next
+    @size -= 1
+    num
+  end
+
+  # ## Доступ к элементу в начале очереди ###
+  def peek
+    raise IndexError, 'очередь пуста' if is_empty?
+
+    @front.val
+  end
+
+  # ## Преобразовать связный список в Array и вернуть ###
+  def to_array
+    queue = []
+    temp = @front
+    while temp
+      queue << temp.val
+      temp = temp.next
+    end
+    queue
+  end
+end
+
+### Driver Code ###
+if __FILE__ == $0
+  # Инициализация очереди
+  queue = LinkedListQueue.new
+
+  # Элемент помещается в очередь
+  queue.push(1)
+  queue.push(3)
+  queue.push(2)
+  queue.push(5)
+  queue.push(4)
+  puts "Очередь queue = #{queue.to_array}"
+
+  # Доступ к элементу в начале очереди
+  peek = queue.peek
+  puts "Первый элемент front = #{peek}"
+
+  # Извлечение элемента из очереди
+  pop_front = queue.pop
+  puts "Извлеченный элемент pop = #{pop_front}"
+  puts "queue после извлечения = #{queue.to_array}"
+
+  # Получение длины очереди
+  size = queue.size
+  puts "Длина очереди size = #{size}"
+
+  # Проверка, пуста ли очередь
+  is_empty = queue.is_empty?
+  puts "Пуста ли очередь = #{is_empty}"
+end

ru/codes/ruby/chapter_stack_and_queue/linkedlist_stack.rb

@@ -0,0 +1,87 @@
+=begin
+File: linkedlist_stack.rb
+Created Time: 2024-04-06
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+require_relative '../utils/list_node'
+
+# ## Стек на основе связного списка ###
+class LinkedListStack
+  attr_reader :size
+
+  # ## Конструктор ###
+  def initialize
+    @size = 0
+  end
+
+  # ## Проверка, пуст ли стек ###
+  def is_empty?
+    @peek.nil?
+  end
+
+  # ## Помещение в стек ###
+  def push(val)
+    node = ListNode.new(val)
+    node.next = @peek
+    @peek = node
+    @size += 1
+  end
+
+  # ## Извлечение из стека ###
+  def pop
+    num = peek
+    @peek = @peek.next
+    @size -= 1
+    num
+  end
+
+  # ## Доступ к верхнему элементу стека ###
+  def peek
+    raise IndexError, 'стек пуст' if is_empty?
+
+    @peek.val
+  end
+
+  # ## Преобразовать связный список в Array и вернуть ###
+  def to_array
+    arr = []
+    node = @peek
+    while node
+      arr << node.val
+      node = node.next
+    end
+    arr.reverse
+  end
+end
+
+### Driver Code ###
+if __FILE__ == $0
+  # Инициализация стека
+  stack = LinkedListStack.new
+
+  # Помещение элемента в стек
+  stack.push(1)
+  stack.push(3)
+  stack.push(2)
+  stack.push(5)
+  stack.push(4)
+  puts "Стек stack = #{stack.to_array}"
+
+  # Доступ к верхнему элементу стека
+  peek = stack.peek
+  puts "Верхний элемент peek = #{peek}"
+
+  # Извлечение элемента из стека
+  pop = stack.pop
+  puts "Извлеченный элемент pop = #{pop}"
+  puts "stack после извлечения = #{stack.to_array}"
+
+  # Получение длины стека
+  size = stack.size
+  puts "Длина стека size = #{size}"
+
+  # Проверка на пустоту
+  is_empty = stack.is_empty?
+  puts "Пуст ли стек = #{is_empty}"
+end

ru/codes/ruby/chapter_stack_and_queue/queue.rb

@@ -0,0 +1,38 @@
+=begin
+File: queue.rb
+Created Time: 2024-04-06
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### Driver Code ###
+if __FILE__ == $0
+  # Инициализировать очередь
+  # Во встроенной очереди Ruby (Thread::Queue) нет методов peek и обхода, поэтому Array можно использовать как очередь
+  queue = []
+
+  # Добавление элемента в очередь
+  queue.push(1)
+  queue.push(3)
+  queue.push(2)
+  queue.push(5)
+  queue.push(4)
+  puts "Очередь queue = #{queue}"
+
+  # Обратиться к элементу очереди
+  peek = queue.first
+  puts "Первый элемент peek = #{peek}"
+
+  # Элемент извлекается из очереди
+  # Обратите внимание: поскольку используется массив, временная сложность метода Array#shift равна O(n)
+  pop = queue.shift
+  puts "Извлеченный элемент pop = #{pop}"
+  puts "queue после извлечения = #{queue}"
+
+  # Получение длины очереди
+  size = queue.length
+  puts "Длина очереди size = #{size}"
+
+  # Проверка, пуста ли очередь
+  is_empty = queue.empty?
+  puts "Пуста ли очередь = #{is_empty}"
+end

ru/codes/ruby/chapter_stack_and_queue/stack.rb

@@ -0,0 +1,37 @@
+=begin
+File: stack.rb
+Created Time: 2024-04-06
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### Driver Code ###
+if __FILE__ == $0
+  # Инициализировать стек
+  # В Ruby нет встроенного класса стека, поэтому Array можно использовать как стек
+  stack = []
+
+  # Помещение элемента в стек
+  stack << 1
+  stack << 3
+  stack << 2
+  stack << 5
+  stack << 4
+  puts "Стек stack = #{stack}"
+
+  # Доступ к верхнему элементу стека
+  peek = stack.last
+  puts "Верхний элемент peek = #{peek}"
+
+  # Извлечение элемента из стека
+  pop = stack.pop
+  puts "Извлеченный элемент pop = #{pop}"
+  puts "stack после извлечения = #{stack}"
+
+  # Получение длины стека
+  size = stack.length
+  puts "Длина стека size = #{size}"
+
+  # Проверка на пустоту
+  is_empty = stack.empty?
+  puts "Пуст ли стек = #{is_empty}"
+end