Personalizzare l'output di Mercurial

# HG changeset patch # User Giulio@puck # Date 1249514535 -7200 # Node ID 46c4ba8de2b1525d63213235663a0ec122e9d0f5 # Parent c0794abb494e7c821e92cefb324c8bda6840c79b Revision of Ch.11, not entirely satisfying. diff -r c0794abb494e -r 46c4ba8de2b1 it/ch11-template.xml --- a/it/ch11-template.xml Tue Aug 04 18:57:58 2009 +0200 +++ b/it/ch11-template.xml Thu Aug 06 01:22:15 2009 +0200 @@ -1,70 +1,70 @@ - - Personalizzare l'output di Mercurial - - Mercurial offre un potente meccanismo basato sui template per permettervi di controllare il modo in cui visualizza le informazioni. Potete usare i template per generare uno specifico output per un singolo comando, o per personalizzare l'intera apparenza dell'interfaccia web predefinita. + + Personalizzare i messaggi di Mercurial + + Mercurial offre un potente meccanismo basato sui template per permettervi di controllare il modo in cui visualizza le informazioni. Potete usare i template per generare una specifica presentazione dei risultati di un singolo comando, o per personalizzare l'intero aspetto dell'interfaccia web predefinita. - Usare gli stili di output già pronti - - Distribuiti con Mercurial ci sono alcuni stili di output che potete usare immediatamente. Uno stile è semplicemente un template già pronto che qualcuno ha scritto e installato da qualche parte che Mercurial può trovare. - - Prima di dare un'occhiata agli stili inclusi in Mercurial, rivediamo il suo output normale. + Usare gli stili di presentazione già pronti + + Mercurial include alcuni stili di presentazione che potete usare immediatamente. Uno stile è semplicemente un template già pronto che qualcuno ha scritto e installato in una posizione nota a Mercurial. + + Prima di dare un'occhiata agli stili distribuiti con Mercurial, rivediamo il normale risultato di un suo comando. &interaction.template.simple.normal; - Questo ci dà qualche informazione, ma porta via un sacco di spazio&emdash;cinque righe di output per ogni changeset. Lo stile compact riduce questo spazio a tre righe, presentate in maniera sparsa. + Questo messaggio ci dà alcune informazioni, ma porta via molto spazio&emdash;cinque righe per ogni changeset. Lo stile compact riduce questo spazio a tre righe, presentate in maniera sparsa. &interaction.template.simple.compact; - Lo stile changelog ci suggerisce quale sia il potere espressivo del motore di template di Mercurial. Questo stile tenta di seguire le linee guida per i registri dei cambiamenti stabilite dal progetto GNUweb:changelog. + Lo stile changelog ci dà un'idea quale sia il potere espressivo del motore di template di Mercurial. Questo stile tenta di seguire le linee guida per la formattazione di un registro dei cambiamenti stabilite dal progetto GNUweb:changelog. &interaction.template.simple.changelog; - Non vi impressionerà sapere che lo stile di output predefinito di Mercurial è chiamato default. + Non vi sorprenderà sapere che lo stile di output predefinito di Mercurial è chiamato default. Impostare uno stile predefinito - Potete modificare lo stile di output che Mercurial userà per ogni comando modificando il vostro file ~/.hgrc, nominando lo stile che preferireste usare. + Potete modificare lo stile di presentazione che Mercurial userà per ogni comando aggiungendo al vostro file ~/.hgrc il nome dello stile che preferireste usare. [ui] style = compact - Se scrivete un vostro stile, potete usarlo inserendo il percorso del vostro file di stile, oppure copiano il vostro file di stile in un luogo dove Mercurial possa trovarlo (tipicamente la sottodirectory templates della vostra directory di installazione di Mercurial). + Se scrivete un vostro stile, potete usarlo inserendo il percorso del vostro file di stile, oppure copiando il vostro file di stile in un luogo dove Mercurial possa trovarlo (tipicamente la sottodirectory templates della vostra directory di installazione di Mercurial). Comandi che supportano stili e template - Tutti i comandi Mercurial di tipo log vi permettono di usare stili e template: hg incoming, hg log, hg outgoing, and hg tip. - - Al momento in cui scrivo questo manuale, questi sono i comandi che finora supportano stili e template. Dato che questi sono i comandi più importanti che hanno bisogno di un output personalizzabile, c'è stata poca pressione da parte della comunità utenti di Mercurial per aggiungere il supporto per stili e template ad altri comandi. + Tutti i comandi Mercurial di tipo log vi permettono di usare stili e template: hg incoming, hg log, hg outgoing e hg tip. + + Al momento di scrivere questo manuale, quelli elencati sono i comandi che finora supportano stili e template. Dato che questi sono i comandi più importanti che necessitino di una formattazione personalizzabile, la comunità utenti di Mercurial non ha fatto molta pressione per aggiungere il supporto per stili e template ad altri comandi. Nozioni di base sui template - Nella sua forma più semplice, un template Mercurial è un frammento di testo. Parte del testo non cambia mai, mentre altre parti vengono espanse, o sostituite con nuovo testo, quando è necessario. - - Prima di continuare, diamo un'altra occhiata al semplice esempio del normale output di Mercurial + Nella sua forma più semplice, un template Mercurial è un frammento di testo. Parte del testo non cambia mai, mentre altre parti vengono espanse, cioè sostituite con nuovo testo, quando è necessario. + + Prima di continuare, diamo un'altra occhiata al semplice esempio del normale risultato di un comando Mercurial. &interaction.template.simple.normal; - Ora, eseguiamo lo stesso comando, ma usando un template per cambiare il suo output. + Ora, eseguiamo lo stesso comando, ma usando un template per cambiare il messaggio visualizzato. &interaction.template.simple.simplest; - Questo esempio illustra il template più semplice possibile, composto solo da un frammento di testo statico stampato una volta per ogni changeset. L'opzione per il comando hg log dice a Mercurial di usare il testo dato come template nel stampare ogni changeset. - - Notate che la stringa di template appena usata termina con il testo \n. Questa è una sequenza di escape che dice a Mercurial di stampare una carattere di nuova riga alla fine di ogni elemento di template. Se omettete questa nuova riga, Mercurial mostrerà ogni frammento di output uno dietro l'altro. Leggete la per maggiori dettagli sulle sequenze di escape. + Questo esempio illustra il template più semplice possibile, composto solo da un messaggio di testo statico stampato una volta per ogni changeset. L'opzione per il comando hg log dice a Mercurial di usare il testo dato come template nel stampare ogni changeset. + + Notate che la stringa di template appena usata termina con il testo \n. Questa è una sequenza di escape che dice a Mercurial di stampare una carattere di nuova riga alla fine di ogni elemento di template. Se omettete questa nuova riga, Mercurial mostrerà un messaggio di testo dietro l'altro. Leggete la per maggiori dettagli sulle sequenze di escape. Un template che stampa una stringa di testo fissata tutte le volte non è molto utile, perciò proviamo qualcosa di un po' più complesso. &interaction.template.simple.simplesub; - Come potete vedere, la stringa {desc} nel template è stata sostituita nell'output con la descrizione di ogni changeset. Ogni volta che Mercurial trova testo racchiuso tra parentesi graffe ({ e }), proverà a sostituire le parentesi e il testo con l'espansione di qualunque cosa vi sia contenuta. Per stampare una parentesi graffa letterale, dovete effettuarne l'escape, come descritto nella . + Come potete vedere, la stringa {desc} nel template è stata sostituita con la descrizione di ogni changeset nel messaggio. Ogni volta che Mercurial trova un testo racchiuso tra parentesi graffe ({ e }), proverà a sostituire le parentesi e il testo con l'espansione di qualunque cosa vi sia contenuta. Per stampare una parentesi graffa letterale dovete effettuarne l'escape, come descritto nella . @@ -77,7 +77,7 @@ branches: stringa. Il nome del ramo su cui il changeset è stato inserito. Sarà vuoto se il nome del branch è default. - date: informazioni di data. La data in cui il changeset è stato inserito. Questa informazione non è pensata per essere letta dalle persone; dovete passarla attraverso un filtro che la presenterà in maniera appropriata. Leggete la per maggiori informazioni sui filtri. La data viene espressa come una coppia di numeri. Il primo numero è una marcatura temporale che segue lo Unix UTC (e indica il numero di secondi trascorsi dal 1° gennaio 1970); il secondo è la differenza tra la zona temporale dell'autore del commit e l'UTC, in secondi. + date: informazioni di data. La data in cui il changeset è stato inserito. Questa informazione non è rappresentata in maniera comprensibile, bensì dovete passarla attraverso un filtro per presentarla in maniera appropriata. Leggete la per maggiori informazioni sui filtri. La data viene espressa come una coppia di numeri. Il primo numero è una marcatura temporale che segue l'UTC Unix (e indica il numero di secondi trascorsi dal 1° gennaio 1970); il secondo è la differenza tra il fuso orario dell'autore del commit e l'UTC, espressa in secondi. desc: stringa. Il testo della descrizione del changeset. @@ -101,7 +101,7 @@ &interaction.template.simple.keywords; - Come abbiamo notato prima, la parola chiave per la data non produce un output in forma leggibile, così dobbiamo trattarla in maniera speciale. Questo implica l'uso dei filtri, che verranno trattati in maniera più approfondita nella . + Come abbiamo notato prima, la parola chiave per la data non produce un risultato in forma leggibile, così dobbiamo trattarla in maniera speciale. Questo implica l'uso dei filtri, che verranno trattati in maniera più approfondita nella . &interaction.template.simple.datekeyword; @@ -109,7 +109,7 @@ Sequenze di escape - Il motore di template di Mercurial riconosce le sequenze di escape più comunemente usate nelle stringhe. Quando vede un carattere di backslash (\), guarda il carattere successivo e sostituisce i due caratteri con un unico rimpiazzo, come descritto qui di seguito. + Il motore di template di Mercurial riconosce le sequenze di escape più comunemente usate nelle stringhe. Quando trova un carattere di backslash (\), esamina il carattere successivo e rimpiazza i due caratteri con un unico sostituto, come descritto qui di seguito. \: @@ -133,24 +133,24 @@ 175. - Come appena indicato, se volete che l'espansione di un template contenga una carattere \, {, o { letterale, dovete effettuarne l'escape. + Come appena indicato, se volete che l'espansione di un template contenga un carattere \, {, o { letterale, dovete effettuarne l'escape. Filtrare le parole chiave per modificarne i risultati - Alcuni dei risultati dell'espansione dei template non sono immediatamente facili da usare. Mercurial vi permette di specificare una catena opzionale di filtri per modificare il risultato dell'espansione di una parola chiave. Avete già visto un filtro comune, isodate, precedentemente in azione per rendere leggibile una data. - - Qui di seguito viene presentata una lista dei filtri più comunemente usati che Mercurial supporta. Mentre alcuni filtri possono essere applicati a qualsiasi testo, altri possono essere usati solo in circostanze specifiche. Il nome di ogni filtro è seguito prima da una indicazione su dove può essere usato e poi da una descrizione dei suoi effetti. + Alcuni dei risultati dell'espansione dei template non sono immediatamente facili da usare. Mercurial vi permette di specificare una catena opzionale di filtri per modificare il risultato dell'espansione di una parola chiave. Avete già visto in azione un filtro comune, isodate, usato precedentemente per rendere leggibile una data. + + Qui di seguito viene presentata una lista dei filtri più comunemente usati che Mercurial supporta. Mentre alcuni filtri possono essere applicati a qualsiasi testo, altri possono essere usati solo in circostanze specifiche. Il nome di ogni filtro è seguito prima da un'indicazione del contesto in cui può essere usato e poi da una descrizione dei suoi effetti. addbreaks: qualsiasi testo. Aggiunge un elemento XHTML <br/> prima della fine di ogni riga tranne l'ultima. Per esempio, foo\nbar diventa foo<br/>\nbar. age: parola chiave date. Rappresenta l'età della data, relativa all'ora corrente. Produce stringhe come 10 minutes. - basename: qualsiasi testo, ma utile soprattutto per la parola chiave files e relative. Tratta il testo come un percorso e restituisce il nome di base. Per esempio, foo/bar/baz diventa baz. - - date: parola chiave date. Presenta una data in un formato simile al comando Unix date, ma includendo la zona temporale. Produce stringhe come Mon Sep 04 15:13:13 2006 -0700. + basename: qualsiasi testo, ma utile soprattutto per la parola chiave files e simili. Tratta il testo come un percorso e restituisce il nome di base. Per esempio, foo/bar/baz diventa baz. + + date: parola chiave date. Presenta una data in un formato simile al comando Unix date, ma includendo il fuso orario. Produce stringhe come Mon Sep 04 15:13:13 2006 -0700. domain: qualsiasi testo, ma utile soprattutto per la parola chiave author. Trova la prima stringa che somiglia a un indirizzo email e ne estrae il componente del dominio. Per esempio, Bryan O'Sullivan <bos@serpentine.com> diventa serpentine.com. @@ -158,7 +158,7 @@ escape: qualsiasi testo. Sostituisce i caratteri speciali XML/XHTML &, < e > con entità XML. - fill68: qualsiasi testo. Manda a capo il testo per farlo stare in 68 colonne. Questo è utile prima di passare il testo attraverso al filtro tabindent, se volete che stia ancora in una finestra di 80 colonne con caratteri a spaziatura fissa. + fill68: qualsiasi testo. Manda a capo il testo per farlo stare in 68 colonne. Questo filtro è utile da applicare prima di combinarlo con il filtro tabindent, se volete che il testo non esca dai bordi di una finestra di 80 colonne con caratteri a spaziatura fissa. fill76: qualsiasi testo. Manda a capo il testo per farlo stare in 76 colonne. @@ -168,9 +168,9 @@ isodate: parola chiave date. Rappresenta una data come stringa di testo in formato ISO 8601. Produce una stringa come 2006-09-04 15:13:13 -0700. - obfuscate: qualsiasi testo, ma utile soprattutto per la parola chiave author. Riproduce il testo in ingresso rappresentandolo come una sequenza di entità XML. Questo è utile per battere alcuni #spambot# particolarmente stupidi che effettuano lo #screen-scraping# per raccogliere indirizzi email. - - person: qualsiasi testo, ma utili soprattutto per la parola chiave author. Produce il testo prima di un indirizzo email. Per esempio, Bryan O'Sullivan <bos@serpentine.com> diventa Bryan O'Sullivan. + obfuscate: qualsiasi testo, ma utile soprattutto per la parola chiave author. Riproduce il testo in ingresso rappresentandolo come una sequenza di entità XML. Questo è utile per impedire ad alcuni programmi particolarmente stupidi utilizzati dagli spammer per raccogliere indirizzi email di copiare i dati destinati a essere visualizzati su schermo. + + person: qualsiasi testo, ma utile soprattutto per la parola chiave author. Produce il testo prima di un indirizzo email. Per esempio, Bryan O'Sullivan <bos@serpentine.com> diventa Bryan O'Sullivan. rfc822date: parola chiave date. Rappresenta una data usando lo stesso formato impiegato nelle intestazioni email. Produce una stringa come Mon, 04 Sep 2006 15:13:13 -0700. @@ -191,28 +191,28 @@ &interaction.template.simple.manyfilters; - Se provate ad applicare un filtro a un frammeto di dati che non può elaborare, Mercurial fallirà e stamperà una eccezione Python. Per esempio, provare a utilizzare l'output della parola chiave desc con il filtro isodate non è una buona idea. + Se provate ad applicare un filtro a un frammento di dati che non può elaborare, Mercurial fallirà e stamperà un'eccezione Python. Per esempio, non è una buona idea provare a utilizzare l'output della parola chiave desc con il filtro isodate. Combinare i filtri - È facile combinare filtri per produrre un output della forma che preferite. La seguente catena di filtri ripulisce una descrizione, poi si assicura che stia tranquillamente in 68 colonne, poi la indenta ulteriormente di 8 caratteri (almeno sui sistemi di tipo Unix, dove una tabulazione è convenzionalmente larga 8 caratteri). + È facile combinare filtri per produrre un testo formattato nel modo che preferite. La seguente catena di filtri ripulisce una descrizione, poi si assicura che stia tranquillamente in 68 colonne, infine la indenta ulteriormente di 8 caratteri (almeno sui sistemi di tipo Unix, dove una tabulazione è convenzionalmente larga 8 caratteri). &interaction.template.simple.combine; - Notate l'uso di \t (un carattere di tabulazione) nel template per forzare la prima riga a essere indentata; questo è necessario dato che tabindent indenta tutte le righe tranne la prima. - - Tenete a mente che l'ordine dei filtri in una catena è significativo. Il primo filtro viene applicato al risultato della parola chiave; il secondo al risultato del primo filtro; e così via. Per esempio, usare fill68|tabindent dà risultati molto diversi da tabindent|fill68. + Notate l'uso di \t (un carattere di tabulazione) nel template per indentare la prima riga, necessario dato che tabindent indenta tutte le righe tranne la prima. + + Tenete a mente che l'ordine dei filtri in una catena è significativo. Il primo filtro viene applicato al risultato della parola chiave, il secondo al risultato del primo filtro, e così via. Per esempio, usare fill68|tabindent dà risultati molto diversi da tabindent|fill68. - Dai template agil stili - - Un template a riga di comando fornisce un modo veloce e semplice per formattare un certo output. I template possono diventare prolissi, però, e quindi è utile essere in grado di dare un nome a un template. Un file di stile è un template con un nome, memorizzato in un file. - - Più di questo, usare un file di stile sblocca la potenza del motore di template di Mercurial in modi che non sono possibili usando l'opzione a riga di comando. + Dai template agli stili + + Un template a riga di comando fornisce un modo veloce e semplice per formattare il risultato di un certo comando. Ma i template possono diventare prolissi, quindi è utile essere in grado di dare un nome a un template. Un file di stile è un template con un nome, memorizzato in un file. + + Ma soprattutto, l'impiego di un file di stile sfrutta la potenza del motore di template di Mercurial in modi che non sono possibili usando l'opzione a riga di comando. Il più semplice dei file di stile @@ -238,13 +238,13 @@ Se una riga comincia con un carattere # o ;, l'intera riga viene trattata come un commento e saltata come se fosse vuota. - Una riga comincia con una parola chiave, che deve cominciare con un carattere alfabetico o di sottolineatura e può contenere successivamente qualsiasi carattere alfanumerico o di sottolineatura. (Nella notazione per le espressioni regolari, una parola chiave deve corrispondere a [A-Za-z_][A-Za-z0-9_]*.) + Una riga comincia con una parola chiave, che deve iniziare con un carattere alfabetico o di sottolineatura e successivamente può contenere qualsiasi carattere alfanumerico o di sottolineatura. (Nella notazione per le espressioni regolari, una parola chiave deve corrispondere a [A-Za-z_][A-Za-z0-9_]*.) L'elemento successivo deve essere un carattere =, che può essere preceduto o seguito da una quantità arbitraria di spazio bianco. - Se il resto della riga comincia e finisce con caratteri di apice o virgolette corrispondenti, viene trattato come il corpo di un template. - - Se il resto della riga non comincia con caratteri di apice o virgolette, è trattato come il nome di un file i cui contenuti verranno letti e usati come il corpo di un template. + Se il resto della riga comincia e finisce con caratteri corrispettivi di apice o di virgolette, viene trattato come il corpo di un template. + + Se il resto della riga non comincia con caratteri di apice o di virgolette, viene trattato come il nome di un file i cui contenuti saranno letti e usati come il corpo di un template. @@ -252,26 +252,26 @@ Esempi di file di stile - Per illustrare come scrivere un file di stile, ne costruiremo alcuni esempi. Piuttosto che fornire un file di stile completo e camminarci attraverso, replicheremo il classico processo di sviluppo di un file di stile cominciando con qualcosa di molto semplice e cammninando attraverso una serie di esempi successivi più completi. + Per illustrare come scrivere un file di stile, ne costruiremo alcuni esempi. Piuttosto che fornire un file di stile completo e ripercorrerlo passo per passo, replicheremo il classico processo di sviluppo di un file di stile cominciando con qualcosa di molto semplice e proseguendo attraverso una serie di esempi successivi più completi. Identificare errori in un file di stile - Se Mercurial incontra un problema in un file di stile su cui state lavorando, stampa uno stringato messaggio di errore che, una volta che avete scoperto cosa significa, è in effetti piuttosto utile. + Se Mercurial incontra un problema in un file di stile su cui state lavorando, stampa uno stringato messaggio di errore che si rivela in effetti piuttosto utile una volta scoperto cosa significa. &interaction.template.svnstyle.syntax.input; - Notate che broken.style tenta di definire una parola chiave changeset, ma dimentica di darle un qualsiasi contenuto. Quando gli si chiede di usare questo file di stile, Mercurial si lamenta prontamente. + Notate che broken.style tenta di definire una parola chiave changeset, ma dimentica di darle un contenuto qualsiasi. Quando gli si chiede di usare questo file di stile, Mercurial si lamenta prontamente. &interaction.template.svnstyle.syntax.error; Questo messaggio di errore sembra minaccioso, ma non è troppo difficile da seguire. - Il primo componente è semplicemente il modo che Mercurial ha di dire gliela dò su. + Il primo componente è semplicemente il modo in cui Mercurial dice rinuncio. ___abort___: broken.style:1: parse error - Successivamente arriva il nome del file di stile che contiene l'errore. + Subito dopo, trovate il nome del file di stile che contiene l'errore. abort: ___broken.style___:1: parse error Il nome del file è seguito dal numero di riga dove l'errore è stato incontrato. @@ -280,7 +280,7 @@ Infine, viene fornita una descrizione di quello che è andato storto. abort: broken.style:1: ___parse error___ - La descrizione del problema non è sempre chiara (come in questo caso), ma anche quando è criptica, è quasi sempre elementare inspezionare visivamente la riga del file di stile che contiene il problema e vedere cosa c'è di sbagliato. + La descrizione del problema non è sempre chiara (come in questo caso), ma anche quando è criptica, è quasi sempre banale trovare cosa c'è di sbagliato inspezionando visivamente la riga del file di stile che contiene il problema. @@ -292,17 +292,17 @@ &interaction.template.svnstyle.id; - È molto probabile che questo identificatore siaunico, quindi si rivela utile in molti casi. Ci sono alcune avvertenze. - - Non funzionerà in un repository completamente vuoto, perché un tale repository non possiede la revisione zero. - - Non funzionerà nemmeno nel caso (estremamente raro) in cui un repository è l'unione di due o più repository precedentemente indipendenti che avete ancora in giro da qualche parte. + È molto probabile che questo identificatore sia unico, quindi si rivela utile in molti casi. Ci sono alcune avvertenze. + + Questa tecnica non funzionerà in un repository completamente vuoto, perché un tale repository non possiede la revisione zero. + + Questa tecnica non funzionerà nemmeno nel caso (estremamente raro) in cui un repository sia l'unione di due o più repository precedentemente indipendenti e quei repository siano ancora nei paraggi. Ecco alcuni usi che potete fare di questo identificatore: - come chiave nella tabella di un datavase che gestisce i repository presenti su un server. - - come metà di una tupla {identificatore di repository, identificatore di revisione}. Salvate questa informazione da qualche parte quando esguite un assemblaggio automatico o un'altra attività simile, in modo che possiate rieseguire l'assemblaggio in seguito se necessario. + come chiave nella tabella di un database che gestisce i repository presenti su un server. + + come metà di una tupla {identificatore di repository, identificatore di revisione}. Salvate questa informazione da qualche parte quando esguite un assemblaggio automatico o un'altra attività simile, in modo che possiate rieseguire lo stesso assemblaggio in seguito se necessario. @@ -310,35 +310,35 @@ Elencare file su più righe - Supponete di voler elencare i file modificati da un changeset uno per riga, con una piccola indentazione prima di ogni nome di file. + Supponete di voler elencare i file modificati da un changeset uno per riga, aggiungendo una piccola indentazione prima di ogni nome di file. &interaction.ch10-multiline.go; - Imitare l'output di Subversion - - Proviamo a emulare il formato di output predefinito usato da un altro strumento di controllo di revisione, Subversion. + Imitare i messaggi di Subversion + + Proviamo a emulare il formato predefinito usato da un altro strumento di controllo di revisione, Subversion, per mostrare le voci del proprio registro. &interaction.template.svnstyle.short; - Dato che lo stile di output di Subversion è abbastanza semplice, è facile copiare e incollare un pezzo del suo output in un file e rimpiazzare il testo prodotto da Subversion con i valori di template che vorremmo vedere espansi. + Dato che lo stile della rappresentazione di Subversion è abbastanza semplice, è facile copiare e incollare una parte dei suoi messaggi in un file e rimpiazzare il testo prodotto da Subversion con i valori di template che vorremmo vedere espansi. &interaction.template.svnstyle.template; - Ci sono alcuni modi in cui questo template si discosta dall'output prodotto da Subversion. - - Subversion stampa una data leggibile (il Wed, 27 Sep 2006 nel risultato dell'esempio precedente) tra parentesi. Il motore di template di Mercurial non fornisce un modo per visualizzare una data in questo formato senza stampare anche l'orario e la zona temporale. - - Emuliamo la stampa da parte di Subversion di righe separatrici piene di caratteri - concludendo il template con una riga di quel tipo. Usiamo la parola chiave header del motore di template per stampare una riga separatrice come la prima riga di output (vedete più avanti), quindi ottenendo un output simile a quello di Subversion. - - L'output di Subversion include nell'intestazione il conteggio del numero di righe del messaggio di commit. Non possiamo replicare questa caratteristica in Mercurial, poiché attualmente il motore di template non fornisce un filtro che conti il numero di righe generate dal template. + Ci sono alcuni modi in cui questo template si discosta dalla presentazione prodotta da Subversion. + + Subversion stampa una data leggibile (il Wed, 27 Sep 2006 nel risultato dell'esempio precedente) tra parentesi. Il motore di template di Mercurial non fornisce un modo per visualizzare una data in questo formato senza stampare anche l'ora e il fuso orario. + + Emuliamo la stampa di righe separatrici piene di caratteri - da parte di Subversion concludendo il template con una riga di quel tipo. Usiamo la parola chiave header del motore di template per stampare una riga separatrice come prima riga (vedete più avanti), quindi ottenendo un risultato simile a quello di Subversion. + + Il formato di Subversion include nell'intestazione il conteggio del numero di righe del messaggio di commit. Non possiamo replicare questa caratteristica in Mercurial, poiché attualmente il motore di template non fornisce un filtro che conti il numero di righe generate dal template. - Non mi ci sono voluti più di uno o due minuti di lavoro per sostituire il testo letterale da un esempio dell'output di Subversion con alcune parole chiave e alcuni filtri per ottenere il template appena visto. Il file di stile fa semplicemente riferimento al template. + Non mi ci sono voluti più di uno o due minuti di lavoro per sostituire il testo letterale di un esempio del messaggio di Subversion con alcune parole chiave e alcuni filtri per ottenere il template appena visto. Il file di stile fa semplicemente riferimento al template. &interaction.template.svnstyle.style; - Avremmo potuto includere il testo del file di template direttamente nel file di stile, circondandolo con virgolette e rimpiazzando le nuove righe con sequenze \n, ma questo avrebbe reso il file di stile troppo difficile da leggere. La leggibilità è una buona guida quando state cercando di decidere se un certo testo appartiene a un file di stile o a un file di template a cui il file di stile fa riferimento. Nel caso il file di stile vi sembrasse troppo grande o disordinato se inserite un frammento letterale di testo, spostatelo invece in un template. + Avremmo potuto includere il testo del file di template direttamente nel file di stile, circondandolo con virgolette e rimpiazzando le nuove righe con sequenze \n, ma questo avrebbe reso il file di stile troppo difficile da leggere. La leggibilità è una buon criterio da cui farsi guidare per decidere se un certo testo appartiene a un file di stile o a un file di template a cui il file di stile fa riferimento. Nel caso il file di stile vi sembri troppo grande o disordinato se inserite un frammento letterale di testo, allora spostate il testo in un template.