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/go/chapter_searching/binary_search.go

@@ -0,0 +1,43 @@
+// File: binary_search.go
+// Created Time: 2022-12-05
+// Author: Slone123c (274325721@qq.com)
+
+package chapter_searching
+
+/* Бинарный поиск (двусторонне замкнутый интервал) */
+func binarySearch(nums []int, target int) int {
+	// Инициализировать двусторонне замкнутый интервал [0, n-1], то есть i и j указывают на первый и последний элементы массива соответственно
+	i, j := 0, len(nums)-1
+	// Цикл завершается, когда диапазон поиска пуст (при i > j диапазон пуст)
+	for i <= j {
+		m := i + (j-i)/2      // Вычислить индекс середины m
+		if nums[m] < target { // Это означает, что target находится в интервале [m+1, j]
+			i = m + 1
+		} else if nums[m] > target { // Это означает, что target находится в интервале [i, m-1]
+			j = m - 1
+		} else { // Целевой элемент найден, вернуть его индекс
+			return m
+		}
+	}
+	// Целевой элемент не найден, вернуть -1
+	return -1
+}
+
+/* Бинарный поиск (лево замкнутый, право открытый интервал) */
+func binarySearchLCRO(nums []int, target int) int {
+	// Инициализировать лево замкнутый, право открытый интервал [0, n), то есть i и j указывают на первый элемент массива и позицию сразу за последним элементом соответственно
+	i, j := 0, len(nums)
+	// Цикл завершается, когда диапазон поиска пуст (при i = j диапазон пуст)
+	for i < j {
+		m := i + (j-i)/2      // Вычислить индекс середины m
+		if nums[m] < target { // Это означает, что target находится в интервале [m+1, j)
+			i = m + 1
+		} else if nums[m] > target { // Это означает, что target находится в интервале [i, m)
+			j = m
+		} else { // Целевой элемент найден, вернуть его индекс
+			return m
+		}
+	}
+	// Целевой элемент не найден, вернуть -1
+	return -1
+}

ru/codes/go/chapter_searching/binary_search_edge.go

@@ -0,0 +1,31 @@
+// File: binary_search_edge.go
+// Created Time: 2023-08-23
+// Author: Reanon (793584285@qq.com)
+
+package chapter_searching
+
+/* Бинарный поиск самого левого target */
+func binarySearchLeftEdge(nums []int, target int) int {
+	// Эквивалентно поиску точки вставки target
+	i := binarySearchInsertion(nums, target)
+	// target не найден, вернуть -1
+	if i == len(nums) || nums[i] != target {
+		return -1
+	}
+	// Найти target и вернуть индекс i
+	return i
+}
+
+/* Бинарный поиск самого правого target */
+func binarySearchRightEdge(nums []int, target int) int {
+	// Преобразовать задачу в поиск самого левого target + 1
+	i := binarySearchInsertion(nums, target+1)
+	// j указывает на самый правый target, а i — на первый элемент больше target
+	j := i - 1
+	// target не найден, вернуть -1
+	if j == -1 || nums[j] != target {
+		return -1
+	}
+	// Найти target и вернуть индекс j
+	return j
+}

ru/codes/go/chapter_searching/binary_search_insertion.go

@@ -0,0 +1,49 @@
+// File: binary_search_insertion.go
+// Created Time: 2023-08-23
+// Author: Reanon (793584285@qq.com)
+
+package chapter_searching
+
+/* Бинарный поиск точки вставки (без повторяющихся элементов) */
+func binarySearchInsertionSimple(nums []int, target int) int {
+	// Инициализировать двусторонне замкнутый интервал [0, n-1]
+	i, j := 0, len(nums)-1
+	for i <= j {
+		// Вычислить индекс середины m
+		m := i + (j-i)/2
+		if nums[m] < target {
+			// target находится в интервале [m+1, j]
+			i = m + 1
+		} else if nums[m] > target {
+			// target находится в интервале [i, m-1]
+			j = m - 1
+		} else {
+			// Найти target и вернуть точку вставки m
+			return m
+		}
+	}
+	// target не найден, вернуть точку вставки i
+	return i
+}
+
+/* Бинарный поиск точки вставки (с повторяющимися элементами) */
+func binarySearchInsertion(nums []int, target int) int {
+	// Инициализировать двусторонне замкнутый интервал [0, n-1]
+	i, j := 0, len(nums)-1
+	for i <= j {
+		// Вычислить индекс середины m
+		m := i + (j-i)/2
+		if nums[m] < target {
+			// target находится в интервале [m+1, j]
+			i = m + 1
+		} else if nums[m] > target {
+			// target находится в интервале [i, m-1]
+			j = m - 1
+		} else {
+			// Первый элемент меньше target находится в интервале [i, m-1]
+			j = m - 1
+		}
+	}
+	// Вернуть точку вставки i
+	return i
+}

ru/codes/go/chapter_searching/binary_search_test.go

@@ -0,0 +1,61 @@
+// File: binary_search_test.go
+// Created Time: 2022-12-05
+// Author: Slone123c (274325721@qq.com)
+
+package chapter_searching
+
+import (
+	"fmt"
+	"testing"
+)
+
+func TestBinarySearch(t *testing.T) {
+	var (
+		target   = 6
+		nums     = []int{1, 3, 6, 8, 12, 15, 23, 26, 31, 35}
+		expected = 2
+	)
+	// Выполнить бинарный поиск в массиве
+	actual := binarySearch(nums, target)
+	fmt.Println("Индекс целевого элемента 6 =", actual)
+	if actual != expected {
+		t.Errorf("Индекс целевого элемента 6 = %d, должно быть %d", actual, expected)
+	}
+}
+
+func TestBinarySearchEdge(t *testing.T) {
+	// Массив с повторяющимися элементами
+	nums := []int{1, 3, 6, 8, 12, 15, 23, 26, 31, 35}
+	fmt.Println("\nМассив nums =", nums)
+
+	// Бинарный поиск левой и правой границы
+	for _, target := range []int{6, 7} {
+		index := binarySearchLeftEdge(nums, target)
+		fmt.Println("Индекс самого левого элемента", target, "равен", index)
+
+		index = binarySearchRightEdge(nums, target)
+		fmt.Println("Индекс самого правого элемента", target, "равен", index)
+	}
+}
+
+func TestBinarySearchInsertion(t *testing.T) {
+	// Массив без повторяющихся элементов
+	nums := []int{1, 3, 6, 8, 12, 15, 23, 26, 31, 35}
+	fmt.Println("Массив nums =", nums)
+
+	// Бинарный поиск точки вставки
+	for _, target := range []int{6, 9} {
+		index := binarySearchInsertionSimple(nums, target)
+		fmt.Println("Индекс позиции вставки элемента", target, "равен", index)
+	}
+
+	// Массив с повторяющимися элементами
+	nums = []int{1, 3, 6, 6, 6, 6, 6, 10, 12, 15}
+	fmt.Println("\nМассив nums =", nums)
+
+	// Бинарный поиск точки вставки
+	for _, target := range []int{2, 6, 20} {
+		index := binarySearchInsertion(nums, target)
+		fmt.Println("Индекс позиции вставки элемента", target, "равен", index)
+	}
+}

ru/codes/go/chapter_searching/hashing_search.go

@@ -0,0 +1,29 @@
+// File: hashing_search.go
+// Created Time: 2022-12-12
+// Author: Slone123c (274325721@qq.com)
+
+package chapter_searching
+
+import . "github.com/krahets/hello-algo/pkg"
+
+/* Хеш-поиск (массив) */
+func hashingSearchArray(m map[int]int, target int) int {
+	// key хеш-таблицы: целевой элемент, value: индекс
+	// Если такого key нет в хеш-таблице, вернуть -1
+	if index, ok := m[target]; ok {
+		return index
+	} else {
+		return -1
+	}
+}
+
+/* Хеш-поиск (связный список) */
+func hashingSearchLinkedList(m map[int]*ListNode, target int) *ListNode {
+	// key хеш-таблицы: значение целевого узла, value: объект узла
+	// Если такого key нет в хеш-таблице, вернуть nil
+	if node, ok := m[target]; ok {
+		return node
+	} else {
+		return nil
+	}
+}

ru/codes/go/chapter_searching/hashing_search_test.go

@@ -0,0 +1,36 @@
+// File: hashing_search_test.go
+// Created Time: 2022-12-12
+// Author: Slone123c (274325721@qq.com)
+
+package chapter_searching
+
+import (
+	"fmt"
+	"testing"
+
+	. "github.com/krahets/hello-algo/pkg"
+)
+
+func TestHashingSearch(t *testing.T) {
+	target := 3
+	/* Хеш-поиск (массив) */
+	nums := []int{1, 5, 3, 2, 4, 7, 5, 9, 10, 8}
+	// Инициализация хеш-таблицы
+	m := make(map[int]int)
+	for i := 0; i < len(nums); i++ {
+		m[nums[i]] = i
+	}
+	index := hashingSearchArray(m, target)
+	fmt.Println("Индекс целевого элемента 3 = ", index)
+
+	/* Хеш-поиск (связный список) */
+	head := ArrayToLinkedList(nums)
+	// Инициализация хеш-таблицы
+	m1 := make(map[int]*ListNode)
+	for head != nil {
+		m1[head.Val] = head
+		head = head.Next
+	}
+	node := hashingSearchLinkedList(m1, target)
+	fmt.Println("Объект узла со значением 3 =", node)
+}

ru/codes/go/chapter_searching/linear_search.go

@@ -0,0 +1,36 @@
+// File: linear_search.go
+// Created Time: 2022-11-25
+// Author: Reanon (793584285@qq.com)
+
+package chapter_searching
+
+import (
+	. "github.com/krahets/hello-algo/pkg"
+)
+
+/* Линейный поиск (массив) */
+func linearSearchArray(nums []int, target int) int {
+	// Обход массива
+	for i := 0; i < len(nums); i++ {
+		// Целевой элемент найден, вернуть его индекс
+		if nums[i] == target {
+			return i
+		}
+	}
+	// Целевой элемент не найден, вернуть -1
+	return -1
+}
+
+/* Линейный поиск (связный список) */
+func linearSearchLinkedList(node *ListNode, target int) *ListNode {
+	// Обойти связный список
+	for node != nil {
+		// Найти целевой узел и вернуть его
+		if node.Val == target {
+			return node
+		}
+		node = node.Next
+	}
+	// Целевой элемент не найден, вернуть nil
+	return nil
+}

ru/codes/go/chapter_searching/linear_search_test.go

@@ -0,0 +1,26 @@
+// File: linear_search_test.go
+// Created Time: 2022-11-25
+// Author: Reanon (793584285@qq.com)
+
+package chapter_searching
+
+import (
+	"fmt"
+	"testing"
+
+	. "github.com/krahets/hello-algo/pkg"
+)
+
+func TestLinearSearch(t *testing.T) {
+	target := 3
+	nums := []int{1, 5, 3, 2, 4, 7, 5, 9, 10, 8}
+
+	// Выполнить линейный поиск в массиве
+	index := linearSearchArray(nums, target)
+	fmt.Println("Индекс целевого элемента 3 =", index)
+
+	// Выполнить линейный поиск в связном списке
+	head := ArrayToLinkedList(nums)
+	node := linearSearchLinkedList(head, target)
+	fmt.Println("Объект узла со значением 3 =", node)
+}

ru/codes/go/chapter_searching/two_sum.go

@@ -0,0 +1,33 @@
+// File: two_sum.go
+// Created Time: 2022-11-25
+// Author: reanon (793584285@qq.com)
+
+package chapter_searching
+
+/* Метод 1: полный перебор */
+func twoSumBruteForce(nums []int, target int) []int {
+	size := len(nums)
+	// Два вложенных цикла, временная сложность O(n^2)
+	for i := 0; i < size-1; i++ {
+		for j := i + 1; j < size; j++ {
+			if nums[i]+nums[j] == target {
+				return []int{i, j}
+			}
+		}
+	}
+	return nil
+}
+
+/* Метод 2: вспомогательная хеш-таблица */
+func twoSumHashTable(nums []int, target int) []int {
+	// Вспомогательная хеш-таблица, пространственная сложность O(n)
+	hashTable := map[int]int{}
+	// Один цикл, временная сложность O(n)
+	for idx, val := range nums {
+		if preIdx, ok := hashTable[target-val]; ok {
+			return []int{preIdx, idx}
+		}
+		hashTable[val] = idx
+	}
+	return nil
+}

ru/codes/go/chapter_searching/two_sum_test.go

@@ -0,0 +1,24 @@
+// File: two_sum_test.go
+// Created Time: 2022-11-25
+// Author: reanon (793584285@qq.com)
+
+package chapter_searching
+
+import (
+	"fmt"
+	"testing"
+)
+
+func TestTwoSum(t *testing.T) {
+	// ======= Test Case =======
+	nums := []int{2, 7, 11, 15}
+	target := 13
+
+	// ====== Основной код ======
+	// Метод 1: решение полным перебором
+	res := twoSumBruteForce(nums, target)
+	fmt.Println("Результат метода 1 res =", res)
+	// Способ 2: хеш-таблица
+	res = twoSumHashTable(nums, target)
+	fmt.Println("Результат метода 2 res =", res)
+}