aspell - คู่มืออ้างอิง ตัวเลือก ตัวอย่างคำสั่ง

ชื่อ

aspell - ตัวตรวจสอบการสะกดแบบโต้ตอบ

เรื่องย่อ

aspell [options] <command>

คำอธิบาย

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

ไลบรารี Aspell มีอินเทอร์เฟซที่อนุญาตให้โปรแกรมอื่นๆ เข้าถึงฟังก์ชันได้โดยตรง ดังนั้นจึงลดงานที่ซับซ้อนในการตรวจสอบการสะกดเป็นการเรียกไลบรารีแบบธรรมดา ไลบรารีเริ่มต้นไม่มีรายการคำในพจนานุกรม หากต้องการเพิ่มพจนานุกรมภาษา โปรดตรวจสอบ distro ของคุณก่อนเพื่อหาพจนานุกรมที่แก้ไข หรือดูที่นี่สำหรับพจนานุกรมภาษาพื้นฐาน http://aspell.net

ข้อมูลต่อไปนี้อธิบายคำสั่งและตัวเลือกที่ใช้โดย Aspell Utility

หน้าคู่มือนี้ได้รับการดูแลแยกต่างหากจากเอกสารอย่างเป็นทางการ ดังนั้นหน้านี้อาจล้าสมัยหรือไม่สมบูรณ์ เอกสารอย่างเป็นทางการได้รับการบำรุงรักษาเป็นคู่มือ Texinfo ดูรายการ ` aspell ' ใน ข้อมูล สำหรับเอกสารที่สมบูรณ์เพิ่มเติม

คำสั่ง

<command> เป็นหนึ่งใน:

usage, -?: ส่งข้อความการใช้งาน Aspell Utility สั้นๆ ไปยังเอาต์พุตมาตรฐาน นี่เป็นข้อมูลสรุปโดยย่อที่แสดงรายการคำสั่งและตัวเลือกการตรวจตัวสะกดทั่วไป
help: ส่งข้อความช่วยเหลือ Aspell Utility โดยละเอียดไปยังเอาต์พุตมาตรฐาน นี่คือรายการทั้งหมดที่แสดงคำสั่ง ตัวเลือก ตัวกรอง และพจนานุกรมทั้งหมด
version, -v: พิมพ์หมายเลขเวอร์ชันของ Aspell Library และ Utility ไปยังเอาต์พุตมาตรฐาน
check <file>, -c <file>: ตรวจสอบการสะกดไฟล์เดียว
pipe, -a: เรียกใช้ Aspell ในโหมดความเข้ากันได้ของ ispell -a
list: สร้างรายการคำที่สะกดผิดจากการป้อนข้อมูลมาตรฐาน
[dump] config: ดัมพ์ตัวเลือกการกำหนดค่าปัจจุบันทั้งหมดไปยังเอาต์พุตมาตรฐาน
config <key>: ส่งค่าปัจจุบันของ <key> ไปยังเอาต์พุตมาตรฐาน
soundslike: เอาต์พุตเสียงที่เทียบเท่ากันของแต่ละคำที่ป้อน
munch: สร้างคำรูตและคำต่อท้ายที่เป็นไปได้จากรายการคำที่ป้อน
expand [1-4]: ขยายค่าสถานะส่วนต่อท้ายของแต่ละคำที่บีบอัดส่วนต่อท้ายที่ป้อน
clean [strict]: ล้างรายการคำที่ป้อนเพื่อให้ทุกบรรทัดเป็นคำที่ถูกต้อง
munch-list [simple] [single|multi] [keep]: ลดขนาดของรายการคำผ่านการบีบอัดส่วนต่อท้าย
conv <from> <to> [<norm-form>]: แปลง <from> หนึ่งการเข้ารหัส <to> อื่น
norm (<norm-map>|<from> <norm-map> <to>) [<norm-form>]: ดำเนินการทำให้เป็นบรรทัดฐาน Unicode
[dump] dicts|filters|modes: แสดงรายการพจนานุกรม ตัวกรอง หรือโหมดที่มีอยู่
dump|create|merge master|personal|repl <wordlist>: การถ่ายโอนข้อมูล สร้าง หรือรวมรายการคำหลัก ส่วนบุคคล หรือแทนที่

ตัวเลือกพจนานุกรม

อาจใช้ตัวเลือกต่อไปนี้เพื่อควบคุมว่าจะใช้พจนานุกรมใดและลักษณะการทำงานอย่างไร

--master=<name>, -d <name>: ชื่อฐานของพจนานุกรมที่จะใช้ หากระบุตัวเลือกนี้ Aspell จะใช้พจนานุกรมนี้หรือไม่ก็ตาย
--dict-dir=<directory>: ตำแหน่งของรายการคำศัพท์หลักในพจนานุกรม
--lang=<string>, -l <string>: ภาษาที่จะใช้ เป็นไปตามรูปแบบเดียวกันของตัวแปรสภาพแวดล้อม LANG ในระบบส่วนใหญ่ ประกอบด้วยรหัสภาษา ISO 639 ตัวอักษร 2 ตัว และรหัสประเทศ ISO 3166 ตัวอักษร 2 ตัวหลังขีดกลางหรือขีดล่าง ค่าเริ่มต้นขึ้นอยู่กับค่าของโลแคล LC_MESSAGES
--size=<string>: ขนาดที่ต้องการของรายการคำในพจนานุกรม ประกอบด้วยรหัสอักขระสองหลักที่อธิบายขนาดของรายการ โดยมีค่าทั่วไปเป็น: 10=จิ๋ว, 20=เล็กมาก, 30=เล็ก, 40=med-small, 50=med, 60=med-large, 70 =ใหญ่, 80=ใหญ่, 90=บ้า
--variety=<string>: ข้อมูลเพิ่มเติมใดๆ ที่จะทำให้พจนานุกรมประเภทนี้แตกต่างจากพจนานุกรมอื่นๆ ซึ่งอาจมีภาษาและขนาดเหมือนกัน
--jargon=<string>: โปรดใช้ตัวเลือก หลากหลาย เนื่องจากแทนที่ ศัพท์แสง เป็นทางเลือกที่ดีกว่า ศัพท์แสง จะถูกลบออกในอนาคต
--word-list-path=<list of directories>: ค้นหาเส้นทางสำหรับไฟล์ข้อมูลรายการคำ
--personal=<file>, -p <file>: ชื่อไฟล์รายการคำส่วนบุคคล
--repl=<file>: ชื่อไฟล์รายการแทนที่
--extra-dicts=<list>: พจนานุกรมพิเศษที่จะใช้
--ignore-accents: ตัวเลือกนี้ยังไม่ได้ใช้งาน

ตัวเลือกตัวตรวจสอบ

ตัวเลือกเหล่านี้ควบคุมการทำงานของ Aspell เมื่อตรวจสอบเอกสาร

--ignore=<integer>, -W <integer>: ละเว้นคำที่มีความยาว <= <integer> อักขระ
--ignore-case, --dont-ignore-case: ละเว้นกรณีเมื่อตรวจสอบคำ
--ignore-repl, --dont-ignore-repl: ละเว้นคำสั่งในการจัดเก็บคู่เปลี่ยน
--save-repl, --dont-save-repl: บันทึกรายการคำแทนที่ในบันทึกทั้งหมด
--sug-mode=<mode>: คำแนะนำ <mode>=พิเศษ| เร็ว| ปกติ| ตัวสะกดไม่ดี

ตัวเลือกตัวกรอง

ตัวเลือกเหล่านี้ปรับเปลี่ยนลักษณะการทำงานของตัวกรองต่างๆ

--add-filter=<list>, --rem-filter=<list>: เพิ่มหรือลบตัวกรอง
--add-filter-path=<paths>, --rem-filter-path=<paths>: เพิ่มหรือลบเส้นทางที่ค้นหาตัวกรอง
--mode=<string>, -e, -H, -t, -n: ตั้งค่าโหมดตัวกรอง โหมด เป็นหนึ่งในไม่มี, url, อีเมล, html, tex หรือ nroff ตัวเลือกทางลัดอื่นๆ ได้แก่ '-e' สำหรับอีเมล, '-H' สำหรับ Html/Sgml, '-t' สำหรับ Tex หรือ '-n' สำหรับ Nroff
--encoding=<string>: คาดว่าจะเข้ารหัสเอกสาร ค่าเริ่มต้นขึ้นอยู่กับตำแหน่งที่ตั้งปัจจุบัน
--add-email-quote=<list>, --rem-email-quote=<list>: เพิ่มหรือลบรายการอักขระคำพูดในอีเมล
--email-margin=<integer>: จำนวนตัวอักษรที่สามารถปรากฏก่อนเครื่องหมายคำพูด
--add-html-check=<list>, --rem-html-check=<list>: เพิ่มหรือลบรายการแอตทริบิวต์ HTML เพื่อตรวจสอบเสมอ ตัวอย่างเช่น ดูภายในแท็ก alt=
--add-html-skip=<list>, --rem-html-skip=<list>: เพิ่มหรือลบรายการแอตทริบิวต์ HTML เพื่อข้ามไปเสมอขณะตรวจการสะกด
--add-sgml-check=<list>, --rem-sgml-check=<list>: เพิ่มหรือลบรายการแอตทริบิวต์ SGML เพื่อตรวจสอบการสะกดเสมอ
--add-sgml-skip=<list>, --rem-sgml-skip=<list>: เพิ่มหรือลบรายการแอตทริบิวต์ SGML ที่จะข้ามไปเสมอขณะตรวจการสะกดคำ
--sgml-extension=<list>: นามสกุลไฟล์ SGML
--tex-check-comments, --dont-tex-check-comments: ตรวจสอบความคิดเห็น TeX
--add-tex-command=<list>, --rem-tex-command=<list>: เพิ่มหรือลบรายการคำสั่ง TeX

ตัวเลือกคำที่ใช้ร่วมกัน

สิ่งเหล่านี้อาจใช้เพื่อควบคุมพฤติกรรมของคำที่ทำงานร่วมกัน

--run-together, --dont-run-together, -C, -B: พิจารณาคำที่ใช้ร่วมกันได้
--run-together-limit=<integer>: จำนวนคำสูงสุดที่สามารถร้อยเข้าด้วยกันได้
--run-together-min=<integer>: ความยาวขั้นต่ำของคำภายใน

ตัวเลือกอื่น ๆ

ตัวเลือกเบ็ดเตล็ดที่ไม่อยู่ในหมวดหมู่อื่นใด

--conf=<file name>: ไฟล์การกำหนดค่าหลัก ไฟล์นี้ลบล้างค่าเริ่มต้นสากลของ Aspell
--conf-dir=<directory>: ตำแหน่งของไฟล์คอนฟิกูเรชันหลัก
--data-dir=<directory>: ตำแหน่งของไฟล์ข้อมูลภาษา
--keyboard=<keyboard>: ใช้เค้าโครงแป้นพิมพ์นี้เพื่อแนะนำคำที่เป็นไปได้ ข้อผิดพลาดในการสะกดคำเหล่านี้เกิดขึ้นหากผู้ใช้กดแป้นที่อยู่ติดกับแป้นที่ถูกต้องโดยไม่ตั้งใจ
--local-data-dir=<directory>: ตำแหน่งอื่นของไฟล์ข้อมูลภาษา ไดเร็กทอรีนี้ถูกค้นหาก่อน data-dir
--home-dir=<directory>: ตำแหน่งไดเร็กทอรีสำหรับไฟล์ wordlist ส่วนตัว
--per-conf=<file name>: ไฟล์การกำหนดค่าส่วนบุคคล ไฟล์นี้แทนที่ตัวเลือกที่พบในไฟล์กำหนดค่าส่วนกลาง

ตัวเลือกยูทิลิตี้ ASPELL

ตัวเลือกเหล่านี้เป็นส่วนหนึ่งของยูทิลิตี้ aspell และทำงานเป็นอิสระจากไลบรารี

--backup, --dont-backup, -b, -x: ยูทิลิตี aspell สร้างไฟล์สำรองโดยทำสำเนาและเพิ่ม .bak ต่อท้ายชื่อไฟล์ ใช้เฉพาะเมื่อคำสั่ง ตรวจสอบ <ไฟล์> และไฟล์สำรองจะถูกสร้างขึ้นเฉพาะเมื่อมีการแก้ไขการสะกดคำ
--byte-offsets, --dont-byte-offsets: ใช้การชดเชยไบต์แทนการชดเชยอักขระ
--guess, --dont-guess, -m, -P: สร้างชุดค่าผสมรูต/ส่วนต่อท้ายที่ขาดหายไปซึ่งไม่อยู่ในพจนานุกรมในโหมด ไปป์
--keymapping=aspell, --keymapping=ispell: การแมปคีย์ที่จะใช้ ไม่ว่าจะเป็น aspell สำหรับการแมปเริ่มต้น หรือ ispell เพื่อใช้การแมปเดียวกับที่ยูทิลิตี Ispell ใช้
--reverse, --dont-reverse: ย้อนกลับลำดับของรายการคำแนะนำในโหมดไปป์
--suggest, --dont-suggest: แนะนำการเปลี่ยนที่เป็นไปได้ในโหมดไปป์ หากเป็นเท็จ Aspell จะรายงานการสะกดผิดและไม่พยายามให้คำแนะนำหรือแก้ไขที่เป็นไปได้
--time, --dont-time: ตั้งเวลาโหลดและแนะนำเวลาในโหมดไพพ์

นอกจากนี้ Aspell จะพยายามทำความเข้าใจกับตัวเลือกบรรทัดคำสั่งของ Ispell เพื่อให้สามารถทำหน้าที่แทน Ispell ได้ หาก Aspell ทำงานโดยไม่มีตัวเลือกบรรทัดคำสั่งใด ๆ มันจะแสดงหน้าจอช่วยเหลือสั้น ๆ และปิด

การกำหนดค่า

Aspell สามารถยอมรับตัวเลือกผ่านไฟล์การกำหนดค่าส่วนกลางหรือส่วนตัว ดังนั้นคุณไม่จำเป็นต้องระบุตัวเลือกเหล่านี้ทุกครั้งที่บรรทัดคำสั่ง ไฟล์การกำหนดค่าส่วนกลางเริ่มต้นคือ /etc/aspell.conf หรือไฟล์อื่นที่ระบุโดยตัวเลือก --conf และเลือกก่อน ไฟล์กำหนดค่าเริ่มต้นสำหรับผู้ใช้แต่ละราย ~/.aspell.conf ซึ่งอยู่ในไดเรกทอรี $HOME (หรือไฟล์อื่นที่ระบุโดยตัวเลือก --per-conf ) ถูกทำเครื่องหมายไว้ถัดไปและลบล้างตัวเลือกที่ตั้งค่าไว้ในไฟล์กำหนดค่าส่วนกลาง อ็อพชันที่ระบุที่บรรทัดรับคำสั่งหรือผ่านตัวแปรสภาวะแวดล้อมจะแทนที่อ็อพชันที่ระบุโดยไฟล์คอนฟิกูเรชัน

แต่ละบรรทัดของไฟล์คอนฟิกูเรชันมีรูปแบบ:

option [value]

โดยที่ ตัวเลือก คือหนึ่งในตัวเลือกไลบรารีมาตรฐานด้านบนโดยไม่มีเครื่องหมายขีดคั่นนำหน้า ตัวอย่างเช่น บรรทัดต่อไปนี้จะตั้งค่าภาษาเริ่มต้นเป็น Swiss German:

lang de_CH

อาจมีช่องว่างจำนวนเท่าใดก็ได้ระหว่างตัวเลือกและค่า แต่สามารถเป็นช่องว่างได้เท่านั้น เช่น ไม่มี '=' ระหว่างชื่อตัวเลือกและค่า ความคิดเห็นอาจรวมอยู่ด้วยโดยนำหน้าด้วย '#' เนื่องจากสิ่งใดก็ตามตั้งแต่ '#' ถึงบรรทัดใหม่จะถูกละเว้น อนุญาตให้มีบรรทัดว่างได้เช่นกัน ไฟล์ /etc/aspell.conf เป็นตัวอย่างที่ดีของวิธีตั้งค่าตัวเลือกเหล่านี้ และคู่มือ Aspell ก็มีข้อมูลโดยละเอียดเพิ่มเติม

ดูสิ่งนี้ด้วย

aspell-import(1), prezip-bin(1), run-with-aspell(1), word-list-compress(1)

Aspell is fully documented in its Texinfo manual. See the ` aspell ' entry in info for more complete documentation.

สนับสนุน

การสนับสนุนสำหรับ Aspell สามารถพบได้ในรายชื่อผู้รับจดหมายของ Aspell คำแนะนำสำหรับการเข้าร่วมรายชื่ออีเมลต่างๆ (และที่เก็บถาวร) สามารถดูได้จากหน้าแรกของ Aspell ที่ http://aspell.net รายงานข้อผิดพลาดควรส่งผ่านทาง GitHub Issues แทนที่จะโพสต์ในรายชื่อผู้รับจดหมาย

ผู้เขียน

หน้าคู่มือนี้เขียนโดย Brian Nelson pyro@debian.org ตามคู่มือผู้ใช้ Aspell ลิขสิทธิ์ © 2002 Kevin Atkinson อัปเดตเมื่อ พ.ย. 2549 โดย Jose Da Silva digital@joescat.com และ ธ.ค. 2549 โดย Kevin Atkinson kevina@gnu.org