iacore
894d769051
The skill metadata had drifted: every SKILL.md name field lacked the mpi- prefix, contradicting the directory names and the Agent Skills specification. Descriptions were also missing negative triggers, making it easy for the agent to load the wrong skill. Rewrote the pdf-to-docx skill to follow progressive disclosure: the main SKILL.md dropped from 318 lines to 80, with detailed code examples moved to on-demand references. Added uv run instructions and /// script PEP 723 metadata so dependencies are declared inline and installed automatically. Fixed the pptx skill's script paths and added CLI usage messages to both pptx scripts and the normalize script. Removed the empty self-review directory that was superseded by the unified translation-review skill.
60 lines
1.4 KiB
Markdown
60 lines
1.4 KiB
Markdown
# DOCX Construction Notes
|
|
|
|
Low-level notes for building the DOCX output with python-docx.
|
|
|
|
## East Asian fonts
|
|
|
|
Set CJK fonts properly on a run:
|
|
|
|
```python
|
|
from docx.oxml.ns import qn
|
|
from docx.oxml import OxmlElement
|
|
|
|
def set_east_asian_font(run, name: str):
|
|
rPr = run._element.get_or_add_rPr()
|
|
rFonts = rPr.find(qn('w:rFonts'))
|
|
if rFonts is None:
|
|
rFonts = OxmlElement('w:rFonts')
|
|
rPr.insert(0, rFonts)
|
|
rFonts.set(qn('w:eastAsia'), name)
|
|
rFonts.set(qn('w:ascii'), name)
|
|
rFonts.set(qn('w:hAnsi'), name)
|
|
```
|
|
|
|
## Native bullets
|
|
|
|
Use Word's `List Bullet` style, not Wingdings characters:
|
|
|
|
```python
|
|
p = doc.add_paragraph(style='List Bullet')
|
|
p.clear()
|
|
run = p.add_run("Bullet text")
|
|
set_east_asian_font(run, font_name)
|
|
```
|
|
|
|
## Image embedding
|
|
|
|
Extract images from the PDF first, then embed them:
|
|
|
|
```python
|
|
from docx.shared import Inches
|
|
|
|
# Extract
|
|
doc = pymupdf.open("input.pdf")
|
|
for pi in range(len(doc)):
|
|
for idx, img in enumerate(doc[pi].get_images()):
|
|
xref = img[0]
|
|
base = doc.extract_image(xref)
|
|
path = f"extracted_{pi}_{idx}.{base['ext']}"
|
|
with open(path, 'wb') as f:
|
|
f.write(base['image'])
|
|
|
|
# Embed
|
|
p = doc.add_paragraph()
|
|
p.alignment = WD_ALIGN_PARAGRAPH.CENTER
|
|
run = p.add_run()
|
|
run.add_picture(image_path, width=Inches(3.5))
|
|
```
|
|
|
|
See `scripts/convert_pdf_to_docx.py` for the production-ready implementation.
|