feat(ko): add the Korean online edition (#2006)

* feat(ko): add the complete Korean online edition

* Use UTF-8 for Python CI output on Windows

* Remove print-book promotion from the Korean site

* fix(ko): preserve emphasis before Korean particles
This commit is contained in:
Yudong Jin
2026-10-29 03:46:43 +08:00
committed by GitHub
parent 71a773df64
commit 2f561d3d51
2072 changed files with 110884 additions and 102 deletions
@@ -0,0 +1,111 @@
"""
File: graph_adjacency_list.py
Created Time: 2023-02-23
Author: krahets ([email protected])
"""
import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent.parent))
from modules import Vertex, vals_to_vets
class GraphAdjList:
"""인접 리스트로 구현한 무방향 그래프 클래스"""
def __init__(self, edges: list[list[Vertex]]):
"""생성자"""
# 인접 리스트의 key: 정점, value: 해당 정점의 모든 인접 정점
self.adj_list = dict[Vertex, list[Vertex]]()
# 모든 정점과 간선을 추가한다
for edge in edges:
self.add_vertex(edge[0])
self.add_vertex(edge[1])
self.add_edge(edge[0], edge[1])
def size(self) -> int:
"""정점 개수 반환"""
return len(self.adj_list)
def add_edge(self, vet1: Vertex, vet2: Vertex):
"""간선 추가"""
if vet1 not in self.adj_list or vet2 not in self.adj_list or vet1 == vet2:
raise ValueError()
# 간선 vet1 - vet2를 추가한다
self.adj_list[vet1].append(vet2)
self.adj_list[vet2].append(vet1)
def remove_edge(self, vet1: Vertex, vet2: Vertex):
"""간선 삭제"""
if vet1 not in self.adj_list or vet2 not in self.adj_list or vet1 == vet2:
raise ValueError()
# 간선 vet1 - vet2를 삭제한다
self.adj_list[vet1].remove(vet2)
self.adj_list[vet2].remove(vet1)
def add_vertex(self, vet: Vertex):
"""정점 추가"""
if vet in self.adj_list:
return
# 인접 리스트에 새 연결 리스트를 추가한다
self.adj_list[vet] = []
def remove_vertex(self, vet: Vertex):
"""정점 삭제"""
if vet not in self.adj_list:
raise ValueError()
# 인접 리스트에서 정점 vet에 해당하는 연결 리스트를 삭제한다
self.adj_list.pop(vet)
# 다른 정점의 연결 리스트를 순회하여 vet를 포함하는 모든 간선을 삭제한다
for vertex in self.adj_list:
if vet in self.adj_list[vertex]:
self.adj_list[vertex].remove(vet)
def print(self):
"""인접 리스트 출력"""
print("인접 리스트 =")
for vertex in self.adj_list:
tmp = [v.val for v in self.adj_list[vertex]]
print(f"{vertex.val}: {tmp},")
"""실행 코드"""
if __name__ == "__main__":
# 무방향 그래프 초기화
v = vals_to_vets([1, 3, 2, 5, 4])
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]],
]
graph = GraphAdjList(edges)
print("\n초기화한 후의 그래프")
graph.print()
# 간선 추가
# 정점 1, 2는 각각 v[0], v[2]이다
graph.add_edge(v[0], v[2])
print("\n간선 1-2를 추가한 후의 그래프")
graph.print()
# 간선 삭제
# 정점 1, 3은 각각 v[0], v[1]이다
graph.remove_edge(v[0], v[1])
print("\n간선 1-3을 삭제한 후의 그래프")
graph.print()
# 정점 추가
v5 = Vertex(6)
graph.add_vertex(v5)
print("\n정점 6을 추가한 후의 그래프")
graph.print()
# 정점 삭제
# 정점 3은 v[1]이다
graph.remove_vertex(v[1])
print("\n정점 3을 삭제한 후의 그래프")
graph.print()
@@ -0,0 +1,116 @@
"""
File: graph_adjacency_matrix.py
Created Time: 2023-02-23
Author: krahets ([email protected])
"""
import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent.parent))
from modules import Vertex, print_matrix
class GraphAdjMat:
"""인접 행렬로 구현한 무방향 그래프 클래스"""
def __init__(self, vertices: list[int], edges: list[list[int]]):
"""생성자"""
# 정점 리스트의 원소는 정점 값을, 인덱스는 정점 인덱스를 나타낸다
self.vertices: list[int] = []
# 인접 행렬의 행과 열 인덱스는 정점 인덱스에 해당한다
self.adj_mat: list[list[int]] = []
# 정점 추가
for val in vertices:
self.add_vertex(val)
# 간선 추가
# edges의 원소는 정점 인덱스, 즉 vertices 원소의 인덱스를 나타낸다
for e in edges:
self.add_edge(e[0], e[1])
def size(self) -> int:
"""정점 개수 반환"""
return len(self.vertices)
def add_vertex(self, val: int):
"""정점 추가"""
n = self.size()
# 정점 리스트에 새 정점의 값을 추가한다
self.vertices.append(val)
# 인접 행렬에 행 하나를 추가한다
new_row = [0] * n
self.adj_mat.append(new_row)
# 인접 행렬에 열 하나를 추가한다
for row in self.adj_mat:
row.append(0)
def remove_vertex(self, index: int):
"""정점 삭제"""
if index >= self.size():
raise IndexError()
# 정점 리스트에서 인덱스 index의 정점을 제거한다
self.vertices.pop(index)
# 인접 행렬에서 인덱스 index의 행을 삭제한다
self.adj_mat.pop(index)
# 인접 행렬에서 인덱스 index의 열을 삭제한다
for row in self.adj_mat:
row.pop(index)
def add_edge(self, i: int, j: int):
"""간선 추가"""
# 매개변수 i, j는 vertices 원소의 인덱스에 해당한다
# 인덱스가 범위를 벗어나거나 서로 같은 경우를 처리한다
if i < 0 or j < 0 or i >= self.size() or j >= self.size() or i == j:
raise IndexError()
# 무방향 그래프의 인접 행렬은 주대각선에 대해 대칭이며, (i, j) == (j, i)를 만족한다
self.adj_mat[i][j] = 1
self.adj_mat[j][i] = 1
def remove_edge(self, i: int, j: int):
"""간선 삭제"""
# 매개변수 i, j는 vertices 원소의 인덱스에 해당한다
# 인덱스가 범위를 벗어나거나 서로 같은 경우를 처리한다
if i < 0 or j < 0 or i >= self.size() or j >= self.size() or i == j:
raise IndexError()
self.adj_mat[i][j] = 0
self.adj_mat[j][i] = 0
def print(self):
"""인접 행렬 출력"""
print("정점 리스트 =", self.vertices)
print("인접 행렬 =")
print_matrix(self.adj_mat)
"""실행 코드"""
if __name__ == "__main__":
# 무방향 그래프 초기화
# edges의 원소는 정점 인덱스, 즉 vertices 원소의 인덱스를 나타낸다
vertices = [1, 3, 2, 5, 4]
edges = [[0, 1], [0, 3], [1, 2], [2, 3], [2, 4], [3, 4]]
graph = GraphAdjMat(vertices, edges)
print("\n초기화한 후의 그래프")
graph.print()
# 간선 추가
# 정점 1, 2의 인덱스는 각각 0, 2이다
graph.add_edge(0, 2)
print("\n간선 1-2를 추가한 후의 그래프")
graph.print()
# 간선 삭제
# 정점 1, 3의 인덱스는 각각 0, 1이다
graph.remove_edge(0, 1)
print("\n간선 1-3을 삭제한 후의 그래프")
graph.print()
# 정점 추가
graph.add_vertex(6)
print("\n정점 6을 추가한 후의 그래프")
graph.print()
# 정점 삭제
# 정점 3의 인덱스는 1이다
graph.remove_vertex(1)
print("\n정점 3을 삭제한 후의 그래프")
graph.print()
@@ -0,0 +1,64 @@
"""
File: graph_bfs.py
Created Time: 2023-02-23
Author: krahets ([email protected])
"""
import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent.parent))
from modules import Vertex, vals_to_vets, vets_to_vals
from collections import deque
from graph_adjacency_list import GraphAdjList
def graph_bfs(graph: GraphAdjList, start_vet: Vertex) -> list[Vertex]:
"""너비 우선 순회"""
# 지정한 정점의 모든 인접 정점을 얻기 쉽도록 그래프를 인접 리스트로 표현한다
# 정점 순회 순서
res = []
# 방문한 정점을 기록하는 해시 집합
visited = set[Vertex]([start_vet])
# 큐를 사용하여 BFS를 구현한다
que = deque[Vertex]([start_vet])
# 정점 vet에서 시작하여 모든 정점을 방문할 때까지 반복한다
while len(que) > 0:
vet = que.popleft() # 큐 맨 앞의 정점을 꺼낸다
res.append(vet) # 방문한 정점을 기록한다
# 해당 정점의 모든 인접 정점을 순회한다
for adj_vet in graph.adj_list[vet]:
if adj_vet in visited:
continue # 이미 방문한 정점은 건너뛴다
que.append(adj_vet) # 방문하지 않은 정점만 큐에 삽입한다
visited.add(adj_vet) # 해당 정점을 방문했다고 표시한다
# 정점 순회 순서를 반환한다
return res
"""실행 코드"""
if __name__ == "__main__":
# 무방향 그래프 초기화
v = vals_to_vets([0, 1, 2, 3, 4, 5, 6, 7, 8, 9])
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]],
]
graph = GraphAdjList(edges)
print("\n초기화한 후의 그래프")
graph.print()
# 너비 우선 순회
res = graph_bfs(graph, v[0])
print("\n너비 우선 순회(BFS)의 정점 순서")
print(vets_to_vals(res))
@@ -0,0 +1,57 @@
"""
File: graph_dfs.py
Created Time: 2023-02-23
Author: krahets ([email protected])
"""
import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent.parent))
from modules import Vertex, vets_to_vals, vals_to_vets
from graph_adjacency_list import GraphAdjList
def dfs(graph: GraphAdjList, visited: set[Vertex], res: list[Vertex], vet: Vertex):
"""깊이 우선 순회 보조 함수"""
res.append(vet) # 방문한 정점을 기록한다
visited.add(vet) # 해당 정점을 방문했다고 표시한다
# 해당 정점의 모든 인접 정점을 순회한다
for adjVet in graph.adj_list[vet]:
if adjVet in visited:
continue # 이미 방문한 정점은 건너뛴다
# 인접 정점을 재귀적으로 방문한다
dfs(graph, visited, res, adjVet)
def graph_dfs(graph: GraphAdjList, start_vet: Vertex) -> list[Vertex]:
"""깊이 우선 순회"""
# 지정한 정점의 모든 인접 정점을 얻기 쉽도록 그래프를 인접 리스트로 표현한다
# 정점 순회 순서
res = []
# 방문한 정점을 기록하는 해시 집합
visited = set[Vertex]()
dfs(graph, visited, res, start_vet)
return res
"""실행 코드"""
if __name__ == "__main__":
# 무방향 그래프 초기화
v = vals_to_vets([0, 1, 2, 3, 4, 5, 6])
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]],
]
graph = GraphAdjList(edges)
print("\n초기화한 후의 그래프")
graph.print()
# 깊이 우선 순회
res = graph_dfs(graph, v[0])
print("\n깊이 우선 순회(DFS)의 정점 순서")
print(vets_to_vals(res))