.\" Copyright (c) 2002 Bill C. Riemers .\" .\" This is free documentation; you can redistribute it and/or .\" modify it under the terms of the GNU General Public License as .\" GNU General Public License, either Version 2 of the license, .\" or (at your option) any later version. The license should have .\" published by the Free Software Foundation; either version 2 of .\" the License, or (at your option) any later version. .\" .\" The GNU General Public License's references to "object code" .\" and "executables" are to be interpreted as the output of any .\" document formatting or typesetting system, including .\" intermediate and printed output. .\" .\" This manual is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public .\" License along with this manual. Otherwise check the web site .\" of the Free Software Foundation at http://www.fsf.org. .\" .\" I, Bill C. Riemers, hereby grant all rights to this code, .\" provided usage complies with the GPL or a written exception to .\" the GPL granted by any of Bill C. Riemers, Leon Bottou, .\" Yann Le Cun, or the Free Source Foundation. .\" .\" ------------------------------------------------------------------ .\" DjVuLibre-3.5 is derived from the DjVu(r) Reference Library from .\" Lizardtech Software. Lizardtech Software has authorized us to .\" replace the original DjVu(r) Reference Library notice by the following .\" text (see doc/lizard2002.djvu and doc/lizardtech2007.djvu): .\" .\" ------------------------------------------------------------------ .\" | DjVu (r) Reference Library (v. 3.5) .\" | Copyright (c) 1999-2001 LizardTech, Inc. All Rights Reserved. .\" | The DjVu Reference Library is protected by U.S. Pat. No. .\" | 6,058,214 and patents pending. .\" | .\" | This software is subject to, and may be distributed under, the .\" | GNU General Public License, either Version 2 of the license, .\" | or (at your option) any later version. The license should have .\" | accompanied the software or you may obtain a copy of the license .\" | from the Free Software Foundation at http://www.fsf.org . .\" | .\" | The computer code originally released by LizardTech under this .\" | license and unmodified by other parties is deemed "the LIZARDTECH .\" | ORIGINAL CODE." Subject to any third party intellectual property .\" | claims, LizardTech grants recipient a worldwide, royalty-free, .\" | non-exclusive license to make, use, sell, or otherwise dispose of .\" | the LIZARDTECH ORIGINAL CODE or of programs derived from the .\" | LIZARDTECH ORIGINAL CODE in compliance with the terms of the GNU .\" | General Public License. This grant only confers the right to .\" | infringe patent claims underlying the LIZARDTECH ORIGINAL CODE to .\" | the extent such infringement is reasonably necessary to enable .\" | recipient to make, have made, practice, sell, or otherwise dispose .\" | of the LIZARDTECH ORIGINAL CODE (or portions thereof) and not to .\" | any greater extent that may be necessary to utilize further .\" | modifications or combinations. .\" | .\" | The LIZARDTECH ORIGINAL CODE is provided "AS IS" WITHOUT WARRANTY .\" | OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED .\" | TO ANY WARRANTY OF NON-INFRINGEMENT, OR ANY IMPLIED WARRANTY OF .\" | MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. .\" +------------------------------------------------------------------ .TH DJVUXML 1 "11/15/2002" "DjVuLibre XML Tools" "DjVuLibre XML Tools" .de SS .SH \\0\\0\\0\\$* .. .SH "نام (NAME)" djvutoxml, djvuxmlparser \- ابزارهای XML برای DjVuLibre .SH "خلاصه دستور (SYNOPSIS)" .BI "djvutoxml [" options "] " inputdjvufile " [" outputxmlfile "]" .br .BI "djvuxmlparser [ -o " djvufile " ] " inputxmlfile .SH "توضیحات (DESCRIPTION)" ابزارهای XML در DjVuLibre امکان ویرایش متاداده، پیوندها و متن پنهان مرتبط با پرونده‌های DjVu را فراهم می‌کنند. برخلاف .BR djvused (1) ابزارهای XML در DjVuLibre بر فناوری XML تکیه دارند و می‌توانند از ویرایشگرها و اعتبارسنج‌های XML بهره ببرند. .SH "DJVUTOXML" برنامه .B djvutoxml یک پرونده XML با نام .I outputxmlfile ایجاد می‌کند که حاوی ارجاعی به سند اصلی DjVu .I inputdjvufile و همچنین برچسب‌هایی است که متاداده، پیوندها و متن پنهان مرتبط با پرونده DjVu را توصیف می‌کنند. گزینه‌های زیر پشتیبانی می‌شوند: .TP .BI "--page " "pagenum" یک صفحه را در یک سند چندصفحه‌ای انتخاب می‌کند. بدون این گزینه، .B djvutoxml خروجی XML مربوط به تمام صفحات سند را تولید می‌کند. .TP .BI "--with-text" مشخص می‌کند که عنصر .B HIDDENTEXT برای هر صفحه باید در خروجی گنجانده شود. اگر بدون پرچم .B --with-anno مشخص شود، پرچم .B --without-anno به طور ضمنی در نظر گرفته می‌شود. اگر هیچ‌یک از پرچم‌های .BR --with-text ، .BR --without-text ، .B --with-anno یا .B --without-anno مشخص نشوند، هر دو پرچم .B --with-text و .B --with-anno به طور ضمنی اعمال می‌شوند. .TP .BI "--without-text" مشخص می‌کند که عنصر .B HIDDENTEXT برای هر صفحه در خروجی درج نشود. اگر بدون پرچم .B --without-anno مشخص شود، پرچم .B --with-anno به طور ضمنی در نظر گرفته می‌شود. .TP .BI "--with-anno" مشخص می‌کند که عنصر ناحیه .B MAP برای هر صفحه در خروجی گنجانده شود. اگر بدون پرچم .B --with-text مشخص شود، پرچم .B --without-text به طور ضمنی در نظر گرفته می‌شود. .TP .BI "--without-anno" مشخص می‌کند که عنصر ناحیه .B MAP برای هر صفحه در خروجی گنجانده نشود. اگر بدون پرچم .B --without-text مشخص شود، پرچم .B --with-text به طور ضمنی در نظر گرفته می‌شود. .SH "DJVUXMLPARSER" پرونده‌های تولیدشده توسط .B djvutoxml را می‌توان با یک ویرایشگر متن یا ویرایشگر XML ویرایش کرد. برنامه .B djvuxmlparser پرونده XML .I inputxmlfile را تجزیه می‌کند تا متاداده پرونده متناظر DjVu را تغییر دهد. .TP .BI "-o " "djvufile" در اصل پرونده DjVu هدف، همان پرونده‌ای است که توسط عنصر .I OBJECT پرونده XML به آن ارجاع داده شده است. این گزینه امکانی فراهم می‌کند تا نام پرونده مشخص‌شده در عنصر .I OBJECT لغو و بازنویسی شود. .SH "تعریف نوع سند DJVUXML (DJVUXML DOCUMENT TYPE DEFINITION)" پرونده تعریف نوع سند (DTD) .IP "" 2 .B /usr/share/djvu/pubtext/DjVuXML-s.dtd .PP ورودی و خروجی ابزارهای XML در DjVu را تعریف می‌کند. پرونده DjVuXML-s DTD نسخه‌ای ساده‌شده از HTML DTD است: .IP "" 2 .B \%http://www.w3c.org/TR/1998/REC-html40-19980424/sgml/dtd.html .PP به همراه چند ویژگی جدید که ویژه DjVu اضافه شده‌اند. هر یک از صفحات مشخص‌شده یک سند DjVu به صورت عناصر .B OBJECT درون عنصر .B BODY پرونده XML نمایش داده می‌شوند. هر عنصر .B OBJECT می‌تواند شامل چندین عنصر .B PARAM برای تعیین ویژگی‌هایی مانند نام صفحه، وضوح (DPI) و ضریب گاما باشد. هر عنصر .B OBJECT همچنین می‌تواند شامل یک عنصر .B HIDDENTTEXT باشد تا متن پنهان (معمولاً تولیدشده توسط موتور OCR) را درون صفحه DjVu مشخص کند. علاوه بر این، هر عنصر .B OBJECT می‌تواند به یک عنصر ناحیه .B MAP ارجاع دهد که شامل چندین عنصر .B AREA برای بازنمایی تمامی نواحی پیوند و هایلایت در سند DjVu است. .SS "عناصر PARAM (PARAM Elements)" عناصر مجاز .B PARAM برای یک .B OBJECT در DjVu شامل موارد زیر می‌شوند (اما محدود به آنها نیستند): .B PAGE برای تعیین نام صفحه، .B GAMMA برای تعیین ضریب تصحیح گاما (معمولاً ۲٫۲)، و .B DPI برای تعیین وضوح صفحه. .SS "عناصر HIDDENTEXT (HIDDENTEXT Elements)" عناصر .B HIDDENTEXT از عناصر تو در توی .BR PAGECOLUMNS ، .BR REGION ، .BR PARAGRAPH ، .B LINE و .B WORD تشکیل شده‌اند. عمیق‌ترین عنصر مشخص‌شده باید مختصات مرزی عنصر را با جهت‌گیری بالا به پایین مشخص کند. بدنه عمیق‌ترین عنصر مشخص‌شده باید شامل متن باشد. بیشتر اسناد DjVu از .B LINE یا .B WORD به عنوان پایین‌ترین سطح عنصر استفاده می‌کنند، اما هر عنصری می‌تواند به عنوان پایین‌ترین سطح مجاز باشد. یک فاصله سفید همیشه بین عناصر .B WORD و یک خط جدید همواره بین عناصر .B LINE اضافه می‌شود. از آنجا که زبان‌هایی مانند ژاپنی از فاصله بین کلمات استفاده نمی‌کنند، معمول است که موتورهای OCR آسیایی از .B WORD برای کاراکترها استفاده کنند. .SS "عناصر MAP (MAP Elements)" بدنه عناصر .B MAP از عناصر .B AREA تشکیل شده است. علاوه بر ویژگی‌های ذکرشده در .IP "" 2 .BR \%http://www.w3.org/TR/1998/REC-html40-19980424/struct/objects.html#edef-AREA ، .PP ویژگی‌های .BR bordertype ، .BR bordercolor ، .BR border و .B highlight به ترتیب برای تعیین نوع کادر، رنگ کادر، پهنای کادر و رنگ‌های هایلایت اضافه شده‌اند. مقادیر مجاز برای هر یک از این ویژگی‌ها در DjVuXML-s DTD فهرست شده است. علاوه بر این، شکل .B oval (بیضی) به فهرست شکل‌های مجاز افزوده شده است. یک بیضی از یک کادر مرزی مستطیلی استفاده می‌کند. .SH "اشکالات (BUGS)" شاید بهتر بود به جای تعریف عنصر .B HIDDENTEXT از شیوه‌نامه‌های سبک CSS2 با عناصر استاندارد HTML استفاده می‌شد. .SH "دست‌اندرکاران (CREDITS)" ابزارهای DjVu XML و DTD توسط Bill C. Riemers و Fred Crary نوشته شده‌اند. .SH "همچنین ببینید (SEE ALSO)" .BR djvu (1), .BR djvused (1) و .BR utf8 (7).