นี่คือตัวจัดการคำสั่งที่สามารถเรียกใช้ในผู้ให้บริการโฮสต์ฟรีของ OnWorks โดยใช้หนึ่งในเวิร์กสเตชันออนไลน์ฟรีของเรา เช่น Ubuntu Online, Fedora Online, โปรแกรมจำลองออนไลน์ของ Windows หรือโปรแกรมจำลองออนไลน์ของ MAC OS
โครงการ:
ชื่อ
manlifter - สคริปต์การแปลงมวลและสายรัดทดสอบสำหรับ doclifter
เรื่องย่อ
คนยกของ [-NS ตัวเลือก] [-e] [-ฉ รายการไฟล์] [-สวัสดี ดีร์] [-ม.] [-ม] [-o คนนอก]
[-NS ไดเร็กทอรีแพทช์] [-P] [-q] [-v] [-ส ส่วน] [-NS ไม่รวม] ชื่อ...
คนยกของ [-NS]
DESCRIPTION
คนยกของ เป็นสคริปต์ที่เรียงลำดับ ด็อกลิฟเตอร์(1) เพื่อแปลงแผนผังหน้าคู่มือทั้งหมดเป็น
XML-Docbook หรือจะสร้าง HTML จาก XML ก็ได้ การใช้งานอีกประการหนึ่งคือเป็น
เครื่องมือทดสอบการทรมานสำหรับ doclifter มันบันทึกข้อผิดพลาดไปยังเอาต์พุตมาตรฐานและรวบรวมการกำหนดเวลา
เรียกว่าไม่มีอาร์กิวเมนต์ไฟล์ใด ๆ manlifter พยายามแปลง man page ที่มีสิทธิ์ทั้งหมด
ติดตั้งบนระบบโดยวางไฟล์ xml ที่เป็นผลลัพธ์ภายใต้ xmlman ในปัจจุบัน
ไดเร็กทอรี แต่ละหน้าที่แปลสำเร็จ foo.N จะถูกคัดลอกไปยัง manN/foo.xml ข้างใต้
ไดเร็กทอรีเอาต์พุต ไม่ว่าจะมาจากไดเร็กทอรีต้นทางใด
หน้าคู่มือถือว่าไม่มีสิทธิ์สำหรับการแปลงแบบกลุ่มหากมีข้อความระบุว่า
มันถูกสร้างขึ้นจากผู้เชี่ยวชาญ DocBook จาก Doxygen
สำหรับไฟล์ต้นทางแต่ละไฟล์ที่ตรวจสอบ หากมีไฟล์ปลายทางและใหม่กว่าไฟล์
แหล่งที่มา การแปลงถูกข้าม; ดังนั้นการวิ่งที่เพิ่มขึ้นของ คนยกของ ทำงานให้น้อยที่สุด
จำเป็นต้องทำให้ต้นไม้ XML เป้าหมายเป็นปัจจุบันอยู่เสมอ ในทำนองเดียวกัน ในโหมด -h ไฟล์ HTML ที่ได้รับคือ
ทำเมื่อจำเป็นเท่านั้น
หน้า Stub ที่เป็นเพียง .ดังนั้น การเปลี่ยนเส้นทางถูกแปลเป็นลิงก์ที่เกี่ยวข้องของ XML
ไฟล์ (และด้วย -h ไฟล์ HTML)
คนยกของ อาจถูกเรียกด้วยอาร์กิวเมนต์ไฟล์เดียวซึ่งตีความว่าเป็น stem
ชื่อของหน้าคู่มือที่เป็นไปได้ คนยกของ จากนั้นค้นหาส่วนคู่มือที่เลือกทั้งหมดสำหรับ
หน้าตรงกันและพยายามแปลง ในกรณีนี้ สำเนาของหน้าคนและ
เวอร์ชันที่แปลงแล้วจะถูกลบทันทีไปยังไดเร็กทอรีเอาต์พุตพร้อมชื่อ
foobar.man และ foobar.man.xml ตามลำดับ ปกติโหมดนี้น่าสนใจเท่านั้น
ไปยัง ด็อกลิฟเตอร์ นักพัฒนาสำหรับการดีบักโปรแกรมนั้น
ในกรณีใดกรณีหนึ่งข้างต้น คนยกของ จะคลายการบีบอัดไฟล์หากมี .gz, .bz2 หรือ
.Z คำต่อท้ายชื่อ
ตัวเลือกมีดังนี้:
-d
ส่งผ่านอาร์กิวเมนต์สตริงไปยังการเรียก doclifter แต่ละรายการเป็นตัวเลือก แต่ละโทเค็นที่คั่นด้วยช่องว่าง
ในสตริงจะกลายเป็นอาร์กิวเมนต์แยกต่างหากในการโทร
-e
เรียกใช้ในโหมดบันทึกตัวกรอง (ส่วนใหญ่เป็นที่สนใจของ ด็อกลิฟเตอร์ นักพัฒนา) ในโหมดนี้
คนยกของ อ่านบันทึกการทดสอบจากอินพุตมาตรฐานและกรองตามวิธี aa ขึ้นอยู่กับ
ตัวเลือก -f และ -q หากไม่ระบุข้อความจากการวิ่งที่สำเร็จจะเป็น
แยกออกและมีเพียงข้อผิดพลาดที่ส่งผ่านไปยังเอาต์พุตมาตรฐาน
-f
โดยปกติ ให้เรียกใช้ doclifter ในไฟล์ที่ตั้งชื่อตามแต่ละบรรทัดในไฟล์อาร์กิวเมนต์ ใน
โหมดตัวกรองข้อผิดพลาด อาร์กิวเมนต์ถูกตีความแทนการกรองแบบปกติ
การแสดงออก
-h
สร้างการแปล HTML ลงในไดเร็กทอรีเอาต์พุตด้วย มาร์กอัป DocBook citerefentry
ถูกแปลงเป็นไฮเปอร์ลิงก์ในไดเร็กทอรี และรายการเนื้อหาจะถูกสร้างขึ้นเป็น
ดัชนี.html
-I
ระบุรูทของแผนผังหน้าคู่มือ โดยค่าเริ่มต้น นี่คือ /usr/share/man
-m
ทำโปรแกรมแก้ไขเพื่อแก้ไขหน้าที่ดึงข้อมูลล่าสุด คัดลอกแล้วเรียกบรรณาธิการ
สำเนา (โดยใช้ตัวแปรสภาพแวดล้อม $ EDITOR) แล้ว diff(1) ถูกเรียกให้ดรอป
แพตช์ในไดเร็กทอรีพรีแพตช์ ล้มเหลวโดยมีข้อผิดพลาดหากแพตช์ดังกล่าวมีอยู่แล้ว
นำเสนอ.
-M
ยกไฟล์ที่ระบุ จากนั้นดำเนินการเทียบเท่ากับตัวเลือก -m
-o
ตั้งค่าไดเร็กทอรีผลลัพธ์ที่จะละทิ้งการแปล XML-DocBook โดย
ค่าเริ่มต้น นี่คือ xmlman ภายใต้ไดเร็กทอรีปัจจุบันในโหมดแบตช์หรือปัจจุบัน
ไดเร็กทอรีเป็นอย่างอื่น
-p
ตีความอาร์กิวเมนต์เป็นชื่อของไดเร็กทอรีโปรแกรมแก้ไข (ชื่อเริ่มต้นคือ prepatch
ภายใต้ไดเร็กทอรีปัจจุบัน) แต่ละไฟล์ชื่อ foo.N.patch จะถูกตีความว่าเป็นแพตช์ไปยัง
นำไปใช้กับหน้าคู่มือ foo(N) ก่อนที่ doclifter จะแปล
-P
เปิดใช้งานการทำโปรไฟล์โดยใช้โมดูล Python hotshot; สิ่งนี้มีประโยชน์สำหรับการปรับแต่งเท่านั้น
doclifter เพื่อให้ทำงานได้เร็วขึ้น ข้อมูลดิบเขียนไปที่ manlifter.prof และย่อย
รายงานถูกผนวกเข้ากับบันทึกของเอาต์พุตมาตรฐาน คำเตือน: ไฟล์ข้อมูลดิบสามารถ
กลายเป็นเรื่องใหญ่ และการประมวลผลภายหลังสำหรับการสร้างรายงานอาจใช้เวลานานตราบเท่าที่
การประมวลผลจริง (หรือนานกว่านั้น!)
-q
โดยปกติ ให้ส่งตัวเลือก -q (เงียบ) ไปที่การเรียก doclifter แต่ละครั้ง ในโหมดตัวกรองข้อผิดพลาด
ส่งคืนรายการไฟล์ที่การแปลล้มเหลว
-v
ส่งตัวเลือก -v (verbose) ให้กับการเรียก doclifter แต่ละครั้ง ตัวเลือกนี้สามารถทำซ้ำได้เพื่อ
เพิ่มระดับความฟุ่มเฟือย
-s
ระบุส่วนที่จะสแกน ใช้สิ่งนี้กับอาร์กิวเมนต์ ไม่จำเป็นเมื่อ
ทำการดัดแปลงต้นไม้ทั้งต้น
-S
รวบรวมสถิติข้อผิดพลาดจาก a คนยกของ logfile นำเสนอบนอินพุตมาตรฐาน นี้
ออปชั่นจะเป็นที่สนใจของ ด็อกลิฟเตอร์ นักพัฒนา
-X
ในโหมดแบทช์ไม่รวมหน้าที่แสดงในไฟล์อาร์กิวเมนต์ หมายถึงใช้สำหรับเพจ
ที่รู้ดีและใช้เวลานานมากในการยกเพื่อจะดับ
เวลาสำหรับการทดสอบการทำงาน (หน้าส่วนใหญ่จะยกขึ้นในเวลาไม่ถึงครึ่งวินาที แต่บางหน้าก็ใช้ได้
15 นาทีขึ้นไป)
คนยกของ ส่งไฟล์บันทึกไปยังเอาต์พุตมาตรฐาน ไฟล์เริ่มต้นด้วยบรรทัดการประทับเวลาและ a
บรรทัดว่างและลงท้ายด้วยเส้นบอกเวลาทำงานและสถิติที่น่าสนใจต่างๆ
ระหว่างเหล่านี้คือบทที่คั่นด้วยบรรทัดว่าง หนึ่งบทสำหรับแต่ละไฟล์ซึ่ง ด็อกลิฟเตอร์
ถูกเรียกใช้
บรรทัดแรกของแต่ละบทเริ่มต้นด้วย "!" ตามด้วยชื่อพาธของแหล่งที่มา
คู่มือเพจเจอร์ ตามด้วย "=" และสถานะการส่งคืนของ doclifter ทำงานบนไฟล์นั้น
ตามด้วยช่องว่างและ ด็อกลิฟเตอร์รันไทม์เป็นวินาที
บรรทัดแรกนี้อาจตามด้วยข้อความข้อมูลและเอาต์พุตข้อผิดพลาดของ
doclifter วิ่ง
คนยกของ ต้องหาสำเนาของ ด็อกลิฟเตอร์ ในไดเร็กทอรีปัจจุบันหรือหนึ่งใน
ไดเรกทอรีคำสั่งใน your เส้นทาง เพื่อที่จะวิ่ง
ใช้ manlifter ออนไลน์โดยใช้บริการ onworks.net