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,124 @@
/**
* File: graph_adjacency_list.dart
* Created Time: 2023-05-15
* Author: liuyuxin (gvenusleo@gmail.com)
*/
import '../utils/vertex.dart';
/* Класс неориентированного графа на основе списка смежности */
class GraphAdjList {
// Список смежности, где key — вершина, а value — все смежные ей вершины
Map<Vertex, List<Vertex>> adjList = {};
/* Конструктор */
GraphAdjList(List<List<Vertex>> edges) {
for (List<Vertex> edge in edges) {
addVertex(edge[0]);
addVertex(edge[1]);
addEdge(edge[0], edge[1]);
}
}
/* Получить число вершин */
int size() {
return adjList.length;
}
/* Добавление ребра */
void addEdge(Vertex vet1, Vertex vet2) {
if (!adjList.containsKey(vet1) ||
!adjList.containsKey(vet2) ||
vet1 == vet2) {
throw ArgumentError;
}
// Добавить ребро vet1 - vet2
adjList[vet1]!.add(vet2);
adjList[vet2]!.add(vet1);
}
/* Удаление ребра */
void removeEdge(Vertex vet1, Vertex vet2) {
if (!adjList.containsKey(vet1) ||
!adjList.containsKey(vet2) ||
vet1 == vet2) {
throw ArgumentError;
}
// Удалить ребро vet1 - vet2
adjList[vet1]!.remove(vet2);
adjList[vet2]!.remove(vet1);
}
/* Добавление вершины */
void addVertex(Vertex vet) {
if (adjList.containsKey(vet)) return;
// Добавить новый список в список смежности
adjList[vet] = [];
}
/* Удаление вершины */
void removeVertex(Vertex vet) {
if (!adjList.containsKey(vet)) {
throw ArgumentError;
}
// Удалить из списка смежности список, соответствующий вершине vet
adjList.remove(vet);
// Обойти списки других вершин и удалить все ребра, содержащие vet
adjList.forEach((key, value) {
value.remove(vet);
});
}
/* Вывести список смежности */
void printAdjList() {
print("Список смежности =");
adjList.forEach((key, value) {
List<int> tmp = [];
for (Vertex vertex in value) {
tmp.add(vertex.val);
}
print("${key.val}: $tmp,");
});
}
}
/* Driver Code */
void main() {
/* Инициализация неориентированного графа */
List<Vertex> v = Vertex.valsToVets([1, 3, 2, 5, 4]);
List<List<Vertex>> 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]],
];
GraphAdjList graph = GraphAdjList(edges);
print("\nГраф после инициализации");
graph.printAdjList();
/* Добавление ребра */
// Вершины 1 и 2 соответствуют v[0] и v[2]
graph.addEdge(v[0], v[2]);
print("\nГраф после добавления ребра 1-2");
graph.printAdjList();
/* Удаление ребра */
// Вершины 1 и 3 соответствуют v[0] и v[1]
graph.removeEdge(v[0], v[1]);
print("\nГраф после удаления ребра 1-3");
graph.printAdjList();
/* Добавление вершины */
Vertex v5 = Vertex(6);
graph.addVertex(v5);
print("\nГраф после добавления вершины 6");
graph.printAdjList();
/* Удаление вершины */
// Вершина 3 соответствует v[1]
graph.removeVertex(v[1]);
print("\nГраф после удаления вершины 3");
graph.printAdjList();
}
@@ -0,0 +1,133 @@
/**
* File: graph_adjacency_matrix.dart
* Created Time: 2023-05-15
* Author: liuyuxin (gvenusleo@gmail.com)
*/
import '../utils/print_util.dart';
/* Класс неориентированного графа на основе матрицы смежности */
class GraphAdjMat {
List<int> vertices = []; // Элемент вершины: элемент представляет «значение вершины», индекс представляет «индекс вершины»
List<List<int>> adjMat = []; // Матрица смежности, где индексы строк и столбцов соответствуют «индексам вершин»
/* Конструктор */
GraphAdjMat(List<int> vertices, List<List<int>> edges) {
this.vertices = [];
this.adjMat = [];
// Добавление вершины
for (int val in vertices) {
addVertex(val);
}
// Добавить ребра
// Обратите внимание: элементы edges представляют собой индексы вершин, то есть соответствуют индексам элементов vertices
for (List<int> e in edges) {
addEdge(e[0], e[1]);
}
}
/* Получить число вершин */
int size() {
return vertices.length;
}
/* Добавление вершины */
void addVertex(int val) {
int n = size();
// Добавить значение новой вершины в список вершин
vertices.add(val);
// Добавить строку в матрицу смежности
List<int> newRow = List.filled(n, 0, growable: true);
adjMat.add(newRow);
// Добавить столбец в матрицу смежности
for (List<int> row in adjMat) {
row.add(0);
}
}
/* Удаление вершины */
void removeVertex(int index) {
if (index >= size()) {
throw IndexError;
}
// Удалить вершину с индексом index из списка вершин
vertices.removeAt(index);
// Удалить строку с индексом index из матрицы смежности
adjMat.removeAt(index);
// Удалить столбец с индексом index из матрицы смежности
for (List<int> row in adjMat) {
row.removeAt(index);
}
}
/* Добавление ребра */
// Параметры i и j соответствуют индексам элементов vertices
void addEdge(int i, int j) {
// Обработка выхода индекса за границы и случая равенства
if (i < 0 || j < 0 || i >= size() || j >= size() || i == j) {
throw IndexError;
}
// В неориентированном графе матрица смежности симметрична относительно главной диагонали, то есть выполняется (i, j) == (j, i)
adjMat[i][j] = 1;
adjMat[j][i] = 1;
}
/* Удаление ребра */
// Параметры i и j соответствуют индексам элементов vertices
void removeEdge(int i, int j) {
// Обработка выхода индекса за границы и случая равенства
if (i < 0 || j < 0 || i >= size() || j >= size() || i == j) {
throw IndexError;
}
adjMat[i][j] = 0;
adjMat[j][i] = 0;
}
/* Вывести матрицу смежности */
void printAdjMat() {
print("Список вершин = $vertices");
print("Матрица смежности = ");
printMatrix(adjMat);
}
}
/* Driver Code */
void main() {
/* Инициализация неориентированного графа */
// Обратите внимание: элементы edges представляют индексы вершин, то есть соответствуют индексам элементов vertices
List<int> vertices = [1, 3, 2, 5, 4];
List<List<int>> edges = [
[0, 1],
[0, 3],
[1, 2],
[2, 3],
[2, 4],
[3, 4],
];
GraphAdjMat graph = GraphAdjMat(vertices, edges);
print("\nГраф после инициализации");
graph.printAdjMat();
/* Добавление ребра */
// Индексы вершин 1 и 2 равны 0 и 2 соответственно
graph.addEdge(0, 2);
print("\nГраф после добавления ребра 1-2");
graph.printAdjMat();
/* Удаление ребра */
// Индексы вершин 1 и 3 равны 0 и 1 соответственно
graph.removeEdge(0, 1);
print("\nГраф после удаления ребра 1-3");
graph.printAdjMat();
/* Добавление вершины */
graph.addVertex(6);
print("\nГраф после добавления вершины 6");
graph.printAdjMat();
/* Удаление вершины */
// Индекс вершины 3 равен 1
graph.removeVertex(1);
print("\nГраф после удаления вершины 3");
graph.printAdjMat();
}
@@ -0,0 +1,66 @@
/**
* File: graph_bfs.dart
* Created Time: 2023-05-15
* Author: liuyuxin (gvenusleo@gmail.com)
*/
import 'dart:collection';
import '../utils/vertex.dart';
import 'graph_adjacency_list.dart';
/* Обход в ширину */
List<Vertex> graphBFS(GraphAdjList graph, Vertex startVet) {
// Использовать список смежности для представления графа, чтобы получать все смежные вершины заданной вершины
// Последовательность обхода вершин
List<Vertex> res = [];
// Хеш-множество для хранения уже посещенных вершин
Set<Vertex> visited = {};
visited.add(startVet);
// Очередь используется для реализации BFS
Queue<Vertex> que = Queue();
que.add(startVet);
// Начиная с вершины vet, продолжать цикл, пока не будут посещены все вершины
while (que.isNotEmpty) {
Vertex vet = que.removeFirst(); // Извлечь головную вершину из очереди
res.add(vet); // Отметить посещенную вершину
// Обойти все смежные вершины данной вершины
for (Vertex adjVet in graph.adjList[vet]!) {
if (visited.contains(adjVet)) {
continue; // Пропустить уже посещенную вершину
}
que.add(adjVet); // Помещать в очередь только непосещенные вершины
visited.add(adjVet); // Отметить эту вершину как посещенную
}
}
// Вернуть последовательность обхода вершин
return res;
}
/* Dirver Code */
void main() {
/* Инициализация неориентированного графа */
List<Vertex> v = Vertex.valsToVets([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
List<List<Vertex>> 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]],
];
GraphAdjList graph = GraphAdjList(edges);
print("\nГраф после инициализации");
graph.printAdjList();
/* Обход в ширину */
List<Vertex> res = graphBFS(graph, v[0]);
print("\nПоследовательность вершин при обходе в ширину (BFS)");
print(Vertex.vetsToVals(res));
}
@@ -0,0 +1,59 @@
/**
* File: graph_dfs.dart
* Created Time: 2023-05-15
* Author: liuyuxin (gvenusleo@gmail.com)
*/
import '../utils/vertex.dart';
import 'graph_adjacency_list.dart';
/* Вспомогательная функция обхода в глубину */
void dfs(
GraphAdjList graph,
Set<Vertex> visited,
List<Vertex> res,
Vertex vet,
) {
res.add(vet); // Отметить посещенную вершину
visited.add(vet); // Отметить эту вершину как посещенную
// Обойти все смежные вершины данной вершины
for (Vertex adjVet in graph.adjList[vet]!) {
if (visited.contains(adjVet)) {
continue; // Пропустить уже посещенную вершину
}
// Рекурсивно обходить смежные вершины
dfs(graph, visited, res, adjVet);
}
}
/* Обход в глубину */
List<Vertex> graphDFS(GraphAdjList graph, Vertex startVet) {
// Последовательность обхода вершин
List<Vertex> res = [];
// Хеш-множество для хранения уже посещенных вершин
Set<Vertex> visited = {};
dfs(graph, visited, res, startVet);
return res;
}
/* Driver Code */
void main() {
/* Инициализация неориентированного графа */
List<Vertex> v = Vertex.valsToVets([0, 1, 2, 3, 4, 5, 6]);
List<List<Vertex>> 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]],
];
GraphAdjList graph = GraphAdjList(edges);
print("\nГраф после инициализации");
graph.printAdjList();
/* Обход в глубину */
List<Vertex> res = graphDFS(graph, v[0]);
print("\nПоследовательность вершин при обходе в глубину (DFS)");
print(Vertex.vetsToVals(res));
}