مستند XSL-FO

مستندات XSL-FO فایل‌های XML‌ای با اطلاعات خروجی هستند.

مستند XSL-FO

مستندات XSL-FO فایل‌های XML‌ای با اطلاعات خروجی هستند. آنها شامل اطلاعات مربوط به چیدمان خروجی و محتوای خروجی هستند.

مستندات XSL-FO در فایل‌هایی با پسوند .fo یا .fob ذخیره می‌شوند. همچنین مستندات XSL-FO با پسوند .xml نیز رایج هستند، که این کار باعث می‌شود مستندات XSL-FO به راحتی توسط ویرایشگرهای XML دسترسی پیدا شوند.

ساختار مستند XSL-FO

ساختار مستند XSL-FO مانند این است:

<?xml version="1.0" encoding="ISO-8859-1"?>
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
<fo:layout-master-set>
  <fo:simple-page-master master-name="A4">
    <!-- قالب صفحه اینجا قرار می‌گیرد -->
  </fo:simple-page-master>
</fo:layout-master-set>
<fo:page-sequence master-reference="A4">
  <!-- محتوای صفحه اینجا قرار می‌گیرد -->
</fo:page-sequence>
</fo:root>

توضیح ساختار

مستند XSL-FO نیز از مستند XML است، زیرا نیاز به بیان سرآغازی از XML دارد:

<?xml version="1.0" encoding="ISO-8859-1"?>

عنصر <fo:root> به عنوان عنصر ریشه مستند XSL-FO است. این ریشه باید نام فضای معرف XSL-FO را نیز بیان کند:

<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
  <!-- اینجا محتوای مستند XSL-FO است -->
</fo:root>

عنصر <fo:layout-master-set> شامل یک یا چند قالب صفحه است:

<fo:layout-master-set>
  <!-- اینجا تمام قالب‌های صفحه است -->
</fo:layout-master-set>

عنصر <fo:simple-page-master> یک قالب صفحه یکتا را شامل می‌شود. هر قالب باید یک نام منحصر به فرد داشته باشد (master-name):

<fo:simple-page-master master-name="A4">
  <!-- اینجا یک قالب صفحه خاص است -->
</fo:simple-page-master>

یک یا چند عنصر <fo:page-sequence> می‌توانند محتوای صفحه را توصیف کنند.属性 master-reference با نام‌های مشابه برای اشاره به قالب‌های simple-page-master استفاده می‌شود:

<fo:page-sequence master-reference="A4">
  <!-- اینجا محتوای صفحه است -->
</fo:page-sequence>

نکته:نکته: مقادیر master-reference مانند "A4" واقعاً توصیف‌کننده یک قالب صفحه پیش‌تعریف نیستند. این تنها یک نام است. می‌توانید از هر نامی استفاده کنید، مانند "MyPage"، "MyTemplate" و غیره.