R: Indentazione

Federico Nebiacolombo federico.nebiacolombo at softeco.it
Tue Nov 28 10:33:53 CST 2006


In effetti nel file HACKING.txt della versione in inglese si legge
di utilizzare un'indenzazione adeguate (in coda a questa mail ho riportato
uno stralcio)
Onestamente penso che sia eccessivo darsi una regola in termini di colonne
alle quali
effettuare ritorni a capo (col. 77?), mentre propongo di:

- Cercare di mantenere un'indentazione che 'permetta una buona leggibilita'
- Effettuare indentazioni tramite spazi.

Cosa ne dite?

Teniamo presente, che, come noto, la formttazione del testo xml NON ha
impatto (per fortuna:-)
sul layout HTML o PDF.

saluti
Nebiac

"

- All markup should be properly indented, with the exception of
  <screen></screen> blocks, which should be aligned all the way to the
  left. For example:

<chapter id="svn-ch-pi">
<title>Tips</title>

  <!-- ================================================================= -->
  <!-- ======================== SECTION 1 ============================== -->
  <!-- ================================================================= -->
  <sect1 id="svn-ch-pi-sect-1">
    <title>Flornthorple Plathering</title>

    <para>The real key to <firstterm>Plathering</firstterm> is to start with
       a good glab. A good glab provides a solid thorpy foundation.</para>

    <sect2 id="svn-ch-pi-sect-1.1">
      <title>Cross-blather</title>

      <para>Cross-blather tends to create a hoopy pile of crandy. You
        can avoid this by using the cross-blather avoid
        command.</para>

      <screen>
$ cb-avoid
Avoiding blather......... Done
$
</screen> <!-- Note the closing tag at the left-most column? -->

    </sect2>

  </sect1>

</chapter>
"

> -----Messaggio originale-----
> Da: svn-it-bounces at red-bean.com [mailto:svn-it-bounces at red-bean.com]Per
> conto di Alessandro Rossini
> Inviato: Tuesday, November 28, 2006 16:54
> A: svn-it at red-bean.com
> Oggetto: Indentazione
>
>
> Verificando i capitoli 2 e 3 ho notato che ognuno sembra usare i propri
> criteri di indentazione e ritorno a capo.
> Io ad esempio indento con spazi e ritorno a capo alla colonna 77,
> allineandomi
> alla versione originale. Sarebbe comodo, anche per evitare di
> fare modifiche
> eccessive in fase di validazione, che si adottasse una
> convenzione comune.
> Immagino che queste regole siano comunque definite da qualche
> parte per la
> versione inglese del libro, basterebbe tradurle ed inserirle
> nell'Howto-translate.txt.
>
> Fatemi sapere.
> --
> Alessandro 'Aronnax' Rossini
> ----------------------------
> web -> www.aronnax.it
> e-mail -> aronnax at openlug.org
> ZeroNotice IT Solutions -> www.zeronotice.com
>
> _______________________________________________
> svn-it mailing list
> svn-it at red-bean.com
> http://www.red-bean.com/mailman/listinfo/svn-it
>
>







More information about the svn-it mailing list