ctanify - Dalam talian di Awan

JADUAL:

NAMA

ctanify - Sediakan pakej untuk muat naik ke CTAN

SINOPSIS

ctanify [--pkgname=rentetan] [--[tidak]auto] [--tdsonly=filespec ...] [--[tidak]unixify]
[--[tidak]skip] [--tdsdir=nama panggilan ...] [--tex=makro_pkg] [--[tidak]salah faham] filespec[=nama panggilan]
...

ctanify [- membantu]

ctanify [--versi]

DESCRIPTION

ctanify ditujukan untuk pembangun yang mempunyai pakej LaTeX yang ingin mereka edarkan
melalui Rangkaian Arkib TeX Komprehensif (CTAN). Diberi senarai nama fail, ctanify
mencipta bola tar (a .tar.gz fail) dengan fail yang dibentangkan dalam struktur pilihan CTAN.
Tarball juga mengandungi ZIP (. Zip) fail dengan salinan semua fail yang diletakkan di dalamnya
Struktur Direktori TeX standard (TDS), yang memudahkan kemasukan pakej ke dalam
pengedaran TeX Live.

PILIHAN

ctanify menerima pilihan baris arahan berikut:

-h, - membantu
Keluarkan maklumat penggunaan asas dan keluar.

-V, --versi
Output ctanifynombor versi dan keluar.

-p rentetan, --pkgname=rentetan
Nyatakan secara eksplisit nama pakej. Biasanya, ctanify menggunakan nama asas yang pertama
.in or .sty fail disenaraikan sebagai nama pakej. Nama pakej membentuk nama asas
daripada tarball itu ctanify menghasilkan.

--noauto
Jangan tambah fail secara automatik pada tarball. Biasanya, ctanify secara automatik
termasuk semua fail yang disebut dalam a .in fail.

-t filespec, --tdsonly=filespec
Tentukan subset fail yang dinamakan pada baris arahan untuk dimasukkan hanya dalam TDS
Fail ZIP, bukan dalam direktori pakej CTAN. Kad bebas dibenarkan (dipetik jika
perlu), dan --tdsonly boleh digunakan beberapa kali pada baris arahan yang sama.

Sekurang-kurangnya satu nama fail mesti dinyatakan pada baris arahan. ctanify tempat secara automatik
fail dalam pepohon TDS berdasarkan sambungannya, tetapi ini boleh ditindih dengan menentukan
secara eksplisit direktori TDS sasaran menggunakan borang filespec=nama panggilan. Kad bebas dibenarkan
untuk filespec (dipetik jika perlu).

TAMBAHAN PILIHAN

Pilihan berikut tidak mungkin diperlukan dalam penggunaan biasa. Mereka disediakan
untuk keadaan khusus yang mungkin timbul.

-d nama panggilan, --tdsdir=nama panggilan
Daripada mencipta tarball untuk CTAN, cuma buat pakej TDS yang berakar umbi
direktori nama panggilan.

-T makro_pkg, --tex=makro_pkg
Tegaskan bahawa fail yang dibungkus untuk CTAN menyasarkan pakej makro TeX selain daripada
LaTeX. Beberapa contoh biasa makro_pkg adalah "generik", "biasa", dan "konteks".

-nou, --tidak-unixify
Simpan fail teks tanpa diubah suai dan bukannya menukar aksara akhir barisnya kepada Unix
format (karakter suapan baris tunggal tanpa aksara carriage-return), walaupun
CTAN lebih suka menerima semua fail dengan aksara hujung baris format Unix.

-nok, --tidak-langkau
Memaksa ctanify untuk memasukkan fail seperti fail tersembunyi Unix, fail sandaran Emacs dan
fail metadata kawalan versi, yang kesemuanya CTAN tidak suka menerima.

-m, --miscify
Namakan semula direktori yang mengandungi satu fail kepada "misc". (Sebagai contoh, namakan semula
"tex/latex/mypackage/mypackage.sty" kepada "tex/latex/misc/mypackage.sty".) Ini ialah
amalan biasa pada masa lalu tetapi kini sangat tidak digalakkan.

DIAGNOSTIK

"Gagal menyalin nama fail (No seperti fail or direktori)"
Mesej ini biasanya disebabkan oleh a .in fail yang menjana nama fail tetapi itu telah
belum dilalui tex or getah untuk benar-benar menghasilkan nama fail. ctanify tidak
tidak berjalan secara automatik tex or getah; ini perlu dilakukan secara manual oleh pengguna. Lihat
"CAVEATS" untuk maklumat lanjut.

"Diubah suai nama fail kepada penggunaan Unix selaras pengakhiran (gunakan --tidak-unixify kepada mencegah ini)"
Untuk ketekalan, CTAN menyimpan semua fail teks dengan pengakhiran baris gaya Unix (single
watak linefeed tanpa watak carriage-return). Untuk membantu dalam usaha ini,
ctanify secara automatik menggantikan pengakhiran baris bukan gaya Unix. Yang terdahulu semata-mata
mesej memberitahu pengguna bahawa dia tidak seharusnya bimbang untuk melihat saiz yang berbeza untuk
nama fail dalam tarball berbanding yang asal nama fail pada cakera (yang ctanify pernah
mengubah suai). Jika ada sebab yang baik untuk mengekalkan penghujung baris asal (dan di sana
jarang), yang --tidak-unixify pilihan boleh digunakan untuk mencegah ctanify daripada mengubah mana-mana
fail apabila menyimpannya dalam tarball.

“Tidak termasuk nama fail (gunakan --tidak-langkau kepada kekuatan kemasukan)"
ctanify biasanya mengabaikan fail--walaupun dinyatakan secara eksplisit pada arahan
baris--bahawa CTAN lebih suka tidak menerima. Ini termasuk fail yang namanya bermula dengan
"." (Fail tersembunyi Unix), berakhir dengan "~" (Sandaran automatik Emacs), atau yang datang daripada a
CVS or .svn direktori (fail metadata kawalan versi). Jika ada alasan yang baik untuk
serahkan fail tersebut kepada CTAN (dan jarang ada), the --tidak-langkau pilihan boleh digunakan untuk
mencegah ctanify daripada mengabaikan mereka.

"CTAN lebih suka mempunyai hanya dokumentasi PDF (semula: nama fail)"
Kerana populariti format PDF, CTAN mahu mempunyai banyak dokumentasi
yang mungkin diedarkan dalam PDF. Mesej sebelumnya meminta pengguna untuk menggantikan mana-mana
Dokumentasi PostScript atau DVI dengan PDF jika boleh. (ctanify masih akan termasuk
Dokumentasi PostScript dan DVI dalam tarball; mesej sebelum ini hanyalah a
permintaan sopan.)

"Tidak termasuk nama fail in yang TDS pokok (tidak diketahui sambungan)"
ctanify meletakkan fail dalam pepohon TDS berdasarkan jadual sambungan fail. Untuk
contoh, semua .sty fail diletakkan di tex/latex/package-name. Jika ctanify tidak
tahu di mana untuk meletakkan fail ia tidak meletakkannya di mana-mana. Lihat perenggan terakhir
"PILIHAN" untuk penjelasan tentang cara menentukan lokasi sasaran fail secara eksplisit
pokok TDS. Untuk sambungan fail biasa yang kebetulan tiada ctanify's
jadual, pertimbangkan juga untuk memberitahu ctanifypengarang di alamat yang ditunjukkan di bawah di bawah
"PENULIS".

CONTOH

. Common kes
Biasanya, apa yang diperlukan hanyalah memberitahu ctanify nama .in fail (atau .sty jika
pakej tidak menggunakan DocStrip) dan dokumentasi terbina, jika ada:

$ ctanify mypackage.in mypackage.pdf README

490347 mypackage.tar.gz

1771 mypackage/README
15453 mypackage/mypackage.dtx
1957 mypackage/mypackage.ins
277683 mypackage/mypackage.pdf
246935 mypackage.tds.zip

1771 doc/latex/mypackage/README
277683 doc/latex/mypackage/mypackage.pdf
15453 source/latex/mypackage/mypackage.dtx
1957 sumber/latex/mypackage/mypackage.ins
1725 tex/latex/mypackage/mypackage.sty

ctanify mengeluarkan saiz dalam bait tarball yang terhasil, setiap fail di dalamnya, dan setiap satu
fail dalam fail ZIP yang terkandung. Dalam contoh sebelumnya, perhatikan bagaimana ctanify
secara automatik melakukan semua operasi berikut:

· termasuk mypackage.dtx (ditemui dengan menghuraikan mypackage.ins) dalam kedua-dua pakej saya
direktori dan fail ZIP,

· termasuk mypackage.sty (ditemui dengan menghuraikan mypackage.ins) dalam fail ZIP tetapi, kerana
ia adalah fail yang dijana, bukan dalam pakej saya direktori, dan

· meletakkan semua fail ke dalam direktori TDS yang sesuai (dokumentasi, sumber, utama
pakej) dalam fail ZIP.

Pertimbangkan apa yang diperlukan untuk menghasilkan yang setara secara manual mypackage.tar.gz fail.
ctanify pastinya merupakan alternatif yang lebih mudah dan cepat.

Maju Penggunaan
ctanify menganggap bahawa fail PostScript adalah dokumentasi dan oleh itu menyimpannya di bawah
doc/latex/package-name/ dalam pepohon TDS dalam Fail ZIP. Katakan, bagaimanapun, bahawa a
Pakej LaTeX menggunakan set fail PostScript untuk dikawal dvipskeluaran. Dalam kes ini,
ctanify mesti diberitahu untuk memasukkan fail PostScript tersebut dalam direktori pakej, bukan fail
direktori dokumentasi.

$ ctanify mypackage.ins "mypackage*.ps=tex/latex/mypackage"

Gunakan ctanify dalam talian menggunakan perkhidmatan onworks.net