hxindex - Online în cloud

PROGRAM:

NUME

hxindex - inserați un index într-un document HTML

REZUMAT

hxindex [ -t ] [ -x ] [ -n ] [ -f ] [ -r ] [ -c clase ] [ -b de bază ] [ -i indexdb ] [ -s
șablon ] [ -u frază ] [--] [ fișier-sau-URL ]

DESCRIERE

hxindex caută termeni care să fie indexați într-un document, îi colectează, îi transformă în
țintă ancorează și creează un index sortat ca o listă HTML, care este inserată la locul respectiv
a unui substituent din document. Documentul rezultat este scris la ieșirea standard.

Indexul este introdus la locul unui comentariu al formularului



sau între două comentarii ale formularului


...


În acest din urmă caz, tot conținutul existent între cele două comentarii este eliminat mai întâi.

Termenii de index sunt fie elemente de tip sau elemente cu un atribut de clasă de
"index". (Pentru compatibilitate inversă, de asemenea, atribute de clasă "index-inst" și "index-def"
sunt recunoscute.) elemente (și clasa "index-def") sunt considerate mai importante decât
elemente cu clasă "index" și va apărea cu caractere aldine în indexul generat.

Optiunea -c adaugă clase suplimentare, care sunt aliasuri pentru "index".

În mod implicit, conținutul elementului este luat ca termen de index. Iată două
exemple de apariții ale termenului index „pantof”:

Un pantof este o piesă de îmbrăcăminte care...
completat de un pantof de piele...

Dacă termenul de indexat nu este egal cu conținutul elementului, titlu atribut
poate fi folosit pentru a da termenul corect:

... Pantofii sunt piese de îmbrăcăminte care...
... cu doi pantofi de piele ...

titlu atribut trebuie folosit și atunci când termenul index este un subtermen al altuia.
Subtermenii apar indentați în index, sub termenul lor principal. Pentru a defini un subtermen, utilizați a
titlu atribut cu două semne de exclamare ("!!") între termen și subtermen, ca
acest:

...
...
...

După cum arată ultimul exemplu de mai sus, pot exista mai multe niveluri de sub-subtermeni.

titlu Atributul permite, de asemenea, să fie asociate mai multor termeni de index cu un singur
apariția. Termenii multipli sunt separați cu o bară verticală ("|"). Comparați
următoarele exemple cu cele de mai sus:

...
...

Aceste două elemente introduc ambele doi termeni în index. Rețineți că al doilea exemplu
de mai sus combină subtermeni și termeni multipli.

Este posibil să rulați index pe un fișier care are deja un index. Vechea țintă ancore
iar vechiul index va fi eliminat înainte de a fi regenerat.

OPŢIUNI

Sunt acceptate următoarele opțiuni:

-t În mod implicit, hxindex adaugă un atribut ID la elementul care conține
apariţia unui termen şi de asemenea introduce an element în interiorul acestuia cu a nume
atribut egal cu ID-ul. Acest lucru este pentru a permite browserelor vechi care ignoră ID-ul
atribute, cum ar fi Netscape 4, pentru a găsi și ținta. The -t opțiune
suprimă element.

-x Această opțiune activează convențiile de sintaxă XML: elementele goale se vor termina în />
în loc de > ca în HTML. -x implică t.

-i indexdb
hxindex poate citi un index inițial dintr-un fișier și poate scrie colecția îmbinată de
termenii de index înapoi la acel fișier. Acest lucru permite unui index să acopere mai multe documente.
-i opțiunea este folosită pentru a da numele fișierului care conține indexul.

-b de bază Această opțiune este utilă în combinație cu -i pentru a da referința URL de bază a
documentul. În mod implicit, hxindex va stoca link-uri către apariții în indexdb
dosar în formular #ancoră, dar cand -b este dat, linkurile vor arăta ca
baza#ancora in schimb.

Când este utilizat în combinație cu -n, vor conține atributele de titlu ale linkurilor
titlul documentului care conține termenul. Titlul este introdus înainte
il șablon (vezi opțiunea -s) și separat de acesta cu o virgulă și un spațiu.
De exemplu, dacă hxindex este numit cu

hxindex -i termdb -n -base fișierul meu.html fișierul meu.html

iar termenul db conține deja o intrare pentru „foo” în secțiunea „3.1” din a
document numit „file2.html” cu titlul „The foos”, apoi indexul generat
va conține o intrare ca aceasta:

prost,
title="The Foos, secțiunea 3.1">3.1

-c clasa[,clasa[,...]]
Termenii normali de index sunt recunoscuți deoarece au o clasă de "index". -c
opțiunea adaugă nume de clasă suplimentare, separate prin virgulă, care vor fi luate în considerare
aliasuri pentru "index". De exemplu, -c instanță se va asigura că
class="instance">termen este recunoscut ca termen pentru index.

-n În mod implicit, indexul constă din linkuri cu „#” ca text de ancorare. Opțiune -n
face ca textul linkului să fie format din numerele de secțiuni ale secțiunilor în care
termenii apar, revenind la „fără număr” (vezi opțiunea -u mai jos) dacă nu
numărul secțiunii poate fi găsit. Numerele secțiunilor sunt găsite căutând
cea mai apropiată etichetă de început anterioară cu o clasă de „secno” sau „no-num”. În cazul în care
„secno”, conținutul acelui element este luat ca număr de secțiune. În
cazul „no-num” se presupune că secțiunea nu are număr și hxindex va imprima
„fără număr” în schimb. Aceste clase sunt folosite și de hxnum(1), așa este
util pentru a alerga hxindex după hxnum, de exemplu,

hxnum fișierul meu.html | hxindex -n >mynewfile.html

-s șablon
Când opțiunea -n este utilizat, linkul va avea un atribut title și șablon
determină ce conține. Valoarea implicită este „secțiunea %s”, unde %s este a
substituent pentru numărul secțiunii. Cu alte cuvinte, indexul va conține
intrări ca aceasta:

termen, 7.8

Cateva exemple:

hxindex -n -s „capitolul %s”
hxindex -n -s „partea %s”
hxindex -n -s 'hoofdstuk %s' -u 'număr zona'

Această opțiune este utilă numai în combinație cu -n

-u frază Când opțiunea -n este utilizat pentru afișarea numerelor de secțiuni, referințe pentru care nr
numărul secțiunii poate fi găsit sunt afișate ca frază in schimb. Valoarea implicită este „??”.

Această opțiune este utilă numai în combinație cu -n

-f Elimină titlu atributele care au fost folosite pentru index, precum și pentru comentarii
care delimitează indexul inserat. Acest lucru evită ca browserele să le afișeze
atribute. Rețineți că hxindex nu poate fi rulat din nou pe propria ieșire dacă acest lucru
este folosită opțiunea. (Mnemonic: "freeze" sau "final".)

-r Nu ignorați semnele de punctuație de la urmă când sortați termenii de index. De exemplu, dacă doi termeni
sunt scrise ca

foo, ... foo

hxindex în mod normal, va ignora virgula și le va trata ca același termen, dar cu
-r, sunt tratați ca fiind diferiți. Acest lucru afectează virgulele finale (,), punctele și virgulă
(;), două puncte (:), semn de exclamare (!), semn de întrebare (?) și puncte (.).
Un punct final nu este niciodată ignorat dacă există două sau mai multe în termen, to
protejați abrevierile ("BC") și punctele de suspensie ("mai mult..."). Asta face nu afecta
cum este tipărit termenul index (este întotdeauna tipărit așa cum apare în text),
doar cum este comparat cu termeni similari. (Mnemonic: "raw".)

OPERANDE

Următorul operand este suportat:

fișier-sau-URL
Numele unui fișier HTML sau XML sau adresa URL a unuia. Dacă lipsește, sau dacă dosarul este
„-”, intrarea standard este citită în schimb.

EXIT STAREA

Sunt returnate următoarele valori de ieșire:

0 Finalizarea cu succes.

>0 A apărut o eroare la analizarea fișierului HTML.

MEDIUL

Se presupune că intrarea este în UTF-8, dar localitatea curentă este utilizată pentru a determina
ordinea de sortare a termenilor de index. adica hxindex se uită la LANG, LC_ALL și/sau
LC_COLLATE variabile de mediu. Vedea localizare(1).

Pentru a utiliza un proxy pentru a prelua fișiere de la distanță, setați variabilele de mediu Http proxy or
ftp_proxy. De exemplu, http_proxy="http://localhost:8080/"

Utilizați hxindex online folosind serviciile onworks.net