| name | export-formatter |
| description | 匯出格式器，將試卷匯出為多種格式。Triggers: 匯出, export, 下載, PDF, Word, 列印, 輸出格式. |
匯出格式器 (Export Formatter)
描述
將試卷匯出為多種格式：
- PDF（含答案卷/無答案卷）
- Word/DOCX
- JSON（程式化處理）
- Markdown
- 線上互動格式
觸發條件
- 「匯出」「export」「下載」
- 「PDF」「Word」
- 「列印」「輸出格式」
🔧 匯出流程
Step 1: 載入試卷
exam = get_exam(exam_id)
Step 2: 選擇匯出格式
formats = {
"pdf": export_to_pdf,
"pdf_with_answers": export_to_pdf_with_answers,
"docx": export_to_docx,
"json": export_to_json,
"markdown": export_to_markdown,
"html": export_to_html,
"moodle_xml": export_to_moodle
}
Step 3: 應用樣式
def apply_template(exam, format, template="default"):
"""套用輸出樣式"""
templates = {
"default": "標準考卷樣式",
"formal": "正式考試樣式 (含浮水印)",
"practice": "練習用樣式 (含解答)",
"print_friendly": "列印友善 (省墨)"
}
return render(exam, templates[template])
📊 匯出格式
PDF 格式
def export_to_pdf(exam, options):
"""匯出為 PDF"""
pdf_options = {
"page_size": "A4",
"margins": {"top": 2, "bottom": 2, "left": 2.5, "right": 2},
"font": "Times New Roman",
"font_size": 12,
"include_cover": True,
"include_answer_sheet": True,
"watermark": None,
"header": exam.title,
"footer": "Page {page} of {total}"
}
pdf = PDFDocument()
pdf.add_cover_page(exam)
pdf.add_instructions(exam)
pdf.add_questions(exam.questions)
if options.include_answer_sheet:
pdf.add_answer_sheet(exam)
return pdf.save(f"{exam.id}.pdf")
Word (DOCX) 格式
def export_to_docx(exam, options):
"""匯出為 Word 文件"""
doc = Document()
doc.styles['Normal'].font.name = '標楷體'
doc.add_heading(exam.title, 0)
doc.add_paragraph(f"考試日期: {exam.date}")
doc.add_paragraph(f"考試時間: {exam.duration} 分鐘")
for q in exam.questions:
doc.add_paragraph(f"{q.number}. {q.stem}")
for opt in q.options:
doc.add_paragraph(f" {opt}")
return doc.save(f"{exam.id}.docx")
JSON 格式
def export_to_json(exam):
"""匯出為 JSON (程式化處理)"""
return {
"exam_id": exam.id,
"metadata": exam.metadata,
"questions": [q.to_dict() for q in exam.questions],
"answer_key": exam.answer_key,
"explanations": exam.explanations
}
Moodle XML 格式
def export_to_moodle(exam):
"""匯出為 Moodle 題庫格式"""
xml = '<?xml version="1.0" encoding="UTF-8"?>\n<quiz>\n'
for q in exam.questions:
xml += f'''
<question type="multichoice">
<name><text>{q.number}</text></name>
<questiontext format="html">
<text><![CDATA[{q.stem}]]></text>
</questiontext>
...
</question>
'''
xml += '</quiz>'
return xml
📝 輸出格式選項
🖨️ 匯出試卷
試卷: exam_20260203_001
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
選擇匯出格式:
1️⃣ PDF - 考試用
└── 不含答案，正式考試格式
2️⃣ PDF - 練習用
└── 含答案和解析
3️⃣ Word (DOCX)
└── 可編輯格式
4️⃣ JSON
└── 程式化處理格式
5️⃣ Moodle XML
└── 可匯入 Moodle/LMS
6️⃣ Markdown
└── 純文字格式
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📄 匯出範例
PDF 考試卷
┌────────────────────────────────────────┐
│ │
│ 麻醉學模擬考 │
│ 靜脈麻醉劑專章 │
│ │
│ 考試日期: 2026年2月3日 │
│ 考試時間: 60 分鐘 │
│ 總分: 100 分 │
│ │
│ 注意事項: │
│ 1. 請仔細閱讀題目 │
│ 2. 每題只選一個答案 │
│ 3. 請用 2B 鉛筆作答 │
│ │
├────────────────────────────────────────┤
│ │
│ 1. Propofol 最主要的心血管副作用是？ │
│ │
│ A. 低血壓 │
│ B. 心搏過速 │
│ C. 高血壓 │
│ D. 心室頻脈 │
│ │
│ 2. 下列哪種藥物最適合用於顱內壓升高 │
│ 的病人進行麻醉誘導？ │
│ ... │
│ │
└────────────────────────────────────────┘
答案卷
┌────────────────────────────────────────┐
│ │
│ 答案卷 │
│ │
│ 姓名: ____________ 座號: _____ │
│ │
│ ┌──┬──┬──┬──┬──┬──┬──┬──┬──┬──┐ │
│ │01│02│03│04│05│06│07│08│09│10│ │
│ ├──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤ │
│ │ │ │ │ │ │ │ │ │ │ │ │
│ └──┴──┴──┴──┴──┴──┴──┴──┴──┴──┘ │
│ ... │
│ │
└────────────────────────────────────────┘
✅ 匯出完成
✅ 匯出成功
格式: PDF (考試用)
檔案: exam_20260203_001.pdf
大小: 2.3 MB
頁數: 12 頁
包含內容:
├── ✓ 封面
├── ✓ 考試說明
├── ✓ 試題 (50題)
├── ✓ 答案卷
└── ✗ 解答 (未包含)
📁 已儲存至: data/exams/exam_20260203_001.pdf
