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

napište » Zprávičky

dnes 11:55 | Zajímavý software

Vývojář Spytihněv, autor počítačové hry Hrot (Wikipedie, ProtonDB), pracuje na nové hře Brno Transit. Jedná se o příběhový psychologický horor o strojvedoucím v zácviku, uvězněném v nejzatuchlejším metru východně od všeho, na čem záleží. Vydání je plánováno na čtvrté čtvrtletí letošního roku.

Ladislav Hagara | Komentářů: 16

České dráhy testují vysokorychlostní satelitní internet Starlink ve vlaku

včera 18:22 | IT novinky

V uplynulých dnech byla v depu Českých drah v Brně-Maloměřicích úspěšně dokončena zástavba speciální antény satelitního internetu Starlink od společnosti SpaceX do jednotky InterPanter 660 004 Českých drah. Zástavbu provedla Škoda Group. Cestující se s InterPanterem, vybaveným vysokorychlostním satelitním internetem, setkají například na linkách Svitava Brno – Česká Třebová – Praha nebo Moravan Brno – Břeclav – Přerov – Olomouc.

Ladislav Hagara | Komentářů: 11

digiKam 8.7.0

včera 13:11 | Nová verze

Byla vydána nová verze 8.7.0 správce sbírky fotografií digiKam (Wikipedie). Přehled novinek i s náhledy v oficiálním oznámení (NEWS). Nejnovější digiKam je ke stažení také jako balíček ve formátu AppImage. Stačí jej stáhnout, nastavit právo ke spuštění a spustit.

Ladislav Hagara | Komentářů: 0

Před 30 lety byl v ČR liberalizován Internet

včera 12:22 | IT novinky

Před 30 lety, k 1. 7. 1995, byl v ČR liberalizován Internet - tehdejší Eurotel přišel o svou exkluzivitu a mohli začít vznikat první komerční poskytovatelé přístupu k Internetu [𝕏].

Ladislav Hagara | Komentářů: 5

Zabbix 7.4

včera 11:33 | Nová verze

Byla vydána (𝕏) nová verze 7.4 open source monitorovacího systému Zabbix (Wikipedie). Přehled novinek v oznámení na webu, v poznámkách k vydání a v aktualizované dokumentaci.

Ladislav Hagara | Komentářů: 1

Sudo 1.9.17p1 řeší zranitelnosti CVE-2025-32462 a CVE-2025-32463

včera 05:44 | Bezpečnostní upozornění

Balíček s příkazem sudo byl vydán ve verzi 1.9.17p1. Řešeny jsou zranitelnosti CVE-2025-32462 (lokální eskalace práv prostřednictvím volby host) a CVE-2025-32463 (lokální eskalace práv prostřednictvím volby chroot).

Ladislav Hagara | Komentářů: 6

Na Seznam.cz s MojeID

včera 05:22 | IT novinky

Do služeb Seznam.cz se lze nově přihlásit pomocí služby MojeID [𝕏].

Ladislav Hagara | Komentářů: 5

Zranitelnosti v tiskárnách umožňují útočníkům obejít zabezpečení a převzít správu zařízení

včera 03:33 | Bezpečnostní upozornění

Bezpečnostní výzkumníci zveřejnili informace o osmi zranitelnostech, které postihují více než 700 modelů tiskáren, skenerů a štítkovačů značky Brother. Bezpečnostní upozornění vydali také další výrobci jako Fujifilm, Ricoh, Konica Minolta a Toshiba. Nejzávažnější zranitelnost CVE-2024-51978 umožňuje útočníkovi vzdáleně a bez přihlášení získat administrátorská oprávnění prostřednictvím výchozího hesla, které lze odvodit ze

… více »

Ladislav Hagara | Komentářů: 0

Dění kolem ochranné známky JAVASCRIPT

30.6. 16:00 | Komunita

Společnost Oracle vlastní ochrannou známku JAVASCRIPT. Komunita kolem programovacího jazyka JavaScript zastoupena společností Deno Land vede právní bitvu za její osvobození, viz petice a otevřený dopis na javascript.tm. Do 7. srpna se k nim má vyjádřit Oracle (USPTO TTAB).

Ladislav Hagara | Komentářů: 6

Raspberry Pi Radio Module 2

30.6. 13:11 | IT novinky

Byl představen samostatný rádiový modul Raspberry Pi Radio Module 2 s Wi-Fi a Bluetooth.

Ladislav Hagara | Komentářů: 6

Centrum | Napsat | Starší

navrhněte » Anketa

Jaký je váš oblíbený skriptovací jazyk?

bash (59%)

python (28%)

perl (7%)

powershell (2%)

batch (0%)

vbscript (1%)

jiný, uvedu v diskusi (3%)

Celkem 338 hlasů

Komentářů: 16, poslední 8.6. 21:05

Rozcestník

AbcLinuxu

HDmag.cz

AbcLinuxu:/ Blogy / Tomik / Linux / Užitečné skripty 3: automaticky generovaný obsah v HTML

Štítky: HTML, web, Windows

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

11.3.2007 21:49 | Přečteno: 2333× | 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

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

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

Odkazy v obsahu mají nepříjemnou vlastnost--aktivní je celý řádek, ne jenom text. Dá se to nějak snadno zlepšit?
Uměl by někdo přidat automatické číslování?
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?

Hodnocení: 100 %

špatné • dobré

Anketa

Tiskni Sdílej:

Komentáře

Nástroje: Začni sledovat (0) ? , Tisk

Vložit další komentář

11.3.2007 22:49 anicka | blog: ze_zivota
Rozbalit Rozbalit vše Re: Užitečné skripty 3: automaticky generovaný obsah v HTML

Odpovědět | Sbalit | Link | Blokovat | Admin

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... :-)

12.3.2007 09:40 botanicus | blog: Botanicusovi povzdechy | Prachatice
Rozbalit Rozbalit vše Re: Užitečné skripty 3: automaticky generovaný obsah v HTML

... mam chut na jablicka ;)

12.3.2007 11:55 Käyttäjä 11133 | skóre: 58 | blog: Ajattelee menneisyyttä
Rozbalit Rozbalit vše Re: Užitečné skripty 3: automaticky generovaný obsah v HTML

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

12.3.2007 13:22 Tomáš | skóre: 31 | blog: Tomik
Rozbalit Rozbalit vše Re: Užitečné skripty 3: automaticky generovaný obsah v HTML

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.

11.3.2007 23:44 Ritchie | skóre: 27 | blog: Ritchie's | Berlin
Rozbalit Rozbalit vše Re: Užitečné skripty 3: automaticky generovaný obsah v HTML

Odpovědět | Sbalit | Link | Blokovat | Admin

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

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.
Elegantní řešení je obsaženo v předešlé odpovědi.
Ř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ů.

12.3.2007 08:56 Tomáš | skóre: 31 | blog: Tomik
Rozbalit Rozbalit vše Re: Užitečné skripty 3: automaticky generovaný obsah v HTML

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

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

12.3.2007 09:40 Ritchie | skóre: 27 | blog: Ritchie's | Berlin
Rozbalit Rozbalit vše Re: Užitečné skripty 3: automaticky generovaný obsah v HTML

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

12.3.2007 08:09 Zdeněk Burda | skóre: 61 | blog: Zdendův blog | Praha
Rozbalit Rozbalit vše Re: Užitečné skripty 3: automaticky generovaný obsah v HTML

Odpovědět | Sbalit | Link | Blokovat | Admin

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.

-- Nezdar není hanbou, hanbou je strach z pokusu.

12.3.2007 08:51 Tomáš | skóre: 31 | blog: Tomik
Rozbalit Rozbalit vše Re: Užitečné skripty 3: automaticky generovaný obsah v HTML

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.

26.1.2012 18:45 Josef Kufner | skóre: 70
Rozbalit Rozbalit vše Re: Užitečné skripty 3: automaticky generovaný obsah v HTML

Odpovědět | Sbalit | Link | Blokovat | Admin

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

Hello world ! Segmentation fault (core dumped)

Založit nové vlákno • Nahoru