Bundledoc - ออนไลน์ใน Cloud

โครงการ:

ชื่อ

Bundledoc - รวมไฟล์ทั้งหมดที่จำเป็นสำหรับเอกสาร LaTeX

เรื่องย่อ

บันเดิลดอค [--รุ่น] [--ช่วยด้วย] [--[ไม่]ละเอียด] [--textfile=ไฟล์] [--ไดเรกทอรี=ไดเรกทอรี]
[--[ไม่]เฉพาะท้องถิ่น] [--ไม่รวม=เชือก] [--รวม=สเปคไฟล์] [--ประจักษ์=ไฟล์]
[--listdeps=[ใช่|ไม่ใช่|เท่านั้น|rel]...] [--[ไม่]Keepdirs] [--การกำหนดค่า=ไฟล์] .de ไฟล์

DESCRIPTION

Bundledoc เป็นโพรเซสเซอร์สำหรับ ภาพรวม แพ็คเกจที่รวมเอาทั้งหมด
คลาส แพ็คเกจ และไฟล์ที่จำเป็นในการสร้างเอกสาร LaTeX ที่กำหนด มันอ่านว่า .de
ไฟล์ที่ ภาพรวม สร้าง, ค้นหาไฟล์แต่ละไฟล์ที่กล่าวถึงในนั้น, และจัดแพ็คเกจให้
เป็นไฟล์เก็บถาวรไฟล์เดียว (เช่น a .tar.gz ไฟล์) เหมาะสำหรับการเคลื่อนย้ายข้ามระบบ
ส่งต่อให้เพื่อนร่วมงาน ฯลฯ

ดังตัวอย่างที่ง่ายที่สุด ให้พิจารณาไฟล์ LaTeX ที่เรียกว่า พูดว่า สวัสดี. tex:

\RequirePackage{snapshot} % ต้องการโดยบันเดิลdoc
\documentclass[11pt]{บทความ}

\ begin {เอกสาร}
สวัสดีชาวโลก!
\ ปลายทาง {เอกสาร}

"\RequirePackage{snapshot}" ทำให้เกิด สวัสดี.dep ไฟล์ที่จะผลิต เมื่อไหร่ Bundledoc is
จากนั้นให้ "hello.dep" เป็นอาร์กิวเมนต์ มันค้นหาไฟล์ที่ขึ้นต่อกัน -- สแน็ปช็อต.sty,
บทความ.clsและ size11.clo -- และรวมเป็นไฟล์เก็บถาวรไฟล์เดียว พร้อมด้วย
สวัสดี. tex และ MANIFEST ไฟล์ (อธิบายใน "ตัวเลือก" ด้านล่าง)

OPTIONS

ในคำอธิบายต่อไปนี้ ไฟล์บางไฟล์ หมายถึงชื่อเอกสาร LaTeX หลักของคุณ (no
ส่วนขยาย).

Bundledoc ต้องการชื่อของไฟล์การพึ่งพาที่สร้างโดย ภาพรวม (โดยทั่วไป
ซัมไฟล์.dep). อาจให้ตัวเลือกต่อไปนี้ด้วย:

--รุ่น
เอาท์พุท Bundledoc หมายเลขเวอร์ชันของสคริปต์ สิ่งนี้จะแทนที่ส่วนที่เหลือทั้งหมด
ตัวเลือก

--ช่วยด้วย
ให้ข้อความการใช้งานสั้น ๆ สิ่งนี้จะแทนที่ตัวเลือกที่เหลือทั้งหมด

--[ไม่]ละเอียด (ค่าเริ่มต้น: "noverbose")
Bundledoc ปกติแล้วจะไม่แสดงผลอะไรเลยยกเว้นข้อความแสดงข้อผิดพลาด ด้วย "--verbose"
มันแสดงข้อความสถานะมากมาย

--textfile=หลัก .เท็กซ์ ไฟล์ (ค่าเริ่มต้น: ซัมไฟล์.เท็กซ์)
ภาพรวมไฟล์การพึ่งพาของไม่แสดงรายการไฟล์ LaTeX หลัก (ไฟล์ที่ผ่าน
ไปยัง น้ำยาง). เพื่อให้ Bundledoc เพื่อค้นหาและรวมกลุ่มไฟล์นั้น Bundledoc ถือว่า
มีชื่อเดียวกับ ภาพรวม ไฟล์พึ่งพา แต่ด้วย a .เท็กซ์ ส่วนขยาย. ถ้านี้
ไม่ใช่กรณีนี้ ให้ใช้ "--texfile" เพื่อระบุชื่อไฟล์ที่ถูกต้อง

--ไดเรกทอรี=เก็บ ไดเรกทอรี (ค่าเริ่มต้น: ไฟล์บางไฟล์)
เมื่อ Bundledoc สร้างไฟล์เก็บถาวร (เช่น a .tar or ซิป ไฟล์) ที่มี
ไฟล์ของเอกสาร มันวางทั้งหมดไว้ในไดเร็กทอรีเพื่อหลีกเลี่ยงไม่เกะกะกระแส
ไดเร็กทอรีที่มีไฟล์. หากไฟล์อ้างอิงที่กำหนดเรียกว่า ซัมไฟล์.dep แล้ว
ไฟล์เก็บถาวรที่เป็นผลลัพธ์จะจัดเก็บไฟล์ที่ขึ้นต่อกันทั้งหมดใน a . ตามค่าเริ่มต้น ไฟล์บางไฟล์
ไดเร็กทอรี ในการเปลี่ยนชื่อไดเร็กทอรีใช้ตัวเลือก "--directory"

--[ไม่]เฉพาะท้องถิ่น (ค่าเริ่มต้น: "nolocalonly")
แม้ว่า Bundledoc ปกติจะเก็บไฟล์ทั้งหมดที่มีชื่ออยู่ในตัว .de ไฟล์ the
"--เฉพาะ" ตัวเลือกบอก Bundledoc เพื่อแยกไฟล์ทั้งหมดที่อยู่ในไดเร็กทอรีอื่น ๆ
กว่า .เท็กซ์ ไดเร็กทอรีของไฟล์หรือหนึ่งในไดเร็กทอรีย่อย

--ไม่รวม=เชือก (ค่าเริ่มต้น: ไม่มี)
ในขณะที่ "--localonly" ทำให้ไฟล์ภายนอก .เท็กซ์ ไดเร็กทอรีทรีของไฟล์ที่จะเป็น
ละเว้นจากไฟล์เก็บถาวร "--exclude" ให้การควบคุมไฟล์ที่ละเอียดยิ่งขึ้น
ละเว้นจากไฟล์เก็บถาวร ตัวเลือก "--ไม่รวม" ซึ่งสามารถระบุซ้ำได้บน
บรรทัดคำสั่ง ทำให้ไฟล์ทั้งหมดที่มีชื่อมี เชือก ให้ละเว้นจาก
เก็บ

--รวม=สเปคไฟล์ (ค่าเริ่มต้น: ไม่มี)
ตัวเลือก "--include" ซึ่งสามารถระบุซ้ำได้บนบรรทัดคำสั่ง
สั่งสอน Bundledoc เพื่อรวมไว้ในไฟล์เก็บถาวรของไฟล์ที่ตรงกันทั้งหมด สเปคไฟล์แม้
ถ้าพวกเขาไม่ได้อ้างอิงใน .de ไฟล์

--ประจักษ์=ประจักษ์ ไฟล์ (ค่าเริ่มต้น: MANIFEST)
นอกจากไฟล์ที่ต้องพึ่งพา Bundledoc รวมไว้ในไฟล์เก็บถาวรหนึ่งไฟล์พิเศษ
ไฟล์ที่เรียกโดยค่าเริ่มต้น ``MANIFEST''. MANIFEST เป็นไฟล์ข้อความที่แสดงรายการ
ชื่อไฟล์ดั้งเดิมของการพึ่งพาทั้งหมด ในการเปลี่ยนชื่อไฟล์จาก ``MANIFEST''
อย่างอื่น ใช้ตัวเลือก "--manifest" เป็นกรณีพิเศษ "--manifest="""
บอก Bundledoc ไม่รวมไฟล์รายการเลย

--listdeps=[ใช่|ไม่ใช่|เท่านั้น|rel]...] (ค่าเริ่มต้น: "ไม่")
"--listdeps" ยอมรับ "yes", "no", "only" หรือ "rel" อย่างน้อยหนึ่งรายการโดยคั่นด้วยเครื่องหมายจุลภาค
รายการ. ตราบใดที่ "ไม่" ไม่ปรากฏในรายการนี้ Bundledoc ส่งออกหลักทั้งหมด
การพึ่งพาไฟล์ LaTeX หากรายการมี "rel" แสดงว่า Bundledoc เอาท์พุท
รายการการพึ่งพาที่มีชื่อพาธสัมพันธ์ หากรายการมี "เท่านั้น" แสดงว่า
Bundledoc ออกหลังจากแสดงรายการโดยไม่ต้องสร้างไฟล์เก็บถาวร

--[ไม่]Keepdirs (ค่าเริ่มต้น: "nokeepdirs")
โดยปกติไฟล์เก็บถาวรที่ Bundledoc ผลิตมีไดเร็กทอรีเดียว -- และ
ไดเร็กทอรีย่อย ถ้าเอกสารอ้างอิงอย่างชัดเจนถึงไดเร็กทอรีย่อย - ซึ่งทั้งหมด
ไฟล์ขึ้นอยู่กับโกหก หากระบุ "--keepdirs" ไฟล์ที่ขึ้นต่อกันทั้งหมดจะถูกเก็บไว้
ด้วยชื่อเส้นทางเดิม ตัวอย่างเช่น if ซัมไฟล์.เท็กซ์ ขึ้นอยู่กับ
ตัวเลข/somefigure.eps, บทความ.clsและ สแน็ปช็อต.styแล้ว ไฟล์บางไฟล์ เก็บถาวรจะ
โดยปกติจะมีไฟล์ต่อไปนี้:

· somefile/somefile.tex

· somefile/figures/somefigure.eps

· somefile/article.cls

· somefile/snapshot.sty

· บางไฟล์/MANIFEST

อย่างไรก็ตาม "--keepdirs" จะทำให้ ไฟล์บางไฟล์ เก็บถาวรเพื่อให้มี sorts ต่อไปนี้
ของชื่อไฟล์แทน:

· หน้าแรก/me/mydocs/somefile.tex

· หน้าแรก/me/mydocs/figures/somefigure.eps

· usr/share/texmf/tex/latex/base/article.cls

· usr/share/texmf/tex/latex/snapshot/snapshot.sty

ไม่ใช้ "--directory" เมื่อ "--keepdirs" มีผลใช้งาน นอกจากนี้ยังไม่มีประจักษ์
ไฟล์ถูกเขียนลงในไฟล์เก็บถาวรเนื่องจากมีข้อมูลที่ซ้ำซ้อน

--การกำหนดค่า=องค์ประกอบ ไฟล์ (ค่าเริ่มต้น: )
ตัวเลือก "--config" ใช้เพื่อชี้ Bundledoc เพื่อการกำหนดค่าที่เหมาะสม
(.cfg) สำหรับการแจกจ่าย TeX และระบบปฏิบัติการของคุณ Bundledoc มาพร้อมกับ a
ไฟล์การกำหนดค่าไม่กี่ไฟล์และง่ายต่อการเขียนเพิ่มเติม ดู "ไฟล์การกำหนดค่า"
(ด้านล่าง) สำหรับคำอธิบายของรูปแบบไฟล์การกำหนดค่า

การกำหนดค่า ไฟล์

รูปแบบ
ไฟล์การกำหนดค่ามีรูปแบบที่ค่อนข้างง่าย บรรทัดที่ขึ้นต้นด้วย "#" คือความคิดเห็น
บรรทัดว่างจะถูกละเว้น บรรทัดอื่น ๆ ทั้งหมดอยู่ในรูปแบบ:

ตัวแปร: ค่า

รุ่นปัจจุบันของ Bundledoc รู้จักตัวแปรต่อไปนี้:

กำ
คำสั่งที่ใช้เพื่อบันเดิลชุดของไฟล์เป็นไฟล์เก็บถาวรไฟล์เดียว

จม
ติดอยู่กับคำสั่งเพื่อละทิ้งเอาท์พุต

พบ
คำสั่งเพื่อค้นหาไฟล์ภายในทรี TeX

ค่าที่ยาวเกินไปสำหรับหนึ่งบรรทัดสามารถแบ่งออกเป็นหลายบรรทัดได้โดยใช้ "\" as
สัญลักษณ์ความต่อเนื่องของเส้น

มีสองตัวแปรสภาพแวดล้อมที่ Bundledoc ทำให้สามารถใช้ได้โดย
คำสั่งไฟล์ configuration: "BDBASE" ซึ่งตั้งค่าเป็น ไฟล์บางไฟล์ (ดังใน "ตัวเลือก") และ
"BDINPUTS" ซึ่งถูกกำหนดเป็นรายการไฟล์ที่คั่นด้วยช่องว่างที่คำสั่งให้ดำเนินการ
เมื่อ. นั่นคือเมื่อคำสั่งที่เกี่ยวข้องกับ "bundle" กำลังทำงานอยู่ "BDINPUTS" ประกอบด้วย
รายการไฟล์ทั้งหมดที่จะเก็บถาวร ในทางตรงกันข้าม เมื่อคำสั่ง
ที่เกี่ยวข้องกับ "find" กำลังทำงานอยู่ "BDINPUTS" มีชื่อของไฟล์ที่จะค้นหา

ตัวอย่าง
ไฟล์การกำหนดค่าต่อไปนี้ขนานกัน Bundledocค่าเริ่มต้นของต่างๆ
ตัวแปรไฟล์คอนฟิกูเรชันซึ่งแสดงถึงการแจกจ่าย TeX แบบ kpathsea ที่ทำงานอยู่
บนระบบ Unix ทั่วไป ซึ่งไม่จำเป็นต้องมีเครื่องมือ GNU ใดๆ เช่น
gzip หรือ GNU น้ำมันดิน:

# "ค่าเริ่มต้น" ไฟล์กำหนดค่า
# By สก๊อต ภาคิน[ป้องกันอีเมล]>

กลุ่ม: (tar -cvf - $BDINPUTS | บีบอัด > $BDBASE.tar.Z)
ซิงก์: > /dev/null 2>&1
ค้นหา: kpsewhich -progname=latex $BDINPUTS

วงเล็บในบรรทัด "bundle:" บอกให้เชลล์ Unix รันคำสั่งใน a
เปลือกย่อย นี่คือการทำให้ส่วนต่อ "จม:" ทำงานอย่างถูกต้อง (เช่นดังนั้นจึงไม่มีสอง
">" เป็นคำสั่งเดียวกัน)

สังเกตว่าคำสั่งปฏิบัติต่อ "BDBASE" และ "BDINPUTS" เหมือนกับตัวแปรสภาพแวดล้อมอื่น ๆ อย่างไร
ในเชลล์ Unix โดยใช้ "$" เพื่อรับค่า ระบบปฏิบัติการอื่นใช้ต่างกัน
อนุสัญญาสำหรับการอ้างอิงถึงตัวแปรสภาพแวดล้อม ตัวอย่างเช่น ไฟล์คอนฟิกูเรชัน
สำหรับการกระจาย TeX ที่ใช้ Windows จะใช้ "%BDBASE%" และ "%BDINPUTS%" แทน

ค่าสำหรับ "sink:" เป็นค่าเฉพาะสำหรับระบบปฏิบัติการ ค่าของ "find:" คือ
เฉพาะสำหรับการกระจาย TeX "bundle:" เป็นที่ที่มีโอกาสปรับแต่งได้มากที่สุด
โกหก คุณสามารถใช้ "bundle:" เพื่อระบุรูปแบบไฟล์เก็บถาวรที่คุณชื่นชอบ ตัวอย่างเช่น คุณ
สามารถสร้างไฟล์ shar บน Unix ได้ดังนี้:

บันเดิล: (shar --archive-name="$BDBASE" $BDINPUTS > $BDBASE.sh)

หรือไฟล์ CAB บน Microsoft Windows ที่มีลักษณะดังนี้:

กลุ่ม: cabarc -r -p N %BDBASE%.cab %BDINPUTS%

ตัวอย่าง

สมมติว่า myfile.dep ผลิตจาก myfile.tex โดยปฏิบัติตามคำแนะนำใน
ส่วนคำอธิบาย คำสั่งต่อไปนี้สร้าง a ซิป ไฟล์ด้วย MikTeX TeX
การกระจายที่ทำงานบน Microsoft Windows:

Bundledoc --config=miktex.cfg myfile.dep

(ในทางปฏิบัติ อาจจำเป็นต้องระบุ "--config" เส้นทางที่สมบูรณ์ไปยัง
Bundledoc's miktex.cfg ไฟล์คอนฟิก)

ต่อไปนี้สร้างa .tar.gz เก็บถาวรด้วยการกระจาย TeX Live ที่ทำงานบน Unix-
เช่นระบบปฏิบัติการ Bundledoc จะสร้างผลลัพธ์โดยละเอียดที่อธิบายการทำงานของมัน
ไฟล์ทั้งหมดไม่อยู่ในแผนผังไดเร็กทอรีเดียวกันกับ myfile.tex และไฟล์ทั้งหมดที่มี ".fd" หรือ
".sty" ในชื่อของพวกเขาจะละเว้น อย่างไรก็ตาม ทั้งหมด .เอี๊ยม ไฟล์ในไดเร็กทอรีปัจจุบัน will
รวมอยู่ในไฟล์เก็บถาวรแม้ว่าจะไม่มีการอ้างถึงโดย myfile.dep.
สุดท้าย ไม่ MANIFEST ไฟล์จะถูกผลิต

Bundledoc --config=texlive-unix.cfg --verbose --localonly \
--exclude=.fd --exclude=.cfg --include="*.bib" --manifest="" \
myfile.dep

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