|
|
Line 1: |
Line 1: |
| = Come revisionare =
| | #REDIRECT [[it_IT/How to review documentation]] |
| | |
| Sei interessato a revisionare un documento in fase di lavorazione?
| |
| | |
| | |
| | |
| {{Anchor|ReviewingaWiki-basedDocument}}
| |
| == Revisionare un documento basato sulla wiki ==
| |
| | |
| 1. I documenti in Bozza si trovano sotto il namespace [[Docs/Drafts| Docs/Drafts]] .
| |
| 1. Se non si vuole creare un account Wiki, spedisci i tuoi commenti all'autore(i), i cui nomi appaiono in cima al documento in bozza. In alternativa, puoi spedire i commenti alla [http://www.redhat.com/mailman/listinfo/fedora-docs-list fedora-docs-list] .
| |
| 1. Per creare un account Wiki per editare, leggi [[WikiEditing| WikiEditing]] .
| |
| 1. Fa i cambiamenti o aggiungi blocchi di commento direttamente nelle pagine Wiki, in piccoli incrementi, affinchè l'autore della pagina possa avere la possibilità di revisionare e commentare i tuoi cambiamenti.
| |
| 1. Opzionalmente, copiate il documento in bozza o una pagina specifica sotto il namespace del vostro UserName. Ad esempio, utente FooBar copia Docs/Drafts/DesktopUserGuide/Introduction in FooBar/Drafts/DesktopUserGuide/Introduction. Questa pagina sarà usata per la dimostrazione all'autore ed alla fedora-docs-list.
| |
| | |
| {{Anchor|ReviewingaDocumentinCVS}}
| |
| == Revisionare un documento in CVS ==
| |
| | |
| Stiamo lavorando per migliorare i metodi. Nel frattempo, questi sono i modi per revisionare un documento in fase di traduzione dal CVS.
| |
| | |
| {{Anchor|UsingYelp}}
| |
| === Uso di Yelp ===
| |
| | |
| 1. Usare CVS per eseguire il check out del documento:
| |
| <pre>export CVSROOT=:pserver:anonymous@cvs.fedoraproject.org:/cvs/docs
| |
| cvs -z3 login
| |
| cvs -z3 co foo-guide-devel
| |
| </pre>
| |
| 1. Generare un po di files necessari:
| |
| <pre>cd foo-guide-devel/foo-guide
| |
| make validate-xml-en_US
| |
| </pre>
| |
| 1. Usare '''Yelp''', il navigatore di aiuto di GNOME, per visionare il file XML:
| |
| <pre>yelp en_US/foo-guide.xml &
| |
| </pre>
| |
| | |
| Ad esempio, quando si revisiona la ''Fedora Installation Guide'':
| |
| | |
| <pre>export CVSROOT=:pserver:anonymous@cvs.fedoraproject.org:/cvs/docs
| |
| cvs -z3 login
| |
| cvs -z3 co install-guide-devel
| |
| make validate-xml-en_US
| |
| yelp en_US/install-guide.xml &</pre>
| |
| | |
| {{Anchor|BuildingtoHTMLorText}}
| |
| === Compilare in HTML o Testo ===
| |
| | |
| 1. Usare CVS per eseguire il check out del documento:
| |
| <pre>export CVSROOT=:pserver:anonymous@cvs.fedoraproject.org:/cvs/docs
| |
| cvs -z3 login
| |
| cvs -z3 co foo-guide-devel
| |
| </pre>
| |
| 1. Compilare la versione per uno specifico linguaggio:
| |
| <pre>cd foo-guide-devel/foo-guide/
| |
| make html-en_US
| |
| </pre>
| |
| 1. Visualizzare in un navigatore:
| |
| <pre>firefox foo-guide-en_US/index.html &
| |
| </pre>
| |
| 1. In alternativa, compilare in formato testo e visualizzare in un editor di testo:
| |
| <pre>cd foo-guide-devel/foo-guide/
| |
| make text-en_US
| |
| emacs foo-guide-en_US.txt &</pre>
| |