notangle - ອອນລາຍໃນຄລາວ

ໂຄງການ:

NAME

notangle, noweave, nountangle - noweb, ເຄື່ອງມືການຂຽນໂປຣແກຣມທີ່ຮູ້ໜັງສື

ສະຫຼຸບສັງລວມ

ຮູບສີ່ຫລ່ຽມ [-Rຊື່ຮາກ ... ] [-ຕົວກັ່ນຕອງ ຄໍາ​ສັ່ງ​] [-L[format]] [file] ...
ຄຳນາມ [-ml|-m3|-c|-c++|-ອ້າວ|-tex|-f77|-f90|-lisp|-matlab] [-Rຊື່ຮາກ ... ] [-ຕົວກັ່ນຕອງ
ຄໍາ​ສັ່ງ​] [-wwidth] [ໄຟລ໌] ...
ດຽວນີ້ [ຕົວເລືອກ] [ໄຟລ໌] ...

ລາຍລະອຽດ

Noweb ເປັນເຄື່ອງມືການຂຽນໂປລແກລມທີ່ຮູ້ຫນັງສືຄືກັບ Knuth's ເວັບ, ພຽງ​ແຕ່​ງ່າຍ​ດາຍ​. ກ noweb ເອກະສານ
ປະກອບມີລະຫັດແຫຼ່ງໂຄງການ interleaved ກັບເອກະສານ. ເມື່ອ​ໃດ​ ຮູບສີ່ຫລ່ຽມ ແມ່ນໃຫ້ເປັນ
noweb ໄຟລ໌, ມັນຂຽນໂຄງການກ່ຽວກັບຜົນຜະລິດມາດຕະຖານ. ເມື່ອ​ໃດ​ ດຽວນີ້ ແມ່ນໃຫ້ເປັນ noweb ແຟ້ມ,
ມັນອ່ານໄດ້ noweb ແຫຼ່ງ​ແລະ​ການ​ຜະ​ລິດ​, ກ່ຽວ​ກັບ​ຜົນ​ຜະ​ລິດ​ມາດ​ຕະ​ຖານ​, LaTeX, ເທັກ, ຕັດໄມ້, ຫຼື HTML
ແຫຼ່ງຂໍ້ມູນສໍາລັບເອກະສານປະເພດ. ຄຳນາມ ປ່ຽນໂຄງການທີ່ຮູ້ຫນັງສືເປັນແບບທໍາມະດາ
ໂຄງ​ການ​ໂດຍ​ການ​ປ່ຽນ​ເອ​ກະ​ສານ interleaved ເປັນ​ຄໍາ​ເຫັນ​. ຊື່ໄຟລ໌ `-' ຫມາຍເຖິງ
ວັດສະດຸປ້ອນມາດຕະຖານ.

ຮູບແບບ OF ດຽວນີ້ ເອກະສານ

A noweb ໄຟລ໌ແມ່ນລໍາດັບຂອງ ຊິ້ນ, ເຊິ່ງອາດຈະປາກົດຢູ່ໃນຄໍາສັ່ງໃດໆ. ຕ່ອນໜຶ່ງອາດມີ
ລະຫັດ ຫຼືເອກະສານ. ຕ່ອນເອກະສານເລີ່ມຕົ້ນດ້ວຍເສັ້ນທີ່ເລີ່ມຕົ້ນດ້ວຍເຄື່ອງໝາຍ
(@) ຕາມດ້ວຍຊ່ອງຫວ່າງ ຫຼືແຖວໃໝ່. ພວກເຂົາບໍ່ມີຊື່. ຕ່ອນລະຫັດເລີ່ມຕົ້ນດ້ວຍ
<<ຄັກ ຊື່>> =
ຢູ່ໃນເສັ້ນດ້ວຍຕົວມັນເອງ. ວົງເລັບມຸມຊ້າຍສອງເທົ່າ (<<) ຈະຕ້ອງຢູ່ໃນຖັນທໍາອິດ.
Chunks ຖືກຢຸດໂດຍການເລີ່ມຕົ້ນຂອງ chunk ອື່ນ, ຫຼືໃນຕອນທ້າຍຂອງໄຟລ໌. ຖ້າທໍາອິດ
ເສັ້ນໃນໄຟລ໌ບໍ່ໄດ້ຫມາຍຈຸດເລີ່ມຕົ້ນຂອງ chunk, ມັນແມ່ນສົມມຸດວ່າທໍາອິດ
ແຖວຂອງເອກະສານເອກະສານ.

ຊິ້ນເອກະສານມີຂໍ້ຄວາມທີ່ຖືກລະເລີຍໂດຍ ຮູບສີ່ຫລ່ຽມ ແລະສຳເນົາຄຳເວົ້າໃສ່
ຜົນຜະລິດມາດຕະຖານໂດຍ ດຽວນີ້ (ຍົກເວັ້ນລະຫັດອ້າງອີງ). ດຽວນີ້ ສາມາດເຮັດວຽກຮ່ວມກັບ LaTeX, ທົ່ງພຽງ
ເທັກ, ຕັດໄມ້ or HTML. ກັບທໍາມະດາ ເທັກ, ມັນແຊກການອ້າງອີງເຖິງ a ເທັກ ຊຸດມະຫາພາກ, nwmac,
ເຊິ່ງກໍານົດຄໍາສັ່ງເຊັ່ນ \ ບົດ ແລະ \ ພາກ.

ຊິ້ນສ່ວນຂອງລະຫັດມີລະຫັດແຫຼ່ງຂອງໂປຣແກຣມ ແລະອ້າງອີງໃສ່ຊຸດລະຫັດອື່ນໆ. ລະຫັດຫຼາຍ
chunks ອາດ​ຈະ​ມີ​ຊື່​ດຽວ​ກັນ​; ຮູບສີ່ຫລ່ຽມ concatenates ຄໍານິຍາມຂອງພວກເຂົາເພື່ອຜະລິດອັນດຽວ
chunk, ຄືກັນກັບເຮັດ tangle(1). ຄໍານິຍາມລະຫັດ chunk ແມ່ນຄ້າຍຄືຄໍານິຍາມມະຫາພາກ;
ຮູບສີ່ຫລ່ຽມ ສະກັດໂຄງການໂດຍການຂະຫຍາຍຫນຶ່ງ chunk (ໂດຍຄ່າເລີ່ມຕົ້ນ, chunk ຊື່ <<*>>).
ຄໍານິຍາມຂອງ chunk ນັ້ນປະກອບດ້ວຍການອ້າງອີງເຖິງ chunks ອື່ນໆ, ຊຶ່ງເປັນຕົວຂອງມັນເອງ
ຂະຫຍາຍ, ແລະອື່ນໆ. ຮູບສີ່ຫລ່ຽມຜົນຜະລິດຂອງແມ່ນສາມາດອ່ານໄດ້; ມັນຮັກສາ indentation ຂອງ
ການຂະຫຍາຍ chunks ກ່ຽວກັບ chunks ທີ່ເຂົາເຈົ້າປາກົດ.

ລະຫັດອາດຈະຖືກອ້າງອີງພາຍໃນຊິ້ນເອກະສານໂດຍການວາງວົງເລັບສອງເທົ່າ ([[...]])
ອ້ອມຮອບມັນ. ວົງເລັບສີ່ຫຼ່ຽມເຫຼົ່ານີ້ຖືກລະເລີຍໂດຍ ມຸມ, ແຕ່ພວກເຂົາອາດຈະຖືກນໍາໃຊ້ໂດຍ
ດຽວນີ້ ເພື່ອໃຫ້ລະຫັດການປິ່ນປົວແບບພິເສດ, ຕົວຢ່າງ, ການເຊື່ອມໂຍງ hypertext. ຖ້າອ້າງ
ລະຫັດລົງທ້າຍດ້ວຍວົງເລັບສີ່ຫຼ່ຽມ ຫຼືຫຼາຍກວ່ານັ້ນ, ດຽວນີ້ ເລືອກຄູ່ທີ່ຖືກຕ້ອງທີ່ສຸດ, ດັ່ງນັ້ນ,
ຍົກ​ຕົວ​ຢ່າງ, [[a[i]]] ຖືກວິເຄາະຢ່າງຖືກຕ້ອງ. ຊື່ຂອງລະຫັດ chunks ອາດຈະປາກົດຢູ່ພາຍໃນ
ລະຫັດອ້າງອີງເວັ້ນເສຍແຕ່ວ່າລະຫັດທີ່ອ້າງອີງນັ້ນແມ່ນສ່ວນໜຶ່ງຂອງຊື່ຂອງຊຸດລະຫັດ.

ໃນລະຫັດ, noweb ປະຕິບັດຕໍ່ວົງເລັບມຸມຊ້າຍຫຼືຂວາສອງເທົ່າທີ່ບໍ່ໄດ້ຈັບຄູ່ເປັນຕົວຫນັງສື << ແລະ >>.
ເພື່ອບັງຄັບວົງເລັບດັ່ງກ່າວ, ເຖິງແມ່ນວ່າວົງເລັບຈັບຄູ່ຫຼືວົງເລັບໃນເອກະສານ, ຈະເປັນ
ຖືວ່າເປັນຕົວໜັງສື, ໃຫ້ໃຊ້ເຄື່ອງໝາຍກ່ອນໜ້າ (ຕົວຢ່າງ @<).

ບາງພາສາການຂຽນໂປລແກລມຫຼືການຈັດຮູບແບບອາດຈະຕ້ອງການອັນດຽວ @ ເຂົ້າສູ່ລະບົບຖັນທໍາອິດ.
ຜູ້ໃຊ້ Noweb ອາດຈະບັນລຸຜົນກະທົບນີ້ໂດຍການວາງສອງເທົ່າ @@ ໃນຖັນທໍາອິດ; ໃນ​ນີ້
ຕໍາແຫນ່ງພຽງແຕ່, ມັນຢືນສໍາລັບການດຽວ @ ເຊັນ.

ຂັດຂ້ອງ

ຮູບສີ່ຫລ່ຽມ ແລະ ຄຳນາມ ຍອມຮັບຊຸດທາງເລືອກດຽວກັນ, ເຖິງແມ່ນວ່າບາງທາງເລືອກມີຜົນກະທົບ
ພຽງແຕ່ໃນຫນຶ່ງຫຼືອື່ນໆ. ທາງເລືອກແມ່ນ:

-Rຊື່ ຂະຫຍາຍຕົວ <<ຊື່>> ໂຄດຄໍາສັ່ງ. ໄດ້ -R ທາງເລືອກສາມາດຊ້ໍາໄດ້, ໃນກໍລະນີນີ້ແຕ່ລະຄົນ
chunk ແມ່ນຂຽນໃສ່ຜົນໄດ້ຮັບ. ຖ້າບໍ່ມີ -R ທາງເລືອກແມ່ນໃຫ້, ຂະຫຍາຍ chunk ຊື່
<<*>>.

-Lຮູບແບບ
ປ່ອຍຕົວຊີ້ບອກຕົວເລກແຖວຢູ່ໃນຂອບເຂດຂອງ chunk. ຕົວຊີ້ບອກເລກແຖວ
ກໍານົດແຫຼ່ງທີ່ມາຂອງສາຍທີ່ຕິດຕາມມັນ. ໃນ ຮູບແບບ, %F ຊີ້ບອກ
ຊື່​ຂອງ​ໄຟລ​໌​ທີ່​ມາ​, %L ຊີ້ບອກຕົວເລກແຖວຂອງໄຟລ໌ແຫຼ່ງ, %N
ຊີ້ໃຫ້ເຫັນເຖິງແຖວໃຫມ່, ແລະ %% ຊີ້ໃຫ້ເຫັນເຖິງເຄື່ອງຫມາຍເປີເຊັນ. ເຄື່ອງຫມາຍແລະຕົວເລກອາດຈະເປັນ
ໃສ່ລະຫວ່າງສັນຍາລັກສ່ວນຮ້ອຍແລະ `L', ໃນ​ກໍ​ລະ​ນີ​ທີ່​ຫມາຍ​ເລກ​ແຖວ​ຈະ​
ຈະຖືກປັບຕາມຈໍານວນນັ້ນ. ຖ້າ ຮູບແບບ ຖືກລະເວັ້ນ, ຮູບແບບເລີ່ມຕົ້ນແມ່ນແບບນັ້ນ
ຍອມຮັບໂດຍ C preprocessor: `#ສາຍ %L "%F"%N'. ໃນ​ເວ​ລາ​ທີ່​ການ​ນໍາ​ໃຊ້​ -Lຮູບແບບ ທາງເລືອກ,
ຮູບສີ່ຫລ່ຽມ ຮັບປະກັນວ່າຂໍ້ຄວາມທັງໝົດປາກົດຢູ່ໃນຖັນດຽວກັນໃນການປ້ອນຂໍ້ມູນ ແລະຜົນຜະລິດ.
ຄຳນາມ ບໍ່ສົນໃຈທາງເລືອກນີ້.

ສະຕຣິງຮູບແບບທົ່ວໄປລວມມີ:
C -L'#line %L "%F"%N'
Sun FORTRAN -L'\# %L "%F"%N'
ຮູບສັນຍາລັກ -L'#line %-1L "%F"%N'
ໂມດູລາ-3 -L'<*LINE %L "%F" *>%N'
SML / NJ -L'(*#line %L "%F"*)'

ເພື່ອແກ້ໄຂບັນຫາການສົນທະນາ, ນັ້ນແມ່ນ, ເພື່ອໃຫ້ໄດ້ຮັບ noweb ເພື່ອເຮັດບາງສິ່ງບາງຢ່າງທີ່ເຫມາະສົມກັບ
#ສາຍ ໃນ​ການ​ປ້ອນ​ຂໍ້​ມູນ​ຂອງ​ຕົນ​, ເບິ່ງ​ ເສັ້ນແຫຼມ ການກັ່ນຕອງໃນບັນຊີຕົວຢ່າງ.

-tk ຄັດລອກແຖບທີ່ບໍ່ມີການສໍາພັດຈາກວັດສະດຸປ້ອນໄປຫາຜົນຜະລິດ, ແລະໃຊ້ແຖບສໍາລັບການຫຍໍ້ຫນ້າ, ສົມມຸດວ່າ
ຢຸດທຸກໆ k ຖັນ. ໂດຍຄ່າເລີ່ມຕົ້ນ, ແຖບຖືກຂະຫຍາຍໄປໃສ່ຊ່ອງຫວ່າງທີ່ມີຈຸດຢຸດທຸກໆ 8
ຖັນ.

-ຕົວກັ່ນຕອງ cmd
ການກັ່ນຕອງ noweb ແຫຼ່ງຜ່ານ cmd ຫຼັງ​ຈາກ​ທີ່​ປ່ຽນ​ເປັນ​ຮູບ​ແບບ​ເຄື່ອງ​ມື​ແລະ​ກ່ອນ​
ຂັດກັນ. ຮູບສີ່ຫລ່ຽມ ຊອກຫາ cmd ທໍາອິດກ່ຽວກັບຜູ້ໃຊ້ PATH, ຫຼັງຈາກນັ້ນໃນ /usr/lib/noweb.
ການກັ່ນຕອງດັ່ງກ່າວສາມາດຖືກນໍາໃຊ້ເພື່ອເພີ່ມຄຸນສົມບັດໃສ່ ຮູບສີ່ຫລ່ຽມ; ຕົວຢ່າງເບິ່ງ
/usr/lib/noweb/emptydefn. ສໍາລັບຜູ້ຊ່ຽວຊານເທົ່ານັ້ນ.

-ເຄື່ອງໝາຍ ແມ່ບົດ
ການນໍາໃຊ້ ແມ່ບົດ ເພື່ອວິເຄາະໄຟລ໌ປ້ອນຂໍ້ມູນ. ເປີດໃຊ້ເຄື່ອງມື noweb ໃນໄຟລ໌ອື່ນໆ
ຮູບແບບ; ສໍາລັບການຍົກຕົວຢ່າງ, ໄດ້ ຕົວເລກ parser ເຂົ້າໃຈ ນູເວບ(1) ຮູບແບບ. ເບິ່ງ
nowebfilters(7) ສໍາລັບຂໍ້ມູນເພີ່ມເຕີມ. ສໍາລັບຜູ້ຊ່ຽວຊານເທົ່ານັ້ນ.

-ອ້າວ | -c | -icn | -ໄອຄອນ | -ml | -m3 | - ປາສຄາລ | -f77 | -f90 | -tex
ເມື່ອ​ໃດ​ ຄຳນາມ ປ່ຽນເອກະສານເອກະສານເຂົ້າໄປໃນຄໍາເຫັນ, ໃຊ້ຄໍາຄິດຄໍາເຫັນ
ຮູບແບບຂອງພາສາທີ່ມີຊື່. -c ເປັນຄ່າເລີ່ມຕົ້ນ. ຮູບສີ່ຫລ່ຽມ ບໍ່ສົນໃຈທາງເລືອກເຫຼົ່ານີ້.

-wn ເມື່ອ​ໃດ​ ຄຳນາມ ປ່ຽນເອກະສານເອກະສານເຂົ້າໄປໃນຄໍາເຫັນ, ສ້າງຄໍາເຫັນກ່ຽວກັບ
ເສັ້ນຂອງຄວາມກວ້າງ n. ຮູບສີ່ຫລ່ຽມ ບໍ່ສົນໃຈທາງເລືອກນີ້.

ຕໍ່າແຜ່ນແພ

ຜົນຜະລິດຈາກ ດຽວນີ້ ສາມາດຖືກນໍາໃຊ້ໃນ ເທັກ ເອກະສານທີ່ \ ປ້ອນຂໍ້ມູນ nwmac, in LaTeX ເອກະສານ
ທີ່ໃຊ້ noweb ຊຸດ (ເບິ່ງ nowebstyle(1​)), ແລະໃນ HTML ເອ​ກະ​ສານ​ທີ່​ຈະ​ໄດ້​ຮັບ​ການ​ຄົ້ນ​ຫາ​ດ້ວຍ​
ຂອງໂມເຊ(1). ດຽວນີ້ ປະຕິບັດຕໍ່ຕ່ອນລະຫັດທີ່ຄ້າຍຄື LaTeX ບັນຊີລາຍຊື່ ສະພາບແວດລ້ອມ. ຖ້າ ``@
'' ທີ່ສິ້ນສຸດລະຫັດ chunk ແມ່ນປະຕິບັດຕາມທັນທີໂດຍຂໍ້ຄວາມ, ຂໍ້ຄວາມທີ່ປະຕິບັດຕາມ
ລະຫັດ chunk ໂດຍບໍ່ມີການແຍກວັກ. ຖ້າສາຍທີ່ເຫຼືອແມ່ນຫວ່າງເປົ່າ, ດຽວນີ້ puts puts ເທັກ
ເຂົ້າໄປໃນ ``ຮູບແບບແນວຕັ້ງ,'' ແລະຕໍ່ມາຂໍ້ຄວາມຈະເລີ່ມຫຍໍ້ໜ້າໃໝ່, ຫຍໍ້ໜ້າ.

ບໍ່ມີການແບ່ງໜ້າໃດໆເກີດຂຶ້ນຢູ່ເຄິ່ງກາງຂອງຊິ້ນສ່ວນລະຫັດ ເວັ້ນເສຍແຕ່ຈຳເປັນເພື່ອຫຼີກລ່ຽງການເຕັມ
vbox. ຕ່ອນເອກະສານທັນທີກ່ອນຊຸດລະຫັດຈະປາກົດຢູ່ໃນຫນ້າດຽວກັນ
ເພາະ​ວ່າ​ການ​ລະ​ຫັດ​ນັ້ນ​ຈະ​ເປັນ​ການ​ລະ​ເມີດ​ກົດ​ລະ​ບຽບ​ທີ່​ຜ່ານ​ມາ.

ດຽວນີ້ ບໍ່​ມີ​ການ​ໃສ່​ເສັ້ນ​ໃຫມ່​ເພີ່ມ​ເຕີມ​ໃນ​ມັນ​ ເທັກ ຜົນຜະລິດ, ດັ່ງນັ້ນຕົວເລກແຖວທີ່ໄດ້ຮັບໃນ ເທັກ
ຂໍ້​ຄວາມ​ຜິດ​ພາດ​ແມ່ນ​ຄື​ກັນ​ກັບ​ທີ່​ຢູ່​ໃນ​ໄຟລ​໌​ປ້ອນ​ຂໍ້​ມູນ​.

ດຽວນີ້ ມີທາງເລືອກທີ່ກໍານົດທາງເລືອກຂອງຮູບແບບແລະສະຫນັບສະຫນູນຮູບແບບທີ່ແຕກຕ່າງກັນ
idioms ແລະເຄື່ອງມື. ທາງເລືອກພື້ນຖານໄດ້ຖືກອະທິບາຍຢູ່ທີ່ນີ້; ທາງ​ເລືອກ​ທີ່​ກ່ຽວ​ຂ້ອງ​ກັບ​ດັດ​ຊະ​ນີ​ແລະ​ຂ້າມ
ຂໍ້​ມູນ​ອ້າງ​ອີງ​ແມ່ນ​ອະ​ທິ​ບາຍ​ໃນ​ພາກ​ສ່ວນ​ການ​ດັດ​ແກ້​ແລະ​ການ​ອ້າງ​ອີງ​ຂ້າມ​.

- ຢາງ ປ່ອຍ LaTeX, ລວມທັງ wrapper ໃນ ບົດຄວາມ ແບບກັບ noweb ຊຸດແລະຫນ້າ
ແບບ. (ຄ່າເລີ່ມຕົ້ນ)

-tex ປ່ອຍ TeX ທໍາມະດາ, ລວມທັງ wrapper ກັບ nwmac ມະຫາພາກ.

-html ປ່ອຍ HTML, ໂດຍໃຊ້ HTML wrapper. ຜົນຜະລິດແມ່ນບໍ່ຫນ້າສົນໃຈໂດຍບໍ່ມີການ -ດັດຊະນີ or -x.
ແທັກ ແລະ , ໃນສາຍດ້ວຍຕົນເອງ, ຜະລິດບັນຊີລາຍຊື່ຂອງ
chunks ແລະດັດຊະນີຂອງຕົວລະບຸ, ຕາມລໍາດັບ. ຖ້າແທັກເຫຼົ່ານີ້ບໍ່ຢູ່,
ບັນຊີລາຍຊື່ແລະດັດຊະນີຖືກວາງໄວ້ໃນຕອນທ້າຍຂອງໄຟລ໌.

-latex+html
ສົມມຸດວ່າຊິ້ນສ່ວນເອກະສານແມ່ນ LaTeX, ແຕ່ສ້າງ HTML ສໍາລັບຕ່ອນລະຫັດ, ເຫມາະສົມ
ຫມາຍດັ່ງນັ້ນການແປງດ້ວຍ latex2html(1​) ໃຫ້ຜົນຜະລິດທີ່ສົມເຫດສົມຜົນ. ເຄື່ອງຫໍ່ LaTeX
ແມ່ນ implied, ແຕ່ສາມາດປິດໄດ້ -n. ການນໍາໃຊ້ of ນີ້ ທາງເລືອກ is ເຊົາສະໜັບສະໜູນ; ການນໍາໃຊ້
-html ກັບ -ຕົວກັ່ນຕອງ l2h ແທນທີ່ຈະເປັນ.

-troff ປ່ອຍ ຕັດໄມ້(1) markup (ບໍ່ມີ wrapper). ຜົນໄດ້ຮັບຄວນໄດ້ຮັບການປຸງແຕ່ງດ້ວຍ
ນອຟ(1). ບົດ​ລາຍ​ງານ bug ສໍາ​ລັບ -troff ກັບ Aharon Robbins <arnold@gnu.org>.

-n ຢ່າໃຊ້ wrapper (header ຫຼື trailer). ທາງເລືອກນີ້ແມ່ນເປັນປະໂຫຍດໃນເວລາທີ່ ດຽວນີ້'s
ຜົນຜະລິດຈະເປັນສ່ວນຫນຶ່ງຂອງເອກະສານຂະຫນາດໃຫຍ່. ເບິ່ງນຳ - ຊັກ​ຊ້າ​.

-ຕົວກັ່ນຕອງ cmd
ການກັ່ນຕອງ noweb ແຫຼ່ງຜ່ານ cmd ຫຼັງ​ຈາກ​ທີ່​ປ່ຽນ​ເປັນ​ຮູບ​ແບບ​ເຄື່ອງ​ມື​ແລະ​ກ່ອນ​
ປ່ຽນເປັນ TeX. ດຽວນີ້ ຊອກຫາ cmd ທໍາອິດກ່ຽວກັບຜູ້ໃຊ້ ເສັ້ນທາງ, ຫຼັງຈາກນັ້ນໃນ
/usr/lib/noweb. ການກັ່ນຕອງດັ່ງກ່າວສາມາດຖືກນໍາໃຊ້ເພື່ອເພີ່ມຄຸນສົມບັດໃສ່ ປະຈຸບັນ; ສໍາລັບການຫນຶ່ງ
ຕົວຢ່າງ, ເບິ່ງ /usr/lib/noweb/noxref.krom. ດຽວນີ້ ສະຫນັບສະຫນູນເຖິງສີ່ຕົວກອງ; ຫນຶ່ງ
ສາມາດໄດ້ຮັບຫຼາຍໂດຍການຫຼອກລວງ shell, ສໍາລັບການຍົກຕົວຢ່າງ, -ຕົວກັ່ນຕອງ "icon.filter | noidx". ໄດ້
- autodefs, -x, -ດັດຊະນີ, ແລະ -index ຈາກ ທາງເລືອກແມ່ນປະຕິບັດເປັນຕົວກອງ. ການກັ່ນຕອງ
ຖືກປະຕິບັດດ້ວຍແກະ ການປະເມີນ ຄໍາສັ່ງ, ດັ່ງນັ້ນ cmd ຄວນຖືກອ້າງອີງຕາມຄວາມເຫມາະສົມ.

-ເຄື່ອງໝາຍ ແມ່ບົດ
ການນໍາໃຊ້ ແມ່ບົດ ເພື່ອວິເຄາະໄຟລ໌ປ້ອນຂໍ້ມູນ. ເປີດໃຊ້ເຄື່ອງມື noweb ໃນໄຟລ໌ອື່ນໆ
ຮູບແບບ; ສໍາລັບການຍົກຕົວຢ່າງ, ໄດ້ ຕົວເລກ parser ເຂົ້າໃຈ ນູເວບ(1) ຮູບແບບ. ເບິ່ງ
nowebfilters(7) ສໍາລັບຂໍ້ມູນເພີ່ມເຕີມ. ສໍາລັບຜູ້ຊ່ຽວຊານເທົ່ານັ້ນ.

- ທາງ​ເລືອກ​ ເລືອກ
Adds \noweboptions{ເລືອກ} ການ LaTeX ສ່ວນຫົວ. ເບິ່ງ nowebstyle(1​) ສໍາລັບຄຸນຄ່າຂອງ ເລືອກ.
ປົກກະຕິແລ້ວທີ່ເປັນປະໂຫຍດພຽງແຕ່ກັບ - ຢາງ ທາງເລືອກ, ແຕ່ວ່າ - ທາງ​ເລືອກ​ longxref ເຮັດວຽກ magic ສີດໍາ
ກັບ -html.

- ຊັກ​ຊ້າ​ ໂດຍຕົວຢ່າງ, ດຽວນີ້ ເອົາຊື່ໄຟລ໌ແລະຂໍ້ມູນອື່ນໆເຂົ້າໄປໃນຜົນຜະລິດກ່ອນ
chunk ທໍາ​ອິດ​ຂອງ​ໂຄງ​ການ​. - ຊັກ​ຊ້າ​ ຊັກຊ້າຂໍ້ມູນນັ້ນຈົນກ່ວາຫຼັງຈາກທໍາອິດ
chunk ເອ ກະ ສານ , ເຮັດ ໃຫ້ ການ ປະ ຕິ ບັດ ເປັນ ເລັກ ນ້ອຍ ຄື ເວັບໄຊຕ໌ ``limbo.'' ທາງເລືອກແມ່ນ
ປົກກະຕິແລ້ວໃຊ້ເພື່ອໃຫ້ຜູ້ໃຊ້ສາມາດໃສ່ສະເພາະ LaTeX \documentclass ຄໍາສັ່ງ
ແລະເອກະສານ preamble ອື່ນໆໃນ chunk ເອກະສານທໍາອິດ (ie, ກ່ອນທີ່ຈະ ໄດ້
ສັນຍາລັກ @ ທໍາອິດ). ຕົວເລືອກນີ້ຍັງບັງຄັບໃຫ້ຂໍ້ມູນການອ້າງອີງຂ້າມໄປຫາ
ຈະຖືກປ່ອຍອອກມາກ່ອນບົດສຸດທ້າຍ, ແທນທີ່ຈະຢູ່ໃນຕອນທ້າຍຂອງເອກະສານ; ໄດ້
chunk ສຸດ​ທ້າຍ​ຄາດ​ວ່າ​ຈະ​ມີ​ \end{document}. ໄດ້ - ຊັກ​ຊ້າ​ ທາງເລືອກຫມາຍເຖິງ
-n ທາງເລືອກ.

-tk ຂະຫຍາຍແຖບດ້ວຍການຢຸດທຸກໆ k ຖັນ. (ຄ່າເລີ່ມຕົ້ນແມ່ນການຂະຫຍາຍທຸກໆ 8 ຖັນ.)

-t ຄັດລອກແຖບໃສ່ຜົນໄດ້ຮັບ.

-v ພິມຂໍ້ມູນທໍ່ ແລະ RCS ໃນຄວາມຜິດພາດມາດຕະຖານ.

ດັດສະນີ ແລະ ຂໍ້ມູນຂ້າມ

ເມື່ອໃຊ້ກັບ LaTeX, ຕັດໄມ້, ຫຼື HTML, ດຽວນີ້ ສາມາດສະຫນອງການດັດສະນີແລະການອ້າງອີງຂ້າມ
ຂໍ້​ມູນ​ສໍາ​ລັບ chunks ແລະ​ສໍາ​ລັບ​ຕົວ​ລະ​ບຸ​ພາ​ສາ​ຂອງ​ໂຄງ​ການ​. ຄໍານິຍາມຕົວລະບຸ
ອາດຈະຖືກຫມາຍດ້ວຍມືໂດຍໃຊ້ backticks (`); ໄດ້ -ຕົວກັ່ນຕອງ btdefn ທາງເລືອກຮັບຮູ້ສິ່ງເຫຼົ່ານີ້
ເຄື່ອງໝາຍ. ສໍາລັບບາງພາສາ, ຄໍານິຍາມອາດຈະຖືກພົບເຫັນໂດຍອັດຕະໂນມັດໂດຍໃຊ້ - autodefs
ທາງເລືອກ. ພາກສ່ວນນີ້ອະທິບາຍທາງເລືອກການດັດສະນີ ແລະຂ້າມການອ້າງອີງ; ມັນອາດຈະເປັນ
ຂ້າມໄປອ່ານຄັ້ງທຳອິດ.

-x ສໍາລັບການ LaTeX, ເພີ່ມເລກໜ້າໃສ່ຊື່ແຕ່ລະອັນທີ່ລະບຸທີ່ຢູ່ຂອງສິ່ງນັ້ນ
ຄໍານິຍາມຂອງ chunk, ແລະປ່ອຍຂໍ້ມູນອ້າງອີງຂ້າມທີ່ກ່ຽວຂ້ອງກັບຄໍານິຍາມແລະ
ໃຊ້. ສໍາລັບ HTML, ສ້າງການເຊື່ອມໂຍງ hypertext ລະຫວ່າງການນໍາໃຊ້ແລະການກໍານົດຂອງ chunks.
ເມື່ອ​ໃດ​ ດຽວນີ້ -x ຖືກນໍາໃຊ້ກັບ LaTeX, ລໍາດັບການຄວບຄຸມ \nowebchunks ຂະຫຍາຍເປັນ
ຄັດ​ເລືອກ​ບັນ​ຊີ​ລາຍ​ການ​ຂອງ chunks ລະ​ຫັດ​ທັງ​ຫມົດ​.

-ດັດຊະນີ ສ້າງຂໍ້ມູນອ້າງອີງຂ້າມ (ຫຼືການເຊື່ອມຕໍ່ hypertext) ສໍາລັບຕົວກໍານົດທີ່ກໍານົດ.
ຄໍານິຍາມແມ່ນຜູ້ທີ່ພົບເຫັນຢູ່ໃນໄຟລ໌ປ້ອນຂໍ້ມູນໂດຍ - autodefs ພາສາ ຫຼືໂດຍ
-ຕົວກັ່ນຕອງbtdefn. ຕ້ອງການ LaTeX or html. -ດັດຊະນີ implies -x; ລວມທັງທັງສອງຈະ
ສ້າງຜົນຜະລິດທີ່ແປກປະຫຼາດ. ດຽວນີ້ ບໍ່ສ້າງການອ້າງອີງຂ້າມໄປຫາ
ຕົວລະບຸທີ່ປາກົດຢູ່ໃນລະຫັດອ້າງອີງ (@[[...@]]), ແຕ່ມັນສ້າງ hypertext
ການເຊື່ອມຕໍ່. ເມື່ອ​ໃດ​ ດຽວນີ້ -ດັດຊະນີ ຖືກນໍາໃຊ້ກັບ LaTeX, ລໍາດັບການຄວບຄຸມ \nowebindex
ຂະຫຍາຍໄປສູ່ດັດຊະນີຕົວລະບຸ.

-index ຈາກ ດັດຊະນີ
ຄື - ດັດ​ຊະ​ນີ​, ແຕ່ຕົວລະບຸທີ່ຈະດັດສະນີແມ່ນເອົາມາຈາກໄຟລ໌ ດັດຊະນີ, ທະເລສາບ
noindex(1).

- autodefs lang
ຄົ້ນພົບຄໍານິຍາມຕົວລະບຸອັດຕະໂນມັດ. ລະຫັດໃນ chunks ຈະຕ້ອງເປັນພາສາ
lang. ອະນຸຍາດ langs ແຕກຕ່າງກັນແຕ່ອາດຈະປະກອບມີ tex or icon ໄຮ້ປະໂຫຍດໂດຍບໍ່ມີການ - ດັດ​ຊະ​ນີ​,
ເຊິ່ງມັນຕ້ອງມາກ່ອນ.

-showautodefs
ສະແດງຄ່າຂອງ lang ໃຊ້ໄດ້ກັບ - autodefs.

ERROR MESSAGES

If ຮູບສີ່ຫລ່ຽມ or ດຽວນີ້ ພົບຊື່ chunk ພາຍໃນເອກະສານ, ມັນສົມມຸດວ່ານີ້
ສະແດງຂໍ້ຜິດພາດ, ປົກກະຕິແລ້ວການສະກົດຜິດ ``< >=''. ຂໍ້ຄວາມຜິດພາດອື່ນໆຄວນຈະເປັນ
ການ​ອະ​ທິ​ບາຍ​ດ້ວຍ​ຕົນ​ເອງ​.

ມັນບໍ່ຖືກຕ້ອງທີ່ຈະອ້າງເຖິງ chunks ທີ່ບໍ່ເຄີຍໄດ້ກໍານົດ, ແຕ່ວ່າມັນແມ່ນ OK ສໍາລັບ chunks ທີ່ຈະເປັນ.
ກໍາ​ນົດ​ແລະ​ບໍ່​ໄດ້​ນໍາ​ໃຊ້​.

ຕົວຢ່າງ

ຖ້າທ່ານມີບັນຫາໃນການຍ່ອຍຫນ້າຜູ້ຊາຍນີ້, ທ່ານບໍ່ໄດ້ຢູ່ຄົນດຽວ. ນີ້ແມ່ນບາງຕົວຢ່າງເພື່ອ
ໃຫ້ທ່ານເລີ່ມຕົ້ນ. ຂ້ອຍຈະສົມມຸດວ່າເຈົ້າມີ foo.nw ໄຟລ໌ທີ່ມີໂຄງການ C ເປັນ chunk < >
ແລະໄຟລ໌ header ເປັນ chunk < >, ແລະ​ວ່າ​ເອ​ກະ​ສານ​ຂອງ​ທ່ານ​ແມ່ນ​ຫມາຍ​ເຖິງ​ການ​ນໍາ​ໃຊ້​
latex(1​). ຂ້ອຍຈະສະແດງວິທີການສ້າງສິ່ງຕ່າງໆໂດຍໃຊ້ຕົວເລືອກທົ່ວໄປທີ່ສຸດ.

ເພື່ອສ້າງແຫຼ່ງ C ຂອງທ່ານໃຫມ່, ພະຍາຍາມ
ຮູບສີ່ຫລ່ຽມ -L -Rfoo.c foo.nw > foo.c
ເພື່ອສ້າງໄຟລ໌ສ່ວນຫົວຂອງທ່ານຄືນໃໝ່, ພະຍາຍາມ
ຮູບສີ່ຫລ່ຽມ -Rfoo.h foo.nw | cpif foo.h
ມີການປະນີປະນອມສອງອັນຢູ່ທີ່ນີ້. ການລະເວັ້ນ -L ຮັກສາ #ສາຍ ອອກຈາກໄຟລ໌ຫົວຂອງທ່ານ, ແລະ
ການນໍາໃຊ້ cpif ປ້ອງກັນບໍ່ໃຫ້ຄໍາສັ່ງຈາກການຂຽນຄືນໃຫມ່ foo.h ເວັ້ນເສຍແຕ່ວ່າເນື້ອໃນມີການປ່ຽນແປງ.
ດັ່ງນັ້ນ, ນີ້ແມ່ນລະຫັດທີ່ດີທີ່ຈະໃສ່ໃນກົດລະບຽບ Makefile.

ເພື່ອສ້າງເອກະສານທີ່ພິມອອກ, ດໍາເນີນການ
ດຽວນີ້ - autodefs c -ດັດຊະນີ foo.nw > foo.tex
ຖ້າ​ຫາກ​ວ່າ​ທ່ານ​ມີ preamble ຂອງ​ທ່ານ​ເອງ​, ປະ​ກອບ​ດ້ວຍ​ \documentclass ແລະທັງຫມົດ, ທ່ານຍັງຈະຕ້ອງໄດ້
- ຊັກ​ຊ້າ​ ທາງເລືອກ.

ເພື່ອສ້າງຫນ້າເວັບ, ດໍາເນີນການ
ດຽວນີ້ -ຕົວກັ່ນຕອງ l2h - autodefs c -ດັດຊະນີ -html foo.nw | htmltoc > foo.html
ມີຄວາມມ່ວນ!

ໃຊ້ notangle ອອນໄລນ໌ໂດຍໃຊ້ບໍລິການ onworks.net