¸íá Áðëü ÐáñÜäåéãìá SGML Matt Welsh, mdw@cs.cornell.edu v1.0, 28 Ìáñôßïõ 1994 Áõôü ôï êåßìåíï áðïôåëåß Ýíá óýíôïìï ðáñÜäåéãìá ÷ñÞóçò ôïõ Linuxdoc- SGML DTD. (Ó.ô.Ì. Áðïôåëåß ìåôÜöñáóç áëëÜ êáé ðñïóáñìïãÞ óôá åëëçíéêÜ äåäïìÝíá ôïõ áñ÷éêïý êåéìÝíïõ ðïõ ðåñéëáìâÜíåôáé óôá sgml-tools. Ðñïêüðçò Ðñïêïðßäçò, prokops@hellug.gr, ÓåðôÝìâñéïò 1999) ______________________________________________________________________ Table of Contents 1. ÅéóáãùãÞ 2. Ï êþäéêáò 3. ÌåñéêÜ ðáñáäåßãìáôá 3.1 ÁõôÞ åßíáé ìéá õðïåíüôçôá 3.1.1 ÁõôÞ åßíáé ìéá áíèõðïåíüôçôá 3.2 Êåßìåíï ðïõ ÷ñçóéìïðïéåßôáé ùò ðáñÜäåéãìá 3.3 ÐáñáðïìðÝò óå Üëëá óçìåßá ôïõ êåéìÝíïõ 3.4 ×ñÞóç ôùí ãñáììáôïóåéñþí 3.5 Ëßóôåò ______________________________________________________________________ [1m1. ÅéóáãùãÞ[0m Áõôü åßíáé Ýíá ðáñÜäåéãìá SGML ìå ôç ÷ñÞóç ôïõ Linuxdoc-SGML DTD. Ìðïñåßôå íá ôï ìïñöïðïéÞóåôå ÷ñçóéìïðïéþíôáò ôçí åíôïëÞ % sgml2html example.sgml ðïõ èá ðáñáãÜãåé HTML óåëßäåò. Ìðïñåßôå åðßóçò íá ðáñáãÜãåôå LaTeX, .txt êáé GNU info áñ÷åßá. (Ó.ô.Ì. Ìå ïñéóìÝíïõò ðåñéïñéóìïýò ãéá ôá ÅëëçíéêÜ. Ç ìåôáôñïðÞ óå HTML äïõëåýåé ÷ùñßò êáíÝíá ðñüâëçìá êáé óôá ÅëëçíéêÜ.) [1m2. Ï êþäéêáò[0m ÅîåôÜæïíôáò ôïí êþäéêá áðü áõôü ôï áñ÷åßï èá ìÜèåôå ðþò íá ÷ñçóéìïðïéåßôå ðïëëÝò áðü ôéò äïìÝò ôïõ Linuxdoc-SGML. Èá ðñÝðåé åðßóçò íá äéáâÜóôå ôï [4mLinuxdoc-SGML[24m [4mUser's[24m [4mGuide[24m, óôï áñ÷åßï guide.sgml ðïõ ðåñéëáìâÜíåôáé óôç äéáíïìÞ ôùí sgml-tools. Ï êþäéêáò, üðùò èá äåßôå, ìïéÜæåé ìå ôïí êþäéêá ôïõ LaTeX. Ïé ðáñÜãñáöïé ÷ùñßæïíôáé ìå êåíÝò ãñáììÝò, ïé ìáêñïåíôïëÝò ðåñéêëåßïíôáé óå áãêýëåò. Ðñüêåéôáé ãéá áñêåôÜ áðëü êþäéêá. [1m3. ÌåñéêÜ ðáñáäåßãìáôá[0m Áêïëïõèïýí ðáñáäåßãìáôá ïñéóìÝíùí ðñáãìÜôùí ðïõ èá ÷ñåéáóôåßôå óôïí êþäéêá. Ðñþôá áò êáôåâïýìå óå ìéá õðïåíüôçôá: [1m3.1. ÁõôÞ åßíáé ìéá õðïåíüôçôá[0m ¼ðùò ëÝåé êáé ï ôßôëïò ôçò. ÐñïóÝîôå üôé åßíáé áðáñáßôçôï íá ÷ñçóéìïðïéÞóåôå ôçí åíôïëÞ p ãéá íá áñ÷ßóåôå ôï êõñßùò ìÝñïò ôçò åíüôçôáò, ìåôÜ áðü ôçí åíôïëÞ sect1. Áêïëïõèåß ìéá áíèõðïåíüôçôá: [1m3.1.1. ÁõôÞ åßíáé ìéá áíèõðïåíüôçôá[0m Ùñáßá. ¸÷åôå óôç äéÜèåóÞ óáò 5 åðßðåäá åíïôÞôùí. ×ñçóéìïðïéÞóôå ôéò åíôïëÝò sect, sect1, sect2, sect3, êáé sect4 ãéá íá ôá åêìåôáëëåõôåßôå. Áõôü ôï êåßìåíï ÷ñçóéìïðïéåß ôï óôõë êåéìÝíïõ article (Üñèñï), ðïõ åßíáé êáôÜëëçëï ãéá HOWTO êáé Üëëá ðáñüìïéá êåßìåíá ôï óôõë report (ôå÷íéêÞ áíáöïñÜ) ðïõ ðåñéëáìâÜíåé ôçí åíôïëÞ åíüôçôáò chapt (êåöÜëáéï) èá ðñÝðåé íá ôï ÷ñçóéìïðïéåßôå ãéá ôá êåßìåíá ôïõ Linux Documentation Project. [1m3.2. Êåßìåíï ðïõ ÷ñçóéìïðïéåßôáé ùò ðáñÜäåéãìá[0m Áò õðïèÝóïõìå ëïéðüí üôé, êáèþò óõíå÷ßæåôå ôï ãñÜøéìï, èÝëåôå íá åíóùìáôþóåôå óôï êåßìåíü óáò ôïí êþäéêá, ôçí åßóïäï, Þ ôçí Ýîïäï åíüò ðñïãñÜììáôïò. Óå ôÝôïéåò ðåñéðôþóåéò ÷ñçóéìïðïéÞóôå ôá ``ðåñéâÜëëïíôá'' code Þ verb, ðåñéêëåßïíôÜò ôá óå Ýíá ðåñéâÜëëïí tscreen, üðùò óôï ðáñÜäåéãìá: This is an example for environment verb. Åðßóçò: ______________________________________________________________________ This is an example for environment code. ______________________________________________________________________ Ôï ðåñéâÜëëïí tscreen áðëþò ïñßæåé ìéêñüôåñï ìÝãåèïò ãñáììáôïóåéñÜò êáé öñïíôßæåé ãéá ôç óùóôÞ óôïß÷éóç. Äåí åßíáé áðáñáßôçôï ãéá ôç ÷ñÞóç ôùí verb Þ code, ðÜíôùò åãþ óáò ôï óõíéóôþ. Ôï êåßìåíï [4mLinuxdoc-SGML[24m [4mUser's[24m [4mGuide[24m åîçãåß ðïéïõò åéäéêïýò ÷áñáêôÞñåò ìðïñåßôå êáé ðïéïõò äåí ìðïñåßôå íá ÷ñçóéìïðïéÞóåôå óôá ðåñéâÜëëïíôá verb and code. [1m3.3. ÐáñáðïìðÝò óå Üëëá óçìåßá ôïõ êåéìÝíïõ[0m ÈÝëåôå êáé ðáñáðïìðÝò óå Üëëá óçìåßá ôïõ êåéìÝíïõ; ÁõôÞ ç åíüôçôá Ý÷åé ìáñêáñéóôåß ìå ôçí åíôïëÞ label. ×ñçóéìïðïéþíôáò ôçí åíôïëÞ ref èá äçìéïõñãÞóåôå ìéá ðáñáðïìðÞ, üðùò óôï ðáñÜäåéãìá ``Äåßôå ôçí Åíüôçôá ``'' ãéá ðåñéóóüôåñåò ðëçñïöïñßåò''. Ãéá ôçí þñá ïé ðáñáìðïìðÝò äå äïõëåýïõí êáôÜ ôç ìåôÜöñáóç (ìå ôç ÷ñÞóç ôïõ groff) óå áðëü ASCII êåßìåíï. Äïõëåýïõí óùóôÜ üôáí ðáñÜãåôå LaTeX Þ HTML. [1m3.4. ×ñÞóç ôùí ãñáììáôïóåéñþí[0m Áí èÝëåôå ãñáììáôïóåéñÝò, Ý÷ïõìå êé áð' áõôÝò. ÖõóéêÜ äå èá ôéò âëÝðåôå óôï áðëü êåßìåíï ASCII, áëëÜ èá åìöáíéóôïýí üëåò óôá äéÜöïñá öïñìÜô ðïõ èá ðáñáãÜãåôå: [1mboldface (Ýíôïíá)[22m, [4memphasis[24m [4m(ãéá[24m [4mÝìöáóç)[24m, sans serif (÷ùñßò ïõñÝò), [4mslanted[24m [4m(ðëÜãéá)[24m, typewriter (ãñáöïìç÷áíÞò), and [4mitalics[24m [4m(``éôáëÜêéá'')[24m. [1m3.5. Ëßóôåò[0m Ïé ëßóôåò åßíáé åðßóçò åýêïëåò. Áðëþò ÷ñçóéìïðïéÞóôå ôï óôïé÷åßï itemize ìå ôéò åíôïëÝò item üðùò åìöáíßæïíôáé ðáñáêÜôù: · ÁõôÞ åßíáé ìéá ëßóôá. · Ôßðïôå ôï öïâåñü åäþ. · Åðßóçò õðïóôçñßæïíôáé ðïëëáðëÜ åðßðåäá. · Êáé ðÜëé, êáìéÜ Ýêðëçîç. 1. Ïé áñéèìçìÝíåò ëßóôåò ìå ôç ÷ñÞóç ôïõ enum åðßóçò äïõëåýïõí. 2. Ôï ðåñéâÜëëïí ðåñéãñáöÞò, ìå ôç ÷ñÞóç ôùí descrip êáé tag åßíáé åðßóçò äéáèÝóéìï, üðùò öáßíåôáé êé åäþ. [1mÐñþôï óôïé÷åßï.[0m Íá Ýíá óôïé÷åßï. [1mÄåýôåñï óôïé÷åßï.[0m Íá êé Üëëï Ýíá. [1mÔñßôï óôïé÷åßï.[0m ÐÜìå êáé ãéá ôï ôñßôï. · Êáé ãéá êåñáóÜêé óôçí ôïýñôá, Ýíá ôåëåõôáßï óôïé÷åßï. Êáëýøáìå ó÷åäüí êáèåôß ðïõ ÷ñåéÜæåóôå ãéá íá îåêéíÞóåôå ìå ôo ãñÜøéìï êåéìÝíùí SGML ÷ñçóéìïðïéþíôáò ôï linuxdoc-sgml DTD. Óáò ðáñáêáëþ íá ìå åéäïðïéÞóåôå áí íïìßæåôå üôé êÜôé ðñÝðåé íá áëëÜîåé Þ íá ðñïóôåèåß óå áõôü ôï êåßìåíï.