Užitečné skripty 3: automaticky generovaný obsah v HTML

11.3.2007 21:49 | Přečteno: 2573× | Linux

Dnešní téma nebude úplně linuxové, i když zkušený demagog by jistě zdůvodnil, že do linuxu patří. Podíváme se, jak udělat v HTML souboru obsah (table of content, abych předešel nedorozumnění), který se generuje úplně sám. Samozřejmě s pomocí Javascriptu.

Abstrakt

Určitě jste už někdy potřebovali napsat kratší návod nebo krátký technický dokument. Technická dokumentace by měla mít na začátku obsah (TOC). Musíme tedy najít takový formát, který umí obsah (TOC) vygenerovat sám, protože udržovat dokument i s obsahem (TOC) je mírně řečeno nešikovné.

Popíšeme si tedy kousek Javascriptu, který umí vygenerovat a zobrazit klikací obsah v HTML. Někdy je totiž použití TeXu nevhodné (čtenář neocení krásné slitky fi, fl, ffi, ffl, vyrovnané mezery ve slově PLAVAT atd. Nehledě k tomu, že na Windows je GSView vzácnost. Stručně řečeno házíme perly sviním). Word nebo Swriter je je trošku jiná kategorie, hodně lidí s nimi nechce mít nic společného a navíc se moc nedá čekat, že příjemce uvidí dokument stejně jako my. (U HTML se to už vůbec nedá čekat, ale s tím se tak nějak počítá).

Samotný skript

Skript jsem nevymyslel sám, většinu jsem přebral z [2], ale poskládal jsem ho celý do stavu, ve kterém se dá hned použít. Zde je tedy prázdný dokument, který se bude sám udržovat obsah (TOC), stačí do něj jenom doplnit vlastní text.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
  <head>
   <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
   <META NAME="AUTHOR" CONTENT="Tomas Penicka">
<!-- Based on http://www.quirksmode.org/dom/toc.html, but some changes were made-->
<script type="text/javascript">

function getElementsByTagNames(list,obj) {
	if (!obj) var obj = document;
	var tagNames = list.split(',');
	var resultArray = new Array();
	for (var i=0;i<tagNames.length;i++) {
		var tags = obj.getElementsByTagName(tagNames[i]);

		for (var j=0;j<tags.length;j++) {
			resultArray.push(tags[j]);
		}
	}
	var testNode = resultArray[0];
	if (!testNode) return [];

	if (testNode.sourceIndex) {
		resultArray.sort(function (a,b) {
				return a.sourceIndex - b.sourceIndex;
		});
	}
	else if (testNode.compareDocumentPosition) {

		resultArray.sort(function (a,b) {
				return 3 - (a.compareDocumentPosition(b) & 6);
		});
	}
	return resultArray;
}


function createTOC() {
	var y = document.createElement('div');
	y.id = 'innertoc';
	var a = y.appendChild(document.createElement('span'));
	a.onclick = showhideTOC;
	a.id = 'contentheader';

	a.innerHTML = 'hide page contents';
	var z = y.appendChild(document.createElement('div'));
	var toBeTOCced = getElementsByTagNames('h2,h3,h4,h5,h6');
	if (toBeTOCced.length < 2) return false;

	for (var i=0;i<toBeTOCced.length;i++) {

		var tmp = document.createElement('a');
		tmp.innerHTML = toBeTOCced[i].innerHTML;
		z.appendChild(tmp);
        tmp.className = 'indent' + toBeTOCced[i].nodeName.substring(1);
		var headerId = toBeTOCced[i].id || 'link' + i;
		tmp.href = '#' + headerId;

		toBeTOCced[i].id = headerId;
	}
	return y;
}

var TOCstate = 'block';

function showhideTOC() {

	TOCstate = (TOCstate == 'none') ? 'block' : 'none';
	var newText = (TOCstate == 'none') ? 'show page contents' : 'hide page contents';
	document.getElementById('contentheader').innerHTML = newText;
	document.getElementById('contentheader').onclick = showhideTOC;
	document.getElementById('innertoc').lastChild.style.display = TOCstate;
    alert();

}
</script>
<style type="text/css">
	#toc a   {display: block; margin-top: 2pt; background-color: #EEEEEE;}
	#toc a:hover   {background-color: #CCCCFF;}
	.indent2    {margin-left: 0em;}
	.indent3    {margin-left: 2em;}

	.indent4    {margin-left: 4em;}
	.indent5    {margin-left: 6em;}
	.indent6    {margin-left: 8em;}
</style>
    <title></title>
  </head>

<body onLoad="document.getElementById('toc').appendChild(createTOC());">
<!-- The following DIV is exactly the place, where to TOC will be located, don't remove this -->
<div id="toc"></div>

</body>
</html>

Lehké vysvětlení:

• řádky 8--31: funkce getElementsByTagNames. Všimněte si plurálu. Dělá to stejné, co getElementsByTagName, ale můžete zadat víc tagů (jmen). Podrobněji viz [1].
• řádky 33--54: vlastní tvoření obsahu. Popíšeme si důležitá místa
• řádky 34--35: připraví se DIV, do kterého se celý obsah nacpe
• řádky 36--39: přepínač na skrývání obsahu
• řádek 41: získá se seznam všech nadpisů od úrovně 2. H1 bývá hlavní nadpis a do obsahu se nedává.
• řádky 49--51: každý nadpis dostane Id, pokud už ho nemá a stejné Id se použije jako cíl odkazu z obsahu. Obsah je složen jednoduše ze samých odkazů bez dalšího formátování
• řádky 58--65: pomocná funkce na skrývání a zobrazování obsahu
• řádky 67--75: styl, která zajistí, že se obsah zobrazí v přehledné podobě (v rámci možností). Všimněte si zejména vlastnosti display na řádku 68.
• řádek 78: po načtení stránky se to celé spustí
• řádek 80: DIV, kam bude obsah umístěn

Skript jsem testoval ve Firefoxu (Linux i Windows) a IE6. V obojím funguje.

Chtěl jsem ještě přidat odkaz na příklad, ale zápisek už jsem uložil. (To byl vtip, ve skutečnosti jsem chtěl přidat k zápisku přílohu dostal jsem chybovou hlášku "přístup odmítnout")

Odkazy

1. http://www.quirksmode.org/dom/getElementsByTagNames.html
2. http://www.quirksmode.org/dom/toc.html

Místa k vylepšení, otázky

1. Odkazy v obsahu mají nepříjemnou vlastnost--aktivní je celý řádek, ne jenom text. Dá se to nějak snadno zlepšit?
2. Uměl by někdo přidat automatické číslování?
3. Nadpisy v HTML se dost špatně opticky odlišují. Šlo by zařídit, aby i text dokumentu byl odražený od levého kraje podobně jako položky obsahu?

       

Anketa

Komentáře

[anicka]

Pokud jde o TeX, Windows a perly svinim: cspdftex mi vzdycky chodil docela pekne a psat v TeXu da IMHO min prace nez psat v cemkoliv jinem. Ale proti gustu...

[botanicus]

+1

[Käyttäjä 11133]

Spát v plaintextu je ještě méně práce, jinak taky LaTeX.

[Tomáš]

Spát rozhodně.

TeX samozřejmě používám raději, mám plno svých maker pro plain (LaTeX moc nemusím). Někdy je ale lepší sáhnout po tom, co umí i kolegové, aby mohli opravovat chyby apod.

[Ritchie]

Používat innerHTML je poněkud nečisté, co takhle zkusit metody cloneNode a replaceData?

Ideální řešení by stavělo na DOM objektu NodeIterator. Bohužel jeho implementace v prohlížečích je problematická.

Odpovědi na otázky

1. Protože jste element a učinil blokovým elementem. Čisté řešení je použití zanořených seznamů a element a ponechat řádkovým.
2. Elegantní řešení je obsaženo v předešlé odpovědi.
3. Řešení spočívá v přiřazení záporného levého okraje nadpisům a kladného levého okraje předku všech textů.

[Tomáš]

Díky za odpovědi, ještě mám pár komentářů.

1. Jak moc by to zkomplikovalo kód? Přeci jenom jsem se snažil o co nejjednodušší řešení
2. A co číslování v textu?
3. To je dobý hack. Až budu mít čas, tak si to přepíšu.

[Ritchie]

1. Záleží, jak elegantně byste to napsal. Lze to napsat jako cyklus odhadem s 15–20 řádky kódu.
2. Ideálně CSS 2.1 kapitola 12.4, v prohlížečích bohužel příliš nepodporováno. Jinak javascript na 10 řádků.

[Zdeněk Burda]

Nemám rád zbytečný javascript. Ah, to není pravda, nenávidím ho! Proč při psaní dokumentu prostě nezvolit vhodný způsob, který ho vygeneruje automaticky? Používám Docbook, generuje číslování, toc a vše co potřebuju. Proti javascriptu má tu velkou výhodu, že funguje i v lynxu.

[Tomáš]

Plně souhlasím s námitkou (javascript taky moc nemusím), ale někdy prostě nemůžu použít pořádné řešení. První důvod je ten, že Docbook nemumím používat. Druhý důvod je, že dokument musí být univerzálně přenositelný a musí jít opravit odkudkoliv (ne všechny počítače mají nainstalovaný patřičný software). Třetí důvod je, si nemůžu vybírat programové prostředí. Prostě si na počítač nesmím instalovat všechno, na co si vzpomenu.

[Josef Kufner]

http://duramecho.com/ComputerPrograms/HtmlHeadingsToTableOfContents/index.html