makeindex - ออนไลน์ในคลาวด์

โครงการ:

ชื่อ

makeindex - วัตถุประสงค์ทั่วไป ตัวประมวลผลดัชนีที่ไม่ขึ้นกับฟอร์แมตเตอร์

เรื่องย่อ

ทำดัชนี [-c] [-g] [-i] [-l] [-o ตัว] [-p NUM] [-q] [-r] [-s ไฟล์] [-t เข้าสู่ระบบ] [-L] [-T]
[รหัส0 รหัส1 รหัส2... ]

DESCRIPTION

โปรแกรม ทำดัชนี เป็นเครื่องกำเนิดดัชนีแบบลำดับชั้นวัตถุประสงค์ทั่วไป มันยอมรับอย่างใดอย่างหนึ่งหรือ
ไฟล์อินพุตเพิ่มเติม (มักสร้างโดยตัวจัดรูปแบบข้อความเช่น TeX (tex(1L)) หรือ troff(1)
เรียงลำดับรายการ และสร้างไฟล์เอาต์พุตที่สามารถจัดรูปแบบได้ ดัชนีสามารถมี
มากถึงสามระดับ (0, 1 และ 2) ของการซ้อนรายการย่อย วิธีที่คำถูกตั้งค่าสถานะ
สำหรับการจัดทำดัชนีภายในเอกสารหลักนั้นใช้เฉพาะกับฟอร์แมตเตอร์ที่ใช้ ทำดัชนี ทำ
ไม่ ทำให้กระบวนการเลือกคำเหล่านี้เป็นไปโดยอัตโนมัติ เนื่องจากดัชนีผลลัพธ์เป็นแบบลำดับชั้น
ทำดัชนี สามารถถือเป็นส่วนเสริมของ awk(1)-ตาม make.ดัชนี(1L) ระบบของ
Bentley และ Kernighan ซึ่งมีความเฉพาะเจาะจงสำหรับ troff(1) สร้างดัชนีที่ไม่ใช่ลำดับชั้น
และใช้ไวยากรณ์ที่ง่ายกว่ามากในการระบุรายการดัชนี สำหรับภาพประกอบการใช้งาน
กับ troff และ เท็กซ์ดูหัวข้อตัวอย่างด้านล่าง

รูปแบบของไฟล์อินพุตและเอาต์พุตถูกระบุในไฟล์สไตล์ โดยค่าเริ่มต้น input
จะถือว่า a .idx ไฟล์ที่สร้างโดย LaTeX

เว้นแต่จะระบุไว้อย่างชัดเจน ชื่อฐานของไฟล์อินพุตแรก (รหัส0) ใช้เพื่อ
กำหนดชื่อไฟล์อื่นๆ สำหรับแต่ละชื่อไฟล์อินพุตที่ระบุ ไฟล์ของ that
มีการค้นหาชื่อ หากไม่พบไฟล์นี้และชื่อไฟล์ไม่มีนามสกุลไฟล์
นามสกุล .idx ถูกผนวก หากไม่พบไฟล์ที่มีชื่อนี้ ทำดัชนี ยกเลิก

หากระบุไฟล์อินพุตเพียงหนึ่งไฟล์และไม่ได้ระบุไฟล์รูปแบบที่ชัดเจนโดยใช้ -s,
ทำดัชนี ใช้ไฟล์ที่มีนามสกุล .mst เป็นไฟล์สไตล์เริ่มต้น (เมื่อมี)

สำหรับหมายเหตุสำคัญเกี่ยวกับวิธีการเลือกดัชนีคำหลัก ดูเอกสารโดย Lamport อ้าง
ด้านล่าง. เนื่องจากเป็นประเด็นที่แยกจากการเลือกดัชนีคำสำคัญ กลไกที่เป็นระบบสำหรับ
แนะนำให้วางเงื่อนไขดัชนีในเอกสารใน ดัชนี การเตรียมพร้อม และ การประมวลผลที่
กระดาษที่อ้างถึงด้านล่าง

OPTIONS

-c บีบอัดช่องว่างตรงกลาง (ละเว้นช่องว่างและแท็บนำหน้าและต่อท้าย)
โดยค่าเริ่มต้น ช่องว่างในคีย์ดัชนีจะยังคงอยู่

-g ใช้การเรียงลำดับคำภาษาเยอรมันในดัชนี ตามกฎที่กำหนดไว้ในDIN
5007. โดยค่าเริ่มต้น ทำดัชนี ใช้การเรียงลำดับคำซึ่งมีความสำคัญกว่า:
สัญลักษณ์ ตัวเลข ตัวพิมพ์ใหญ่ ตัวพิมพ์เล็ก ลำดับในภาษาเยอรมัน
การเรียงลำดับคำคือ: สัญลักษณ์, ตัวพิมพ์เล็ก, ตัวพิมพ์ใหญ่, ตัวเลข
นอกจากนี้ ตัวเลือกนี้จะเปิดใช้งาน ทำดัชนี เพื่อรับรู้คำสั่ง TeX ของเยอรมัน
{"a, "o, "u และ "s} เป็น {ae, oe, ue และ ss} ในระหว่างการจัดเรียงรายการ
ต้องกำหนดอักขระเครื่องหมายคำพูดใหม่ในไฟล์รูปแบบ (เช่น redefine
อ้างเป็น '+') หากไม่ได้กำหนดตัวอักษรคำพูดใหม่ ทำดัชนี จะผลิต
ข้อความแสดงข้อผิดพลาดและยกเลิก

-i รับข้อมูลจาก สเตดิน. เมื่อระบุตัวเลือกนี้และ -o ไม่ใช่ ผลลัพธ์คือ
เขียนไป แย่.

-l การสั่งซื้อจดหมาย; โดยค่าเริ่มต้น การเรียงลำดับคำจะถูกใช้ (ดูส่วนการสั่งซื้อ)

-o ตัว จ้าง ตัว เป็นไฟล์ดัชนีเอาต์พุต ตามค่าเริ่มต้น ชื่อไฟล์จะถูกสร้างขึ้นโดย
ต่อท้ายนามสกุล .ind ไปยังชื่อฐานของไฟล์อินพุตแรก (รหัส0).

-p NUM ตั้งค่าหมายเลขหน้าเริ่มต้นของไฟล์ดัชนีผลลัพธ์เป็น be NUM (มีประโยชน์เมื่อ
ไฟล์ดัชนีจะต้องจัดรูปแบบแยกต่างหาก) อาร์กิวเมนต์ NUM อาจเป็นตัวเลขหรือ
หนึ่งในสิ่งต่อไปนี้:

ใด หน้าเริ่มต้นคือหมายเลขหน้าต้นทางสุดท้าย บวก 1

คี่ หน้าเริ่มต้นเป็นหน้าคี่หน้าแรกที่อยู่ถัดจากหน้าต้นทางสุดท้าย
จำนวน.

แม้ หน้าเริ่มต้นคือหน้าคู่หน้าแรกตามแหล่งที่มาสุดท้าย
เลขหน้า.

หน้าต้นทางสุดท้ายได้มาจากการค้นหาย้อนหลังในล็อกไฟล์สำหรับ
ตัวอย่างแรกของตัวเลขที่รวมอยู่ในวงเล็บเหลี่ยมที่จับคู่ ([...]). ถ้า
ไม่มีหมายเลขหน้าหรือไม่พบไฟล์บันทึกจะไม่พยายามทำ
กำหนดหมายเลขหน้าเริ่มต้น ชื่อไฟล์บันทึกต้นทางถูกกำหนดโดย
ต่อท้ายนามสกุล .log ไปยังชื่อฐานของไฟล์อินพุตแรก (รหัส0).

-q โหมดเงียบ; ไม่ส่งข้อความถึง สตเดอร์. โดยค่าเริ่มต้น ความคืบหน้าและข้อความแสดงข้อผิดพลาด
ถูกส่งไปยัง สตเดอร์ เช่นเดียวกับไฟล์การถอดเสียง

-r ปิดใช้งานการสร้างช่วงหน้าโดยนัย ต้องสร้างช่วงหน้าโดยใช้
ตัวดำเนินการช่วงที่ชัดเจน ดูเอฟเฟกต์พิเศษด้านล่าง โดยค่าเริ่มต้น สามหรือมากกว่า
หน้าที่ต่อเนื่องกันจะถูกย่อโดยอัตโนมัติเป็นช่วง (เช่น 1–5)

-s จัดแต่งทรงผม จ้าง จัดแต่งทรงผม เป็นไฟล์สไตล์ (ไม่มีค่าเริ่มต้น) ตัวแปรสภาพแวดล้อม INDEXSTYLE
กำหนดเส้นทางที่จะพบไฟล์สไตล์

-t เข้าสู่ระบบ จ้าง เข้าสู่ระบบ เป็นไฟล์การถอดเสียง โดยค่าเริ่มต้น ชื่อไฟล์จะถูกสร้างขึ้นโดย
ต่อท้ายนามสกุล .il ไปยังชื่อฐานของไฟล์อินพุตแรก (รหัส0).

-L จัดเรียงตามการตั้งค่าสถานที่ ใช้ไม่ได้กับทุกระบบ

-T การสนับสนุนพิเศษสำหรับเอกสารภาษาไทย ใช้ไม่ได้กับทุกระบบ

สไตล์ ไฟล์

ไฟล์สไตล์แจ้ง ทำดัชนี เกี่ยวกับรูปแบบของ .idx ไฟล์อินพุตและวัตถุประสงค์
รูปแบบของไฟล์เอาต์พุตสุดท้าย ตัวอย่างปรากฏด้านล่าง ไฟล์นี้สามารถอยู่ที่ใดก็ได้ใน
เส้นทางที่กำหนดโดยตัวแปรสภาพแวดล้อม INDEXSTYLE ไฟล์สไตล์ประกอบด้วยรายการ
ของตัวระบุ, คุณลักษณะ>คู่. ตัวระบุมีสองประเภท: อินพุตและเอาต์พุต
คู่เงินไม่จำเป็นต้องปรากฏในลำดับใดโดยเฉพาะ บรรทัดที่ขึ้นต้นด้วย `%' คือความคิดเห็น
ในรายการตัวระบุและอาร์กิวเมนต์ต่อไปนี้ เป็นสตริงโดยพลการ
คั่นด้วยเครื่องหมายคำพูดคู่ ("..."), เป็นอักษรตัวเดียวที่โอบล้อมด้วยคำพูดเดียว
('...'), และ เป็นจำนวนเต็มที่ไม่ติดลบ ความยาวสูงสุดของa คือ 2048
แบ็กสแลชตามตัวอักษรหรือเครื่องหมายคำพูดต้องหลีกหนี (โดยแบ็กสแลช) สิ่งใดที่ไม่ได้ระบุไว้ใน
ไฟล์สไตล์จะได้รับการกำหนดค่าเริ่มต้นซึ่งจะแสดงที่ส่วนหัวของ
คอลัมน์ขวาสุด

INPUT สไตล์ ผู้จำเพาะ
ที่เกิดขึ้นจริง '@'
สัญลักษณ์ระบุว่ารายการถัดไปจะปรากฏในผลลัพธ์
ไฟล์

arg_close ´}´
การปิดตัวคั่นสำหรับอาร์กิวเมนต์รายการดัชนี

arg_open ´{´
การเปิดตัวคั่นสำหรับอาร์กิวเมนต์รายการดัชนี

ห่อหุ้ม '|'
สัญลักษณ์แสดงว่ารายการอาร์กิวเมนต์ที่เหลือจะเป็น
ใช้เป็นคำสั่งห่อหุ้มหมายเลขหน้า

หลบหนี ´\\´
สัญลักษณ์ที่เว้นตัวอักษรต่อไปนี้ เว้นแต่จะมาก่อน
จดหมายคือ หลบหนี. บันทึก: หุ้น ใช้สำหรับหนีอักษรซึ่ง
ตามมาทันที แต่ถ้านำหน้าด้วย หลบหนี, มันคือ
ถือว่าเป็นตัวละครธรรมดา สองสัญลักษณ์นี้ ต้อง be
แตกต่าง.

คีย์เวิร์ด "\\รายการดัชนี"
คำสั่งที่บอก ทำดัชนี ว่าข้อโต้แย้งของมันคือดัชนี
การเข้า

ระดับ '!'
ตัวคั่นแสดงถึงระดับใหม่ของรายการย่อย

page_compositor "-"
ตัวคั่นแยกส่วนต่าง ๆ ของหมายเลขหน้ารวม (ดู
เอฟเฟกต์พิเศษด้านล่าง)

หุ้น '"'
หมายเหตุ หุ้น จะใช้หนีอักษรซึ่งทันที
ตามมา แต่ถ้านำหน้าด้วย หลบหนี, จะถือว่าเป็น
ตัวละครธรรมดา สองสัญลักษณ์นี้ ต้อง มีความชัดเจน

ช่วง_ปิด ')'
ตัวคั่นปิดซึ่งระบุจุดสิ้นสุดของช่วงหน้าที่ชัดเจน

range_open '('
ตัวคั่นการเปิดระบุจุดเริ่มต้นของหน้าที่ชัดเจน
พิสัย.

เอาท์พุท สไตล์ ผู้จำเพาะ
คำนำ "\\เริ่มต้น{ดัชนี}\n"
คำนำของไฟล์ที่ส่งออก

ไปรษณีย์ "\n\n\\end{theindex}\n"
Postamble ของไฟล์ที่ส่งออก

setpage_prefix "\n \\setcounter{page}{"
คำนำหน้าของคำสั่งซึ่งกำหนดหมายเลขหน้าเริ่มต้น

setpage_suffix "}\n"
คำต่อท้ายของคำสั่งซึ่งกำหนดหมายเลขหน้าเริ่มต้น

group_skip "\n\n \\indexspace\n"
ช่องว่างแนวตั้งที่จะแทรกก่อนที่จะเริ่มกลุ่มใหม่

headings_flag 0
ธงแสดงการรักษาหัวหน้ากลุ่มใหม่ ได้แก่
แทรกเมื่ออยู่ข้างหน้ากลุ่มใหม่ (สัญลักษณ์ ตัวเลข และ 26
ตัวอักษร): ค่าบวกทำให้ตัวพิมพ์ใหญ่เป็น
แทรกระหว่างคำนำหน้าและคำต่อท้าย และค่าลบทำให้เกิดa
ตัวพิมพ์เล็กที่จะแทรก (ค่าเริ่มต้นคือ 0 ซึ่งสร้าง no
หัวข้อ).

heading_prefix ""
จะต้องใส่คำนำหน้าหัวจดหมายก่อนเริ่มตัวอักษรใหม่

heading_suffix ""
ตัวอักษรต่อท้ายหัวเรื่องที่จะแทรกเมื่อเริ่มต้นตัวอักษรใหม่

symhead_positive
"สัญลักษณ์"
หัวข้อสำหรับสัญลักษณ์ที่จะแทรก if headings_flag เป็นบวก

symhead_negative
"สัญลักษณ์"
หัวข้อสำหรับสัญลักษณ์ที่จะแทรก if headings_flag เป็นลบ

numhead_positive
"ตัวเลข"
หัวเรื่องที่จะใส่ตัวเลข if headings_flag เป็นบวก

numhead_negative
"ตัวเลข"
หัวเรื่องที่จะใส่ตัวเลข if headings_flag เป็นลบ

item_0 "\n \\รายการ "
คำสั่งที่จะแทรกระหว่างสองรายการหลัก (ระดับ 0)

item_1 "\n \\subitem "
คำสั่งที่จะแทรกระหว่างสองรายการรอง (ระดับ 1)

item_2 "\n \\subitem "
คำสั่งที่จะแทรกระหว่างสองรายการระดับ 2

item_01 "\n \\subitem "
คำสั่งที่จะแทรกระหว่างรายการระดับ 0 และรายการระดับ 1

รายการ_x1 "\n \\subitem "
คำสั่งที่จะแทรกระหว่างรายการระดับ 0 และรายการระดับ 1
โดยที่รายการระดับ 0 ไม่มีหมายเลขหน้าที่เกี่ยวข้อง

item_12 "\n \\subitem "
คำสั่งที่จะแทรกระหว่างรายการระดับ 1 และรายการระดับ 2

รายการ_x2 "\n \\subitem "
คำสั่งที่จะแทรกระหว่างรายการระดับ 1 และรายการระดับ 2
โดยที่รายการระดับ 1 ไม่มีหมายเลขหน้าที่เกี่ยวข้อง

เดลิม_0 ", "
ตัวคั่นที่จะแทรกระหว่างคีย์ระดับ 0 และหน้าแรก
หมายเลข (ค่าเริ่มต้น: เครื่องหมายจุลภาคตามด้วยช่องว่าง)

เดลิม_1 ", "
ตัวคั่นที่จะแทรกระหว่างคีย์ระดับ 1 และหน้าแรก
หมายเลข (ค่าเริ่มต้น: เครื่องหมายจุลภาคตามด้วยช่องว่าง)

เดลิม_2 ", "
ตัวคั่นที่จะแทรกระหว่างคีย์ระดับ 2 และหน้าแรก
หมายเลข (ค่าเริ่มต้น: เครื่องหมายจุลภาคตามด้วยช่องว่าง)

เดลิม_n ", "
ตัวคั่นที่จะแทรกระหว่างสองหมายเลขหน้าเหมือนกัน
คีย์ในระดับใดก็ได้ (ค่าเริ่มต้น: เครื่องหมายจุลภาคตามด้วยช่องว่าง)

เดลิม_r "--"
ตัวคั่นที่จะแทรกระหว่างหน้าเริ่มต้นและหน้าสิ้นสุด
ตัวเลขของช่วง

เดลิม_t ""
ตัวคั่นที่จะแทรกที่ส่วนท้ายของรายการหน้า นี้
ตัวคั่นไม่มีผลกับรายการที่ไม่มีหน้าที่เกี่ยวข้อง
รายการ.

encap_prefix "\\"
ส่วนแรกของคำนำหน้าสำหรับคำสั่งที่ห่อหุ้มเพจ
จำนวน.

encap_infix "{"
ส่วนที่สองของคำนำหน้าสำหรับคำสั่งที่ห่อหุ้มเพจ
จำนวน.

encap_suffix "}".
คำต่อท้ายสำหรับคำสั่งที่ห่อหุ้มหมายเลขหน้า

page_precedence "อาร์นาอาร์"
ลำดับความสำคัญของประเภทหน้า ค่าเริ่มต้นระบุ: ตัวพิมพ์เล็ก
โรมัน, ตัวเลข/อารบิก, ตัวอักษรพิมพ์เล็ก, อักษรโรมันตัวพิมพ์ใหญ่,
ตัวอักษรตัวพิมพ์ใหญ่

line_max 72
ความยาวสูงสุดของบรรทัดในเอาต์พุต เกินกว่าที่ line
ห่อ

indent_space "\t\t"
ช่องว่างที่จะแทรกหน้าบรรทัดที่ห่อ (ค่าเริ่มต้น: two
แท็บ)

เยื้อง_ความยาว 16
ความยาวของ indent_space (ค่าเริ่มต้น: 16 เทียบเท่ากับ 2 แท็บ)

คำต่อท้าย_2p ""
ตัวคั่นเพื่อแทนที่ตัวคั่นช่วงและหน้าที่สอง
จำนวนรายการสองหน้า เมื่อปัจจุบันจะแทนที่ เดลิม_r.
ตัวอย่าง: "f.".

คำต่อท้าย_3p ""
ตัวคั่นเพื่อแทนที่ตัวคั่นช่วงและหน้าที่สอง
จำนวนสามหน้ารายการ เมื่อปัจจุบันจะแทนที่ เดลิม_r
และ คำต่อท้าย_mp. ตัวอย่าง: "ff.".

คำต่อท้าย_mp ""
ตัวคั่นเพื่อแทนที่ตัวคั่นช่วงและหน้าที่สอง
จำนวนรายการหลายหน้า (สามหน้าขึ้นไป) เมื่อไหร่
ปัจจุบันมันแทนที่ เดลิม_r. ตัวอย่าง: "f.".

ตัวอย่าง

เท็กซ์ ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงไฟล์รูปแบบที่เรียกว่า หนังสือ.istซึ่งกำหนดดัชนีสำหรับa
หนังสือที่สามารถจัดรูปแบบโดยอิสระจากแหล่งที่มาหลัก:

คำนำ
"\\documentstyle[12pt]{หนังสือ}
\\เริ่มต้น{เอกสาร}
\\เริ่มต้น{ดัชนี}
{\\เล็ก\n"
ไปรษณีย์
"\n\n}
\\end{ดัชนี}
\\end{เอกสาร}\n"

สมมติว่ารูปแบบหนังสือเฉพาะต้องการดัชนี (เช่นเดียวกับบทใด ๆ ) ถึง
เริ่มจากเลขหน้าคี่และชื่อไฟล์อินพุต foo.idxดังต่อไปนี้
บรรทัดคำสั่งสร้างเอาต์พุตในไฟล์ footmp.ind:

makeindex -s book.ist -o footmp.ind -p แปลก foo

ที่นี่ใช้ชื่อไฟล์เอาท์พุตที่ไม่ใช่ค่าเริ่มต้นเพื่อหลีกเลี่ยงการปิดกั้นเอาต์พุตสำหรับหนังสือ
ตัวเอง (น่าจะ ฟู.ดีวีไอซึ่งจะเป็นชื่อเริ่มต้นสำหรับเอาต์พุตดัชนี
ไฟล์!).

ทรอฟ ตัวอย่าง
ไฟล์ควบคุมตัวอย่างสำหรับสร้างดัชนี ซึ่งเราจะถือว่าอยู่ในไฟล์
ตัวอย่าง.ist:

คำสำคัญ "ทรงเครื่อง:"
คำนำ
".\\\" เริ่มต้นของเอาต์พุตดัชนี
\".\\\" เข้าสู่โหมดสองคอลัมน์
.2ซ
.NS
.นี้
ดัชนี
.XS
ดัชนี
.XE
.R
.ปล. 9p
.ต่อ 11p
.sp
.de I1
.ti 0.25i
..
.de I2
.ti 0.5i
.. "
postamble "\n.\\\" สิ้นสุดเอาต์พุตดัชนี"
setpage_prefix "\n.nr % "
setpage_suffix ""
group_skip "\n.sp 1.0"
หัวเรื่อง_ธง 1
heading_prefix "\n.IS\n"
heading_suffix "\n.IE"
item_0 "\n.br\n"
item_1 "\n.I1\n"
item_2 "\n.I2\n"
item_01 "\n.I1\n"
item_x1 "\n.I1\n"
item_12 "\n.I2\n"
item_x2 "\n.I2\n"
delim_0 ", "
delim_1 ", "
delim_2 ", "
delim_r "-"
delim_t "."
encap_prefix "\\fB"
encap_infix ""
encap_suffix "\\fP"
indent_space ""
indent_length 0

แพ็คเกจแมโครในเครื่องอาจต้องมีการแก้ไข ดังในตัวอย่างนี้ของส่วนขยายถึง
-นางสาว มาโคร (โปรดทราบว่าในบางไซต์ มาโครนี้ควร แทนที่ มาโครที่มีอยู่ก่อนของ
ชื่อเดียวกัน):

.
.de ทรงเครื่อง
.ie '\\n(.z'' .tm IX: \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9 {\\n(PN}
.el \\!.IX \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9 {\\n(PN}
..

(โปรดทราบว่าสตริง {\\n(PN} แยกจากส่วนที่เหลือของบรรทัดด้วยแท็บ ถ้าคุณ
แพ็คเกจแมโครในเครื่องไม่มีส่วนขยายนี้ เพียงรวมบรรทัดเหล่านั้นที่
จุดเริ่มต้นของไฟล์ของคุณ ง่ายๆแบบนี้ troff(1) ไฟล์อินพุต ซึ่งเราจะถือว่า is
ชื่อ ตัวอย่าง.txt:

นี่คือไฟล์ตัวอย่างเพื่อทดสอบ \fImakeindex\fP(1 ลิตร)
โปรแกรมและดู
.IX {การทำดัชนี!โปรแกรม!ภาษาซี}
.IX {makeindex@\fImakeindex\fP(1ลิตร)}
.bp
.rs
.IX {นัต}
.IX {การเรียงพิมพ์!คอมพิวเตอร์ช่วย}
มันทำงานได้ดีแค่ไหนใน \fItroff\fP(1) สิ่งแวดล้อม

โปรดทราบว่ารายการดัชนีจะถูกระบุโดย ทรงเครื่อง มาโครซึ่งทำให้ข้อความต่อไปนี้เป็น
เขียนถึง แย่ พร้อมกับเลขหน้าปัจจุบัน

การสร้าง DIE ดัชนี ไฟล์ IN DIE บอร์น SHELL
เพื่อสร้างไฟล์อินพุตสำหรับ ทำดัชนี, in บอร์น เปลือก สิ่งแวดล้อม ทำเท่าเทียม
ที่เว็บไซต์ของคุณคำสั่ง:

psroff -ms -Tpsc -t sample.txt > /dev/null 2> sample.tmp

บางเว็บไซต์จะต้อง ดิทรอฟฟ์ แทน พอใจ. เพื่อกรองข้อผิดพลาดที่แท้จริง
ข้อความ, เรียกใช้ grep(1):

grep '^IX:' sample.tmp > sample.idx

การสร้าง DIE ดัชนี ไฟล์ ใช้ ยูซีเอสเอฟ ปรับปรุง TROFF/ทรานสคริป
ด้วย UCSF Enhanced troff/TRANSCRIPT, the -I ตัวเลือกของ พอใจ(1L) สามารถผลิตได้ทั้ง
ฟอร์แมตเตอร์เอาต์พุตและไฟล์ดัชนี:

psroff -ms -I ตัวอย่าง.inp -Tpsc ตัวอย่าง.txt

หากต้องการระงับเอาต์พุตของฟอร์แมตเตอร์:

psroff -ms -I sample.inp -Tpsc -t sample.txt > /dev/null

เสร็จสิ้น DIE ดัชนี
ขั้นตอนใด ๆ ข้างต้นออกจากอินพุตสำหรับ ทำดัชนี in ตัวอย่าง.inp. ขั้นตอนต่อไป
คือการเรียกใช้ ทำดัชนี:

makeindex -s ตัวอย่าง.ist ตัวอย่าง.idx

ใบนี้ troff(1)-พร้อมเอาต์พุตในไฟล์ ตัวอย่าง.ind.

การสั่งซื้อ

โดยค่าเริ่มต้น ทำดัชนี ถือว่า word การสั่งซื้อ; ถ้า -l ตัวเลือกมีผลบังคับใช้ จดหมาย
การสั่งซื้อ ถูกนำมาใช้. ในการเรียงลำดับคำ ช่องว่างนำหน้าตัวอักษรใดๆ ในตัวอักษร ในขณะที่
ในการเรียงลำดับตัวอักษรจะไม่นับเลย โดยมีภาพประกอบดังต่อไปนี้
ตัวอย่าง:

word ใบสั่ง จดหมาย ใบสั่ง
ซีลสิงโตทะเล
สิงโตทะเล seal

ตัวเลขจะเรียงตามลำดับตัวเลขเสมอ ตัวอย่างเช่น

9 (เก้า), 123
10 (สิบ) ดู ดีเร็ก โบ

จดหมายจะถูกจัดเรียงเป็นลำดับแรกโดยไม่คำนึงถึงตัวพิมพ์ เมื่อคำเหมือนกัน ตัวพิมพ์ใหญ่
เวอร์ชันก่อนหน้าตัวพิมพ์เล็ก

สัญลักษณ์พิเศษถูกกำหนดที่นี่ให้เป็นอักขระใด ๆ ที่ไม่ปรากฏในการรวมกันของตัวเลข
และตัวอักษรภาษาอังกฤษ รูปแบบที่ขึ้นต้นด้วยสัญลักษณ์พิเศษนำหน้า
ตัวเลข ซึ่งนำหน้ารูปแบบที่ขึ้นต้นด้วยตัวอักษร เป็นกรณีพิเศษ สตริง
ขึ้นต้นด้วยหลักแต่ไม่ปะปนกันถือเป็นรูปแบบการเริ่มต้น
ด้วยตัวอักษรพิเศษ

พิเศษ ผล

รายการเช่น

\ดัชนี{อัลฟา}{1}
\ดัชนี{อัลฟา!เบต้า}{3}
\ดัชนี{alpha!beta!gamma}{10}

ในไฟล์อินพุตจะถูกแปลงเป็น

\item อัลฟ่า 1
\subitem เบต้า 3
\subitem แกมมา 10

ในไฟล์ดัชนีเอาต์พุต สังเกตว่า ระดับ สัญลักษณ์ (`!') ใช้ด้านบนเพื่อคั่น
ระดับลำดับชั้น

เป็นไปได้ที่จะทำให้รายการปรากฏในรูปแบบที่กำหนดโดยใช้ ที่เกิดขึ้นจริง (`@')
โอเปอเรเตอร์ ตัวอย่างเช่น

\ดัชนี{alpha@{\it alpha\/}}{1}

จะกลายเป็น

\item {\it อัลฟ่า\/}, 1

หลังจากการประมวลผล รูปแบบที่อยู่ข้างหน้า `@' ถูกใช้เป็นคีย์การเรียงลำดับ ในขณะที่หนึ่ง
ต่อไปนี้จะถูกเขียนไปยังไฟล์ที่ส่งออก โปรดทราบว่าการปรากฏของคีย์เดียวกันสองครั้ง
หนึ่งที่มีและอีกหนึ่งโดยไม่ต้อง ที่เกิดขึ้นจริง ผู้ประกอบการถือเป็น แตกต่าง รายการ.

ฟิลด์รายการ รายการย่อย และรายการย่อยอาจมีคีย์การจัดเรียงแต่ละรายการ:

\ดัชนี{aa@{\it aa\/}!bb@{\it bb\/}!cc@{\it cc\/}}{1}

นี่จะถูกแปลงเป็น

\item {\it aa}, 1
\subitem {\it bb}, 3
\subitem {\it cc}, 10

เป็นไปได้ที่จะแค็ปซูลหมายเลขหน้าด้วยคำสั่งที่กำหนดโดยใช้ ห่อหุ้ม
(`|') ตัวดำเนินการ:

\indexentry{อัลฟา|ตัวหนา}{1}

จะถูกแปลงเป็น

\รายการอัลฟ่า \ตัวหนา{1}

โดยที่คำจำกัดความที่เหมาะสมสำหรับ TeX \bold{n} จะขยายเป็น {\bf n} ในเรื่องนี้
ตัวอย่าง คุณลักษณะเอาต์พุตสามรายการที่เกี่ยวข้องกับการห่อหุ้มหน้า encap_prefix,
encap_infixและ encap_suffixสอดคล้องกับแบ็กสแลช วงเล็บปีกกาซ้าย และวงเล็บปีกกาขวา
ตามลำดับ กลไกนี้ช่วยให้สามารถตั้งค่าหมายเลขหน้าเป็นแบบอักษรต่างๆ ได้ สำหรับ
ตัวอย่าง หน้าที่มีคำจำกัดความของคำสำคัญปรากฏอยู่ในแบบอักษรเดียว
ตำแหน่งของตัวอย่างหลักสามารถอยู่ในแบบอักษรอื่นและลักษณะอื่น ๆ ในที่สาม
ตัวอักษร

พื้นที่ ห่อหุ้ม ตัวดำเนินการยังสามารถใช้เพื่อสร้างการอ้างอิงโยงในดัชนี:

\indexentry{อัลฟา|ดู{เบต้า}}{1}

จะกลายเป็น

\รายการอัลฟ่า \ดู{เบต้า}{1}

ในไฟล์เอาต์พุตโดยที่

\ดู{เบต้า}{1}

จะขยายเป็น

{\it see\/} เบต้า

โปรดทราบว่าในการอ้างอิงโยงเช่นนี้ หมายเลขหน้าจะหายไป

คู่ของ ห่อหุ้ม ที่เชื่อมกับ range_open (`|(') และ ช่วง_ปิด (`|)') สร้าง an
ช่วงหน้าที่ชัดเจน:

\indexentry{อัลฟา|(}{1}
\indexentry{อัลฟา|)}{5}

จะกลายเป็น

\รายการอัลฟ่า 1—5

เพจระดับกลางที่จัดทำดัชนีด้วยคีย์เดียวกันจะถูกรวมเข้ากับช่วงโดยปริยาย นี้
มีประโยชน์อย่างยิ่งเมื่อมีการจัดทำดัชนีทั้งหัวข้อเกี่ยวกับหัวข้อเฉพาะ
ในกรณีนี้จำเป็นต้องใส่เฉพาะตัวดำเนินการเปิดและปิดช่วงที่
จุดเริ่มต้นและจุดสิ้นสุดของส่วน การสร้างช่วงหน้าที่ชัดเจนยังสามารถรวมส่วนเสริม
คำสั่งกำหนดช่วงหน้าในแบบอักษรที่กำหนด:

\indexentry{อัลฟา|(ตัวหนา}{1}
\indexentry{อัลฟา|)}{5}

จะกลายเป็น

\รายการอัลฟ่า \ตัวหนา{1-5}

ปัญหาที่อาจเกิดขึ้นหลายประการที่ควรค่าแก่การกล่าวถึง ก่อนอื่น รายการเช่น

\indexentry{อัลฟา|(}{1}
\indexentry{อัลฟา|ตัวหนา}{3}
\indexentry{อัลฟา|)}{5}

จะตีความว่า

\item alpha, \bold{3}, 1-5

แต่มีข้อความเตือนในข้อความว่าเจอหน้าไม่ตรงกัน
เครื่องห่อหุ้ม ช่วงที่ชัดเจนที่ขึ้นต้นด้วยเลขหน้าโรมันและลงท้ายด้วยภาษาอาหรับคือ
ยังถือว่าผิดพลาด ในกรณีนี้ (ถ้าเป็นไปได้) ช่วงจะถูกแบ่งออกเป็นสอง
ช่วงย่อยหนึ่งเป็นภาษาโรมันและอีกส่วนหนึ่งเป็นภาษาอาหรับ ตัวอย่างเช่น

\indexentry{อัลฟา|(}{i}
\ดัชนี{alpha}{iv}
\ดัชนี{อัลฟา}{3}
\indexentry{อัลฟา|)}{7}

จะถูกเปลี่ยนเป็น

\item อัลฟา, i--iv, 3--7

พร้อมข้อความเตือนในไฟล์การถอดเสียงที่บ่นเกี่ยวกับช่วงที่ผิดกฎหมาย
รูปแบบ.

สัญลักษณ์พิเศษทุกอันที่กล่าวถึงในส่วนนี้ หุ้น โอเปอเรเตอร์ (`"')
ดังนั้น

\indexentry{alpha"@beta}{1}

จะกลายเป็น

\รายการ alpha@beta, 1

อันเป็นผลมาจากการดำเนินการ ทำดัชนี. อำนาจการอ้างของ หุ้น จะถูกกำจัดถ้าเป็น
นำหน้าโดยทันที หลบหนี (`\'). ตัวอย่างเช่น,

\indexentry{f\"ur}{1}

จะกลายเป็น

\item f\"ur, 1

ซึ่งแสดงถึง `u' ที่เน้นเสียงเครื่องหมายสำหรับตระกูล TeX ของโปรเซสเซอร์

หมายเลขหน้าสามารถเป็นการรวมกันของฟิลด์ตั้งแต่หนึ่งฟิลด์ขึ้นไปโดยคั่นด้วยตัวคั่นที่ผูกกับ
page_compositor (`-') เช่น II-12 สำหรับหน้า 12 ของบทที่ II เลขหน้าอาจมีup
ถึงสิบสนาม

ตั้งแต่เวอร์ชั่น 2.11 ของ ทำดัชนีที่ หุ้น ผู้ประกอบการอาจเสนอราคา ใด อักขระในช่วง 1
... 255. ไม่รวมอักขระ 0 เนื่องจากมีใช้ภายในตัว ทำดัชนี แหล่ง
รหัสเป็นตัวยุติสตริง ด้วยการเปลี่ยนแปลงนี้ คุณสามารถสร้างคีย์การเรียงลำดับสำหรับทั้งแปดบิต
อักขระยกเว้น 0 ลำดับการจัดเรียงคือ

เครื่องหมายวรรคตอน (ตามลำดับ ASCII)
ตัวเลข,
อักขระควบคุม (1 ... 31),
ช่องว่าง (32),
จดหมาย (ละเว้นตัวพิมพ์ใหญ่)
ตัวอักษร 127 ... 255.

นี่คือตัวอย่างที่แสดงการสร้างดัชนีของอักขระ ASCII ที่พิมพ์ได้ทั้งหมดที่ไม่ใช่
ตัวอักษรและตัวเลข โดยใช้รูปแบบ TeX เริ่มต้น เพื่อความสะดวกหมายเลขหน้า
การอ้างอิงเป็นค่าลำดับ ASCII ที่สอดคล้องกัน

\indexentry{" @" (เว้นวรรค)}{32}
\indexentry{"!@"! (เครื่องหมายอัศเจรีย์)}{33}
\indexentry{""@"" (เครื่องหมายคำพูด)}{34}
\indexentry{"#@"\# (เครื่องหมายแหลม)}{35}
\indexentry{"$@"\$ (เครื่องหมายดอลลาร์)}{36}
\indexentry{"%@"\% (เครื่องหมายเปอร์เซ็นต์)}{37}
\indexentry{"&@"\& (เครื่องหมายและ)}{38}
\indexentry{"<@"$<$ (วงเล็บมุมซ้าย)}{60}
\indexentry{"=@"= (เท่ากับ)}{61}
\indexentry{">@"$>$ (วงเล็บมุมขวา)}{62}
\indexentry{"?@"? (แบบสอบถาม)}{63}
\indexentry{"@@"@ (ที่ป้าย)}{64}
\indexentry{"[@"[ (วงเล็บเหลี่ยมด้านซ้าย)}{91}
\indexentry{"\@"\verb=\= (แบ็กสแลช)}{92}
\indexentry{"]@"] (วงเล็บเหลี่ยมขวา)}{93}
\indexentry{"^@"\verb=^= (คาเร็ต)}{94}
\indexentry{"_@"\verb=_= (ขีดล่าง)}{95}
\indexentry{"`@"\verb=~= (เน้นหนัก)}{96}
\indexentry{"{@"\"{ (วงเล็บปีกกาซ้าย)}{123}
\indexentry{"|@"\verb="|= (แถบแนวตั้ง)}{124}
\indexentry{"}@"\"} (วงเล็บปีกกาขวา)}{125}
\indexentry{"~@"\verb=~= (ตัวหนอน)}{126}

อักขระในฟิลด์จริงตามอักขระ `@' ซึ่งมีอักขระพิเศษ
ความสำคัญของ TeX จะต้องแสดงเป็นลำดับการควบคุม หรือเป็นอักขระในโหมดคณิตศาสตร์
สังเกตว่ารายการสำหรับเครื่องหมาย at วงเล็บปีกกาซ้ายและขวาและแนวตั้ง
แถบมีรหัส ไฟล์ดัชนีที่ส่งออกโดย ทำดัชนี สำหรับตัวอย่างนี้มีลักษณะดังนี้:

\เริ่มต้น{ดัชนี}

\สิ่งของ ! (เครื่องหมายอัศเจรีย์), 33
\item " (เครื่องหมายคำพูด), 34
\item \# (เครื่องหมายแหลม), 35
\item \$ (เครื่องหมายดอลลาร์), 36
\item \% (เครื่องหมายเปอร์เซ็นต์), 37
\item \& (เครื่องหมายและ), 38
\item $<$ (วงเล็บมุมซ้าย), 60
\item = (เท่ากับ), 61
\item $>$ (วงเล็บมุมขวา), 62
\สิ่งของ ? (แบบสอบถาม), 63
\item @ (ที่ป้าย), 64
\item [ (วงเล็บเหลี่ยมด้านซ้าย), 91
\item \verb=\= (แบ็กสแลช), 92
\item ] (วงเล็บเหลี่ยมขวา), 93
\item \verb=^= (คาเร็ต), 94
\item \verb=_= (ขีดล่าง), 95
\item \verb=~= (สำเนียงหลุมฝังศพ), 96
\item \{ (วงเล็บปีกกาซ้าย), 123
\item \verb=|= (แถบแนวตั้ง), 124
\item \} (วงเล็บปีกกาขวา), 125
\item \verb=~= (ตัวหนอน), 126

\พื้นที่ดัชนี

\item (ช่องว่าง), 32

\end{ดัชนี}

ใช้ makeindex ออนไลน์โดยใช้บริการ onworks.net