xnav - Dalam talian dalam Awan

JADUAL:

NAMA

xnav - Bina navigasi atas dan bar sisi untuk koleksi halaman web

SINOPSIS

xnav [ -V ] [ -h ] [ -v ] [ -c (semua | (tajuk | asas | skrip | gaya | meta | pautan |
objek)[,(tajuk | asas | skrip | gaya | meta | pautan | objek)][,...])] [ -b (rmv | div)
] [ -i ] [ INIT | membuat | sah | membersihkan ] jalan

DESCRIPTION

XNav menambah pembungkus dengan gaya CSS dan bar navigasi atas dan sisi pada pepohon direktori
dokumen XHTML. Ia juga menyediakan mekanisme untuk pembinaan automatik XHTML
dokumen daripada jenis dokumen XML yang ditentukan pengguna, menggunakan XSL yang dibekalkan pengguna.

PILIHAN

INIT jalan
Mulakan direktori jalan sebagai tapak web XNav.

membuat jalan
Bina laman web XNav dalam direktori jalan.

sah jalan
Sahkan XML dan XHTML dalam direktori jalan.

membersihkan jalan
Bersihkan fail yang dijana secara automatik dalam direktori jalan.

-V Versi paparan.

-h Paparkan maklumat penggunaan.

-v Operasi verbose.

-c Tentukan kanak-kanak html/kepala untuk dimasukkan ke dalam dokumen output. Nilai yang dibenarkan ialah
'semua' (lalai), 'tiada', atau senarai nama elemen 'tajuk' dipisahkan koma,
'asas', 'skrip', 'gaya', 'meta', 'pautan' dan 'objek'.

-b Pilih pengendalian spesifikasi badan dalam CSS dalam elemen html/head/style.
Nilai yang sah ialah 'rmv', meminta pengalihan keluar sebarang definisi badan dan 'div',
meminta penggantian oleh elemen div peringkat atas dengan gaya yang sama.

-i Tambahkan 'index.html' pada laluan direktori navigasi atas dan sisi. Terutamanya berguna untuk
membina satu set halaman yang mungkin dilayari sebagai fail yang diakses terus oleh web
pelayar, bukannya melalui pelayan web.

PENGGUNAAN

Mulakan dengan menyediakan struktur direktori yang dikehendaki bagi koleksi halaman web. Semua
Dokumen HTML hendaklah sah XHTML 1.0 Strict, dan sepatutnya mempunyai sambungan .xml
daripada .html biasa. Setiap direktori harus mempunyai, sekurang-kurangnya, dokumen indeks yang dipanggil
indeks.xml, dan fail konfigurasi dipanggil xnav.xml.

Format fail konfigurasi ditakrifkan dalam fail xnav.dtd. Elemen peringkat atas ialah
xnav, dengan elemen anak pilihan direktori and fail. Label untuk direktori tertentu
biasanya disediakan oleh label dalam elemen direktori rujukan dalam induk
direktori, tetapi boleh ditentukan dengan menggunakan label atribut dalam direktori peringkat atas.
Jika indeks.xml fail bukan HTML, the jenis atribut hendaklah ditetapkan kepada nama
format dokumen, dan templat XSL harus disediakan untuk mengendalikan jenis tersebut.

A direktori elemen mewakili pautan navigasi ke subdirektori, direktori sebenar
nama yang dinyatakan oleh href atribut, dan label direktori yang digunakan dalam navigasi
bar ditentukan sebagai kandungan elemen. Jika elemen direktori menunjuk ke direktori
tidak diuruskan oleh XNav (iaitu di mana skrip binaan tidak sepatutnya berulang), the masukkan
nilai atribut hendaklah 'tidak'. Jika direktori diuruskan oleh XNav, tetapi untuk sesetengah orang
sebab yang diingini untuk dikecualikan daripada bar navigasi sisi, yang sidenav nilai atribut
sepatutnya 'tidak'.

A fail elemen mewakili pautan ke fail dalam direktori yang sama dengan fail xnav.xml,
dan mempunyai penggunaan yang serupa dengan elemen direktori. Jika fail itu bukan HTML, fail jenis
atribut hendaklah ditetapkan kepada nama format dokumen dan templat XSL sepatutnya
disediakan untuk mengendalikan jenis itu. Jika fail dikehendaki untuk dikecualikan dari sisi
bar navigasi, the sidenav nilai atribut hendaklah 'tidak'.

Mulakan struktur direktori di jalan menggunakan arahan

xnav INIT jalan

mencipta direktori XNAV in jalan, mengandungi fail konfigurasi yang boleh diedit oleh
pengguna. Fail-fail itu head.xml and foot.xml tentukan pengepala dan pengaki HTML ditambahkan pada setiap
halaman yang dihasilkan oleh XNav. The katalog.xml fail membenarkan utiliti pemprosesan XML yang digunakan oleh
XNav untuk mencari DTD untuk xnav.xml fail konfigurasi. Jika pengguna menambah tambahan
jenis dokumen untuk diproses oleh XNav, rujukan kepada DTD yang berkaitan harus ditambah
fail katalog. Akhirnya, yang xnavinc.xsl fail termasuk helaian gaya XSL utama xnav.xsl
bertanggungjawab untuk sebahagian besar pemprosesan XNav.

XNav boleh diperluaskan untuk memproses jenis dokumen XML sewenang-wenangnya dengan memasukkan XSL tambahan
lembaran gaya dalam xnavinc.xsl fail. Jika jenis dokumen bukan HTML dirujuk sebagai
jenis baru dalam jenis atribut, pengguna harus menentukan templat XSL dengan nama jenis baru
dan mod dynamic-template-select. Dalam templat ini, kandungan dokumen yang akan
diproses boleh didapati di XPath src /jenis baru.

Setelah permulaan selesai, dan apabila dokumen XML sumber diedit, outputnya
Fail HTML boleh dijana menggunakan arahan

xnav membuat jalan

Perintah itu

xnav sah jalan

mengesahkan fail XML sumber yang mengandungi a DOCTYPE spesifikasi. Fail yang tidak
mengandungi spesifikasi sedemikian diperiksa untuk menentukan sama ada ia terbentuk dengan baik.

Gunakan xnav dalam talian menggunakan perkhidmatan onworks.net