ctanify - Online di Cloud

PROGRAM:

NAMA

ctanify - Siapkan paket untuk diunggah ke CTAN

RINGKASAN

memperkuat [--nama pkg=tali] [--[tidak]mobil] [--hanya saja=spesifikasi file ...] [--[tidak]menyatukan]
[--[tidak]melewatkan] [--tdsdir=nama dirname ...] [--teks=makro_pkg] [--[tidak]mengacaukan] spesifikasi file[=nama dirname]
...

memperkuat [--membantu]

memperkuat [--Versi: kapan]

DESKRIPSI

ubah ditujukan untuk pengembang yang memiliki paket LaTeX yang ingin mereka distribusikan
melalui Jaringan Arsip TeX Komprehensif (CTAN). Diberikan daftar nama file, ubah
menciptakan tarbal (a .tar.gz file) dengan file yang ditata dalam struktur pilihan CTAN.
Tarball juga berisi ZIP (Zip.) file dengan salinan semua file yang diletakkan di
Struktur Direktori TeX (TDS) standar, yang memfasilitasi penyertaan paket dalam
distribusi TeX Live.

PILIHAN

ubah menerima opsi baris perintah berikut:

-h, --membantu
Keluarkan informasi penggunaan dasar dan keluar.

-V, --Versi: kapan
Keluaran ubahnomor versi dan keluar.

-p tali, --nama pkg=tali
Tentukan secara eksplisit nama paket. Biasanya, ubah menggunakan nama dasar yang pertama
.in or .tembel file yang terdaftar sebagai nama paket. Nama paket membentuk nama dasar
dari tarbal itu ubah menghasilkan.

--tidak otomatis
Jangan otomatis menambahkan file ke tarball. Biasanya, ubah secara otomatis
mencakup semua file yang disebutkan dalam a .in file.

-t spesifikasi file, --hanya saja=spesifikasi file
Tentukan subset dari file yang dinamai pada baris perintah untuk disertakan hanya di TDS
ZIP, bukan di direktori paket CTAN. Wildcard diperbolehkan (dikutip jika
diperlukan), dan --hanya saja dapat digunakan beberapa kali pada baris perintah yang sama.

Setidaknya satu nama file harus ditentukan pada baris perintah. ubah secara otomatis menempatkan
file di pohon TDS berdasarkan ekstensinya, tetapi ini dapat diganti dengan menentukan
secara eksplisit direktori TDS target menggunakan formulir spesifikasi file=nama dirname. Wildcard diperbolehkan
untuk spesifikasi file (dikutip jika perlu).

TAMBAHAN PILIHAN

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

-d nama dirname, --tdsdir=nama dirname
Alih-alih membuat tarball untuk CTAN, cukup buat paket pohon TDS yang di-root
direktori nama dirname.

-T makro_pkg, --teks=makro_pkg
Menyatakan bahwa file yang sedang dikemas untuk CTAN menargetkan paket makro TeX selain
Getah. Beberapa contoh umum dari makro_pkg adalah "generik", "polos", dan "konteks".

-tidak, --tidak-unixify
Simpan file teks yang tidak dimodifikasi alih-alih mengonversi karakter akhir barisnya ke Unix
format (karakter linefeed tunggal tanpa karakter carriage-return), meskipun
CTAN lebih suka menerima semua file dengan karakter akhir baris format Unix.

-tidak, --jangan lewati
kekuatan ubah untuk menyertakan file seperti file tersembunyi Unix, file cadangan Emacs, dan
file metadata kontrol versi, yang semuanya tidak disukai CTAN.

-m, --salah paham
Ganti nama direktori yang berisi satu file menjadi "misc". (Misalnya, ganti nama
"tex/latex/mypackage/mypackage.sty" menjadi "tex/latex/misc/mypackage.sty".) Ini tadinya
praktek umum di masa lalu tetapi sekarang sangat tidak dianjurkan.

DIAGNOSTIK

"Gagal menyalin nama file (Tidak seperti itu fillet or direktori)"
Pesan ini biasanya disebabkan oleh .in file yang menghasilkan nama file tapi itu punya
belum dijalankan tex or getah untuk benar-benar menghasilkan nama file. ubah tidak
tidak otomatis berjalan tex or getah; ini perlu dilakukan secara manual oleh pengguna. Lihat
"PERINGATAN" untuk informasi lebih lanjut.

"Diubah nama file untuk menggunakan Unix line akhir (menggunakan --tidak-unixify untuk mencegah ini)"
Untuk konsistensi, CTAN menyimpan semua file teks dengan akhiran baris gaya Unix (satu
karakter linefeed tanpa karakter carriage-return). Untuk membantu upaya ini,
ubah secara otomatis menggantikan akhiran baris gaya non-Unix. Yang sebelumnya hanya
pesan memberi tahu pengguna bahwa dia tidak perlu khawatir melihat ukuran yang berbeda untuk
nama file di tarball versus aslinya nama file pada disk (yang ubah tak pernah
memodifikasi). Jika ada alasan bagus untuk mempertahankan akhiran baris asli (dan di sana
jarang ada), --tidak-unixify pilihan dapat digunakan untuk mencegah ubah dari mengubah apapun
file saat menyimpannya di tarball.

"Tidak termasuk nama file (menggunakan --jangan lewati untuk kekuatan penyertaan)"
ubah biasanya mengabaikan file--bahkan ketika ditentukan secara eksplisit pada perintah
line--yang CTAN memilih untuk tidak menerima. Ini termasuk file yang namanya dimulai dengan
"." (file tersembunyi Unix), diakhiri dengan "~" (Pencadangan otomatis Emacs), atau yang berasal dari a
CVS or .svn direktori (file metadata kontrol versi). Jika ada alasan bagus untuk
kirimkan file tersebut ke CTAN (dan jarang ada), the --jangan lewati pilihan dapat digunakan untuk
mencegah ubah dari mengabaikan mereka.

"CTAN lebih suka hanya memiliki dokumentasi PDF (re: nama file)"
Karena popularitas format PDF, CTAN ingin memiliki banyak dokumentasi
mungkin didistribusikan dalam PDF. Pesan sebelumnya meminta pengguna untuk mengganti apapun
Dokumentasi PostScript atau DVI dengan PDF jika memungkinkan. (ubah akan tetap menyertakan
Dokumentasi PostScript dan DVI di tarball; pesan sebelumnya hanyalah
permintaan sopan.)

"Tidak termasuk nama file in itu TDS pohon (tidak diketahui perpanjangan)"
ubah menempatkan file di pohon TDS berdasarkan tabel ekstensi file. Untuk
contoh, semua .tembel file ditempatkan di tex/lateks/nama-paket. Jika ubah tidak
tahu di mana harus meletakkan file itu tidak meletakkannya di mana saja. Lihat paragraf terakhir dari
"OPTIONS" untuk penjelasan tentang cara menentukan lokasi target file secara eksplisit di
pohon TDS. Untuk ekstensi file umum yang kebetulan tidak ada ubah's
meja, pertimbangkan juga untuk memberi tahu ubah's penulis di alamat yang ditunjukkan di bawah ini di bawah
"PENGARANG".

CONTOH

Grafik Umum Kasus
Biasanya, yang diperlukan hanyalah memberi tahu ubah nama dari .in berkas (atau .tembel jika
paket tidak menggunakan DocStrip) dan dokumentasi bawaan, jika ada:

$ ctanify mypackage.ins mypackage.pdf README

490347 paketku.tar.gz

1771 paket saya/README
15453 paket saya/paket saya.dtx
1957 paketku/paketku.ins
277683 paket saya/paket saya.pdf
246935 paketku.tds.zip

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

ubah menampilkan ukuran dalam byte dari tarball yang dihasilkan, setiap file di dalamnya, dan masing-masing
file dalam file ZIP yang terkandung. Dalam contoh sebelumnya, perhatikan bagaimana ubah
otomatis melakukan semua operasi berikut:

· termasuk paket saya.dtx (ditemukan dengan menguraikan mypackage.in) di kedua paket saya
direktori dan file ZIP,

· termasuk paket saya.sty (ditemukan dengan menguraikan mypackage.in) dalam file ZIP tetapi, karena
ini adalah file yang dihasilkan, bukan di paket saya direktori, dan

· menempatkan semua file ke dalam direktori TDS yang sesuai (dokumentasi, sumber, main
paket) dalam file ZIP.

Pertimbangkan apa yang diperlukan untuk menghasilkan yang setara secara manual paket saya.tar.gz file.
ubah jelas merupakan alternatif yang lebih sederhana dan lebih cepat.

Advanced penggunaan
ubah mengasumsikan bahwa file PostScript adalah dokumentasi dan oleh karena itu menyimpannya di bawah
doc/lateks/nama-paket/ di pohon TDS dalam File ZIP. Misalkan, bagaimanapun, bahwa
Paket LaTeX menggunakan satu set file PostScript untuk mengontrol dvipkeluaran. Pada kasus ini,
ubah harus diberitahu untuk menyertakan file PostScript tersebut di direktori paket, bukan di
direktori dokumentasi.

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

Gunakan ctanify online menggunakan layanan onworks.net