STARG-LEE/claude-skill-hwpx

Créez, lisez, éditez et convertissez des documents Hangul (.hwpx) en Python, avec des fonctions avancées de mise en forme de tableaux (marges de cellule, alignement vertical, gestion du texte, saut de page, étirement de tableau).

Qu'est-ce que claude-skill-hwpx ?

Cette compétence permet aux agents IA (comme Claude Code) de manipuler des fichiers Hangul (.hwpx) — le format natif du traitement de texte coréen — directement via Python. Elle offre des fonctionnalités de base (création, lecture, édition, conversion) ainsi qu'un ensemble enrichi de fonctions pour le formatage avancé des tableaux : réglage des marges intérieures des cellules, alignement vertical du contenu, gestion des caractères de contrôle (comme les sauts de ligne), contrôle des sauts de page et étirement automatique des tableaux. Idéale pour l'automatisation documentaire dans un contexte coréen, elle s'exécute sous Python 3.8+ et repose sur la bibliothèque `pyhwpx` (avec une interface orientée objet dérivée de `win32com` via `hwpapi`). Elle est conçue pour les agents disposant de capacités d'exécution de code Python, comme Claude Code (Anthropic), Cursor (code assistant) ou Codex CLI. L'agent peut ainsi générer des rapports structurés, des factures ou des documents officiels au format Hangul sans intervention manuelle. La compétence est publiée sur GitHub (`STARG-LEE/claude-skill-hwpx`) et s'intègre via une configuration `claude-skills` dans le fichier de configuration du projet.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add STARG-LEE/claude-skill-hwpx

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait claude-skill-hwpx ?

Créez, lisez, éditez et convertissez des documents Hangul (.hwpx) en Python, avec des fonctions avancées de mise en forme de tableaux (marges de cellule, alignement vertical, gestion du texte, saut de page, étirement de tableau).

Fonctionnalités

  • Création de documents .hwpx : génération de nouveaux fichiers Hangul à partir de zéro.
  • Lecture : extraction du contenu texte et des propriétés des documents existants.
  • Édition : modification des paragraphes, tableaux, styles et en-têtes/pieds de page.
  • Conversion : export vers .docx, .pdf, .txt ou autres formats pris en charge par Hangul.
  • Mise en forme avancée des tableaux :
    • Marges intérieures des cellules (gauche, droite, haut, bas)
    • Alignement vertical (haut, milieu, bas)
    • Gestion des caractères de contrôle (\\n, retour chariot, etc.)
    • Contrôle des sauts de page dans les tableaux
    • Étirement automatique du tableau pour remplir la zone disponible

Prérequis

  • Python 3.8 ou supérieur
  • La bibliothèque pyhwpx (installable via pip install pyhwpx)
  • Hangul (Hancom Office) doit être installé sur Windows (car pyhwpx s'appuie sur l'automatisation COM)

Installation

pip install pyhwpx

Utilisation

Créer un document simple

from hwpx import Hwp

hwp = Hwp()
hwp.create()
hwp.insert_text("Bonjour, monde !")
hwp.save("exemple.hwpx")
hwp.quit()

Lire un document existant

from hwpx import Hwp

hwp = Hwp()
hwp.open("existant.hwpx")
print(hwp.get_text())
hwp.quit()

Ajouter un tableau avec mise en forme avancée

from hwpx import Hwp

hwp = Hwp()
hwp.create()

# Créer un tableau 3x4
table = hwp.create_table(3, 4)
hwp.set_cell_margin(table, 0, 0, left=5, right=5, top=3, bottom=3)
hwp.set_cell_vertical_align(table, 0, 0, "middle")
hwp.set_cell_text_control(table, 0, 0, allow_newline=True)
hwp.set_table_page_break(table, "auto")
hwp.stretch_table(table, enable=True)

hwp.save("tableau_mis_en_forme.hwpx")
hwp.quit()

Référence de l'API

Consultez la documentation pyhwpx pour une liste complète des fonctions disponibles.

Licence

MIT

Skills associés