update-hwpx-differences

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

HWPX-Markdown 차이점 문서 업데이트

HWPX-Markdown差异文档更新

이 스킬은 HWPX와 Markdown 간의 차이점 문서(

docs/hwpx-markdown-differences.md

)를 자동으로 업데이트합니다.

此技能会自动更新HWPX与Markdown之间的差异文档（

docs/hwpx-markdown-differences.md

）。

사용 시점

使用场景

다음과 같은 경우에 이 스킬을 사용하세요:

새로운 변환 문제 발견: HWPX 파싱 중 Markdown으로 표현할 수 없는 새로운 요소 발견
새로운 처리 방법 구현: 기존 차이점에 대한 새로운 변환 로직 추가
기존 문서 개선: 더 나은 설명이나 예시 추가 필요

请在以下情况使用此技能：

发现新的转换问题：在HWPX解析过程中发现无法用Markdown表达的新元素
实现新的处理方法：为现有差异添加新的转换逻辑
优化现有文档：需要添加更清晰的说明或示例

실행 단계

执行步骤

1. 현재 문서 확인

1. 查看当前文档

docs/hwpx-markdown-differences.md

파일을 읽어 현재 문서화된 차이점 목록을 확인합니다.

docs/hwpx-markdown-differences.md

读取文件，确认当前已记录的差异列表。

2. 새로운 차이점 추가

2. 添加新差异

다음 형식으로 새 항목을 추가합니다:

markdown

undefined

按照以下格式添加新条目：

markdown

undefined

N. [차이점 이름]

N. [差异名称]

항목	설명
HWPX	[HWPX에서의 동작/기능]
Markdown	[Markdown의 제한사항]
변환 방식	[hwp2markdown의 처리 방법]

예시:

HWPX: [원본 예시]
Markdown: [변환된 결과 예시]

관련 코드:

[파일 경로]

[함수명]

함수

undefined

项目	说明
HWPX	[HWPX中的行为/功能]
Markdown	[Markdown的限制]
转换方式	[hwp2markdown的处理方法]

示例:

HWPX: [原始示例]
Markdown: [转换后的结果示例]

相关代码:

[文件路径]

[函数名]

函数

undefined

3. 번호 재정렬

3. 重新排序编号

새 항목 추가 후 전체 번호가 순차적인지 확인합니다.

添加新条目后，确认整体编号是否连续。

4. 날짜 업데이트

4. 更新日期

문서 하단의 마지막 업데이트 날짜를 오늘 날짜로 변경합니다:

markdown

*마지막 업데이트: YYYY-MM-DD*

将文档底部的最后更新日期修改为今日日期：

markdown

*最后更新: YYYY-MM-DD*

차이점 카테고리

差异分类

문서에 포함할 수 있는 차이점 유형:

카테고리	설명
레이아웃	페이지, 여백, 단 나누기 등
테이블	병합, 중첩, 스타일 등
텍스트	글꼴, 색상, 특수 문자 등
객체	이미지, OLE, 수식 등
구조	각주, 목차, 참조 등

文档可包含的差异类型：

分类	说明
布局	页面、边距、分栏等
表格	合并、嵌套、样式等
文本	字体、颜色、特殊字符等
对象	图片、OLE、公式等
结构	脚注、目录、引用等

예시: 새 차이점 추가

示例：添加新差异

상황:

<hp:tab/>

요소가 Markdown에서 지원되지 않음을 발견

추가할 내용:

markdown

undefined

场景：发现

<hp:tab/>

元素在Markdown中不受支持

需添加的内容:

markdown

undefined

11. 탭 문자 (Tab Character)

11. 制表符（Tab Character）

항목	설명
HWPX	`<hp:tab/>` 요소로 탭 정렬 지원
Markdown	탭은 코드 블록 들여쓰기로만 사용
변환 방식	탭을 공백 4개로 변환

예시:

HWPX:
```
이름<hp:tab/>홍길동
```
Markdown:
```
이름    홍길동
```

관련 코드:

internal/parser/hwpx/parser.go

readElementText()

함수

undefined

项目	说明
HWPX	通过 `<hp:tab/>` 元素支持制表符对齐
Markdown	制表符仅用于代码块缩进
转换方式	将制表符转换为4个空格

示例:

HWPX:
```
이름<hp:tab/>홍길동
```
Markdown:
```
이름    홍길동
```

相关代码:

internal/parser/hwpx/parser.go

readElementText()

函数

undefined

주의사항

注意事项

기존 항목의 번호나 구조를 변경할 때는 다른 문서의 참조도 확인
코드 변경과 문서 업데이트는 같은 커밋에 포함
예시는 실제 테스트 파일(
```
testdata/한글 테스트.hwpx
```
)에서 가져오는 것이 좋음

修改现有条目的编号或结构时，请确认其他文档的引用是否正确
代码变更与文档更新需包含在同一个提交中
示例最好取自实际测试文件（
```
testdata/한글 테스트.hwpx
```
）