Hypertocp - عبر الإنترنت في السحابة

برنامج:

اسم

Hypertoc - إنشاء جدول محتويات لمستندات HTML

VERSION

إصدار 3.20

موجز

المساعدة الفائقة | --manpage | --مساعدة الرجل | --رجل

مفرط [- باك سلسلة ] [--debug] [--entrysep سلسلة ] [ --تذييل ملف ] [- رأس
ملف ] [--ignore_only_one] [--ignore_sole_first] [--inline] [--make_anchors] [
--make_toc] [--notoc_match سلسلة ] [--ol | --nool] [--ol_num_levels] [--outfile
ملف ] [- overwrite] [- هادئ] [- textonly] [- العنوان سلسلة ] {--toc_after
العلامة = اللاحقة } {--toc_before العلامة = البادئة } {- الموعد النهائي العلامة = علامة النهاية } {- موضوع_المركز العلامة = المستوى
} [- التسمية_المحددة سلسلة ] [- tooc_only | --notoc_only] [--toc_tag سلسلة ] [
--toc_tag_replace] [--use_id] [--useorg] ملف ...

الوصف

Hypertoc يسمح لك بتحديد "العناصر الهامة" التي سيتم ربطها تشعبيًا في ملف
"جدول المحتويات" (ToC) لمجموعة معينة من مستندات HTML.

بشكل أساسي ، تكون ToC التي تم إنشاؤها عبارة عن قائمة متعددة المستويات تحتوي على روابط إلى ملف
عناصر مهمة. يقوم Hypertoc بإدراج الروابط في ToC إلى العناصر المهمة في ملف
المستوى المحدد من قبل المستخدم.

على سبيل المثال:

إذا تم تحديد H1s على أنها المستوى 1 ، فستظهر في قائمة المستوى الأول من ToC. لو
يتم تحديد H2s كمستوى 2 ، مما يظهر في قائمة المستوى الثاني في ToC.

هناك جانبان لتوليد ToC: (1) وضع نقاط ارتساء مناسبة في HTML
المستندات (--make_anchors) ، و (2) إنشاء ToC من مستندات HTML التي تحتوي على
المراسي فيها لربط ToC بـ (--make_toc). يمكن للمرء أن يختار القيام بواحد أو كليهما
هذه.

يدعم Hypertoc أيضًا القدرة على دمج ToC في مستند HTML نفسه
عبر خيار --inline.

من أجل أن يدعم Hypertoc الارتباط بالعناصر المهمة ، يقوم Hypertoc بإدراج المراسي
في العناصر الهامة. يمكن للمرء استخدام Hypertoc كمرشح ، وإخراج النتيجة إلى
ملف آخر ، أو يمكن للمرء الكتابة فوق الملف الأصلي ، مع نسخ الملف الأصلي احتياطيًا بامتداد
اللاحقة (الافتراضية: "org") ملحقة باسم الملف.

يمكن للمرء أيضًا تحديد الخيارات في ملف التكوين وكذلك في سطر الأوامر.

OPTIONS

يمكن أن تبدأ الخيارات بـ "-" أو "-" ؛ يمكن إبطال الخيارات المنطقية بسبقها بـ
"لا"؛ يمكن إضافة الخيارات ذات قيم التجزئة أو الصفيف من خلال إعطاء الخيار مرة أخرى لـ
كل قيمة.

انظر Getopt :: Long لمزيد من المعلومات.

--argfile اسم الملف
اسم الملف لقراءة المزيد من الخيارات منه. يمكن استخدام هذا أكثر من مرة. ل
مثال:

--argfile your.args --argfile my.args

راجع "ملفات الخيارات" لمزيد من المعلومات.

- باك
- باك سلسلة

إذا تم الكتابة فوق ملف الإدخال / الملفات (- الكتابة فوقية قيد التشغيل) ، فانسخ ملف
الملف الأصلي إلى "اسم الملف.سلسلة". إذا كانت القيمة فارغة ، فلا يوجد ملف نسخ احتياطي
مكتوب. (افتراضي: org)

--Debug
تمكين إخراج التصحيح المطول. تستخدم لتصحيح هذه الوحدة ؛ بعبارة أخرى،
لا تهتم. (الافتراضي: إيقاف)

- نفاذية
- نفاذية سلسلة

سلسلة فاصلة لغير إدخالات العنصر (الافتراضي: "،")

--تذييل
--تذييل ملف

ملف يحتوي على نص تذييل لجدول المحتويات.

- رأس
- رأس ملف

ملف يحتوي على نص رأس لجدول المحتويات.

--مساعدة
اطبع رسالة تعليمات قصيرة واخرج.

--ignore_only_one
إذا كان هناك عنصر واحد فقط في ToC ، فلا تقم بإنشاء ToC.

- تجاهل_وحيد_أولاً
إذا كان العنصر الأول في ToC من أعلى مستوى ، فهو العنصر الوحيد في ذلك
المستوى ، تجاهله. هذا مفيد في صفحات الويب حيث لا يوجد سوى رأس H1 واحد ولكن
لا يعرف المرء مسبقًا ما إذا كان سيكون هناك واحد فقط.

--في النسق
ضع ToC في المستند عند نقطة معينة. راجع "تضمين ToC" للحصول على مزيد من المعلومات.

- صنع_المانتشور | --gen_anchors
إنشاء نقاط ارتساء لجدول المحتويات للارتباط بها.

--make_toc | --gen_toc
قم بعمل جدول محتويات يرتبط بالعناصر المهمة الراسخة.

--مساعدة الرجل | --manpage | --رجل
اطبع جميع الوثائق واخرج.

--notoc_match
--notoc_match سلسلة

إذا كانت هناك علامات فردية معينة لا ترغب في تضمينها في جدول
المحتويات ، على الرغم من أنها تتطابق مع "العناصر المهمة" ، إذا كان هذا النمط
يطابق المحتويات داخل العلامة (وليس النص الأساسي) ، فلن يتم تضمين هذه العلامة ،
سواء في إنشاء المراسي أو في توليد ToC. (افتراضي: class = "notoc")

--ol | --نول
استخدم قائمة مرتبة لإدخالات جدول المحتويات (لعمق معين). إذا كان --ol هو
خطأ (على سبيل المثال - تم تعيين أداة) ثم لا استخدم قائمة مرتبة لإدخالات ToC.

(افتراضي: خطأ)

(راجع --ol_num_levels لتحديد مدى عمق قائمة القائمة المرتبة)

--ol_num_levels
عدد المستويات العميقة في قائمة OL ستذهب إذا كانت --ol صحيحة. إذا تم التعيين على الصفر ،
سيستخدم قائمة مرتبة لجميع المستويات. (افتراضي: 1)

- ملف
- ملف ملف

ملف لكتابة الإخراج إليه. هذا هو المكان الذي تم فيه تعديل إخراج HTML و Table-of-
محتويات يذهب إلى. إذا أعطيت "-" كاسم ملف ، فسيذهب الإخراج إلى STDOUT.
(افتراضي: STDOUT)

--الكتابة فوق
الكتابة فوق ملف الإدخال مع الإخراج. إذا كان هذا ساريًا ، فسيتم تجاهل --outfile.
مستعمل في توليد_المنشورات لإنشاء المراسي "في مكانها" وداخلها توليد_محكمة if
الخيار --inline ساري المفعول. (الافتراضي: إيقاف)

--هادئ
قم بإلغاء الرسائل الإعلامية. (الافتراضي: إيقاف)

--نص فقط
استخدم فقط محتوى النص في العناصر الهامة.

--لقب
--لقب سلسلة

عنوان صفحة ToC (إذا لم تكن تستخدم --header أو --inline أو --toc_only) (الافتراضي: "Table
المحتويات ")

--toc_after
--toc_after بطاقة=لاحقة

--toc_after "H2 ="

لتعريف تخطيط العناصر المهمة في ToC. ال بطاقة هي علامة HTML التي
يمثل بداية العنصر. ال لاحقة هو ما هو مطلوب لإلحاق
تم إنشاء إدخال جدول المحتويات لتلك العلامة. هذه حجة تجزئة تراكمية.
(افتراضي: غير محدد)

--toc_before
--toc_before بطاقة=بادئة

--toc_before "H2 = "

لتعريف تخطيط العناصر المهمة في ToC. ال بطاقة هي علامة HTML
الذي يمثل بداية العنصر. ال بادئة هو المطلوب لتجهيزه مسبقا
إلى إدخال "جدول المحتويات" الذي تم إنشاؤه لتلك العلامة. هذا هو تجزئة تراكمية
دعوى. (افتراضي: غير محدد)

--المخادع
--المخادع بطاقة=endtag

--toc_end "H1 = / H1"

لتحديد العناصر المهمة. ال بطاقة هي علامة HTML التي تحدد بداية
العنصر. ال endtag علامة HTML التي تحدد نهاية العنصر. متى
المطابقة في ملف الإدخال ، يتم تجاهل حالة الأحرف (ولكن تأكد من أن ملف بطاقة الخيارات
الإشارة إلى نفس العلامة هي نفسها تمامًا!). هذه حجة تجزئة تراكمية.
(افتراضي: H1 = / H1 H2 = / H2)

- إدخال_المحتوى
- إدخال_المحتوى بطاقة=مستوى

--toc_entry "TITLE = 1" - tooc_entry "H1 = 2"

لتحديد العناصر المهمة. ال بطاقة هي علامة HTML التي تحدد بداية
العنصر. ال مستوى هو المستوى الذي تعتبره العلامة. قيمة ال مستوى
يجب أن تكون رقمية وغير صفرية. إذا كانت القيمة سالبة ، مدخلات سلبية
يتم تمثيله بالعنصر الكبير سيتم فصله بالقيمة التي تم تعيينها بواسطة
- خيار intrysep. هذه حجة تجزئة تراكمية. (افتراضي: H1 = 1 H2 = 2)

--toc_label | --toclabel
--toc_label سلسلة

نص HTML الذي يصنف ToC. تستخدم دائما. (تقصير: " جدول المحتويات ")

--المتوافقة فقط | - ليس فقط
أخرج فقط جدول المحتويات ، أي جدول المحتويات بالإضافة إلى toc_label.
إذا كان هناك --header أو --footer ، فسيتم إخراجهما أيضًا.

إذا كان --toc_only خاطئًا (على سبيل المثال - تم تعيين notoc_only) ثم إذا لم يكن هناك - رأس ، و
--inline ليس صحيحًا ، فسيتم إخراج رأس صفحة HTML مناسب ، وإذا كان هناك
no --footer و --inline غير صحيحين ، فسيتم إخراج تذييل صفحة HTML.
(افتراضي: - notoc_only)

--toc_tag
--toc_tag سلسلة

إذا تم تضمين ToC في السطر ، فهذا هو النمط المستخدم لمطابقة العلامة
حيث يجب وضع شروط الاستخدام. يمكن أن تكون هذه علامة بداية أو علامة نهاية أو تعليقًا ، ولكن
يجب ترك علامة <؛ أي إذا كنت تريد وضع ToC بعد الجسم
علامة ، ثم إعطاء "الجسم". إذا كنت تريد علامة تعليق خاصة لتحديد المكان الذي يجب أن يكون فيه ToC
go ، ثم قم بتضمين علامات التعليق ، على سبيل المثال: "! - toc--" (افتراضي: BODY)

--toc_tag_replace
بالاقتران مع --toc_tag ، يعد هذا علمًا لتحديد ما إذا كان يجب أن تكون العلامة المعينة
أو إذا كان يجب وضع ToC بعد العلامة. يمكن أن يكون هذا مفيدًا إذا كان لديك
toc_tag هو تعليق ولا تحتاج إليه بعد أن يكون لديك ToC في مكانه.
(افتراضي: خطأ)

--use_id
استخدم معرف = "الاسم"من أجل المراسي بدلاً منالاسم"> المراسي. ولكن إذا كانت مرساة
موجود بالفعل لعنصر مهم ، لن يؤدي هذا إلى إنشاء معرف لهذا العنصر بالتحديد
جزء.

--useorg
استخدام ملفات النسخ الاحتياطي الموجودة مسبقًا كمصدر للإدخال ؛ أي ملفات النموذج
اسم الملف.باك (انظر - باك).

FILE صيغ

مزيد من الخيارات ملفات
يمكن إعطاء الخيارات في الملفات وكذلك في سطر الأوامر باستخدام --argfile
اسم الملف الخيار في سطر الأوامر. أيضا ، الملفات ~ / .hypertocrc و ./.hypertocrc هي
فحص الخيارات.

التنسيق كالتالي: الأسطر التي تبدأ بـ # هي تعليقات. الخطوط المرفقة في PoD
علامات هي أيضا تعليقات. يتم تجاهل الأسطر الفارغة. يجب أن تكون الخيارات نفسها
نظرًا للطريقة التي سيكونون بها في سطر الأوامر ، أي اسم الخيار (بما فيها ال
-) متبوعة بقيمته (إن وجدت).

فمثلا:

# اضبط ToC على ثلاثة مستويات
- موضوع_المركز H1 = 1
- موضوع_المركز H2 = 2
- موضوع_المركز H3 = 3

--toc_end H1 = / H1
--toc_end H2 = / H2
--toc_end H3 = / H3

يمكن أن تتداخل ملفات الخيارات بإعطاء --argfile اسم الملف حجة داخل الخيار
ملف ، سيذهب ويحصل على هذا الملف المشار إليه أيضًا.

راجع Getopt :: ArgvFile لمزيد من المعلومات.

المواصفات

هام عناصر
فيما يلي بعض الأمثلة على تحديد العناصر المهمة لجدول المحتويات الخاص بك.

مثال of الترتيب

يعكس ما يلي الإعداد الافتراضي إذا لم يتم تحديد أي شيء بشكل صريح:

--toc_entry "H1 = 1" --toc_end "H1 = / H1" --toc_entry "H2 = 2" --toc_end "H2 = / H2"

أو ، إذا تم تحديده في أحد "ملفات الخيارات" المحتملة:

# الإعدادات الافتراضية
- موضوع_المركز H1 = 1
--toc_end H1 = / H1
- موضوع_المركز H2 = 2
--toc_end H2 = / H2

مثال of قبل بعد

تستفيد الخيارات التالية من خيارات ما قبل / بعد:

# ملف خيارات يضيف بعض التنسيقات
# جعل إدخالات المستوى 1 ToC
- موضوع_المركز H1 = 1
--toc_end H1 = / H1
--toc_before H1 =
--toc_after H1 =

# جعل إدخالات المستوى 2 ToC
- موضوع_المركز H2 = 2
--toc_end H2 = / H2
--toc_before H2 =
--toc_after H2 =

# اجعل إدخالات المستوى 3 كما هي
- موضوع_المركز H3 = 3
--toc_end H3 = / H3

مثال of على النهاية

تحاول الخيارات التالية فهرسة مصطلحات التعريف:

# ملف خيارات يمكن أن يعمل مع مستندات نوع المسرد
- موضوع_المركز H1 = 1
--toc_end H1 = / H1
- موضوع_المركز H2 = 2
--toc_end H2 = / H2

# يفترض أن المستند يحتوي على DD لكل DT ، وإلا ToC
# سيحصل على إدخالات بها الكثير من النصوص.
- إدخال_المركز DT = 3
--toc_end DT = DD
--toc_before DT =
--toc_after DT =

التنسيق ال ToC
تمنحك خيارات --toc_entry وما إلى ذلك التحكم في كيفية ظهور إدخالات ToC ، ولكن هناك
هي خيارات أخرى للتأثير على المظهر النهائي لملف ToC الذي تم إنشاؤه.

باستخدام الخيار --header ، سيتم إضافة محتويات الملف المحدد مسبقًا قبل الامتداد
تم إنشاء ToC. هذا يسمح لك بالحصول على نص تمهيدي ، أو أي نص آخر ، قبل
ToC.

ملحوظة:
إذا كنت تستخدم الخيار --header ، فتأكد من أن الملف المحدد يحتوي على HTML الافتتاحي
العلامة ، والعنصر HEAD (الذي يحتوي على عنصر TITLE) ، وعلامة BODY الافتتاحية.
ومع ذلك ، يجب ألا تكون هذه العلامات / العناصر في ملف الرأس إذا كانت الخيارات --inline
يستخدم. راجع "تضمين ToC" للحصول على معلومات حول ما يجب أن يحتوي عليه ملف الرأس
لتضمين ToC.

باستخدام الخيار --toc_label ، سيتم إضافة محتويات السلسلة المحددة مسبقًا قبل
تم إنشاء ToC (ولكن بعد أي نص مأخوذ من ملف الرأس).

باستخدام الخيار --footer ، سيتم إلحاق محتويات الملف بعد الإنشاء
ToC.

ملحوظة:
إذا كنت تستخدم -footer ، فتأكد من أنه يشتمل على علامات إغلاق BODY و HTML (ما لم ،
بالطبع ، أنت تستخدم الخيار --inline).

إذا لم يتم تحديد الخيار --header ، فسيكون ترميز البداية المناسب لـ HTML
تمت الإضافة ، ما لم يتم تحديد الخيار --toc_only. إذا لم يكن الخيار --footer
المحدد ، ستتم إضافة ترميز HTML المناسب للإغلاق ، ما لم يكن الخيار --toc_only
محدد.

إذا كنت لا تريد / تحتاج إلى التعامل مع ملفات الرأس والتذييل ، فأنت مُنصح بذلك
تحديد العنوان وخيار العنوان لملف ToC ؛ ويسمح لك بتحديد ملف
العنوان ، أو التسمية ، لوضعها قبل قائمة إدخالات ToC ، الخيار --toc_label. كلا الخيارين
تحتوي على قيم افتراضية ، راجع "الخيارات" لمزيد من المعلومات حول كل خيار.

إذا كنت لا تريد توفير علامات صفحة HTML ، وتريد فقط ToC نفسها ، إذن
حدد الخيار --toc_only. إذا لم تكن هناك ملفات --header أو --footer ، فسيكون هذا
ما عليك سوى إخراج محتويات --toc_label و ToC نفسها.

مضمنة ال ToC
يتم دعم القدرة على دمج ToC مباشرة في مستند HTML عبر
- خيار مضمّن.

سيتم إجراء التضمين على الملف الأول في قائمة الملفات التي تمت معالجتها ، وسيتم ذلك فقط
يتم ذلك إذا كان الملف يحتوي على علامة افتتاحية تطابق قيمة --toc_tag.

إذا كانت --overwrite صحيحة ، فسيتم استبدال الملف الأول في القائمة بامتداد
تم إنشاء ToC المُدرج في المكان المناسب. خلاف ذلك نسخة معدلة من الأول
يتم إخراج الملف إلى STDOUT أو إلى ملف الإخراج المحدد بواسطة الخيار --outfile.

يتم استخدام الخيارات --toc_tag و --toc_tag_replace لتحديد مكان وكيفية وجود ToC
يتم إدخاله في الإخراج.

مثال 1

# هذا هو الافتراضي
--toc_tag BODY --notoc_tag_replace

سيؤدي هذا إلى وضع ToC الذي تم إنشاؤه بعد علامة BODY للملف الأول. إذا كان --header
يتم تحديد الخيار ، ثم يتم إدراج محتويات الملف المحدد بعد BODY
بطاقة شعار. إذا لم يكن الخيار --toc_label فارغًا ، فسيكون النص المحدد بواسطة --toc_label
يتم إدراج الخيار. ثم يتم إدخال ToC ، وأخيرًا ، إذا كان خيار --footer
المحدد ، فإنه يُدرج التذييل. ثم يتبع باقي ملف الإدخال كما كان
قبل.

مثال 2

--toc_tag '! - toc--' --toc_tag_replace

سيؤدي هذا إلى وضع ToC الذي تم إنشاؤه بعد التعليق الأول للنموذج ، وذلك
سيتم استبدال التعليق بـ ToC (بالترتيب
- رأس
--toc_label
ToC
--footer) متبوعًا ببقية ملف الإدخال.

ملحوظة:
يجب ألا يحتوي ملف الرأس على علامة HTML الأولى وعنصر HEAD منذ ملف
يجب أن يحتوي ملف HTML الجاري معالجته بالفعل على هذه العلامات / العناصر.

أمثلة

إنشاء an مضمنة ToC For صورة واحدة؟ ملف
Hypertoc --inline --make_anchors --overwrite --make_toc index.html

سيؤدي هذا إلى إنشاء نقاط ارتساء في "index.html" ، وإنشاء ToC بعنوان "جدول
المحتويات "ووضعها بعد علامة BODY الخاصة بـ" index.html ". ملف index.html.org
تحتوي على ملف index.html الأصلي ، بدون ToC أو نقاط ارتساء.

إنشاء a ToC ملف تبدأ من متعدد ملفات
أولاً ، قم بإنشاء المراسي.

Hypertoc --make_anchors --الكتابة فوق Index.html fred.html George.html

ثم قم بإنشاء ToC

Hypertoc --make_toc --outfile table.html Index.html fred.html george.html

إنشاء an مضمنة ToC بعد ال أول عنوان of ال أول ملف
Hypertoc --make_anchors --inline --الكتابة فوق --make_toc --toc_tag /H1 \
--notoc_tag_replace --toc_label "" index.html fred.html george.html

سيؤدي هذا إلى إنشاء نقاط ارتساء في ملفات "index.html" و "fred.html" و "george.html" ، وإنشاء
a ToC بدون رأس وضعه بعد رأس H1 الأول في "index.html" وقم بعمل نسخة احتياطية
الملفات الأصلية إلى "index.html.org" و "fred.html.org" و "george.html.org"

إنشاء an مضمنة ToC مع على عناصر
Hypertoc --quiet --make_anchors --bak "" --الكتابة \
--make_toc --inline --toc_label "" --toc_tag '!--toc--' \
--toc_tag_replace \
--toc_entry H2=1 --toc_entry H3=2 \
--toc_end H2 = / H2 --toc_end H3 = / H3 myfile.html

سيؤدي هذا إلى إنشاء ToC مضمنة للكتابة فوق الملف الأصلي ، واستبدال ملف
التعليق ، والذي يأخذ رؤوس H2 كرؤوس من المستوى 1 و H3 في المستوى 2. يمكن أن يكون هذا
مفيد حيث يتم إنشاء ملف .html من خلال عملية أخرى ، ويمكنك بعد ذلك إنشاء ملفات
ToC كخطوة أخيرة.

إنشاء a ToC مع على عناصر
Hypertoc --quiet --make_anchors --bak "" --الكتابة \
--toc_entry TITLE = 1 --toc_end TITLE = / TITLE
--toc_entry H2=2 --toc_entry H3=3 \
--toc_end H2=/H2 --toc_end H3=/H3 \
--make_toc --outfile Index.html \
Mary.html fred.html جورج.html

يؤدي هذا إلى إنشاء نقاط ارتساء في عنصري H2 و H3 ، وإنشاء ملف ToC يسمى index.html ،
الفهرسة على عناصر TITLE و H2 و H3.

إنشاء a ToC مع على عناصر و الخيارات ملف
إعطاء ملف خيارات يسمى "custom.opt" على النحو التالي:

# العنوان ، H2 و H3
- عنوان الإدخال إلى العنوان = 1
--toc_end TITLE = / TITLE
- موضوع_المركز H2 = 2
--toc_end H2 = / H2
- موضوع_المركز H3 = 3
--toc_end H3 = / H3

ثم يمكن أن يحتوي المثال السابق على أسطر أوامر أقصر كما يلي:

Hypertoc --quiet --make_anchors --bak "" --الكتابة \
--argfile custom.opt --make_toc --outfile Index.html mary.html fred.html george.html

الملاحظات

· يعتبر Hypertoc ذكيًا بما يكفي لاكتشاف المراسي داخل العناصر المهمة. إذا كان المرساة
يحدد سمة NAME ، يستخدم hypertoc القيمة. عدا ذلك ، فإنه يضيف الاسم الخاص به
السمة إلى المرساة. إذا كان --use_id صحيحًا ، فإنه يتحقق أيضًا ويستخدم
المعرفات.

· يتم التعامل مع عنصر TITLE بشكل خاص إذا تم تحديده كعنصر مهم. إنها
من غير القانوني إدراج نقاط ارتساء (A) في عناصر TITLE. لذلك ، سوف Hypertoc في الواقع
الارتباط باسم الملف نفسه بدلاً من عنصر العنوان في المستند.

· سوف يتجاهل Hypertoc عنصرًا مهمًا إذا لم يكن يحتوي على أي مسافات غير بيضاء
الشخصيات. يتم إنشاء رسالة تحذير في حالة وجود مثل هذا الشرط.

· إذا كانت لديك سلسلة من العناصر المهمة التي تتغير بشكل طفيف غير منظم
الموضة ، مثل H1 -> H3 -> H2 أو حتى H2 -> H1 ، على الرغم من أن hypertoc تتعامل مع هذا
قم بإنشاء قائمة لا تزال جيدة HTML ، إذا كنت تستخدم قائمة مرتبة لذلك
العمق ، عندها ستحصل على ترقيم غريب ، حيث سيكون عنصر القائمة الإضافي
تم إدخالها لتداخل العناصر في المستوى الصحيح.

على سبيل المثال (H2 -> H1 مع --ol_num_levels = 1):

1.
* رأس H2 الخاص بي
2. رأس H1 الخاص بي

على سبيل المثال (H1 -> H3 -> H2 مع --ol_num_levels = 0 و H3 مهمان أيضًا):

1. رأس H1 الخاص بي
1.
1. رأس H3 الخاص بي
2. رأس H2 الخاص بي
2. رأسي الثاني H1

في مثل هذه الحالات ، قد يكون من الأفضل عدم استخدام الخيار --ol.

· إذا كان أحدهم لا يستخدم - overwrite عند إنشاء المراسي ، فيجب أن يكون الأمر كذلك
تم إجراؤه في تمريرين ، من أجل إعطاء أسماء الملفات الصحيحة (تلك التي تحتوي على ملفات
المراسي في نفوسهم) إلى الجزء الخاص بتوليد ToC. وبخلاف ذلك ، سيكون لشروط الاستخدام نقاط تثبيت
مشيرا إلى الملفات التي لا تحتوي عليها.

· عند استخدام --inline ، يجب توخي الحذر عند الكتابة فوق - إذا قام أحدهم بتعيين ToC على
يتم تضمينها بعد علامة معينة (مثل BODY الافتراضي) ثم إذا قام أحد بتشغيل الأمر
بشكل متكرر يمكن للمرء الحصول على العديد من ToCs في نفس الملف ، واحدة تلو الأخرى.

تحفظات

الإصدار 3.10 (وما فوق) يولد المزيد من المراسي المطولة (الصديقة للسيو) أكثر من السابق
الإصدارات. وبالتالي لن تتطابق المراسي التي تم إنشاؤها مع الإصدارات السابقة مع الإصدار 3.10
المراسي.

الإصدار 3.00 (وما فوق) من Hypertoc يتصرف بشكل مختلف إلى حد ما عن الإصدار 2.x من
مفرط. إنه مصمم الآن للقيام بكل شيء في مسار واحد ، وقد انخفض بشكل مؤكد
الخيارات: لم يعد الخيار --infile مستخدمًا (يتم وضع جميع أسماء الملفات في نهاية
الامر)؛ لم يعد الخيار --toc_file موجودًا ؛ استخدم الخيار --outfile
بدلاً من؛ لم يعد الخيار --tocmap مدعومًا.

يقوم الآن بإنشاء علامات أحرف صغيرة بدلاً من علامات الأحرف الكبيرة.

· Hypertoc ليست فعالة جدا (الذاكرة والسرعة) ، ويمكن أن تكون بطيئة بالنسبة للكبيرة
الوثائق.

· الآن هذا الجيل من المراسي و ToC يتم في مسار واحد ، المزيد من الذاكرة
يستخدم مما كان عليه الحال من قبل. هذا هو أكثر وضوحا عند معالجة متعددة
الملفات ، حيث تتم قراءة جميع الملفات في الذاكرة قبل معالجتها.

· سيتم إنشاء ترميز غير صالح إذا تم احتواء عنصر مهم داخل ملف
مِرسَاة. على سبيل المثال:

الأمر FOO

سيتم تحويلها إلى (إذا كانت h1 عنصرًا مهمًا) ،

الأمر FOO

وهو أمر غير قانوني حيث لا يمكن دمج المراسي.

من الأفضل وضع عبارات الارتساء داخل العنصر المراد ترسيخه. ل
على سبيل المثال ، يفضل ما يلي:

الأمر FOO

سوف يكتشف Hypertoc "foo" NAME ويستخدمه.

والأفضل من ذلك هو استخدام المعرفات:

الأمر FOO

لم يتم التعرف على سمات NAME بدون علامات اقتباس.

استخدم Hypertocp عبر الإنترنت باستخدام خدمات onworks.net