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,142 @@
/**
* File: graph_adjacency_list.js
* Created Time: 2023-02-09
* Author: Justin (xiefahit@gmail.com)
*/
const { Vertex } = require('../modules/Vertex');
/* Класс неориентированного графа на основе списка смежности */
class GraphAdjList {
// Список смежности, где key — вершина, а value — все смежные ей вершины
adjList;
/* Конструктор */
constructor(edges) {
this.adjList = new Map();
// Добавить все вершины и ребра
for (const edge of edges) {
this.addVertex(edge[0]);
this.addVertex(edge[1]);
this.addEdge(edge[0], edge[1]);
}
}
/* Получить число вершин */
size() {
return this.adjList.size;
}
/* Добавление ребра */
addEdge(vet1, vet2) {
if (
!this.adjList.has(vet1) ||
!this.adjList.has(vet2) ||
vet1 === vet2
) {
throw new Error('Illegal Argument Exception');
}
// Добавить ребро vet1 - vet2
this.adjList.get(vet1).push(vet2);
this.adjList.get(vet2).push(vet1);
}
/* Удаление ребра */
removeEdge(vet1, vet2) {
if (
!this.adjList.has(vet1) ||
!this.adjList.has(vet2) ||
vet1 === vet2 ||
this.adjList.get(vet1).indexOf(vet2) === -1
) {
throw new Error('Illegal Argument Exception');
}
// Удалить ребро vet1 - vet2
this.adjList.get(vet1).splice(this.adjList.get(vet1).indexOf(vet2), 1);
this.adjList.get(vet2).splice(this.adjList.get(vet2).indexOf(vet1), 1);
}
/* Добавление вершины */
addVertex(vet) {
if (this.adjList.has(vet)) return;
// Добавить новый список в список смежности
this.adjList.set(vet, []);
}
/* Удаление вершины */
removeVertex(vet) {
if (!this.adjList.has(vet)) {
throw new Error('Illegal Argument Exception');
}
// Удалить из списка смежности список, соответствующий вершине vet
this.adjList.delete(vet);
// Обойти списки других вершин и удалить все ребра, содержащие vet
for (const set of this.adjList.values()) {
const index = set.indexOf(vet);
if (index > -1) {
set.splice(index, 1);
}
}
}
/* Вывести список смежности */
print() {
console.log('Список смежности =');
for (const [key, value] of this.adjList) {
const tmp = [];
for (const vertex of value) {
tmp.push(vertex.val);
}
console.log(key.val + ': ' + tmp.join());
}
}
}
if (require.main === module) {
/* Driver Code */
/* Инициализация неориентированного графа */
const v0 = new Vertex(1),
v1 = new Vertex(3),
v2 = new Vertex(2),
v3 = new Vertex(5),
v4 = new Vertex(4);
const edges = [
[v0, v1],
[v1, v2],
[v2, v3],
[v0, v3],
[v2, v4],
[v3, v4],
];
const graph = new GraphAdjList(edges);
console.log('\nГраф после инициализации');
graph.print();
/* Добавление ребра */
// Вершины 1 и 2 соответствуют v0 и v2
graph.addEdge(v0, v2);
console.log('\nГраф после добавления ребра 1-2');
graph.print();
/* Удаление ребра */
// Вершины 1 и 3 соответствуют v0 и v1
graph.removeEdge(v0, v1);
console.log('\nГраф после удаления ребра 1-3');
graph.print();
/* Добавление вершины */
const v5 = new Vertex(6);
graph.addVertex(v5);
console.log('\nГраф после добавления вершины 6');
graph.print();
/* Удаление вершины */
// Вершина 3 соответствует v1
graph.removeVertex(v1);
console.log('\nГраф после удаления вершины 3');
graph.print();
}
module.exports = {
GraphAdjList,
};
@@ -0,0 +1,132 @@
/**
* File: graph_adjacency_matrix.js
* Created Time: 2023-02-09
* Author: Zhuo Qinyue (1403450829@qq.com)
*/
/* Класс неориентированного графа на основе матрицы смежности */
class GraphAdjMat {
vertices; // Список вершин: элементы представляют «значения вершин», а индексы — «индексы вершин»
adjMat; // Матрица смежности, где индексы строк и столбцов соответствуют «индексам вершин»
/* Конструктор */
constructor(vertices, edges) {
this.vertices = [];
this.adjMat = [];
// Добавление вершины
for (const val of vertices) {
this.addVertex(val);
}
// Добавить ребра
// Обратите внимание: элементы edges представляют собой индексы вершин, то есть соответствуют индексам элементов vertices
for (const e of edges) {
this.addEdge(e[0], e[1]);
}
}
/* Получить число вершин */
size() {
return this.vertices.length;
}
/* Добавление вершины */
addVertex(val) {
const n = this.size();
// Добавить значение новой вершины в список вершин
this.vertices.push(val);
// Добавить строку в матрицу смежности
const newRow = [];
for (let j = 0; j < n; j++) {
newRow.push(0);
}
this.adjMat.push(newRow);
// Добавить столбец в матрицу смежности
for (const row of this.adjMat) {
row.push(0);
}
}
/* Удаление вершины */
removeVertex(index) {
if (index >= this.size()) {
throw new RangeError('Index Out Of Bounds Exception');
}
// Удалить вершину с индексом index из списка вершин
this.vertices.splice(index, 1);
// Удалить строку с индексом index из матрицы смежности
this.adjMat.splice(index, 1);
// Удалить столбец с индексом index из матрицы смежности
for (const row of this.adjMat) {
row.splice(index, 1);
}
}
/* Добавление ребра */
// Параметры i и j соответствуют индексам элементов vertices
addEdge(i, j) {
// Обработка выхода индекса за границы и случая равенства
if (i < 0 || j < 0 || i >= this.size() || j >= this.size() || i === j) {
throw new RangeError('Index Out Of Bounds Exception');
}
// В неориентированном графе матрица смежности симметрична относительно главной диагонали, то есть выполняется (i, j) === (j, i)
this.adjMat[i][j] = 1;
this.adjMat[j][i] = 1;
}
/* Удаление ребра */
// Параметры i и j соответствуют индексам элементов vertices
removeEdge(i, j) {
// Обработка выхода индекса за границы и случая равенства
if (i < 0 || j < 0 || i >= this.size() || j >= this.size() || i === j) {
throw new RangeError('Index Out Of Bounds Exception');
}
this.adjMat[i][j] = 0;
this.adjMat[j][i] = 0;
}
/* Вывести матрицу смежности */
print() {
console.log('Список вершин = ', this.vertices);
console.log('Матрица смежности =', this.adjMat);
}
}
/* Driver Code */
/* Инициализация неориентированного графа */
// Обратите внимание: элементы edges представляют индексы вершин, то есть соответствуют индексам элементов vertices
const vertices = [1, 3, 2, 5, 4];
const edges = [
[0, 1],
[1, 2],
[2, 3],
[0, 3],
[2, 4],
[3, 4],
];
const graph = new GraphAdjMat(vertices, edges);
console.log('\nГраф после инициализации');
graph.print();
/* Добавление ребра */
// Индексы вершин 1 и 2 равны 0 и 2 соответственно
graph.addEdge(0, 2);
console.log('\nГраф после добавления ребра 1-2');
graph.print();
/* Удаление ребра */
// Индексы вершин 1 и 3 равны 0 и 1 соответственно
graph.removeEdge(0, 1);
console.log('\nГраф после удаления ребра 1-3');
graph.print();
/* Добавление вершины */
graph.addVertex(6);
console.log('\nГраф после добавления вершины 6');
graph.print();
/* Удаление вершины */
// Индекс вершины 3 равен 1
graph.removeVertex(1);
console.log('\nГраф после удаления вершины 3');
graph.print();
@@ -0,0 +1,61 @@
/**
* File: graph_bfs.js
* Created Time: 2023-02-21
* Author: Zhuo Qinyue (1403450829@qq.com)
*/
const { GraphAdjList } = require('./graph_adjacency_list');
const { Vertex } = require('../modules/Vertex');
/* Обход в ширину */
// Использовать список смежности для представления графа, чтобы получить все смежные вершины заданной вершины
function graphBFS(graph, startVet) {
// Последовательность обхода вершин
const res = [];
// Хеш-множество для хранения уже посещенных вершин
const visited = new Set();
visited.add(startVet);
// Очередь используется для реализации BFS
const que = [startVet];
// Начиная с вершины vet, продолжать цикл, пока не будут посещены все вершины
while (que.length) {
const vet = que.shift(); // Извлечь головную вершину из очереди
res.push(vet); // Отметить посещенную вершину
// Обойти все смежные вершины данной вершины
for (const adjVet of graph.adjList.get(vet) ?? []) {
if (visited.has(adjVet)) {
continue; // Пропустить уже посещенную вершину
}
que.push(adjVet); // Помещать в очередь только непосещенные вершины
visited.add(adjVet); // Отметить эту вершину как посещенную
}
}
// Вернуть последовательность обхода вершин
return res;
}
/* Driver Code */
/* Инициализация неориентированного графа */
const v = Vertex.valsToVets([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
const 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]],
];
const graph = new GraphAdjList(edges);
console.log('\nГраф после инициализации');
graph.print();
/* Обход в ширину */
const res = graphBFS(graph, v[0]);
console.log('\nПоследовательность вершин при обходе в ширину (BFS)');
console.log(Vertex.vetsToVals(res));
@@ -0,0 +1,54 @@
/**
* File: graph_dfs.js
* Created Time: 2023-02-21
* Author: Zhuo Qinyue (1403450829@qq.com)
*/
const { Vertex } = require('../modules/Vertex');
const { GraphAdjList } = require('./graph_adjacency_list');
/* Обход в глубину */
// Использовать список смежности для представления графа, чтобы получить все смежные вершины заданной вершины
function dfs(graph, visited, res, vet) {
res.push(vet); // Отметить посещенную вершину
visited.add(vet); // Отметить эту вершину как посещенную
// Обойти все смежные вершины данной вершины
for (const adjVet of graph.adjList.get(vet)) {
if (visited.has(adjVet)) {
continue; // Пропустить уже посещенную вершину
}
// Рекурсивно обходить смежные вершины
dfs(graph, visited, res, adjVet);
}
}
/* Обход в глубину */
// Использовать список смежности для представления графа, чтобы получить все смежные вершины заданной вершины
function graphDFS(graph, startVet) {
// Последовательность обхода вершин
const res = [];
// Хеш-множество для хранения уже посещенных вершин
const visited = new Set();
dfs(graph, visited, res, startVet);
return res;
}
/* Driver Code */
/* Инициализация неориентированного графа */
const v = Vertex.valsToVets([0, 1, 2, 3, 4, 5, 6]);
const 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]],
];
const graph = new GraphAdjList(edges);
console.log('\nГраф после инициализации');
graph.print();
/* Обход в глубину */
const res = graphDFS(graph, v[0]);
console.log('\nПоследовательность вершин при обходе в глубину (DFS)');
console.log(Vertex.vetsToVals(res));