[successivo] [precedente] [inizio] [fine] [indice generale] [violazione licenza] [translators] [docinfo] [indice analitico] [volume] [parte]
In questo capitolo conclusivo della parte dedicata a Sgmltexi, si riepiloga brevemente l'uso di questo sistema di composizione, attraverso la comparazione con Texinfo. In questo modo, si può comprendere cosa di Texinfo non è disponibile con Sgmltexi.
Si osservi che nei modelli sintattici, le parentesi graffe hanno significato letterale, facendo parte dei comandi di Texinfo.
@spazio_bianco|
|
@!|
|
End sentence exclamation mark
@"x@'xPer la rappresentazione di caratteri speciali, si possono utilizzare le entità standard SGML, oppure i caratteri della codifica ISO 8859-n selezionata con l'opzione --input-encoding, o con l'attributo charset dell'elemento sgmltexi.
@*|
|
@,{x}Per la rappresentazione di caratteri speciali, si possono utilizzare le entità standard SGML, oppure i caratteri della codifica ISO 8859-n selezionata con l'opzione --input-encoding, o con l'attributo charset dell'elemento sgmltexi.
@-|
|
@.|
|
End sentence period
@:|
|
Not ending sentence
@=xNon disponibile.
@?|
|
End of sentence question mark
@@|
|
@^@`Per la rappresentazione di caratteri speciali, si possono utilizzare le entità standard SGML, oppure i caratteri della codifica ISO 8859-n selezionata con l'opzione --input-encoding, o con l'attributo charset dell'elemento sgmltexi.
@{|
|
@}|
|
@~@AA{}@aa{}Per la rappresentazione di caratteri speciali, si possono utilizzare le entità standard SGML, oppure i caratteri della codifica ISO 8859-n selezionata con l'opzione --input-encoding, o con l'attributo charset dell'elemento sgmltexi.
@acronym{abbreviazione}|
|
@AE{}@ae{}Per la rappresentazione di caratteri speciali, si possono utilizzare le entità standard SGML, oppure i caratteri della codifica ISO 8859-n selezionata con l'opzione --input-encoding, o con l'attributo charset dell'elemento sgmltexi.
@afivepaper@afourpaper@afourlatex@afourwideIn sostituzione di questi comandi, si possono usare le opzioni della riga di comando: --paper=a5, --paper=a4, --paper=a4latex, --paper=a4wide.
@alias nuovo=esistenteNon disponibile. Probabilmente si può rimediare inserendo il comando all'interno dell'elemento texinfo.
@anchor{nome}|
|
@appendix titolo@appendixsec titolo@appendixsection titolo@appendixsubsec titolo@appendixsubsection titolo@appendixsubsubsec titolo@appendixsubsubsection titoloLe appendici si ottengono nell'ambito dell'elemento appendix.
@asisLa parola asis è usata come argomento dell'attributo emphasis degli elementi table, vtable e ftable.
@author autore|
|
@b{testo}|
|
@bullet{}|
|
@bye|
|
@c commento@comment commentoNon è disponibile un elemento equivalente, dal momento che l'SGML offre un suo sistema per annotare i commenti. Se necessario, questo comando può essere incluso all'interno di un elemento texinfo.
@cartouche|
|
@center testo|
|
Non si può usare nel titolo del documento.
@centerchap titoloNon disponibile.
@chapheading titolo|
|
@chapter titolo|
|
@cindex voce|
|
@cite{riferimento}|
|
@clear indicatoreNon disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@code{testo}|
|
@command{nome_comando}|
|
@contents|
|
@copyright{}|
|
@defcodeindex nome_indice|
|
@defcv categoria classe nome@defcvx categoria classe nome|
|
@deffn categoria nome argomento...@deffnx categoria nome argomento...|
|
@defindex nome_indice|
|
@definfoenclose nuovo_comando prima dopoNon disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@defivar classe nome_variabile_di_istanza@defivarx classe nome_variabile_di_istanza|
|
@defmac nome_macro argomento...@defmacx nome_macro argomento...|
|
@defmethod classe nome_metodo argomento...@defmethodx classe nome_metodo argomento...|
|
@defop categoria classe nome argomento...@defopx categoria classe nome argomento...|
|
@defopt nome_opzione@defoptx nome_opzione|
|
@defspec nome argomento...@defspecx nome argomento...|
|
@deftp categoria nome attributo...@deftpx categoria nome attributo...|
|
@deftypefn classificazione tipo_dati nome argomento...@deftypefnx classificazione tipo_dati nome argomento...|
|
@deftypefun tipo_dati nome_funzione argomento...@deftypefunx tipo_dati nome_funzione argomento...|
|
@deftypeivar classe tipo_dati nome_variabile@deftypeivarx classe tipo_dati nome_variabile|
|
@deftypemethod classe tipo_dati nome_metodo argomento...@deftypemethodx classe tipo_dati nome_metodo argomento...|
|
@deftypeop categioria classe tipo_dati nome argomento...@deftypeopx categioria classe tipo_dati nome argomento...|
|
@deftypevar tipo_dati nome_variabile@deftypevarx tipo_dati nome_variabile|
|
@deftypevr classificazione tipo_dati nome_variabile@deftypevrx classificazione tipo_dati nome_variabile|
|
@defun nome_funzione argomento...@defunx nome_funzione argomento...|
|
@defvar nome_variabile@defvarx nome_variabile|
|
@defvr categoria nome_variabile@defvrx categoria nome_variabile|
|
@detailmenu|
|
@dfn{termine}|
|
@dircategory dirpart@direntry|
|
@display|
|
@dmn{dimensione}|
|
@documentdescription descrizione @end documentdescription|
|
@documentencoding codifica|
|
Definisce la codifica del sorgente Texinfo che viene generato, stabilendo implicitamente che lo stesso sorgente SGML è realizzato nello stesso modo. Viene oscurato dall'opzione --input-encoding, che prende la precedenza generando un sorgente Texinfo in formato ISO 646 puro (ASCII a 7 bit).
@documentlanguage cc|
|
@dotaccent{c}Per la rappresentazione di caratteri speciali, si possono utilizzare le entità standard SGML, oppure i caratteri della codifica ISO 8859-n selezionata con l'opzione --input-encoding, o con l'attributo charset dell'elemento sgmltexi.
@dots{}|
|
@email{indirizzo, testo_mostrato}|
|
@emph{testo}|
|
@env{variabile_di_ambiente}|
|
@enddots{}|
|
@enumerate [numero_o_lettera]|
|
@equiv{}|
|
@error{}|
|
@evenfooting@evenheading@everyfooting@everyheadingNon disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@example|
|
Preformattato:
|
|
Letterale:
|
|
@exampleindentNon disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@exlamdown|
|
@exdent|
|
@expansion{}|
|
@file{nome_file}|
|
@finaloutNon gestibile, in quanto il sorgente Texinfo che viene generato contiene sempre questo comando.
@findex voce|
|
@flushleft|
|
@flushright|
|
@footnote{testo_del_piè_pagina}|
|
@footnotestyle stile|
|
In alternativa si può usare l'opzione --footnotestyle=stile della riga di comando, che prende il sopravvento.
@format|
|
Letterale:
|
|
@frenchspacing|
|
@ftable comando_di_formattazione|
|
@group|
|
@H{c}Per la rappresentazione di caratteri speciali, si possono utilizzare le entità standard SGML, oppure i caratteri della codifica ISO 8859-n selezionata con l'opzione --input-encoding, o con l'attributo charset dell'elemento sgmltexi.
@heading titolo|
|
@headings on@headings off@headings single@headings double|
|
In alternativa si può usare l'opzione --headings della riga di comando, che prende il sopravvento:
|
|
@html|
|
@hyphenation{parole_separate_in_sillabe}|
|
@i{testo}|
|
@ifclear opzioneNon disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@ifhtmlCi sono due possibilità: testo interno alle righe e blocchi di testo.
|
|
|
|
L'SGML dà la possibilità di usare le sezioni marcate. Queste posso essere controllate da Sgmltexi attraverso l'opzione --sgml-include della riga di comando. Per esempio, il sorgente SGML potrebbe essere simile al pezzo seguente:
|
Quindi, quando si genera la composizione in HTML, si deve utilizzare l'opzione --sgml-include=HTML:
$ sgmltexi --sgml-include=HTML --html mio_file.sgml[Invio]
Per la composizione nel formato Info, si deve usare l'opzione --sgml-include=INFO:
$ sgmltexi --sgml-include=INFO --info mio_file.sgml[Invio]
Nello stesso modo, per la composizione attraverso TeX si deve usare l'opzione --sgml-include=TEX:
$ sgmltexi --sgml-include=TEX --tex mio_file.sgml[Invio]
@ifinfoCi sono due possibilità: testo interno alle righe e blocchi di testo.
|
|
|
|
L'SGML dà la possibilità di usare le sezioni marcate, come è già stato mostrato a proposito del comando @ifhtml.
@ifnothtmlCi sono due possibilità: testo interno alle righe e blocchi di testo.
|
|
|
|
L'SGML dà la possibilità di usare le sezioni marcate. Queste posso essere controllate da Sgmltexi attraverso l'opzione --sgml-include della riga di comando. Per esempio, il sorgente SGML potrebbe essere simile al pezzo seguente:
|
Quindi, quando si genera la composizione in HTML, si devono utilizzare le opzioni --sgml-include=NOTINFO e --sgml-include=NOTTEX:
$ sgmltexi --sgml-include=NOTINFO --sgml-include=NOTTEX \
\--html mio_file.sgml[Invio]
Per la composizione nel formato Info, si devono utilizzare le opzioni --sgml-include=NOTHTML e --sgml-include=NOTTEX:
$ sgmltexi --sgml-include=NOTHTML --sgml-include=NOTTEX \
\--info mio_file.sgml[Invio]
Nello stesso modo, per la composizione attraverso TeX si devono utilizzare le opzioni --sgml-include=NOTHTML e --sgml-include=NOTINFO:
$ sgmltexi --sgml-include=NOTHTML --sgml-include=NOTINFO \
\--tex mio_file.sgml[Invio]
@ifnotinfoCi sono due possibilità: testo interno alle righe e blocchi di testo.
|
|
|
|
L'SGML dà la possibilità di usare le sezioni marcate, come è già stato mostrato a proposito del comando @ifnothtml.
@ifnotplaintextCi sono due possibilità: testo interno alle righe e blocchi di testo.
|
|
|
|
L'SGML dà la possibilità di usare le sezioni marcate, come è già stato mostrato a proposito del comando @ifnothtml.
@ifnottexCi sono due possibilità: testo interno alle righe e blocchi di testo.
|
|
|
|
L'SGML dà la possibilità di usare le sezioni marcate, come è già stato mostrato a proposito del comando @ifnothtml.
@ifnotxmlCi sono due possibilità: testo interno alle righe e blocchi di testo.
|
|
|
|
L'SGML dà la possibilità di usare le sezioni marcate, come è già stato mostrato a proposito del comando @ifnothtml.
@ifplaintextCi sono due possibilità: testo interno alle righe e blocchi di testo.
|
|
|
|
L'SGML dà la possibilità di usare le sezioni marcate, come è già stato mostrato a proposito del comando @ifnothtml.
@ifset flagNon disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@iftexCi sono due possibilità: testo interno alle righe e blocchi di testo.
|
|
|
|
L'SGML dà la possibilità di usare le sezioni marcate, come è già stato mostrato a proposito del comando @ifhtml.
@ifxmlCi sono due possibilità: testo interno alle righe e blocchi di testo.
|
|
|
|
L'SGML dà la possibilità di usare le sezioni marcate, come è già stato mostrato a proposito del comando @ifhtml.
@ignoreNon disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo. Se non è necessario inserire commenti nel file Texinfo che viene generato, si possono usare i commenti secondo l'SGML:
|
|
@image{nome_file, [ampiezza], [altezza]}|
|
@includeNon disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo. L'SGML offre un meccanismo alternativo:
|
come si può vedere dall'esempio, l'inserzione nel testo di licenses/gpl.sgml e di licenses/bsd.sgml avviene attraverso l'uso delle macro SGML &GPL; e &BSD;.
Se è necessario includere un file Texinfo, si può fare come si vede nell'esempio seguente:
|
È necessario tenere a mente che l'elemento texinfo è di tipo interno alle righe di testo. Ecco perché nell'esempio è contenuto in un elemento p.
@inforef{nome_nodo, [voce], nome_file_info}|
|
\input file_macroNon è possibile inserire macro aggiuntive all'inizio del documento, oltre a quella predefinita che imposta la sintassi Texinfo.
@itemQuesto comando di Texinfo viene usato in contesti molto diversi. All'interno di Sgmltexi non esiste un modo unico per utilizzarlo, per cui conviene vedere piuttosto la descrizione dei comandi @table, @ftable, @vtable, @itemize, @enumerate e @multitable.
@itemize [marcatore_iniziale]|
|
@itemxQuesto comando di Texinfo viene usato in contesti molto diversi. All'interno di Sgmltexi non esiste un modo unico per utilizzarlo, per cui conviene vedere piuttosto la descrizione dei comandi @table, @ftable e @vtable.
@kbd{tasti_premuti}|
|
@kbdinputstyle stile|
|
@key{nome_tasto}|
|
@kindex voce|
|
@L{}|
|
@l{}|
|
@lisp|
|
Preformattato:
|
|
Letterale:
|
|
@lowersectionsNon disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@macro nome_macro {parametri}Non disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@majorheading titoloNon disponibile attualmente.
@math{espressione_matematica}|
|
@menu|
|
@minus{}|
|
@multitable larghezza_delle_colonne|
|
|
|
@need n|
|
@node nome, successivo, precedente, superioreLa gestione manuale dei nodi di Texinfo avviene come si vede nello schema seguente, dove ci si limita a stabilire il nome del nodo in questione:
|
|
Se è necessario un controllo completo sui nodi, si possono stabilire anche gli altri dati, come nello schema seguente:
|
|
Sgmltexi non fa alcun controllo di validità per quanto riguarda l'inserzione manuale dei nodi.
@noindent|
|
@novalidateNon disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
O{}|
|
o{}|
|
@oddfooting@oddheadingNon disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@option{opzione}|
|
@page|
|
@pagesizes [ampiezza][, altezza]Non disponibile.
@paragraphindent rientroNon disponibile.
@pindex voce|
|
@point{}|
|
@pounds{}|
|
@print{}|
|
@printindex nome_indice|
|
@pxref{nome_nodo, [voce], [argomento_o_titolo], [file_info], [manual]}|
|
@questiondown{}|
|
@quotation|
|
@r{testo}|
|
@raisesectionsNon disponibile.
@ref{nome_nodo, [voce], [argomento_o_titolo], [file_info], [manuale]}|
|
@refillNon disponibile.
@result{}|
|
@ringaccent{c}Per la rappresentazione di caratteri speciali, si possono utilizzare le entità standard SGML, oppure i caratteri della codifica ISO 8859-n selezionata con l'opzione --input-encoding, o con l'attributo charset dell'elemento sgmltexi.
@samp{testo}|
|
@sc{testo}|
|
@section titolo|
|
@set flag stringNon disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@setchapternewpage on@setchapternewpage off@setchapternewpage oddSi può usare l'elemento setchapternewpage, come negli schemi seguenti:
|
|
In alternativa si può utilizzare l'opzione --setchapternewpage, nella riga di comando:
|
|
@setcontentsaftertitlepageNon disponibile.
@setfilename nome_file_info|
|
@setshortcontentsaftertitlepageNon disponibile.
@settitle titolo|
|
@shortcontents|
|
@shorttitlepage titleNon disponibile.
@smallbookSi usa per questo l'opzione: --paper=small.
@smalldisplay|
|
@smallexample|
|
Preformattato:
|
|
Letterale:
|
|
@smallformat|
|
Letterale:
|
|
@smalllisp|
|
Preformattato:
|
|
Letterale:
|
|
@sp n|
|
@ss{}|
|
@strong{testo}|
|
@subheading titolo|
|
@subsection titolo|
|
@subsubheading titolo|
|
@subsubsection titolo|
|
@subtitle sottotitolo|
|
@summarycontents|
|
@syncodeindex indice_di_origine indice_di_destinazione |
|
@synindex indice_di_origine indice_di_destinazione|
|
@t{testo}|
|
@tabSi veda la descrizione di @multitable.
@table comando_di_formattazione|
|
@TeX{}|
|
@tex|
|
@thischapter@thischaptername@thisfile@thispage@thistitleNon disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@tie{}|
|
@tieaccent{cc}Non disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@tindex voce|
|
@title titolo|
|
@titlefont{testo}Non disponibile.
@titlepageNon disponibile. Si veda come è organizzata la struttura di Sgmltexi.
@today|
|
@topViene generato automaticamente.
@u{c}@ubaraccent{c}@udotaccent{c}Non disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@unnumbered titolo|
|
@unnumberedsec titolo|
|
@unnumberedsubsec titolo|
|
@unnumberedsubsubsec titolo|
|
@uref{url, [testo_mostrato], [rimpiazzo]}|
|
@url{url}|
|
@v{c}Non disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@value{indicatore}Non disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@var{metavariabile}|
|
@verb{xtesto_letteralex}|
|
@verbatim testo_letterale @end verbatim|
|
@verbatiminclude file|
|
@vindex voce|
|
@vskip ammontare_dell'avanzamentoNon disponibile. Eventualmente può essere usato all'interno dell'elemento texinfo.
@vtable comando_di_formattazione|
|
@w{testo}|
|
@xref{nome_nodo, [voce], [argomento_o_titolo], [file_info], [manuale]}|
|
Appunti di informatica libera 2004.10.10 --- Copyright © 2000-2004 Daniele Giacomini -- <daniele (ad) swlibero·org>, <daniele·giacomini (ad) poste·it>
Dovrebbe essere possibile fare riferimento a questa pagina anche con il nome corrispondenza_tra_texinfo_e_sgmltexi.html
[successivo] [precedente] [inizio] [fine] [indice generale] [violazione licenza] [translators] [docinfo] [indice analitico]