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.swift
* Created Time: 2023-02-01
* Author: nuomi1 (nuomi1@qq.com)
*/
import utils
/* Класс неориентированного графа на основе списка смежности */
public class GraphAdjList {
// Список смежности, где key вершина, а value все смежные ей вершины
public private(set) var adjList: [Vertex: [Vertex]]
/* Конструктор */
public init(edges: [[Vertex]]) {
adjList = [:]
// Добавить все вершины и ребра
for edge in edges {
addVertex(vet: edge[0])
addVertex(vet: edge[1])
addEdge(vet1: edge[0], vet2: edge[1])
}
}
/* Получить число вершин */
public func size() -> Int {
adjList.count
}
/* Добавление ребра */
public func addEdge(vet1: Vertex, vet2: Vertex) {
if adjList[vet1] == nil || adjList[vet2] == nil || vet1 == vet2 {
fatalError("Неверный аргумент")
}
// Добавить ребро vet1 - vet2
adjList[vet1]?.append(vet2)
adjList[vet2]?.append(vet1)
}
/* Удаление ребра */
public func removeEdge(vet1: Vertex, vet2: Vertex) {
if adjList[vet1] == nil || adjList[vet2] == nil || vet1 == vet2 {
fatalError("Неверный аргумент")
}
// Удалить ребро vet1 - vet2
adjList[vet1]?.removeAll { $0 == vet2 }
adjList[vet2]?.removeAll { $0 == vet1 }
}
/* Добавление вершины */
public func addVertex(vet: Vertex) {
if adjList[vet] != nil {
return
}
// Добавить новый список в список смежности
adjList[vet] = []
}
/* Удаление вершины */
public func removeVertex(vet: Vertex) {
if adjList[vet] == nil {
fatalError("Неверный аргумент")
}
// Удалить из списка смежности список, соответствующий вершине vet
adjList.removeValue(forKey: vet)
// Обойти списки других вершин и удалить все ребра, содержащие vet
for key in adjList.keys {
adjList[key]?.removeAll { $0 == vet }
}
}
/* Вывести список смежности */
public func print() {
Swift.print("Список смежности =")
for (vertex, list) in adjList {
let list = list.map { $0.val }
Swift.print("\(vertex.val): \(list),")
}
}
}
#if !TARGET
@main
enum GraphAdjacencyList {
/* Driver Code */
static func main() {
/* Инициализация неориентированного графа */
let v = Vertex.valsToVets(vals: [1, 3, 2, 5, 4])
let edges = [[v[0], v[1]], [v[0], v[3]], [v[1], v[2]], [v[2], v[3]], [v[2], v[4]], [v[3], v[4]]]
let graph = GraphAdjList(edges: edges)
print("\nГраф после инициализации")
graph.print()
/* Добавление ребра */
// Вершины 1 и 2 соответствуют v[0] и v[2]
graph.addEdge(vet1: v[0], vet2: v[2])
print("\nГраф после добавления ребра 1-2")
graph.print()
/* Удаление ребра */
// Вершины 1 и 3 соответствуют v[0] и v[1]
graph.removeEdge(vet1: v[0], vet2: v[1])
print("\nГраф после удаления ребра 1-3")
graph.print()
/* Добавление вершины */
let v5 = Vertex(val: 6)
graph.addVertex(vet: v5)
print("\nГраф после добавления вершины 6")
graph.print()
/* Удаление вершины */
// Вершина 3 соответствует v[1]
graph.removeVertex(vet: v[1])
print("\nГраф после удаления вершины 3")
graph.print()
}
}
#endif
@@ -0,0 +1,121 @@
/**
* File: graph_adjacency_list.swift
* Created Time: 2023-02-01
* Author: nuomi1 (nuomi1@qq.com)
*/
import utils
/* Класс неориентированного графа на основе списка смежности */
public class GraphAdjList {
// Список смежности, где key вершина, а value все смежные ей вершины
public private(set) var adjList: [Vertex: [Vertex]]
/* Конструктор */
public init(edges: [[Vertex]]) {
adjList = [:]
// Добавить все вершины и ребра
for edge in edges {
addVertex(vet: edge[0])
addVertex(vet: edge[1])
addEdge(vet1: edge[0], vet2: edge[1])
}
}
/* Получить число вершин */
public func size() -> Int {
adjList.count
}
/* Добавление ребра */
public func addEdge(vet1: Vertex, vet2: Vertex) {
if adjList[vet1] == nil || adjList[vet2] == nil || vet1 == vet2 {
fatalError("Неверный аргумент")
}
// Добавить ребро vet1 - vet2
adjList[vet1]?.append(vet2)
adjList[vet2]?.append(vet1)
}
/* Удаление ребра */
public func removeEdge(vet1: Vertex, vet2: Vertex) {
if adjList[vet1] == nil || adjList[vet2] == nil || vet1 == vet2 {
fatalError("Неверный аргумент")
}
// Удалить ребро vet1 - vet2
adjList[vet1]?.removeAll { $0 == vet2 }
adjList[vet2]?.removeAll { $0 == vet1 }
}
/* Добавление вершины */
public func addVertex(vet: Vertex) {
if adjList[vet] != nil {
return
}
// Добавить новый список в список смежности
adjList[vet] = []
}
/* Удаление вершины */
public func removeVertex(vet: Vertex) {
if adjList[vet] == nil {
fatalError("Неверный аргумент")
}
// Удалить из списка смежности список, соответствующий вершине vet
adjList.removeValue(forKey: vet)
// Обойти списки других вершин и удалить все ребра, содержащие vet
for key in adjList.keys {
adjList[key]?.removeAll { $0 == vet }
}
}
/* Вывести список смежности */
public func print() {
Swift.print("Список смежности =")
for (vertex, list) in adjList {
let list = list.map { $0.val }
Swift.print("\(vertex.val): \(list),")
}
}
}
#if !TARGET
@main
enum GraphAdjacencyList {
/* Driver Code */
static func main() {
/* Инициализация неориентированного графа */
let v = Vertex.valsToVets(vals: [1, 3, 2, 5, 4])
let edges = [[v[0], v[1]], [v[0], v[3]], [v[1], v[2]], [v[2], v[3]], [v[2], v[4]], [v[3], v[4]]]
let graph = GraphAdjList(edges: edges)
print("\nГраф после инициализации")
graph.print()
/* Добавление ребра */
// Вершины 1 и 2 соответствуют v[0] и v[2]
graph.addEdge(vet1: v[0], vet2: v[2])
print("\nГраф после добавления ребра 1-2")
graph.print()
/* Удаление ребра */
// Вершины 1 и 3 соответствуют v[0] и v[1]
graph.removeEdge(vet1: v[0], vet2: v[1])
print("\nГраф после удаления ребра 1-3")
graph.print()
/* Добавление вершины */
let v5 = Vertex(val: 6)
graph.addVertex(vet: v5)
print("\nГраф после добавления вершины 6")
graph.print()
/* Удаление вершины */
// Вершина 3 соответствует v[1]
graph.removeVertex(vet: v[1])
print("\nГраф после удаления вершины 3")
graph.print()
}
}
#endif
@@ -0,0 +1,130 @@
/**
* File: graph_adjacency_matrix.swift
* Created Time: 2023-02-01
* Author: nuomi1 (nuomi1@qq.com)
*/
import utils
/* Класс неориентированного графа на основе матрицы смежности */
class GraphAdjMat {
private var vertices: [Int] // Список вершин: элементы представляют «значения вершин», а индексы «индексы вершин»
private var adjMat: [[Int]] // Матрица смежности, где индексы строк и столбцов соответствуют «индексам вершин»
/* Конструктор */
init(vertices: [Int], edges: [[Int]]) {
self.vertices = []
adjMat = []
// Добавление вершины
for val in vertices {
addVertex(val: val)
}
// Добавить ребра
// Обратите внимание: элементы edges представляют собой индексы вершин, то есть соответствуют индексам элементов vertices
for e in edges {
addEdge(i: e[0], j: e[1])
}
}
/* Получить число вершин */
func size() -> Int {
vertices.count
}
/* Добавление вершины */
func addVertex(val: Int) {
let n = size()
// Добавить значение новой вершины в список вершин
vertices.append(val)
// Добавить строку в матрицу смежности
let newRow = Array(repeating: 0, count: n)
adjMat.append(newRow)
// Добавить столбец в матрицу смежности
for i in adjMat.indices {
adjMat[i].append(0)
}
}
/* Удаление вершины */
func removeVertex(index: Int) {
if index >= size() {
fatalError("Выход за границы диапазона")
}
// Удалить вершину с индексом index из списка вершин
vertices.remove(at: index)
// Удалить строку с индексом index из матрицы смежности
adjMat.remove(at: index)
// Удалить столбец с индексом index из матрицы смежности
for i in adjMat.indices {
adjMat[i].remove(at: index)
}
}
/* Добавление ребра */
// Параметры i и j соответствуют индексам элементов vertices
func addEdge(i: Int, j: Int) {
// Обработка выхода индекса за границы и случая равенства
if i < 0 || j < 0 || i >= size() || j >= size() || i == j {
fatalError("Выход за границы диапазона")
}
// В неориентированном графе матрица смежности симметрична относительно главной диагонали, то есть выполняется (i, j) == (j, i)
adjMat[i][j] = 1
adjMat[j][i] = 1
}
/* Удаление ребра */
// Параметры i и j соответствуют индексам элементов vertices
func removeEdge(i: Int, j: Int) {
// Обработка выхода индекса за границы и случая равенства
if i < 0 || j < 0 || i >= size() || j >= size() || i == j {
fatalError("Выход за границы диапазона")
}
adjMat[i][j] = 0
adjMat[j][i] = 0
}
/* Вывести матрицу смежности */
func print() {
Swift.print("Список вершин = ", terminator: "")
Swift.print(vertices)
Swift.print("Матрица смежности =")
PrintUtil.printMatrix(matrix: adjMat)
}
}
@main
enum GraphAdjacencyMatrix {
/* Driver Code */
static func main() {
/* Инициализация неориентированного графа */
// Обратите внимание: элементы edges представляют индексы вершин, то есть соответствуют индексам элементов vertices
let vertices = [1, 3, 2, 5, 4]
let edges = [[0, 1], [1, 2], [2, 3], [0, 3], [2, 4], [3, 4]]
let graph = GraphAdjMat(vertices: vertices, edges: edges)
print("\nГраф после инициализации")
graph.print()
/* Добавление ребра */
// Индексы вершин 1 и 2 равны 0 и 2 соответственно
graph.addEdge(i: 0, j: 2)
print("\nГраф после добавления ребра 1-2")
graph.print()
/* Удаление ребра */
// Индексы вершин 1 и 3 равны 0 и 1 соответственно
graph.removeEdge(i: 0, j: 1)
print("\nГраф после удаления ребра 1-3")
graph.print()
/* Добавление вершины */
graph.addVertex(val: 6)
print("\nГраф после добавления вершины 6")
graph.print()
/* Удаление вершины */
// Индекс вершины 3 равен 1
graph.removeVertex(index: 1)
print("\nГраф после удаления вершины 3")
graph.print()
}
}
@@ -0,0 +1,56 @@
/**
* File: graph_bfs.swift
* Created Time: 2023-02-21
* Author: nuomi1 (nuomi1@qq.com)
*/
import graph_adjacency_list_target
import utils
/* Обход в ширину */
// Использовать список смежности для представления графа, чтобы получить все смежные вершины заданной вершины
func graphBFS(graph: GraphAdjList, startVet: Vertex) -> [Vertex] {
// Последовательность обхода вершин
var res: [Vertex] = []
// Хеш-множество для хранения уже посещенных вершин
var visited: Set<Vertex> = [startVet]
// Очередь используется для реализации BFS
var que: [Vertex] = [startVet]
// Начиная с вершины vet, продолжать цикл, пока не будут посещены все вершины
while !que.isEmpty {
let vet = que.removeFirst() // Извлечь головную вершину из очереди
res.append(vet) // Отметить посещенную вершину
// Обойти все смежные вершины данной вершины
for adjVet in graph.adjList[vet] ?? [] {
if visited.contains(adjVet) {
continue // Пропустить уже посещенную вершину
}
que.append(adjVet) // Помещать в очередь только непосещенные вершины
visited.insert(adjVet) // Отметить эту вершину как посещенную
}
}
// Вернуть последовательность обхода вершин
return res
}
@main
enum GraphBFS {
/* Driver Code */
static func main() {
/* Инициализация неориентированного графа */
let v = Vertex.valsToVets(vals: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9])
let edges = [
[v[0], v[1]], [v[0], v[3]], [v[1], v[2]], [v[1], v[4]],
[v[2], v[5]], [v[3], v[4]], [v[3], v[6]], [v[4], v[5]],
[v[4], v[7]], [v[5], v[8]], [v[6], v[7]], [v[7], v[8]],
]
let graph = GraphAdjList(edges: edges)
print("\nГраф после инициализации")
graph.print()
/* Обход в ширину */
let res = graphBFS(graph: graph, startVet: v[0])
print("\nПоследовательность вершин при обходе в ширину (BFS)")
print(Vertex.vetsToVals(vets: res))
}
}
@@ -0,0 +1,54 @@
/**
* File: graph_dfs.swift
* Created Time: 2023-02-21
* Author: nuomi1 (nuomi1@qq.com)
*/
import graph_adjacency_list_target
import utils
/* Вспомогательная функция обхода в глубину */
func dfs(graph: GraphAdjList, visited: inout Set<Vertex>, res: inout [Vertex], vet: Vertex) {
res.append(vet) // Отметить посещенную вершину
visited.insert(vet) // Отметить эту вершину как посещенную
// Обойти все смежные вершины данной вершины
for adjVet in graph.adjList[vet] ?? [] {
if visited.contains(adjVet) {
continue // Пропустить уже посещенную вершину
}
// Рекурсивно обходить смежные вершины
dfs(graph: graph, visited: &visited, res: &res, vet: adjVet)
}
}
/* Обход в глубину */
// Использовать список смежности для представления графа, чтобы получить все смежные вершины заданной вершины
func graphDFS(graph: GraphAdjList, startVet: Vertex) -> [Vertex] {
// Последовательность обхода вершин
var res: [Vertex] = []
// Хеш-множество для хранения уже посещенных вершин
var visited: Set<Vertex> = []
dfs(graph: graph, visited: &visited, res: &res, vet: startVet)
return res
}
@main
enum GraphDFS {
/* Driver Code */
static func main() {
/* Инициализация неориентированного графа */
let v = Vertex.valsToVets(vals: [0, 1, 2, 3, 4, 5, 6])
let edges = [
[v[0], v[1]], [v[0], v[3]], [v[1], v[2]],
[v[2], v[5]], [v[4], v[5]], [v[5], v[6]],
]
let graph = GraphAdjList(edges: edges)
print("\nГраф после инициализации")
graph.print()
/* Обход в глубину */
let res = graphDFS(graph: graph, startVet: v[0])
print("\nПоследовательность вершин при обходе в глубину (DFS)")
print(Vertex.vetsToVals(vets: res))
}
}