hxtoc - Online nel cloud

PROGRAMMA:

NOME

hxtoc - inserisce un sommario in un file HTML

SINOSSI

hxtoc [ -x ] [ -l Basso ] [ -h alto ] [ filetto ] [ -t ] [ -d ] [ -c classe ]

DESCRIZIONE

I hxtoc il comando legge un file HTML, inserisce gli attributi ID mancanti in tutti gli H1 e H6
elementi tra i livelli -l ed -h (a meno che l'opzione -d è in vigore, vedi sotto) e
inserisce anche elementi A con attributi NAME, quindi i vecchi browser riconosceranno da H1 a H6
anche le intestazioni come ancoraggi di destinazione (a meno che l'opzione -t è in vigore). L'uscita è
scritto su stdout.

Se c'è un commento del modulo



o un paio di commenti


...


quindi il commento, o la coppia con tutto il resto, sarà sostituito da una tabella di
contenuto, costituito da un elenco (UL) di collegamenti a tutte le intestazioni del documento.

Il testo delle intestazioni viene copiato in questo sommario, incluso qualsiasi markup in linea,
tranne che i tag DFN e i tag SPAN con una CLASS di "indice" sono omessi (ma gli elementi
contenuto viene copiato).

Se un'intestazione ha un attributo CLASS con come valore (o uno dei suoi valori) la parola chiave "no-
toc", allora quell'intestazione non apparirà nel sommario.

VERSIONI

Sono supportate le seguenti opzioni:

-x Usa le convenzioni XML: gli elementi vuoti sono scritti con una barra alla fine:

-l Basso Imposta l'intestazione con il numero più basso da visualizzare nell'indice. Il valore predefinito è 1
(cioè H1).

-h alto Imposta l'intestazione con il numero più alto da visualizzare nell'indice. Il valore predefinito è 6
(cioè H6).

-t Normalmente, hxtoc aggiunge sia gli attributi ID che gli elementi A vuoti con un NOME
attributo e CLASS="bctarget", in modo che i browser più vecchi che non capiscono l'ID
troverà ancora il bersaglio. Con questa opzione, gli elementi A non saranno
generato.

-c classe Gli elementi UL generati nell'indice avranno un attributo CLASS
con il valore classe. L'impostazione predefinita è "toc".

-d Tenta di utilizzare gli elementi di sezionamento come obiettivi nel sommario invece di
da H1 a H6. Un elemento di sezionamento è un elemento DIV, SECTION, ARTICLE, ASIDE o NAV
il cui primo figlio è un elemento di intestazione (da H1 a H6) o un HGROUP. Il sezionamento
all'elemento verrà assegnato un ID se non ne ha ancora uno. Con questa opzione, il
livello di qualsiasi H1 a H6 che è il primo figlio di un elemento di sezionamento (o di un
HGROUP che è esso stesso il primo figlio di un elemento di sezionamento) non è determinato
dal nome, ma dalla profondità di annidamento degli elementi di sezionamento. (Qualsiasi H1 a H6
che non sono il primo figlio di un elemento di sezionamento hanno ancora il loro livello
implicito nel loro nome.)

OPERANDI

È supportato il seguente operando:

filetto Il nome di un file HTML. Se assente viene invece letto lo standard input.

DIAGNOSTICA

Vengono restituiti i seguenti valori di uscita:

0 Completato con successo.

> 0 Si è verificato un errore durante l'analisi del file HTML. hxtoc proverò a correggere
l'errore e produrre comunque un output.

Usa hxtoc online utilizzando i servizi onworks.net