وجنوم DOC-تيلس حزم تحتوي على مجموعة من المرافق وثائق المشروع غنوم. والجدير بالذكر، أنه يحتوي على المرافق العامة لبناء وثائق وجميع الملفات المساعدة في شجرة المصدر، وأنه يحتوي على الأنماط XSLT دوكبوك التي تم توزيعها مرة واحدة مع الصرخة. بدءا من جنوم 2.8، سوف الصرخة يتطلب جنوم DOC-تيلس لXSLT.
تنظيم
اختبار
/
الدليل اختبار يحتوي على عدد من الاختبارات لجنوم -doc-تيلس. الدلائل من testdocn شكل من الأشكال، حيث n عدد صحيح موجب، هي الأشجار مصدر الهيكل العظمي التي تحتوي على الوثائق، مع نفس التخطيط الذي سيتم استخدامه في مشاريع الفعلية. يحتوي الدليل testdocs الاختبارات وحدة من دوكبوك-testdocs، التي وضعتها نورم وشركاه للعموم المجرة معدات الشكل دوكبوك. ملف اقرأني إضافي في هذا الدليل، وإعطاء تعليمات بشأن تمديد أو تغيير أي من الملفات في جنوم DOC-تيلس CVS.
وثيقة /
الدليل وثيقة تحتوي على وثائق لجنوم وثيقة -utils. في معظم الحالات، لا بد من جنوم DOC-تيلس لبناء وثائقه. الآليات المعمول بها لإلباس الحذاء.
XSLT /
الدليل XSLT يحتوي على كافة XSLT في جنوم DOC-تيلس. والجدير بالذكر أن الدليل XSLT / دوكبوك يحتوي على دوكبوك XSLT، و XSLT / gettext يحتوي على الأداة المساعدة XSLT gettext لترجمة النص التلقائي.
رمل /
لا DISTed الدليل رمل، لذلك سوف تظهر فقط إذا كان لديك الخروج CVS. إنها ملعب للأفكار الجديدة. يحتوي
xml2po /
الدليل xml2po الأداة xml2po التي وضعتها دانيلو Segan لترجمة صيغ XML التعسفية. يتم استخدامه من قبل جنوم DOC-تيلس للترجمة دوكبوك.
اختبار
تحت الدليل اختبار عدد من الاختبارات لجنوم DOC-تيلس. لاختبار نظام بناء (جنوم DOC-utils.m4 وجنوم DOC-utils.make)، يمكنك استخدام أي من testdocn (لغ صحيحة موجبة) الدلائل. يتم تعيين هذه الاشجار مصدر الهيكل العظمي كما، تماما كما يتصرف مشروع حقيقي من شأنه. أيضا، جنوم DOC-تيلس يستخدم نفسها لبناء وثائقه الخاصة (تحت DOC)، لذلك جنوم DOC-تيلس في حد ذاته هو اختبار لأدوات البناء.
لاختبار معدات الشكل دوكبوك، استخدم اختبار / testdocs الدليل. هذه الاختبارات وحدة هي من حزمة دوكبوك-testdocs على docbook.sourceforge.net، التي وضعتها نورم وشركاه ببساطة كتابة جعل في هذا الدليل سوف نبني كل اختبار. إذا كان اسم الملف الاختبار هو foo.001.xml، سوف يكون الإخراج أتش تي أم أل / foo.001 / foo.001.html. كل اختبار اختبارات عموما عدد قليل من العناصر دوكبوك ذات الصلة. العديد من الميزات من دوكبوك أو من XSLT في جنوم DOC-تيلس قد لا يكون اختبارها من قبل هذه. ويمكن إضافة اختبارات إضافية؛ اتبع الإرشادات في اختبار / testdocs / اقرأني لذلك.
مفيدة أيضا لاختبار XSLT هو تحويل بعض المستندات الكبيرة استخدامه. وغنوم دليل المستخدم ودليل Gnumeric كل من يخدم مستندات اختبار ممتازة.
HACKING
وخلافا لمعظم البرمجة C، والعمل على الكثير من جنوم DOC-تيلس حقا لا تنطوي معزولة تحسينات تدريجية. ليس هناك طريقة لإعطاء قائمة قصيرة من ميزات واسعة في قائمة TODO.
إلى العمل على بناء أدوات (جنوم DOC-utils.m4 وجنوم DOC-utils.make)، بناء مستندات اختبار ونرى ما لا يعمل. جنوم DOC-utils.make لديه قائمة من كل الأهداف رفيعة المستوى التي يجب أن تكون معتمدة بشكل كامل.
للعمل على دوكبوك XSLT، والعثور على أحد العناصر التي لا يتم تنفيذها بعد وتنفيذه . إذا كان لديك XML النجيم (xmlstar.sourceforge.net) تثبيت، يمكنك كتابة "جعل report.html" في XSLT / دوكبوك / أتش تي أم أل الدليل للحصول على
تقرير HTML لطيفة على ما يتم تنفيذ العناصر. وهناك أيضا ملف TODO في هذا الدليل مع قائمة مقتضبة جدا من المباريات التي تحتاج إلى القيام به لا يمكن القبض عليهم من قبل report.html.
ل
لاحظ أن يتم توثيق XSLT مضمنة مع xsldoc، الذي هو في حد ذاته جزء من تمثال-DOC-تيلس. لا تتردد في العمل على xsldoc كذلك. يتم تضمين الوثائق التي تولدها xsldoc في دليل تحت وثيقة / XSLT
ما هو الجديد في هذا الإصدار:.
المشكلة الثابتة مع شعبة نظم وتثبيت مع العديد من الملفات
ترجمة تحديث:
كم (موران الحد)
ما هو الجديد في الإصدار 0.20.9:
مؤقتا مضيفا RNG الملفات مرة أخرى من أجل التوافق. الآن أن الملفات RNG لم تعد تسمى (اعتبارا من 0.20.8)، سيتم إزالة الملفات RNG مرة أخرى بعد فترة انتقالية.
ما هو الجديد في الإصدار 0.20.6:
تحديث مالارد مخطط
ثابت 'جعل وعاء' القاعدة لمالارد
ترجمة تحديث:
كاليفورنيا (جوردي Serratosa)
وفاق (خورخي غونزاليس، دانيال Mustieles)
ميكروغرام (Abduxukur Abdurixit)
ما هو الجديد في الإصدار 0.20.5:
تحديث ملفات مالارد RNG
ترجمة تحديث:
كما (Amitakhya Phukan)
bn_IN (رونا استروسكايت)
EO (Kristjan SCHMIDT)
وفاق (خورخي جونزاليس)
غو (SWETA كوثري)
أو (مانوج كومار غيري)
ما هو الجديد في الإصدار 0.20.3:
الثابتة استبدال قيادة متداخلة في جنوم DOC-utils.make (كريس كولمان)
ترجمة تحديث:
كاليفورنيا @ فالنسيا (كارليس فيراندو)
دي (مسيحية Kirbach)
دي (ماريو Blattermann)
شرم (مايكل Kotsarinis)
وفاق (خورخي جونزاليس)
وآخرون (ايفار سمولين)
اتحاد كرة القدم (مهيار Moghimi)
الاب (برونو Brouard)
GL (فران ديغيز)
SL (ماتي Urbancic)
ميكروغرام (Gheyret T.Kenji)
ما هو الجديد في الإصدار 0.20.2:
حدثت في ترجمة:
دي (ماريو Blattermann)
EN @ شو (توماس ثورمان)
وفاق (خورخي جونزاليس)
الاب (الجيود)
GL (فران ديغيز)
انه (يارون Shahrabani)
هو جين (غابور Kelemen)
معرف (Dirgita)
جا (تاكايوكي كوسانو)
الوقف (Rudols Mazurs)
SL (أندريه Znidarsic)
zh_CH (آرون شو)
لم يتم العثور على التعليقات