hypertocp - آنلاین در ابر

برنامه:

نام

hypertoc - یک جدول از محتویات برای اسناد HTML ایجاد کنید

نسخه

3.20 نسخه

خلاصه

hypertoc --help | --manpage | --man_help | --مرد

هایپرتوک [--باک رشته ] [ --debug ] [ --entrysep رشته ] [ -- پاورقی پرونده ] [ --سرتیتر
پرونده ] [ --ignore_only_one ] [ --ignore_sole_first ] [ --inline ] [ --make_anchors ] [
--make_toc ] [ --notoc_match رشته ] [ --ol | --nool ] [ --ol_num_levels ] [ --outfile
پرونده ] [ -- رونویسی ] [ -- آرام ] [ --textonly ] [ --title رشته ] { --toc_after
برچسب = پسوند } { --toc_before برچسب = پیشوند } { --toc_end tag=endtag } { --toc_entry برچسب = سطح
} [ --toc_label رشته ] [ --toc_only | --notoc_only ] [ --toc_tag رشته ] [
--toc_tag_replace ] [ --use_id ] [ --useorg ] فایل ...

شرح

hypertoc به شما این امکان را می دهد که "عناصر مهم" را مشخص کنید که در a به آنها پیوند داده می شود
"فهرست مطالب" (ToC) برای مجموعه معینی از اسناد HTML.

اساساً، ToC تولید شده یک لیست چند سطحی است که حاوی پیوندهایی به آن است
عناصر قابل توجه hypertoc پیوندها را در ToC به عناصر مهم در a وارد می کند
سطح مشخص شده توسط کاربر

مثال:

اگر H1 ها به عنوان سطح 1 مشخص شده باشند، در لیست سطح اول ToC ظاهر می شوند. اگر
H2 ها به عنوان یک سطح 2 مشخص می شوند تا در لیست سطح دوم در ToC ظاهر شوند.

دو جنبه برای تولید ToC وجود دارد: (1) قرار دادن لنگرهای مناسب در HTML
اسناد (--make_anchors)، و (2) تولید ToC از اسناد HTML که دارند
لنگر در آنها برای ToC به پیوند (--make_toc). فرد می تواند انتخاب کند که یکی یا هر دو را انجام دهد
اینها.

hypertoc همچنین از قابلیت ترکیب ToC در خود سند HTML پشتیبانی می کند
از طریق گزینه --inline.

برای اینکه هایپرتوک از پیوند دادن به عناصر مهم پشتیبانی کند، هایپرتوک لنگرها را درج می کند
به عناصر مهم می توان از hypertoc به عنوان فیلتر استفاده کرد و نتیجه را به خروجی داد
فایل دیگری، یا می‌توان فایل اصلی را بازنویسی کرد، با پشتیبان‌گیری از فایل اصلی با a
پسوند (پیش فرض: "org") به نام فایل اضافه شده است.

همچنین می توان گزینه هایی را در یک فایل پیکربندی و همچنین در خط فرمان تعریف کرد.

OPTIONS

گزینه ها می توانند با "--" یا "-" شروع شوند. گزینه های بولی را می توان با قبل از آنها نفی کرد
"نه"؛ گزینه های دارای مقادیر هش یا آرایه را می توان با دادن مجدد گزینه for به آن اضافه کرد
هر مقدار

برای اطلاعات بیشتر به Getopt::Long مراجعه کنید.

--argfile نام فایل
نام یک فایل برای خواندن گزینه های بیشتر. این را می توان بیش از یک بار استفاده کرد. برای
مثال:

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

برای اطلاعات بیشتر به «فایل‌های گزینه‌ها» مراجعه کنید.

--باک
--باک رشته

اگر فایل/فایل های ورودی بازنویسی می شوند (--بازنویسی روشن است)، آن را کپی کنید
فایل اصلی به "نام فایل.رشتهاگر مقدار خالی باشد، فایل پشتیبان وجود ندارد
نوشته شده است. (پیش فرض:org)

- رفع اشکال
خروجی اشکال زدایی کامل را فعال کنید. برای رفع اشکال این ماژول استفاده می شود. به عبارت دیگر،
اذیت نکن (پیش‌فرض: خاموش)

--entrysep
--entrysep رشته

رشته جداکننده برای غیر ورودی های مورد (پیش فرض: "، ")

-- پاورقی
-- پاورقی پرونده

فایل حاوی متن پاورقی برای فهرست مطالب.

--سرتیتر
--سرتیتر پرونده

فایل حاوی متن سرصفحه فهرست مطالب.

--کمک
یک پیام راهنما کوتاه چاپ کنید و خارج شوید.

--نادیده_فقط_یک
اگر فقط یک مورد در ToC وجود دارد، ToC ایجاد نکنید.

--ignore_sole_first
اگر اولین مورد در ToC از بالاترین سطح باشد، و تنها مورد از آن است
سطح، آن را نادیده بگیرید. این در صفحات وب که تنها یک هدر H1 وجود دارد، مفید است
یک نفر از قبل نمی داند که آیا تنها یکی وجود خواهد داشت یا خیر.

-- به صورت خطی
ToC را در یک نقطه معین در سند قرار دهید. برای اطلاعات بیشتر به "Inlining ToC" مراجعه کنید.

--make_anchors | --gen_anchors
لنگرهایی برای فهرست مطالب ایجاد کنید تا به آن پیوند داده شود.

--make_toc | --gen_toc
فهرستی از مطالب تهیه کنید که به عناصر مهم لنگردار پیوند دارد.

--man_help | --manpage | --مرد
تمام اسناد را چاپ کنید و خارج شوید.

--notoc_match
--notoc_match رشته

اگر تگ های انفرادی خاصی وجود دارد که مایل به اضافه کردن آنها در جدول نیستید
محتویات، حتی اگر با "عناصر مهم" مطابقت داشته باشند، پس اگر این الگو
محتویات داخل تگ (نه بدنه) را مطابقت می دهد، سپس آن برچسب گنجانده نمی شود،
چه در تولید لنگرها و نه در تولید ToC. (پیش‌فرض: class="notoc")

--ol | --نول
از یک لیست مرتب شده برای ورودی های فهرست مطالب (به عمق معین) استفاده کنید. اگر --ol باشد
false (یعنی --nool تنظیم شده است) سپس نکن از یک لیست مرتب شده برای ورودی های ToC استفاده کنید.

(پیش فرض: نادرست)

(به --ol_num_levels مراجعه کنید تا مشخص کنید فهرست مرتب شده لیست تا چه حد عمق دارد)

--ol_num_levels
اگر --ol درست باشد، تعداد سطوح عمیق فهرست OL افزایش می یابد. اگر روی صفر تنظیم شود،
از یک لیست مرتب شده برای همه سطوح استفاده می کند. (پیش فرض: 1)

-- outfile
-- outfile پرونده

فایل برای نوشتن خروجی. اینجا جایی است که خروجی HTML اصلاح شده و Table-of-
مطالب به. اگر «-» را به عنوان نام فایل انتخاب کنید، خروجی به STDOUT می‌رود.
(پیش‌فرض: STDOUT)

--زیاد نوشتن
فایل ورودی را با خروجی بازنویسی کنید. اگر این مورد وجود داشته باشد، --outfile نادیده گرفته می شود.
مورد استفاده در generate_anchors برای ایجاد لنگرها "در محل" و در generate_toc 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 است
که شروع عنصر را نشان می دهد. در پیشوند چیزی است که لازم است از قبل آماده شود
به ورودی فهرست مطالب ایجاد شده برای آن تگ. این یک هش تجمعی است
بحث و جدل. (پیش فرض: تعریف نشده)

--toc_end
--toc_end برچسب=برچسب پایانی

--toc_end "H1=/H1"

برای تعریف عناصر مهم را برچسب تگ HTML است که شروع آن را نشان می دهد
عنصر. در برچسب پایانی تگ HTML که پایان عنصر را مشخص می کند. چه زمانی
مطابقت در فایل ورودی، حروف کوچک و بزرگ نادیده گرفته می شود (اما مطمئن شوید که همه شما برچسب گزینه های
با اشاره به همان برچسب دقیقاً یکسان هستند!). این یک آرگومان هش تجمعی است.
(پیش‌فرض: H1=/H1 H2=/H2)

--toc_entry
--toc_entry برچسب=سطح

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

برای تعریف عناصر مهم را برچسب تگ HTML است که شروع آن را نشان می دهد
عنصر. در سطح سطحی است که تگ در نظر گرفته می شود. ارزش سطح
باید عددی و غیر صفر باشد. اگر مقدار منفی است، ورودی های متوالی
نشان داده شده توسط element_element با مقدار تنظیم شده توسط جدا می شود
گزینه --entrysep. این یک آرگومان هش تجمعی است. (پیش‌فرض: H1=1 H2=2)

--toc_label | --توکلاب
--toc_label رشته

متن HTML که ToC را برچسب گذاری می کند. همیشه استفاده می شود. (پیش فرض:" فهرست مطالب ")

--toc_only | --notoc_only
فقط Table of Contents، یعنی Table of Contents به اضافه toc_label را خروجی بگیرید.
اگر یک --header یا --footer وجود داشته باشد، اینها نیز خروجی خواهند شد.

اگر --toc_only نادرست است (یعنی --notoc_only تنظیم شده است) اگر هیچ سرآغازی وجود ندارد، و
--inline درست نیست، سپس یک هدر صفحه HTML مناسب خروجی خواهد شد، و اگر وجود داشته باشد
no --footer و --inline درست نیست، سپس یک پاورقی صفحه HTML خروجی خواهد شد.
(پیش‌فرض:--notoc_only)

--toc_tag
--toc_tag رشته

اگر قرار است یک ToC به صورت درون خطی گنجانده شود، این الگوی است که برای مطابقت با برچسب استفاده می شود
جایی که ToC باید قرار گیرد. این می تواند یک تگ شروع، یک تگ پایان یا یک نظر باشد، اما
< باید کنار گذاشته شود. یعنی اگر می خواهید ToC بعد از BODY قرار گیرد
برچسب بزنید، سپس "BODY" را بدهید. اگر می‌خواهید یک تگ نظر ویژه در جایی که ToC باید ایجاد کنید
بروید، سپس علامت‌های نظر را اضافه کنید، برای مثال: "!--toc--" (پیش‌فرض:BODY)

--toc_tag_replace
در ارتباط با --toc_tag، این پرچمی است که نشان می دهد آیا تگ داده شده باید باشد یا خیر
جایگزین شود، یا اگر ToC باید بعد از تگ قرار گیرد. این می تواند مفید باشد اگر شما
toc_tag یک نظر است و بعد از نصب ToC به آن نیازی ندارید.
(پیش فرض: نادرست)

--use_id
استفاده از id="نامبرای مجریان به جاینام"> لنگر. با این حال اگر یک لنگر
قبلاً برای یک عنصر مهم وجود دارد، این یک شناسه برای آن عنصر خاص ایجاد نمی کند
عنصر

--useorg
از فایل های پشتیبان از قبل موجود به عنوان منبع ورودی استفاده کنید. یعنی فایل های فرم
نام فایل.باک (نگاه کنید به --باک).

فایل فرمها

گزینه فایل ها
با استفاده از --argfile می توان گزینه ها را در فایل ها و همچنین در خط فرمان ارائه کرد
نام فایل گزینه در خط فرمان همچنین فایل ها ~/.hypertocrc و ./.hypertocrc هستند
برای گزینه ها بررسی شد.

قالب به شرح زیر است: خطوطی که با # شروع می شوند نظرات هستند. خطوط محصور در PoD
نشانگرها نیز نظرات هستند. خطوط خالی نادیده گرفته می شوند. خود گزینه ها باید باشند
با توجه به نحوه قرار گرفتن آنها در خط فرمان، یعنی نام گزینه (شامل la
--) به دنبال آن مقدار آن (در صورت وجود).

مثلا:

# ToC را سه سطحی تنظیم کنید
--toc_entry H1=1
--toc_entry H2=2
--toc_entry 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"

یا اگر در یکی از "فایل های گزینه" ممکن تعریف شده باشد:

# تنظیمات پیش فرض
--toc_entry H1=1
--toc_end H1=/H1
--toc_entry H2=2
--toc_end H2=/H2

مثال of قبل و بعد از

گزینه های زیر از گزینه های قبل / بعد استفاده می کنند:

# فایل گزینه ای که قالب بندی را اضافه می کند
# ورودی های ToC سطح 1 را ایجاد کنید
--toc_entry H1=1
--toc_end H1=/H1
--toc_before H1=
--toc_after H1=

# ورودی های ToC سطح 2 را انجام دهید
--toc_entry H2=2
--toc_end H2=/H2
--toc_before H2=
--toc_after H2=

# ورودی های سطح 3 را همانطور که هست انجام دهید
--toc_entry H3=3
--toc_end H3=/H3

مثال of سفارشی پایان

گزینه های زیر سعی می کنند اصطلاحات تعریف را نمایه کنند:

# یک فایل گزینه که می تواند برای اسناد نوع واژه نامه کار کند
--toc_entry H1=1
--toc_end H1=/H1
--toc_entry H2=2
--toc_end H2=/H2

# فرض می کند که سند برای هر DT یک DD دارد، در غیر این صورت ToC
# ورودی هایی با متن زیاد دریافت می کند.
--toc_entry DT=3
--toc_end DT=DD
--toc_before DT=
--toc_after DT=

قالب بندی la توالت
گزینه های --toc_entry و غیره به شما امکان کنترل نحوه ظاهر ورودی های ToC را می دهد، اما وجود دارد
گزینه های دیگری برای تأثیرگذاری بر ظاهر نهایی فایل ToC ایجاد شده است.

با گزینه --header، محتویات فایل داده شده قبل از
ToC تولید شده است. این به شما امکان می دهد قبل از متن مقدمه یا هر متن دیگری داشته باشید
ToC.

توجه داشته باشید:
اگر از گزینه --header استفاده می کنید، مطمئن شوید که فایل مشخص شده حاوی HTML ابتدایی باشد
تگ، عنصر HEAD (شامل عنصر TITLE) و تگ BODY افتتاحیه.
با این حال، اگر گزینه های --inline هستند، این تگ ها/عناصر نباید در فایل هدر باشند
استفاده می شود. برای اطلاعات در مورد آنچه که فایل سرصفحه باید حاوی آن باشد، به "Inlining ToC" مراجعه کنید
برای داخل کردن ToC.

با گزینه --toc_label، محتویات رشته داده شده قبل از
ToC تولید می شود (اما بعد از هر متنی که از یک فایل --header گرفته شده است).

با گزینه --footer محتویات فایل پس از تولید اضافه می شود
ToC.

توجه داشته باشید:
اگر از -footer استفاده می کنید، مطمئن شوید که شامل بسته شدن برچسب های BODY و HTML است (مگر اینکه
البته، شما از گزینه --inline استفاده می کنید).

اگر گزینه --header مشخص نشده باشد، نشانه گذاری HTML شروع مناسب خواهد بود
اضافه شد، مگر اینکه گزینه --toc_only مشخص شده باشد. اگر گزینه --footer نباشد
مشخص شده، نشانه‌گذاری HTML برای بستن مناسب اضافه خواهد شد، مگر اینکه گزینه --toc_only باشد
مشخص شده است.

اگر نمی‌خواهید/نیازی به رسیدگی به فایل‌های هدر و پاورقی ندارید، به شما اختصاص داده می‌شود
عنوان، گزینه --title، فایل ToC را مشخص کنید. و به شما اجازه می دهد که a را مشخص کنید
عنوان یا برچسب، گزینه --toc_label را قبل از لیست ورودی های ToC قرار دهید. هر دو گزینه
مقادیر پیش فرض داشته باشید، برای اطلاعات بیشتر در مورد هر گزینه به "OPTIONS" مراجعه کنید.

اگر نمی‌خواهید تگ‌های صفحه HTML ارائه شود و فقط خود ToC را می‌خواهید، پس
گزینه --toc_only را مشخص کنید. اگر هیچ فایل --header یا --footer وجود نداشته باشد، این کار وجود دارد
به سادگی محتویات --toc_label و خود ToC را خروجی بگیرید.

خط کشی la توالت
توانایی ترکیب ToC به طور مستقیم در یک سند HTML از طریق پشتیبانی می شود
- گزینه inline.

Inlining در اولین فایل در لیست فایل های پردازش شده انجام می شود و فقط انجام می شود
در صورتی انجام می شود که آن فایل دارای یک تگ باز مطابق با مقدار --toc_tag باشد.

اگر --overwrite درست باشد، اولین فایل در لیست با علامت بازنویسی می شود
ToC تولید شده در محل مناسب درج شده است. در غیر این صورت یک نسخه اصلاح شده از اول
فایل به STDOUT یا به فایل خروجی تعریف شده توسط گزینه --outfile خروجی می شود.

گزینه های --toc_tag و --toc_tag_replace برای تعیین مکان و چگونگی ToC استفاده می شوند.
در خروجی قرار داده شده است.

مثال 1

# این پیش فرض است
--toc_tag BODY --notoc_tag_replace

این ToC تولید شده را بعد از تگ BODY اولین فایل قرار می دهد. اگر سر --
گزینه مشخص شده است، سپس محتویات فایل مشخص شده بعد از BODY درج می شود
برچسب زدن اگر گزینه --toc_label خالی نیست، متنی که توسط --toc_label مشخص شده است
گزینه درج شده است سپس ToC وارد می شود و در نهایت اگر گزینه --footer باشد
مشخص شده، پاورقی را درج می کند. سپس بقیه فایل ورودی به شکل قبلی است
قبل از.

مثال 2

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

این ToC تولید شده را بعد از اولین نظر فرم قرار می دهد ، و آن
نظر با ToC (به ترتیب
--سرتیتر
--toc_label
توالت
--footer) و سپس بقیه فایل ورودی.

توجه داشته باشید:
فایل هدر نباید حاوی تگ HTML ابتدایی و عنصر HEAD باشد
فایل HTML در حال پردازش باید قبلاً حاوی این برچسب ها/عناصر باشد.

مثال ها

ساختن an خطی توالت برای یک پرونده
hypertoc --inline --make_anchors --بازنویسی --make_toc index.html

این لنگرها را در "index.html" ایجاد می کند، یک ToC با عنوان "Table of
Contents" و بعد از تگ BODY "index.html" قرار دهید. فایل index.html.org
حاوی فایل index.html اصلی، بدون ToC یا لنگر.

ساختن a توالت پرونده از جانب چندگانه فایل ها
ابتدا لنگرها را ایجاد کنید.

hypertoc --make_anchors --overwrite index.html fred.html george.html

سپس ToC را ایجاد کنید

hypertoc --make_toc --outfile table.html index.html fred.html george.html

ساختن an خطی توالت بعد از la اول عنوان of la اول پرونده
hypertoc --make_anchors --inline -- overwrite --make_toc --toc_tag /H1 \
--notoc_tag_replace --toc_label "" index.html fred.html george.html

با این کار، لنگرها در فایل های "index.html"، "fred.html" و "george.html" ایجاد می شود.
یک ToC بدون هدر و آن را بعد از اولین هدر H1 در "index.html" قرار دهید و از آن نسخه پشتیبان تهیه کنید
فایل های اصلی به "index.html.org"، "fred.html.org" و "george.html.org"

ساختن an خطی توالت با سفارشی عناصر
hypertoc --quiet --make_anchors --bak "" --overwrite \
--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 درون خطی ایجاد می کند که فایل اصلی را بازنویسی می کند و جایگزین a می شود
نظر، و که سرصفحه های H2 را به عنوان سطح 1 و سرصفحه های H3 را به عنوان سطح 2 می گیرد. این می تواند باشد
در جایی که فایل html توسط فرآیند دیگری تولید می شود مفید است و شما می توانید آن را ایجاد کنید
ToC به عنوان آخرین مرحله.

ساختن a توالت با سفارشی عناصر
hypertoc --quiet --make_anchors --bak "" --overwrite \
--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 george.html

این لنگرها را در عناصر H2 و H3 ایجاد می کند و یک فایل ToC به نام index.html ایجاد می کند.
نمایه سازی در TITLE و عناصر H2 و H3.

ساختن a توالت با سفارشی عناصر و گزینه های پرونده
یک فایل گزینه به نام "custom.opt" به شرح زیر داده می شود:

# عنوان، H2 و H3
--toc_entry TITLE=1
--toc_end TITLE=/TITLE
--toc_entry H2=2
--toc_end H2=/H2
--toc_entry H3=3
--toc_end H3=/H3

سپس مثال قبلی می تواند خطوط فرمان کوتاه تری به شرح زیر داشته باشد:

hypertoc --quiet --make_anchors --bak "" --overwrite \
--argfile custom.opt --make_toc --outfile index.html mary.html fred.html george.html

NOTES

· هایپرتوک به اندازه کافی هوشمند است تا لنگرها را در عناصر مهم تشخیص دهد. اگر لنگر
ویژگی NAME را تعریف می کند، hypertoc از مقدار استفاده می کند. در غیر این صورت، NAME خود را اضافه می کند
نسبت دادن به لنگر. اگر --use_id درست باشد، به همین ترتیب بررسی می کند و استفاده می کند
شناسنامه ها

· اگر عنصر TITLE به عنوان یک عنصر مهم مشخص شده باشد، به‌ویژه رفتار می‌شود. این است
درج لنگر (A) در عناصر TITLE غیرقانونی است. بنابراین، hypertoc در واقع خواهد شد
به جای عنصر TITLE سند، به خود نام فایل پیوند دهید.

· 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. در غیر این صورت ToC دارای لنگر خواهد بود
اشاره به فایل هایی که آنها را ندارند.

· هنگام استفاده از --inline، در صورت بازنویسی - در صورتی که ToC روی آن تنظیم شود، باید مراقب باشید
بعد از یک تگ داده شده (مانند BODY پیش فرض) قرار داده شود، سپس اگر یکی دستور را اجرا کند
به طور مکرر یکی پس از دیگری می تواند چندین ToC را در یک فایل دریافت کند.

هشدارها

· نسخه 3.10 (و بالاتر) لنگرهای پرمخاطب (سئو دوستانه) بیشتری نسبت به قبل ایجاد می کند.
نسخه ها بنابراین لنگرهای تولید شده با نسخه های قبلی با نسخه 3.10 مطابقت ندارند
لنگرها

· نسخه 3.00 (و بالاتر) hypertoc تا حدودی متفاوت از نسخه 2.x رفتار می کند.
هایپرتوک اکنون برای انجام همه کارها در یک پاس طراحی شده است، و برخی از آن کاهش یافته است
گزینه‌ها: گزینه --infile دیگر استفاده نمی‌شود (همه نام فایل‌ها در پایان قرار داده می‌شوند
فرمان)؛ گزینه --toc_file دیگر وجود ندارد. از گزینه --outfile استفاده کنید
بجای؛ گزینه --tocmap دیگر پشتیبانی نمی شود.

اکنون تگ‌های حروف کوچک را به جای تگ‌های بزرگ تولید می‌کند.

· هایپرتوک بسیار کارآمد نیست (حافظه و سرعت)، و می تواند برای بزرگ کند
اسناد.

· اکنون آن نسل از لنگرها و ToC در یک پاس انجام می شود، حتی حافظه بیشتر
نسبت به قبل استفاده می شود. این در هنگام پردازش چندگانه بیشتر قابل توجه است
فایل‌ها، زیرا همه فایل‌ها قبل از پردازش در حافظه خوانده می‌شوند.

· اگر یک عنصر قابل توجه در داخل یک وجود داشته باشد نشانه گذاری نامعتبر ایجاد می شود
لنگر. مثلا:

دستور FOO

تبدیل خواهد شد به (اگر h1 عنصر مهمی باشد)،

دستور FOO

که غیرقانونی است زیرا لنگرها را نمی توان تودرتو کرد.

بهتر است دستورات لنگر را در عنصری که قرار است لنگر بیاندازید، قرار دهید. برای
به عنوان مثال، موارد زیر ترجیح داده می شود:

دستور FOO

hypertoc NAME "foo" را شناسایی کرده و از آن استفاده می کند.

حتی بهتر است از ID استفاده کنید:

دستور FOO

· ویژگی های NAME بدون نقل قول شناسایی نمی شوند.

با استفاده از خدمات onworks.net از hypertocp آنلاین استفاده کنید