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,122 @@
/**
* File: graph_adjacency_list.cs
* Created Time: 2023-02-06
* Author: zjkung1123 (zjkung1123@gmail.com)
*/
namespace hello_algo.chapter_graph;
/* Класс неориентированного графа на основе списка смежности */
public class GraphAdjList {
// Список смежности, где key — вершина, а value — все смежные ей вершины
public Dictionary<Vertex, List<Vertex>> adjList;
/* Конструктор */
public GraphAdjList(Vertex[][] edges) {
adjList = [];
// Добавить все вершины и ребра
foreach (Vertex[] edge in edges) {
AddVertex(edge[0]);
AddVertex(edge[1]);
AddEdge(edge[0], edge[1]);
}
}
/* Получить число вершин */
int Size() {
return adjList.Count;
}
/* Добавление ребра */
public void AddEdge(Vertex vet1, Vertex vet2) {
if (!adjList.ContainsKey(vet1) || !adjList.ContainsKey(vet2) || vet1 == vet2)
throw new InvalidOperationException();
// Добавить ребро vet1 - vet2
adjList[vet1].Add(vet2);
adjList[vet2].Add(vet1);
}
/* Удаление ребра */
public void RemoveEdge(Vertex vet1, Vertex vet2) {
if (!adjList.ContainsKey(vet1) || !adjList.ContainsKey(vet2) || vet1 == vet2)
throw new InvalidOperationException();
// Удалить ребро vet1 - vet2
adjList[vet1].Remove(vet2);
adjList[vet2].Remove(vet1);
}
/* Добавление вершины */
public void AddVertex(Vertex vet) {
if (adjList.ContainsKey(vet))
return;
// Добавить новый список в список смежности
adjList.Add(vet, []);
}
/* Удаление вершины */
public void RemoveVertex(Vertex vet) {
if (!adjList.ContainsKey(vet))
throw new InvalidOperationException();
// Удалить из списка смежности список, соответствующий вершине vet
adjList.Remove(vet);
// Обойти списки других вершин и удалить все ребра, содержащие vet
foreach (List<Vertex> list in adjList.Values) {
list.Remove(vet);
}
}
/* Вывести список смежности */
public void Print() {
Console.WriteLine("Список смежности =");
foreach (KeyValuePair<Vertex, List<Vertex>> pair in adjList) {
List<int> tmp = [];
foreach (Vertex vertex in pair.Value)
tmp.Add(vertex.val);
Console.WriteLine(pair.Key.val + ": [" + string.Join(", ", tmp) + "],");
}
}
}
public class graph_adjacency_list {
[Test]
public void Test() {
/* Инициализация неориентированного графа */
Vertex[] v = Vertex.ValsToVets([1, 3, 2, 5, 4]);
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 = new(edges);
Console.WriteLine("\nГраф после инициализации");
graph.Print();
/* Добавление ребра */
// Вершины 1 и 2 соответствуют v[0] и v[2]
graph.AddEdge(v[0], v[2]);
Console.WriteLine("\nГраф после добавления ребра 1-2");
graph.Print();
/* Удаление ребра */
// Вершины 1 и 3 соответствуют v[0] и v[1]
graph.RemoveEdge(v[0], v[1]);
Console.WriteLine("\nГраф после удаления ребра 1-3");
graph.Print();
/* Добавление вершины */
Vertex v5 = new(6);
graph.AddVertex(v5);
Console.WriteLine("\nГраф после добавления вершины 6");
graph.Print();
/* Удаление вершины */
// Вершина 3 соответствует v[1]
graph.RemoveVertex(v[1]);
Console.WriteLine("\nГраф после удаления вершины 3");
graph.Print();
}
}
@@ -0,0 +1,137 @@
/**
* File: graph_adjacency_matrix.cs
* Created Time: 2023-02-06
* Author: zjkung1123 (zjkung1123@gmail.com)
*/
namespace hello_algo.chapter_graph;
/* Класс неориентированного графа на основе матрицы смежности */
class GraphAdjMat {
List<int> vertices; // Список вершин: элементы представляют «значения вершин», а индексы — «индексы вершин»
List<List<int>> adjMat; // Матрица смежности, где индексы строк и столбцов соответствуют «индексам вершин»
/* Конструктор */
public GraphAdjMat(int[] vertices, int[][] edges) {
this.vertices = [];
this.adjMat = [];
// Добавление вершины
foreach (int val in vertices) {
AddVertex(val);
}
// Добавить ребра
// Обратите внимание: элементы edges представляют собой индексы вершин, то есть соответствуют индексам элементов vertices
foreach (int[] e in edges) {
AddEdge(e[0], e[1]);
}
}
/* Получить число вершин */
int Size() {
return vertices.Count;
}
/* Добавление вершины */
public void AddVertex(int val) {
int n = Size();
// Добавить значение новой вершины в список вершин
vertices.Add(val);
// Добавить строку в матрицу смежности
List<int> newRow = new(n);
for (int j = 0; j < n; j++) {
newRow.Add(0);
}
adjMat.Add(newRow);
// Добавить столбец в матрицу смежности
foreach (List<int> row in adjMat) {
row.Add(0);
}
}
/* Удаление вершины */
public void RemoveVertex(int index) {
if (index >= Size())
throw new IndexOutOfRangeException();
// Удалить вершину с индексом index из списка вершин
vertices.RemoveAt(index);
// Удалить строку с индексом index из матрицы смежности
adjMat.RemoveAt(index);
// Удалить столбец с индексом index из матрицы смежности
foreach (List<int> row in adjMat) {
row.RemoveAt(index);
}
}
/* Добавление ребра */
// Параметры i и j соответствуют индексам элементов vertices
public void AddEdge(int i, int j) {
// Обработка выхода индекса за границы и случая равенства
if (i < 0 || j < 0 || i >= Size() || j >= Size() || i == j)
throw new IndexOutOfRangeException();
// В неориентированном графе матрица смежности симметрична относительно главной диагонали, то есть выполняется (i, j) == (j, i)
adjMat[i][j] = 1;
adjMat[j][i] = 1;
}
/* Удаление ребра */
// Параметры i и j соответствуют индексам элементов vertices
public void RemoveEdge(int i, int j) {
// Обработка выхода индекса за границы и случая равенства
if (i < 0 || j < 0 || i >= Size() || j >= Size() || i == j)
throw new IndexOutOfRangeException();
adjMat[i][j] = 0;
adjMat[j][i] = 0;
}
/* Вывести матрицу смежности */
public void Print() {
Console.Write("Список вершин = ");
PrintUtil.PrintList(vertices);
Console.WriteLine("Матрица смежности =");
PrintUtil.PrintMatrix(adjMat);
}
}
public class graph_adjacency_matrix {
[Test]
public void Test() {
/* Инициализация неориентированного графа */
// Обратите внимание: элементы edges представляют индексы вершин, то есть соответствуют индексам элементов vertices
int[] vertices = [1, 3, 2, 5, 4];
int[][] edges =
[
[0, 1],
[0, 3],
[1, 2],
[2, 3],
[2, 4],
[3, 4]
];
GraphAdjMat graph = new(vertices, edges);
Console.WriteLine("\nГраф после инициализации");
graph.Print();
/* Добавление ребра */
// Индексы вершин 1 и 2 равны 0 и 2 соответственно
graph.AddEdge(0, 2);
Console.WriteLine("\nГраф после добавления ребра 1-2");
graph.Print();
/* Удаление ребра */
// Индексы вершин 1 и 3 равны 0 и 1 соответственно
graph.RemoveEdge(0, 1);
Console.WriteLine("\nГраф после удаления ребра 1-3");
graph.Print();
/* Добавление вершины */
graph.AddVertex(6);
Console.WriteLine("\nГраф после добавления вершины 6");
graph.Print();
/* Удаление вершины */
// Индекс вершины 3 равен 1
graph.RemoveVertex(1);
Console.WriteLine("\nГраф после удаления вершины 3");
graph.Print();
}
}
@@ -0,0 +1,58 @@
/**
* File: graph_bfs.cs
* Created Time: 2023-03-08
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_graph;
public class graph_bfs {
/* Обход в ширину */
// Использовать список смежности для представления графа, чтобы получить все смежные вершины заданной вершины
List<Vertex> GraphBFS(GraphAdjList graph, Vertex startVet) {
// Последовательность обхода вершин
List<Vertex> res = [];
// Хеш-множество для хранения уже посещенных вершин
HashSet<Vertex> visited = [startVet];
// Очередь используется для реализации BFS
Queue<Vertex> que = new();
que.Enqueue(startVet);
// Начиная с вершины vet, продолжать цикл, пока не будут посещены все вершины
while (que.Count > 0) {
Vertex vet = que.Dequeue(); // Извлечь головную вершину из очереди
res.Add(vet); // Отметить посещенную вершину
foreach (Vertex adjVet in graph.adjList[vet]) {
if (visited.Contains(adjVet)) {
continue; // Пропустить уже посещенную вершину
}
que.Enqueue(adjVet); // Помещать в очередь только непосещенные вершины
visited.Add(adjVet); // Отметить эту вершину как посещенную
}
}
// Вернуть последовательность обхода вершин
return res;
}
[Test]
public void Test() {
/* Инициализация неориентированного графа */
Vertex[] v = Vertex.ValsToVets([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
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 = new(edges);
Console.WriteLine("\nГраф после инициализации");
graph.Print();
/* Обход в ширину */
List<Vertex> res = GraphBFS(graph, v[0]);
Console.WriteLine("\nПоследовательность вершин при обходе в ширину (BFS)");
Console.WriteLine(string.Join(" ", Vertex.VetsToVals(res)));
}
}
@@ -0,0 +1,54 @@
/**
* File: graph_dfs.cs
* Created Time: 2023-03-08
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_graph;
public class graph_dfs {
/* Вспомогательная функция обхода в глубину */
void DFS(GraphAdjList graph, HashSet<Vertex> visited, List<Vertex> res, Vertex vet) {
res.Add(vet); // Отметить посещенную вершину
visited.Add(vet); // Отметить эту вершину как посещенную
// Обойти все смежные вершины данной вершины
foreach (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 = [];
// Хеш-множество для хранения уже посещенных вершин
HashSet<Vertex> visited = [];
DFS(graph, visited, res, startVet);
return res;
}
[Test]
public void Test() {
/* Инициализация неориентированного графа */
Vertex[] v = Vertex.ValsToVets([0, 1, 2, 3, 4, 5, 6]);
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 = new(edges);
Console.WriteLine("\nГраф после инициализации");
graph.Print();
/* Обход в глубину */
List<Vertex> res = GraphDFS(graph, v[0]);
Console.WriteLine("\nПоследовательность вершин при обходе в глубину (DFS)");
Console.WriteLine(string.Join(" ", Vertex.VetsToVals(res)));
}
}