Prévisualiser HWP / HWPX sous forme d’images
La lecture d’un fichier .hwp ne donne que son texte, pas son apparence. Ce skill transforme les pages en images en utilisant le moteur de mise en page de rhwp, afin que vous puissiez visualiser un document coréen — ou vérifier un document que vous venez de générer — sans Hancom Office.
Comment l’utiliser
node "${CLAUDE_PLUGIN_ROOT}/scripts/hwp-preview.mjs" "<fichier.hwp|.hwpx>" "<dossier_sortie>" --png
Ensuite, lisez les fichiers PNG produits avec l’outil Read pour les visualiser.
Options :
| Option | Signification |
|---|---|
--png | Écrit également du PNG (nécessite Chrome/Chromium/Edge comme rasteriseur). Sans cela, seulement du SVG. |
--scale <n> | Ratio de pixels PNG, défaut 2. Utilisez 1 pour un aperçu rapide, 3 pour du détail. |
--pages <spéc> | Pages basées sur 1, ex. 1, 1,3, 2-4. Défaut : toutes les pages. |
La sortie est nommée <racine>-<format>-p<N>.svg / .png, ex. rapport-hwp-p1.png.
Utilisations typiques
- Vérifier le résultat généré. Après
hwp-write.mjs, prévisualisez la page 1 et contrôlez la hiérarchie des titres, les bordures de tableau et l’espacement avant de remettre le fichier à l’utilisateur. - Inspecter un document envoyé par l’utilisateur lorsque la question est visuelle (« 표가 왜 깨졌지? ») plutôt que textuelle.
- Montrer à l’utilisateur ce qu’il obtiendra sans lui demander d’ouvrir 한글.
Remarques
- Si
--pngéchoue car aucun navigateur n’a été trouvé, définissezCHROME_PATHpour pointer vers un binaire Chrome/Chromium/Edge — ou retirez--pnget utilisez le SVG, qui ne nécessite que Node. - Il s’agit du moteur de rendu de rhwp, pas de celui de Hancom. Les polices et la pagination sont proches mais pas identiques, et les polices réellement disponibles sur la machine sont utilisées en substitution. Pour une validation visuelle finale, l’utilisateur doit ouvrir le fichier dans 한글.
- Nécessite Node.js (disponible dans l’environnement Cowork VM / Claude Code).