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
This commit is contained in:
Yudong Jin
2026-03-28 04:24:07 +08:00
committed by GitHub
parent 2ca570cc33
commit 772183705e
1958 changed files with 108186 additions and 0 deletions
@@ -0,0 +1,121 @@
/**
* File: graph_adjacency_list.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_graph
import utils.Vertex
/* Класс неориентированного графа на основе списка смежности */
class GraphAdjList(edges: Array<Array<Vertex?>>) {
// Список смежности, где key — вершина, а value — все смежные ей вершины
val adjList = HashMap<Vertex, MutableList<Vertex>>()
/* Конструктор */
init {
// Добавить все вершины и ребра
for (edge in edges) {
addVertex(edge[0]!!)
addVertex(edge[1]!!)
addEdge(edge[0]!!, edge[1]!!)
}
}
/* Получить число вершин */
fun size(): Int {
return adjList.size
}
/* Добавление ребра */
fun addEdge(vet1: Vertex, vet2: Vertex) {
if (!adjList.containsKey(vet1) || !adjList.containsKey(vet2) || vet1 == vet2)
throw IllegalArgumentException()
// Добавить ребро vet1 - vet2
adjList[vet1]?.add(vet2)
adjList[vet2]?.add(vet1)
}
/* Удаление ребра */
fun removeEdge(vet1: Vertex, vet2: Vertex) {
if (!adjList.containsKey(vet1) || !adjList.containsKey(vet2) || vet1 == vet2)
throw IllegalArgumentException()
// Удалить ребро vet1 - vet2
adjList[vet1]?.remove(vet2)
adjList[vet2]?.remove(vet1)
}
/* Добавление вершины */
fun addVertex(vet: Vertex) {
if (adjList.containsKey(vet))
return
// Добавить новый список в список смежности
adjList[vet] = mutableListOf()
}
/* Удаление вершины */
fun removeVertex(vet: Vertex) {
if (!adjList.containsKey(vet))
throw IllegalArgumentException()
// Удалить из списка смежности список, соответствующий вершине vet
adjList.remove(vet)
// Обойти списки других вершин и удалить все ребра, содержащие vet
for (list in adjList.values) {
list.remove(vet)
}
}
/* Вывести список смежности */
fun print() {
println("Список смежности =")
for (pair in adjList.entries) {
val tmp = mutableListOf<Int>()
for (vertex in pair.value) {
tmp.add(vertex._val)
}
println("${pair.key._val}: $tmp,")
}
}
}
/* Driver Code */
fun main() {
/* Инициализация неориентированного графа */
val v = Vertex.valsToVets(intArrayOf(1, 3, 2, 5, 4))
val edges = arrayOf(
arrayOf(v[0], v[1]),
arrayOf(v[0], v[3]),
arrayOf(v[1], v[2]),
arrayOf(v[2], v[3]),
arrayOf(v[2], v[4]),
arrayOf(v[3], v[4])
)
val graph = GraphAdjList(edges)
println("\nГраф после инициализации")
graph.print()
/* Добавление ребра */
// Вершины 1 и 2 соответствуют v[0] и v[2]
graph.addEdge(v[0]!!, v[2]!!)
println("\nГраф после добавления ребра 1-2")
graph.print()
/* Удаление ребра */
// Вершины 1 и 3 соответствуют v[0] и v[1]
graph.removeEdge(v[0]!!, v[1]!!)
println("\nГраф после удаления ребра 1-3")
graph.print()
/* Добавление вершины */
val v5 = Vertex(6)
graph.addVertex(v5)
println("\nГраф после добавления вершины 6")
graph.print()
/* Удаление вершины */
// Вершина 3 соответствует v[1]
graph.removeVertex(v[1]!!)
println("\nГраф после удаления вершины 3")
graph.print()
}
@@ -0,0 +1,134 @@
/**
* File: graph_adjacency_matrix.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_graph
import utils.printMatrix
/* Класс неориентированного графа на основе матрицы смежности */
class GraphAdjMat(vertices: IntArray, edges: Array<IntArray>) {
val vertices = mutableListOf<Int>() // Список вершин: элементы представляют «значения вершин», а индексы — «индексы вершин»
val adjMat = mutableListOf<MutableList<Int>>() // Матрица смежности, где индексы строк и столбцов соответствуют «индексам вершин»
/* Конструктор */
init {
// Добавление вершины
for (vertex in vertices) {
addVertex(vertex)
}
// Добавить ребра
// Обратите внимание: элементы edges представляют собой индексы вершин, то есть соответствуют индексам элементов vertices
for (edge in edges) {
addEdge(edge[0], edge[1])
}
}
/* Получить число вершин */
fun size(): Int {
return vertices.size
}
/* Добавление вершины */
fun addVertex(_val: Int) {
val n = size()
// Добавить значение новой вершины в список вершин
vertices.add(_val)
// Добавить строку в матрицу смежности
val newRow = mutableListOf<Int>()
for (j in 0..<n) {
newRow.add(0)
}
adjMat.add(newRow)
// Добавить столбец в матрицу смежности
for (row in adjMat) {
row.add(0)
}
}
/* Удаление вершины */
fun removeVertex(index: Int) {
if (index >= size())
throw IndexOutOfBoundsException()
// Удалить вершину с индексом index из списка вершин
vertices.removeAt(index)
// Удалить строку с индексом index из матрицы смежности
adjMat.removeAt(index)
// Удалить столбец с индексом index из матрицы смежности
for (row in adjMat) {
row.removeAt(index)
}
}
/* Добавление ребра */
// Параметры i и j соответствуют индексам элементов vertices
fun addEdge(i: Int, j: Int) {
// Обработка выхода индекса за границы и случая равенства
if (i < 0 || j < 0 || i >= size() || j >= size() || i == j)
throw IndexOutOfBoundsException()
// В неориентированном графе матрица смежности симметрична относительно главной диагонали, то есть выполняется (i, j) == (j, i)
adjMat[i][j] = 1
adjMat[j][i] = 1
}
/* Удаление ребра */
// Параметры i и j соответствуют индексам элементов vertices
fun removeEdge(i: Int, j: Int) {
// Обработка выхода индекса за границы и случая равенства
if (i < 0 || j < 0 || i >= size() || j >= size() || i == j)
throw IndexOutOfBoundsException()
adjMat[i][j] = 0
adjMat[j][i] = 0
}
/* Вывести матрицу смежности */
fun print() {
print("Список вершин = ")
println(vertices)
println("Матрица смежности =")
printMatrix(adjMat)
}
}
/* Driver Code */
fun main() {
/* Инициализация неориентированного графа */
// Обратите внимание: элементы edges представляют индексы вершин, то есть соответствуют индексам элементов vertices
val vertices = intArrayOf(1, 3, 2, 5, 4)
val edges = arrayOf(
intArrayOf(0, 1),
intArrayOf(0, 3),
intArrayOf(1, 2),
intArrayOf(2, 3),
intArrayOf(2, 4),
intArrayOf(3, 4)
)
val graph = GraphAdjMat(vertices, edges)
println("\nГраф после инициализации")
graph.print()
/* Добавление ребра */
// Индексы вершин 1 и 2 равны 0 и 2 соответственно
graph.addEdge(0, 2)
println("\nГраф после добавления ребра 1-2")
graph.print()
/* Удаление ребра */
// Индексы вершин 1 и 3 равны 0 и 1 соответственно
graph.removeEdge(0, 1)
println("\nГраф после удаления ребра 1-3")
graph.print()
/* Добавление вершины */
graph.addVertex(6)
println("\nГраф после добавления вершины 6")
graph.print()
/* Удаление вершины */
// Индекс вершины 3 равен 1
graph.removeVertex(1)
println("\nГраф после удаления вершины 3")
graph.print()
}
@@ -0,0 +1,65 @@
/**
* File: graph_bfs.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_graph
import utils.Vertex
import java.util.*
/* Обход в ширину */
// Использовать список смежности для представления графа, чтобы получить все смежные вершины заданной вершины
fun graphBFS(graph: GraphAdjList, startVet: Vertex): MutableList<Vertex?> {
// Последовательность обхода вершин
val res = mutableListOf<Vertex?>()
// Хеш-множество для хранения уже посещенных вершин
val visited = HashSet<Vertex>()
visited.add(startVet)
// Очередь используется для реализации BFS
val que = LinkedList<Vertex>()
que.offer(startVet)
// Начиная с вершины vet, продолжать цикл, пока не будут посещены все вершины
while (!que.isEmpty()) {
val vet = que.poll() // Извлечь головную вершину из очереди
res.add(vet) // Отметить посещенную вершину
// Обойти все смежные вершины данной вершины
for (adjVet in graph.adjList[vet]!!) {
if (visited.contains(adjVet))
continue // Пропустить уже посещенную вершину
que.offer(adjVet) // Помещать в очередь только непосещенные вершины
visited.add(adjVet) // Отметить эту вершину как посещенную
}
}
// Вернуть последовательность обхода вершин
return res
}
/* Driver Code */
fun main() {
/* Инициализация неориентированного графа */
val v = Vertex.valsToVets(intArrayOf(0, 1, 2, 3, 4, 5, 6, 7, 8, 9))
val edges = arrayOf(
arrayOf(v[0], v[1]),
arrayOf(v[0], v[3]),
arrayOf(v[1], v[2]),
arrayOf(v[1], v[4]),
arrayOf(v[2], v[5]),
arrayOf(v[3], v[4]),
arrayOf(v[3], v[6]),
arrayOf(v[4], v[5]),
arrayOf(v[4], v[7]),
arrayOf(v[5], v[8]),
arrayOf(v[6], v[7]),
arrayOf(v[7], v[8])
)
val graph = GraphAdjList(edges)
println("\nГраф после инициализации")
graph.print()
/* Обход в ширину */
val res = graphBFS(graph, v[0]!!)
println("\nПоследовательность вершин при обходе в ширину (BFS)")
println(Vertex.vetsToVals(res))
}
@@ -0,0 +1,60 @@
/**
* File: graph_dfs.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_graph
import utils.Vertex
/* Вспомогательная функция обхода в глубину */
fun dfs(
graph: GraphAdjList,
visited: MutableSet<Vertex?>,
res: MutableList<Vertex?>,
vet: Vertex?
) {
res.add(vet) // Отметить посещенную вершину
visited.add(vet) // Отметить эту вершину как посещенную
// Обойти все смежные вершины данной вершины
for (adjVet in graph.adjList[vet]!!) {
if (visited.contains(adjVet))
continue // Пропустить уже посещенную вершину
// Рекурсивно обходить смежные вершины
dfs(graph, visited, res, adjVet)
}
}
/* Обход в глубину */
// Использовать список смежности для представления графа, чтобы получить все смежные вершины заданной вершины
fun graphDFS(graph: GraphAdjList, startVet: Vertex?): MutableList<Vertex?> {
// Последовательность обхода вершин
val res = mutableListOf<Vertex?>()
// Хеш-множество для хранения уже посещенных вершин
val visited = HashSet<Vertex?>()
dfs(graph, visited, res, startVet)
return res
}
/* Driver Code */
fun main() {
/* Инициализация неориентированного графа */
val v = Vertex.valsToVets(intArrayOf(0, 1, 2, 3, 4, 5, 6))
val edges = arrayOf(
arrayOf(v[0], v[1]),
arrayOf(v[0], v[3]),
arrayOf(v[1], v[2]),
arrayOf(v[2], v[5]),
arrayOf(v[4], v[5]),
arrayOf(v[5], v[6])
)
val graph = GraphAdjList(edges)
println("\nГраф после инициализации")
graph.print()
/* Обход в глубину */
val res = graphDFS(graph, v[0])
println("\nПоследовательность вершин при обходе в глубину (DFS)")
println(Vertex.vetsToVals(res))
}