นี่คือคำสั่ง ikiwiki ที่สามารถเรียกใช้ในผู้ให้บริการโฮสต์ฟรีของ OnWorks โดยใช้หนึ่งในเวิร์กสเตชันออนไลน์ฟรีของเรา เช่น Ubuntu Online, Fedora Online, โปรแกรมจำลองออนไลน์ของ Windows หรือโปรแกรมจำลองออนไลน์ของ MAC OS
โครงการ:
ชื่อ
ikiwiki - คอมไพเลอร์วิกิ
เรื่องย่อ
ikiwiki [ตัวเลือก] ปลายทางต้นทาง
ikiwiki --setup setupfile [ตัวเลือก]
DESCRIPTION
ikiwiki เป็นคอมไพเลอร์วิกิ มันสร้างหน้า HTML แบบคงที่สำหรับวิกิ จากแหล่งที่มาใน
ภาษา ikiwiki/Markdown (หรืออื่นๆ) และเขียนไปยังปลายทาง
โปรดทราบว่าตัวเลือกส่วนใหญ่สามารถย่อให้เหลือตัวอักษรเดียว แฟล็กบูลีน เช่น --verbose
สามารถลบล้างด้วย --no-verbose และตัวเลือกเช่น --verbose สามารถสะกดได้เช่น
-verbose
โหมด OPTIONS
ตัวเลือกเหล่านี้ควบคุมโหมดที่ ikiwiki ดำเนินการ
--รีเฟรช
รีเฟรชวิกิ อัปเดตหน้าที่เปลี่ยนแปลง นี่เป็นพฤติกรรมเริ่มต้นถ้าไม่
มีการระบุการทำงานของโหมดอื่น ๆ (แต่โปรดทราบว่า --setup เป็นการทำงานของโหมดและมี
พฤติกรรมเริ่มต้นที่แตกต่างกัน)
-- สร้างใหม่
บังคับให้สร้างใหม่ทุกหน้า
--setup ไฟล์ติดตั้ง
โหลดตัวเลือกจากไฟล์ติดตั้งที่กำหนด หากไม่มีการระบุการดำเนินการของโหมดอื่น
สร้าง wrappers และสร้างวิกิใหม่ ราวกับว่า --rebuild --wrappers ถูกใช้ ถ้า
คุณต้องการสร้างหน้าที่เปลี่ยนแปลงเท่านั้น คุณสามารถใช้ --refresh กับ --setup
--changesetup ไฟล์ติดตั้ง
อ่านไฟล์ติดตั้ง เพิ่มการเปลี่ยนแปลงการกำหนดค่าที่ระบุโดยตัวเลือกอื่นๆ
และเขียนการกำหนดค่าใหม่กลับไปที่ไฟล์ติดตั้ง ยังอัปเดตใด ๆ
Wrapper ที่กำหนดค่าไว้ ในโหมดนี้ วิกิจะไม่ถูกสร้างขึ้นใหม่ทั้งหมด เว้นแต่คุณจะ
เพิ่ม -- สร้างใหม่.
ตัวอย่าง เพื่อเปิดใช้งานปลั๊กอินบางตัว:
อิกิวิกิ --changesetup ~/ikiwiki.setup --สินค้าปลั๊กอิน --ปฏิทินปลั๊กอิน
--dumpsetup ไฟล์ติดตั้ง
ทำให้ ikiwiki เขียนไปยังไฟล์ติดตั้งที่ระบุ โดยทิ้งไฟล์ปัจจุบันออก
องค์ประกอบ
--ห่อ
หากใช้กับ --setup --refresh จะทำให้อัปเดต wrappers ที่กำหนดค่าไว้ด้วย
--ทำความสะอาด
สิ่งนี้ทำให้ ikiwiki ล้างข้อมูลโดยลบไฟล์ใดๆ ที่สร้างขึ้นในปลายทาง
ไดเร็กทอรี ตลอดจน Wrapper ที่กำหนดค่าไว้ และไดเร็กทอรีสถานะ .ikiwiki
สิ่งนี้มีประโยชน์อย่างยิ่งหากคุณใช้งาน ikiwiki ใน Makefile to build
จัดทำเอกสารและต้องการเป้าหมายที่ชัดเจนที่เกี่ยวข้อง
--cgi เปิดใช้งานโหมด CGI ในโหมด cgi ikiwiki ทำงานเป็นสคริปต์ cgi และรองรับการแก้ไข
หน้า การลงชื่อเข้าใช้ และการลงทะเบียน
ในการใช้ ikiwiki เป็นโปรแกรม CGI คุณต้องใช้ --wrapper หรือ --setup เพื่อสร้าง
กระดาษห่อ โดยทั่วไปแล้ว wrapper จะต้องเรียกใช้ suid 6755 กับผู้ใช้ที่เป็นเจ้าของ
ไดเรกทอรีต้นทางและปลายทาง
--wrapper [ไฟล์]
สร้างไบนารีของ wrapper ที่ฮาร์ดโค้ดเพื่อดำเนินการที่ระบุโดย other
ตัวเลือกโดยใช้ไฟล์อินพุตที่ระบุและไดเร็กทอรีปลายทาง ชื่อไฟล์to
ใช้สำหรับห่อเป็นตัวเลือก
เครื่องห่อได้รับการออกแบบมาเพื่อให้ปลอดภัยและดำเนินการโดยผู้ใช้ที่ไม่น่าเชื่อถือเช่นa
post-commit hook หรือเป็น CGI
โปรดทราบว่า Wrapper ที่สร้างขึ้นจะละเว้นพารามิเตอร์บรรทัดคำสั่งทั้งหมด
--รวม
หากเปิดใช้งานปลั๊กอิน/ปลั๊กอินรวม จะทำให้กำหนดค่าการสำรวจความคิดเห็น ikiwiki
ฟีดและบันทึกโพสต์ใหม่ไปที่ srcdir
โปรดทราบว่าในการสร้างโพสต์ที่รวบรวมไว้ก่อนหน้านี้ใหม่ ให้ใช้ตัวเลือก --rebuild พร้อมกับ
กับอันนี้ --rebuild จะบังคับให้ฟีดถูกสำรวจแม้ว่าจะเป็น
โพลเมื่อไม่นานนี้
--render ไฟล์
แสดงผลไฟล์เดียวโดยส่งออก html ที่เป็นผลลัพธ์ ไม่บันทึกสถานะดังนั้นสิ่งนี้
ไม่สามารถใช้สร้างวิกิทั้งหมดได้ แต่มีประโยชน์สำหรับการดูตัวอย่างการแก้ไข
ไฟล์ที่บรรทัดคำสั่ง โดยทั่วไปใช้ร่วมกับ --setup เพื่อโหลดใน a
การตั้งค่าวิกิ:
ikiwiki -- การตั้งค่า ~/ikiwiki.setup --render foo.mdwn
--โพสต์คอมมิต
เรียกใช้ในโหมด post-commit เหมือนกับการเรียกใช้โดย hook หลังการคอมมิต นี่คือ
อาจมีประโยชน์เฉพาะเมื่อใช้ ikiwiki กับเว็บเซิร์ฟเวอร์บนโฮสต์เดียวและa
ที่เก็บข้อมูลในที่อื่นเพื่อให้ hook post-commit ที่แท้จริงของที่เก็บไปยัง ssh to
โฮสต์เว็บเซิร์ฟเวอร์และเรียกใช้ ikiwiki ด้วยตนเองเพื่ออัปเดตเว็บไซต์
--รุ่น
พิมพ์หมายเลขเวอร์ชันของ ikiwiki
กำหนดค่า OPTIONS
ตัวเลือกเหล่านี้กำหนดค่าวิกิ โปรดทราบว่าปลั๊กอินสามารถเพิ่มการกำหนดค่าเพิ่มเติมได้
ทางเลือกของตัวเอง คุณสามารถกำหนดค่าตัวเลือกทั้งหมดเหล่านี้และอื่น ๆ ได้โดยใช้ a
ไฟล์ติดตั้ง
--ชื่อวิกิ
ชื่อของวิกิ ค่าเริ่มต้นคือ "wiki"
-- templatedir ผบ
ระบุไดเร็กทอรีที่จัดเก็บเทมเพลต ค่าเริ่มต้นคือ
/usr/share/ikiwiki/templates หรือตำแหน่งอื่นตามที่กำหนดค่าไว้ ณ เวลาสร้าง ถ้า
templatedir เปลี่ยนไป เทมเพลตที่หายไปจะยังคงถูกค้นหาใน
ตำแหน่งเริ่มต้นเป็นทางเลือกสำรอง แม่แบบยังสามารถวางใน "แม่แบบ/"
ไดเรกทอรีย่อยของ srcdir
โปรดทราบว่าหากคุณเลือกที่จะคัดลอกและแก้ไขเทมเพลตของ ikiwiki คุณจะต้อง
ระมัดระวังในการอัปเดตให้ทันสมัยอยู่เสมอเมื่ออัปเกรดเป็น ikiwiki เวอร์ชันใหม่ เก่า
เทมเพลตเวอร์ชันต่างๆ อาจใช้ไม่ได้กับเวอร์ชัน ikiwiki ใหม่เสมอไป
--underlaydir ผบ
ระบุไดเร็กทอรีที่ใช้หนุนไดเร็กทอรีต้นทาง ไฟล์ต้นฉบับ
จะถูกพรากไปจากที่นี่ เว้นแต่จะถูกแทนที่โดยไฟล์ในไดเร็กทอรีต้นทาง
ค่าเริ่มต้นคือ /usr/share/ikiwiki/basewiki หรือตำแหน่งอื่นตามการกำหนดค่าที่ build
เวลา
--wrappermode โหมด
ระบุโหมดที่จะ chmod wrapper เป็นหลังจากสร้าง
--wrappergroup กลุ่ม
ระบุกลุ่มยูนิกซ์ที่ wrapper ควรเป็นเจ้าของ สิ่งนี้จะมีประโยชน์หาก
wrapper จะต้องเป็นเจ้าของโดยกลุ่มอื่นที่ไม่ใช่ค่าเริ่มต้น ตัวอย่างเช่น ถ้า
โปรเจ็กต์มีพื้นที่เก็บข้อมูลที่มีคอมมิตเตอร์หลายตัวพร้อมการเข้าถึงที่ควบคุมโดยa
กลุ่ม มันสมเหตุสมผลแล้วที่ wrappers ikiwiki จะเรียกใช้ setgid กับกลุ่มนั้น
--rcs=svn|git|.., --no-rcs
เปิดหรือปิดการใช้ revision_control_system
ไดเร็กทอรีต้นทางจะถือว่าเป็นสำเนาทำงานหรือโคลนหรืออะไรก็ตาม
ระบบควบคุมการแก้ไขที่คุณเลือกใช้
ในโหมด CGI โดยเปิดใช้ระบบควบคุมการแก้ไข หน้าที่แก้ไขผ่านเว็บจะ
มีความมุ่งมั่น
ไม่มีการเปิดใช้งานการควบคุมการแก้ไขโดยค่าเริ่มต้น
--svnrepo /svn/wiki
ระบุตำแหน่งของที่เก็บ svn สำหรับวิกิ
--svnpath ลำต้น
ระบุพาธภายในที่เก็บ svn ของคุณที่มีวิกิอยู่ นี้
ค่าเริ่มต้นเพื่อลำต้น; เปลี่ยนหากวิกิของคุณอยู่ที่เส้นทางอื่นภายใน
ที่เก็บ หากวิกิของคุณถูกรูทที่ด้านบนสุดของที่เก็บ ให้ตั้งค่า svnpath เป็น ""
--rss, --นอร์ส
หากตั้งค่า rss ไว้ ikiwiki จะใช้ค่าเริ่มต้นในการสร้างฟีด RSS สำหรับหน้าเว็บที่อยู่ในบรรทัด
บล็อก
--อนุญาต
หากตั้งค่า allowrss และไม่ได้ตั้งค่า rss ikiwiki จะไม่ใช้ค่าเริ่มต้นในการสร้าง RSS
ฟีด แต่การตั้งค่า rss=yes ในคำสั่งแบบอินไลน์สามารถแทนที่ค่าเริ่มต้นนี้และ
สร้างฟีด
--อะตอม, --โนอะตอม
หากมีการตั้งค่า atom ไว้ ikiwiki จะใช้ค่าเริ่มต้นในการสร้างฟีด Atom สำหรับหน้าที่ inline
บล็อก
--อนุญาติให้
หากมีการตั้งค่า allowatom และไม่ได้ตั้งค่า rss ikiwiki จะไม่ใช้ค่าเริ่มต้นในการสร้าง
Atom ฟีด แต่การตั้งค่า atom=yes ในคำสั่งแบบอินไลน์สามารถแทนที่ค่าเริ่มต้นนี้ได้
และสร้างฟีด
--pingurl URL
ตั้งค่านี้เป็น URL ของบริการ XML-RPC เพื่อ ping เมื่อมีการอัปเดตตัวดึงข้อมูล RSS สำหรับ
ตัวอย่าง ในการ ping Technorati ให้ใช้ URL http://rpc.technorati.com/rpc/ping
พารามิเตอร์นี้สามารถระบุได้หลายครั้งเพื่อระบุ URL มากกว่าหนึ่งรายการไปยัง
ปิง
--URL URL
ระบุ URL ไปยังวิกิ นี่เป็นพารามิเตอร์ที่จำเป็นในโหมด CGI
--cgiurl http://example.org/ikiwiki.cgi
ระบุ URL ไปยังตัวตัดสคริปต์ ikiwiki CGI จำเป็นเมื่อสร้าง
wiki สำหรับลิงก์ไปยังสคริปต์ cgi ที่จะสร้าง
--URL ประวัติ URL
ระบุ URL ที่จะเชื่อมโยงสำหรับการเรียกดูประวัติหน้า ใน URL "[[ไฟล์]]" คือ
แทนที่ด้วยไฟล์ที่จะเรียกดู เป็นเรื่องปกติที่จะใช้ ViewVC สำหรับสิ่งนี้
--adminmail [ป้องกันอีเมล]
ระบุที่อยู่อีเมลที่ ikiwiki ควรใช้สำหรับการส่งอีเมล
--diffurl URL
ระบุ URL ที่จะลิงก์ไปยังส่วนต่างของการเปลี่ยนแปลงในหน้า ใน URL
"[[file]]" ถูกแทนที่ด้วยไฟล์ที่จะเรียกดู "[[r1]]" เป็นเวอร์ชันเก่าของ
หน้า และ "[[r2]]" คือการแก้ไขใหม่ เป็นเรื่องปกติที่จะใช้ ViewVC สำหรับสิ่งนี้
--ไม่รวม regexp
ระบุ rexexp ของไฟล์ต้นทางที่จะแยกออกจากการประมวลผล ระบุได้
หลายครั้งเพื่อเพิ่มเพื่อแยกรายการ
--รวมregexp
ระบุ rexexp ของไฟล์ต้นทางที่ปกติจะถูกยกเว้น แต่คุณ
ต้องการรวมในการประมวลผล อาจระบุหลายครั้งเพื่อเพิ่มเพื่อรวม
รายการ.
--ชื่อผู้ดูแลระบบ
ระบุชื่อผู้ใช้ของผู้ใช้ (หรือหากเปิดใช้งาน openid จะเป็น openid) ที่มี
อำนาจของผู้ดูแลระบบวิกิ ขณะนี้อนุญาตให้ล็อกหน้าใด ๆ และห้ามผู้ใช้เช่น
รวมถึงพลังที่ได้รับจากปลั๊กอินที่เปิดใช้งาน (เช่น [[กลั่นกรอง
ความคิดเห็น|ปลั๊กอิน/กลั่นกรองความคิดเห็น]] และปลั๊กอิน/การตั้งค่าเว็บ ระบุได้
หลายครั้งสำหรับผู้ดูแลระบบหลายคน
สำหรับผู้ใช้ openid ให้ระบุ URL แบบเต็มของการเข้าสู่ระบบ รวมถึง "http://"
--ชื่อปลั๊กอิน
เปิดใช้งานการใช้ปลั๊กอินที่ระบุในวิกิ โปรดทราบว่าชื่อปลั๊กอินคือ
กรณีที่สำคัญ.
--disable-ชื่อปลั๊กอิน
ปิดการใช้งานปลั๊กอิน ตัวอย่างเช่น "--disable-plugin htmlscrubber" ให้ยกเลิก
ด้วยการฆ่าเชื้อ HTML
--libdir ไดเรกทอรี
ทำให้ ikiwiki ดูในไดเร็กทอรีที่ระบุก่อน ก่อนตำแหน่งปกติ
เมื่อโหลดไฟล์ไลบรารีและปลั๊กอิน ตัวอย่างเช่น หากคุณตั้งค่า libdir เป็น
"/home/you/.ikiwiki/" คุณสามารถติดตั้งปลั๊กอิน foo.pm เป็น
"/home/you/.ikiwiki/IkiWiki/Plugin/foo.pm".
--อภิปราย --ไม่อภิปราย
เปิดหรือปิดลิงก์ "การสนทนา" ไม่ให้ถูกเพิ่มในส่วนหัวของทุก
หน้าหนังสือ. ลิงก์ถูกเปิดใช้งานโดยค่าเริ่มต้น
--numbacklinks น
ควบคุมจำนวนลิงก์ย้อนกลับที่ควรแสดงที่ด้านล่างของหน้า ส่วนเกิน
ลิงก์ย้อนกลับจะถูกซ่อนในป๊อปอัป ค่าเริ่มต้นคือ 10 ตั้งค่าเป็น 0 เพื่อปิดใช้งานสิ่งนี้
ลักษณะ
--userdir ย่อย
ทางเลือก อนุญาตให้ลิงก์ไปยังผู้ใช้ของวิกิเพื่อเชื่อมโยงไปยังหน้าต่างๆ ภายใน a
ไดเรกทอรีย่อยของวิกิ ค่าดีฟอลต์คือการลิงก์ไปยังเพจในไดเร็กทอรีระดับบนสุด
ของวิกิ
--htmlexthtml
กำหนดค่าส่วนขยายที่ใช้สำหรับไฟล์ html ที่สร้างขึ้น ค่าเริ่มต้นคือ "html"
--รูปแบบเวลา
ระบุวิธีการแสดงเวลาหรือวันที่ สตริงรูปแบบถูกส่งผ่านไปยัง
สตริฟไทม์(3) ฟังก์ชัน
--verbose --ไม่มี-verbose
ละเอียดถี่ถ้วนเกี่ยวกับสิ่งที่กำลังทำ
--syslog, --no-syslog
เข้าสู่ระบบ syslog(3)
--users, --no-users
สลับการสร้างไฟล์เอาต์พุตชื่อ page/index.html (ค่าเริ่มต้น) แทน page.html
--prefix-directives --no-prefix-directives
สลับไวยากรณ์นำหน้า '!' ใหม่สำหรับคำสั่งตัวประมวลผลล่วงหน้า ikiwiki ปัจจุบัน
ค่าเริ่มต้นเป็น --prefix-directives
--w3mmode, --no-w3mmode
เปิดใช้งาน w3mmode ซึ่งอนุญาตให้ w3m ใช้ ikiwiki เป็นสคริปต์ CGI ในเครื่อง โดยไม่ต้องใช้ a
เว็บเซิร์ฟเวอร์.
--sslookie
ส่งคุกกี้ผ่านการเชื่อมต่อ SSL เท่านั้น สิ่งนี้ควรป้องกันไม่ให้พวกเขาเป็น
สกัดกั้น หากคุณเปิดใช้งานตัวเลือกนี้ คุณต้องเรียกใช้ส่วน CGI เป็นอย่างน้อย
ของ ikiwiki ผ่าน SSL
--gettime --no-gettime
แยกเวลาการสร้างและการแก้ไขสำหรับหน้าใหม่แต่ละหน้าจากการแก้ไข
บันทึกการควบคุม สิ่งนี้จะทำโดยอัตโนมัติเมื่อสร้างวิกิเป็นครั้งแรก
ดังนั้นโดยปกติคุณไม่จำเป็นต้องใช้ตัวเลือกนี้
--set var = ค่า
ซึ่งช่วยให้สามารถตั้งค่าตัวแปรการกำหนดค่าตามอำเภอใจได้ เหมือนกับว่าถูกตั้งค่าไว้
ผ่านไฟล์ติดตั้ง เนื่องจากตัวเลือกที่ใช้บ่อยที่สุดสามารถกำหนดค่าได้โดยใช้
สวิตช์บรรทัดคำสั่ง คุณแทบจะไม่ต้องใช้สิ่งนี้
--set-yaml var=ค่า
เหมือนกับ --set แต่อนุญาตให้ตั้งค่าตัวแปรการกำหนดค่าที่ใช้ complex
โครงสร้างข้อมูลโดยส่งผ่านเอกสาร YAML
ตัวอย่าง
ikiwiki --ตั้งค่า my.setup
สร้างวิกิให้สมบูรณ์ (อีกครั้ง) โดยใช้ไฟล์ติดตั้งที่ระบุ
ikiwiki --setup my.setup --รีเฟรช
รีเฟรชวิกิโดยใช้การตั้งค่าจาก my.setup และหลีกเลี่ยงการสร้างหน้าเว็บใหม่ใดๆ ที่
ไม่ได้เปลี่ยนแปลง นี้จะเร็วกว่า
ikiwiki --setup my.setup --refresh --wrappers
รีเฟรชวิกิ รวมทั้งสร้างโปรแกรม wrapper ใหม่ทั้งหมด แต่อย่าสร้างใหม่
ทุกหน้า. มีประโยชน์หากคุณได้เปลี่ยนแปลงบางอย่างในไฟล์ติดตั้งที่ไม่
ต้องการวิกิใหม่แบบเต็มเพื่ออัปเดตทุกหน้า แต่คุณต้องการใช้ทันที
ผล
ikiwiki --rebuild srcdir ปลายทาง
ใช้ srcdir เป็นซอร์สและสร้าง HTML ใน destdir โดยไม่ต้องใช้ไฟล์ติดตั้ง
ikiwiki srcdir ปลายทาง
ใช้ srcdir เป็นซอร์สเพื่ออัปเดต HTML ของหน้าที่เปลี่ยนแปลงใน destdir โดยไม่ต้องใช้a
ไฟล์ติดตั้ง
และพวกเรา
CC
สิ่งนี้ควบคุมสิ่งที่คอมไพเลอร์ C ถูกใช้เพื่อสร้างห่อ ค่าเริ่มต้นคือ 'cc'
CFLAGS สามารถใช้เพื่อส่งตัวเลือกไปยังคอมไพเลอร์ C เมื่อสร้าง wrappers
ใช้ ikiwiki ออนไลน์โดยใช้บริการ onworks.net