WikiPages/it: Difference between revisions
No edit summary |
No edit summary |
||
(73 intermediate revisions by the same user not shown) | |||
Line 142: | Line 142: | ||
* Un'immagine per illustrarne la descrizione. |
* Un'immagine per illustrarne la descrizione. |
||
Vedere [[#Screen_capture|# |
Vedere [[#Screen_capture|#Istantanee dello schermo]] per le convenzioni su come inserire le immagini. |
||
<span id="Command_pages"></span> |
<span id="Command_pages"></span> |
||
Line 185: | Line 185: | ||
|-- |
|-- |
||
|[[Template:Emphasis| |
|[[Template:Emphasis|Emphasis]] |
||
|{{Emphasis| |
|{{Emphasis|emphasis}} |
||
|Utilizzato per enfatizzare una parte di testo. |
|Utilizzato per enfatizzare una parte di testo. |
||
Line 257: | Line 257: | ||
|[[Template:SystemOutput|SystemOutput]] |
|[[Template:SystemOutput|SystemOutput]] |
||
|{{SystemOutput|Output text}} |
|{{SystemOutput|Output text}} |
||
| |
|Utilizzato per indicare l'output di testo dal sistema. |
||
|-- |
|-- |
||
|[[Template:Incode|Incode]] |
|[[Template:Incode|Incode]] |
||
|{{incode|import FreeCAD}} |
|{{incode|import FreeCAD}} |
||
| |
|Utilizzato per includere il codice sorgente in linea con un carattere a spaziatura fissa. Dovrebbe stare in una riga. |
||
|-- |
|-- |
||
|[[Template:PropertyView|PropertyView]] |
|[[Template:PropertyView|PropertyView]] |
||
|{{PropertyView|Color}} |
|{{PropertyView|Color}} |
||
| |
|Utilizzato per indicare una proprietà View nell'[[Property_editor/it|editor delle proprietà]]. Esempi di proprietà di visualizzazione includono {{emphasis|Line Color}}, {{emphasis|Line Width}}, {{emphasis|Point Color}}, {{emphasis|Point Size}}, ecc.. |
||
|-- |
|-- |
||
|[[Template:PropertyData|PropertyData]] |
|[[Template:PropertyData|PropertyData]] |
||
|{{PropertyData|Position}} |
|{{PropertyData|Position}} |
||
| |
|Utilizzato per indicare una proprietà Data nell'[[Property_editor/it|editor delle proprietà]]. Le proprietà dei dati sono diverse per i diversi tipi di oggetti. |
||
|-- |
|-- |
||
|[[Template:Properties Title|Properties Title]] / [[Template:TitleProperty|TitleProperty]] |
|[[Template:Properties Title|Properties Title]] / [[Template:TitleProperty|TitleProperty]] |
||
|{{Properties_Title|Base}} |
|{{Properties_Title|Base}} |
||
| |
|Utilizzato per indicare il titolo di un gruppo di proprietà nell'[[Property_editor/it|editor delle proprietà]]. Il titolo non verrà incluso nel sommario automatico. |
||
|-- |
|-- |
||
Line 304: | Line 304: | ||
|Questo modello è utilizzato per colorare lo sfondo, il testo o lo sfondo e il testo. (Pagina [[Template:ColoredText|ColoredText]] per ulteriori esempi) |
|Questo modello è utilizzato per colorare lo sfondo, il testo o lo sfondo e il testo. (Pagina [[Template:ColoredText|ColoredText]] per ulteriori esempi) |
||
<div class="mw-translate-fuzzy"> |
|||
|-- |
|-- |
||
|[[Template:ColoredParagraph|ColoredParagraph]] |
|[[Template:ColoredParagraph|ColoredParagraph]] |
||
Line 310: | Line 309: | ||
|Questo modello è utilizzato per colorare lo sfondo, il testo o lo sfondo e il testo di un intero paragrafo. (Pagina [[Template:ColoredParagraph|ColoredParagraph]] per ulteriori esempi) |
|Questo modello è utilizzato per colorare lo sfondo, il testo o lo sfondo e il testo di un intero paragrafo. (Pagina [[Template:ColoredParagraph|ColoredParagraph]] per ulteriori esempi) |
||
|} |
|} |
||
</div> |
|||
<span id="Complex_templates"></span> |
<span id="Complex_templates"></span> |
||
Line 330: | Line 328: | ||
|[[Template:Caption|Caption]] |
|[[Template:Caption|Caption]] |
||
|<div style="width:400px;">{{Caption|Some caption for an image}}</div> |
|<div style="width:400px;">{{Caption|Some caption for an image}}</div> |
||
|Utilizzato per aggiungere una didascalia sotto un'immagine. Può essere allineato a sinistra o al centro. |
|||
|Use it to add an explanation below an image. It can be left aligned or center aligned. |
|||
|-- |
|-- |
||
|[[Template:Clear|Clear]] |
|[[Template:Clear|Clear]] |
||
| |
| |
||
|Utilizato per cancellare le colonne. Seguire la definizione del modello per una spiegazione dettagliata. Viene spesso utilizzato per impedire al testo di scorrere accanto a immagini non correlate. |
|||
|Use it to clear columns. Follow the definition of the template for a detailed explanation. It is often used to stop text from flowing next to unrelated images. |
|||
|-- |
|-- |
||
|[[Template:Code|Code]] |
|[[Template:Code|Code]] |
||
|{{Code|code=import FreeCAD}} |
|{{Code|code=import FreeCAD}} |
||
|Utilizzato per includere esempi di codice su più righe con un carattere a spaziatura fissa. Il linguaggio predefinito è Python, ma è possibile specificare altri linguaggi. |
|||
|Use it to include multi-line code examples with a monospace font. The default language is Python, but other languages can be specified. |
|||
[[Python|Python]] |
Il codice [[Python/it|Python]] deve aderire alle raccomandazioni generali stabilite da [https://www.python.org/dev/peps/pep-0008/ PEP8: Style Guide for Python Code]. In particolare, le parentesi dovrebbero seguire immediatamente il nome della funzione e uno spazio dovrebbe seguire una virgola. Ciò rende il codice più leggibile. |
||
|-- |
|-- |
||
|[[Template:CodeDownload|CodeDownload]] |
|[[Template:CodeDownload|CodeDownload]] |
||
|{{CodeDownload|https://wiki.freecad.org/Main_Page|Some label}} |
|{{CodeDownload|https://wiki.freecad.org/Main_Page|Some label}} |
||
| |
|Utilizzato per creare un collegamento su una pagina di una [[Macros/it|macro]]. |
||
|-- |
|-- |
||
|[[Template:Codeextralink|Codeextralink]] |
|[[Template:Codeextralink|Codeextralink]] |
||
|{{Codeextralink|https://wiki.freecad.org/Main_Page}} |
|{{Codeextralink|https://wiki.freecad.org/Main_Page}} |
||
| |
|Utilizzato se il codice di una [[Macro/it|macro]] è troppo grande per essere ospitato sul Wiki. Il codice può quindi essere ospitato da qualche altra parte e il collegamento non elaborato ad esso può essere specificato con questo modello. [[Std_AddonMgr/it|Addon Manager]] utilizzerà questo collegamento. |
||
|-- |
|-- |
||
|[[Template:Fake heading|Fake heading]] |
|[[Template:Fake heading|Fake heading]] |
||
|{{Fake heading|Heading|2}} |
|{{Fake heading|Heading|2}} |
||
|Utilizzato per creare un'intestazione che non verrà inclusa automaticamente nel sommario. |
|||
|Use it to create a heading that will not be automatically included in the table of contents. |
|||
|-- |
|-- |
||
|[[Template:GuiCommand|GuiCommand]] |
|[[Template:GuiCommand|GuiCommand]] |
||
|See [[GuiCommand model|GuiCommand model]] |
|See [[GuiCommand model|GuiCommand model]] |
||
|Utilizzato per creare un riquadro con informazioni utili per documentare i comandi dell'ambiente di lavoro (strumenti). |
|||
|Use it to create a box with useful information to document workbench commands (tools). |
|||
|-- |
|-- |
||
|[[Template:TutorialInfo|TutorialInfo]] |
|[[Template:TutorialInfo|TutorialInfo]] |
||
|See for example [[Basic_modeling_tutorial|Basic modeling tutorial]] |
|See for example [[Basic_modeling_tutorial|Basic modeling tutorial]] |
||
| |
|Utilizzato per creare un box con informazioni utili per documentare i [[Tutorials/it|tutorial]]. |
||
|-- |
|-- |
||
|[[Template:Macro|Macro]] |
|[[Template:Macro|Macro]] |
||
|See for example [[Macro_FlattenWire|Macro FlattenWire]] |
|See for example [[Macro_FlattenWire|Macro FlattenWire]] |
||
|Utilizzato per creare un box con informazioni utili per documentare le [[Macros/it|macro]]. |
|||
|Use it to create a box with useful information to document [[macros|macros]]. |
|||
|-- |
|-- |
||
|[[Template:Docnav|Docnav]] |
|[[Template:Docnav|Docnav]] |
||
|{{Docnav|Online Help Startpage|Feature list}} |
|{{Docnav|Online Help Startpage|Feature list}} |
||
|Utilizzato per creare una barra con frecce e collegamenti appropriati, adatto a disporre le pagine in una sequenza particolare. |
|||
|Use it to create a bar with arrows and appropriate links, which is useful for putting pages in a particular sequence. |
|||
|-- |
|-- |
||
|[[Template:VeryImportantMessage|VeryImportantMessage]] |
|[[Template:VeryImportantMessage|VeryImportantMessage]] |
||
|{{VeryImportantMessage|Important Message}} |
|{{VeryImportantMessage|Important Message}} |
||
|Utilizzato per creare una casella evidenziata con un messaggio molto importante. Utilizzare con parsimonia, solo per indicare gravi problemi nella funzionalità del software, interruzione degli strumenti e cose simili. |
|||
|Use it to create a highlighted box with a very important message. Use sparingly, only to indicate major problems in the functionality of the software, discontinuation of tools, and similar. |
|||
|-- |
|-- |
||
|[[Template:Page in progress|Page in progress]] |
|[[Template:Page in progress|Page in progress]] |
||
|{{Page in progress|Page in progress}} |
|{{Page in progress|Page in progress}} |
||
|Utilizzato per le pagine che sono ancora in elaborazione o che sono attualmente in fase di rielaborazione. Non dimenticarsi di rimuoverlo quando la pagina è completata. |
|||
|Use this for pages that are still in progress or that are currently being reworked. Don't forget to remove this when the page is ready. |
|||
|-- |
|-- |
||
|[[Template:UnfinishedDocu|UnfinishedDocu]] |
|[[Template:UnfinishedDocu|UnfinishedDocu]] |
||
|{{UnfinishedDocu}} |
|{{UnfinishedDocu}} |
||
|Utilizzato per creare una casella evidenziata che indica una pagina di documentazione incompleta. |
|||
|Use it to create a highlighted box indicating an unfinished documentation page. |
|||
|-- |
|-- |
||
|[[Template:Softredirect|Softredirect]] |
|[[Template:Softredirect|Softredirect]] |
||
| |
| |
||
|Utilizzato al posto del reindirizzamento normale, quando si sta reindirizzando a una pagina speciale (come Media: o Categoria:), nei quali casi il reindirizzamento normale è disabilitato. |
|||
|Use it instead of the normal redirect, when you are redirecting to a special page (such as Media: or Category:), in which cases the normal redirect is disabled. |
|||
|-- |
|-- |
||
|[[Template:Quote|Quote]] |
|[[Template:Quote|Quote]] |
||
|{{Quote|text=Cry "Havoc" and let slip the dogs of war.|sign=William Shakespeare|source=''Julius Caesar'', act III, scene I}} |
|{{Quote|text=Cry "Havoc" and let slip the dogs of war.|sign=William Shakespeare|source=''Julius Caesar'', act III, scene I}} |
||
|Utilizzato per creare una casella di testo con una citazione letterale e un riferimento. |
|||
|Use it to create a box of text with a literal quote and reference. |
|||
|-- |
|-- |
||
|[[Template:Userdocnavi|Userdocnavi]], [[Template:Powerdocnavi|Powerdocnavi]] |
|[[Template:Userdocnavi|Userdocnavi]], [[Template:Powerdocnavi|Powerdocnavi]] |
||
| |
| |
||
|Utilizzati per creare caselle di navigazione per la documentazione per l'utente, la documentazione per utenti esperti e la documentazione per sviluppatori. Ciò consente di saltare rapidamente tra le diverse sezioni della documentazione. Inoltre inseriscono la pagina corrispondente nella categoria corretta. |
|||
|Use them to create navigation boxes for the user documentation, the power user documentation, and the developer documentation. This allows quickly jumping between different sections of the documentation. They also place the corresponding page in the proper category. |
|||
|} |
|} |
||
Line 415: | Line 413: | ||
<div class="mw-collapsible mw-collapsed toccolours"> |
<div class="mw-collapsible mw-collapsed toccolours"> |
||
= |
<span id="Graphics"></span> |
||
== Grafica == |
|||
<div class="mw-collapsible-content"> |
<div class="mw-collapsible-content"> |
||
Immagini e screenshot sono necessari per produrre una documentazione completa di FreeCAD. Sono particolarmente utili per illustrare esempi e tutorial. Le immagini devono essere mostrate nella loro dimensione originale, in modo che presentino dettagli sufficienti e siano leggibili se includono testo. Le immagini [[bitmap/it|Bitmap]] non devono essere ridimensionate. |
|||
Images and screenshots are necessary to produce a complete documentation of FreeCAD. They are particularly useful to illustrate examples and tutorials. Images should be shown in their original size, so they present sufficient detail and are readable if they include text. [[bitmap|Bitmap]] images should not be resized. |
|||
Evitare le immagini animate (GIF) nelle pagine generiche di aiuto. Le animazioni e i video devono essere riservati ai tutorial non destinati a essere utilizzati come documentazione PDF offline. |
|||
Avoid animated pictures (GIF) in the general help pages. Animations and videos should be reserved for tutorials not intended to be used as offline PDF documentation. |
|||
Le immagini possono essere caricate tramite la pagina [[Special:Upload/it|Special:Upload]]. |
|||
<span id="Name"></span> |
|||
=== Name === |
|||
=== Nome === |
|||
Dare nomi significativi alle proprie immagini. Se si ha un'immagine che mostra le caratteristiche di un particolare comando, si dovrebbe usare il nome di quel comando con {{incode|_example}} alla fine. Ad esempio per il comando [[Draft_Offset/it|Draft Offset]] l'immagine dovrebbe essere chiamata {{incode|Draft_Offset_example.png}}. |
|||
<span id="Screen_capture"></span> |
|||
=== Screen capture === |
|||
=== Istantanee dello schermo === |
|||
Le dimensioni consigliate per le istantanee dello schermo sono: |
|||
Recommended sizes for screen captures are: |
|||
* |
* Nativo 400x200 (o larghezza=400 e altezza<=200), per le pagine di [[GuiCommand_model/it|riferimento dei comandi]], per consentire all'immagine di adattarsi alla parte sinistra della pagina e per altre istantanee standard. |
||
* |
* Nativo 600x400 (o larghezza=600 e altezza<=400), per le pagine di [[GuiCommand_model|riferimento dei comandi]], quando si ha davvero bisogno di un'immagine più grande e si consente comunque all'immagine di adattarsi alla parte sinistra della pagina e per altre istantanee standard. |
||
* |
* 1024x768 nativo (o larghezza=1024 e altezza<=768), solo per immagini a schermo intero. |
||
*Sono possibili taglie più piccole quando si mostrano i dettagli. |
|||
* Smaller sizes are possible when showing details. |
|||
* Evitare immagini con risoluzioni maggiori, poiché non saranno molto trasferibili su altri tipi di display o sulla documentazione PDF stampata. |
|||
* Avoid images with larger resolutions, as they won't be very portable to other kinds of displays or the printed PDF documentation. |
|||
Non si dovrebbe dipendere da una configurazione personalizzata del proprio desktop o sistema operativo quando si creano schermate e si dovrebbero utilizzare le impostazioni visive predefinite dell'interfaccia di FreeCAD quando possibile. |
|||
You shouldn't depend on a custom configuration of your desktop or operating system when you create screenshots and you should use the visual defaults of the FreeCAD interface whenever possible. |
|||
Per creare uno screenshot si possono utilizzare le opzioni fornite dal proprio sistema operativo, oppure una di queste macro: [[Image:Snip.png|24px]] [[Macro_Snip/it|Macro Snip]] e [[Image:Macro_Screen_Wiki.png|24px ]] [[Macro_Screen_Wiki/it|Macro Screen Wiki]]. |
|||
<span id="Text"></span> |
|||
=== Text === |
|||
=== Testo === |
|||
Per facilitare le traduzioni della documentazione, cercare di evitare screenshot che contengono testo. Se non lo si può evitare, prendere in considerazione l'idea di acquisire screenshot separati dell'interfaccia e della [[3D_view/it|Vista 3D]]. L'immagine della vista 3D può essere riutilizzata in ogni traduzione, mentre un traduttore può, se necessario, acquisire uno screenshot dell'interfaccia localizzata. |
|||
To ease documentation translations, try to avoid screenshots that contain texts. If you cannot avoid this, consider taking separate screenshots of the interface and the [[3D_view|3D view]]. The image of the 3D view can be reused in every translation, while a translator can take a screenshot of the localized interface if necessary. |
|||
<span id="Icons_and_graphics"></span> |
|||
=== Icons and graphics === |
|||
=== Icone e grafica === |
|||
Fare riferimento alla pagina [[Artwork/it|Artwork]] per tutti gli elementi grafici e le icone che sono state create per FreeCAD e che possono essere utilizzate anche nelle pagine di documentazione. Se si desidera contribuire alle icone, leggere le [[Artwork_Guidelines/it|Linee guida per le Artwork]]. |
|||
</div> <!-- end of Graphics collapsible div. Do not remove! --> |
</div> <!-- end of Graphics collapsible div. Do not remove! --> |
||
</div> <!-- end of Graphics collapsible div. Do not remove! --> |
</div> <!-- end of Graphics collapsible div. Do not remove! --> |
||
Line 452: | Line 455: | ||
<div class="mw-collapsible mw-collapsed toccolours"> |
<div class="mw-collapsible mw-collapsed toccolours"> |
||
= |
<span id="Translations"></span> |
||
== Traduzioni == |
|||
<div class="mw-collapsible-content"> |
<div class="mw-collapsible-content"> |
||
Per consenso generale, la pagina di riferimento nel wiki è la pagina in inglese, che dovrebbe venire creata per prima. Se si desidera modificare o aggiungere contenuto a una pagina, si dovrebbe farlo prima sulla pagina inglese e, solo una volta completato l'aggiornamento, trasferire la modifica sulla pagina tradotta. |
|||
As per general consensus, the reference page in the wiki is the English page, which should be created first. If you want to change or add content to a page, you should do it to the English page first, and only once the update is completed, port the modification to the translated page. |
|||
Il wiki di FreeCAD supporta un'estensione di traduzione che consente di gestire più facilmente le traduzioni tra le pagine; per i dettagli, vedere [[Localisation/it#Tradurre_il_wiki|Tradurre il wiki]]. |
|||
Altre risorse utili sono: |
|||
Other useful resources are: |
|||
* [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO language codes] |
* [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO language codes] per identificare il codice di due lettere per una particolare lingua in cui si desidera tradurre. |
||
* [http://translate.google.com/ Google Translate] |
* [http://translate.google.com/ Google Translate] per l'aiuto con le traduzioni. |
||
* [https://www.deepl.com/translator Deepl translator] |
* [https://www.deepl.com/translator Deepl translator] per l'aiuto con le traduzioni. |
||
<span id="Some_tips_for_translators"></span> |
|||
== Some tips for translators == |
|||
== Alcuni consigli per i traduttori == |
|||
<span id="Translate_GuiCommand"></span> |
|||
=== Translate GuiCommand === |
|||
=== Tradurre GuiCommand === |
|||
<pre> |
<pre> |
||
Line 478: | Line 484: | ||
</pre> |
</pre> |
||
Tradotto: |
|||
Translated: |
|||
<pre> |
<pre> |
||
Line 492: | Line 498: | ||
</pre> |
</pre> |
||
<span id="Translate_navi"></span> |
|||
=== Translate navi === |
|||
=== Tradurre navi === |
|||
<pre> |
<pre> |
||
Line 498: | Line 505: | ||
</pre> |
</pre> |
||
Tradotto: |
|||
Translated: |
|||
<pre> |
<pre> |
||
Line 504: | Line 511: | ||
</pre> |
</pre> |
||
<span id="Translate_link"></span> |
|||
=== Translate link === |
|||
=== Tradurre link === |
|||
<pre> |
<pre> |
||
Line 510: | Line 518: | ||
</pre> |
</pre> |
||
Tradotto: |
|||
Translated: |
|||
<pre> |
<pre> |
||
Line 516: | Line 524: | ||
</pre> |
</pre> |
||
<span id="Translate_Docnav"></span> |
|||
=== Translate Docnav === |
|||
=== Tradurre Docnav === |
|||
<pre> |
<pre> |
||
Line 525: | Line 534: | ||
</pre> |
</pre> |
||
Tradotto: |
|||
Translated: |
|||
<pre> |
<pre> |
||
Line 534: | Line 543: | ||
</pre> |
</pre> |
||
Esempio con le icone: |
|||
Example with icons: |
|||
<pre> |
<pre> |
||
Line 547: | Line 556: | ||
</pre> |
</pre> |
||
Tradotto: |
|||
Translated: |
|||
<pre> |
<pre> |
||
Line 563: | Line 572: | ||
</div> <!-- END of Translation section collapsible element. Do not remove! --> |
</div> <!-- END of Translation section collapsible element. Do not remove! --> |
||
<span id="Create,_rename_and_delete_pages"></span> |
|||
== Create, rename and delete pages == |
|||
== Creare, rinominare ed eliminare le pagine == |
|||
<span id="Create_pages"></span> |
|||
=== Create pages === |
|||
=== Creare pagine === |
|||
Prima di creare una nuova pagina si dovrebbe prima verificare se esiste già una pagina simile. In questo caso, di solito è meglio prima modificare la pagina esistente. In caso di dubbi, aprire prima un topic nel [https://forum.freecadweb.org/viewforum.php?f=21 forum delle Wiki]. |
|||
Per creare una nuova pagina, effettuare una delle seguenti operazioni: |
|||
To create a new page do one of the following: |
|||
* |
* Visitare l'URL con il nome della pagina desiderata, ad esempio: <code><nowiki>https://wiki.freecadweb.org/My_New_Page</nowiki></code>, e fare clic su 'create this page'. |
||
* |
* Effettuare una ricerca nel wiki per il nome della pagina e fare clic sul testo in rosso in 'Create the page "My New Page" on this wiki!'. |
||
<span id="Rename_pages"></span> |
|||
=== Rename pages === |
|||
=== Rinominare le pagine === |
|||
Poiché FreeCAD è un progetto in costante sviluppo, a volte è necessario rivedere il contenuto del wiki. Se i nomi dei comandi vengono modificati nel codice sorgente, anche le pagine wiki che li documentano dovranno essere rinominate. Questo può essere fatto solo dagli amministratori del wiki. Per informarli, aprire un argomento nel [https://forum.freecadweb.org/viewforum.php?f=21 Forum delle Wiki] ed elencare l'operazione di ridenominazione necessaria in questo modulo: |
|||
<pre> |
<pre> |
||
Line 584: | Line 596: | ||
</pre> |
</pre> |
||
<span id="Delete_files_and_pages"></span> |
|||
=== Delete files and pages === |
|||
=== Eliminare file e pagine === |
|||
Nel caso in cui sia necessario eliminare un file, andare alla relativa pagina (<code><nowiki>https://www.freecadweb.org/wiki/File:***.***</nowiki></code>) e modificarlo. Non importa se la pagina è vuota o meno, aggiungere quanto segue come primo elemento: <code><nowiki>{{Delete}}</nowiki></code> e direttamente sotto descrivere il motivo per cui la pagina dovrebbe essere eliminata. Inoltre, aprire un topic nel [https://forum.freecadweb.org/viewforum.php?f=21 Forum delle Wiki]. |
|||
Per le pagine la procedura è la stessa. |
|||
For pages the procedure is the same. |
|||
= |
<span id="Discussion"></span> |
||
== Discussioni == |
|||
Il [http://forum.freecadweb.org/viewforum.php?f=21 Development/Wiki subforum] nel [https://forum.freecadweb.org Forum di FreeCAD] fornisce uno spazio dedicato per discutere argomenti wiki, l'aspetto delle wiki e qualsiasi altra cosa relativa al wiki. Indirizzare lì le proprie domande e i suggerimenti. |
|||
<span id="Terminology_-_naming_policy"></span> |
|||
== Terminology - naming policy == |
|||
== Terminologia - politica di denominazione == |
|||
= |
<span id="English"></span> |
||
=== Inglese === |
|||
Vedere il [[Glossary/it|Glossario]]. |
|||
<span id="Other_languages"></span> |
|||
=== Other languages === |
|||
=== Altre lingue === |
|||
* [[Italian_Translation|Italiano]] |
* [[Italian_Translation|Italiano]] |
Latest revision as of 07:50, 12 May 2024
Questa pagina è un'estensione della pagina Help:Editing e fornisce linee guida comuni per scrivere e aggiornare la documentazione wiki di FreeCAD. Riassume diverse discussioni e sessioni di brainstorming
Prima di iniziare
- Questa documentazione wiki è basata su MediaWiki, lo stesso software con cui è realizzata Wikipedia. Se si ha contribuito a Wikipedia, modificare le pagine wiki di FreeCAD dovrebbe essere facile.
- Contrariamente a Wikipedia, la wiki di FreeCAD è protetta da scrittura per evitare spam. È necessario richiedere un account sul forum.
- Se non si ha mai utilizzato il software wiki prima, leggere Help:Editing per acquisire familiarità con il markup utilizzato.
- Per un utilizzo avanzato del software wiki, vedere MediaWiki Help:Contents. Non tutte le funzionalità di MediaWiki sono disponibili in questo wiki di FreeCAD, ma molte lo sono.
- Si è intenzionati a mantenere la documentazione facile da leggere, quindi si dovrebbe evitare di utilizzare funzionalità complesse. Mantenerlo semplice.
- Utilizzare una sandbox per testare il codice, ad esempio, FreeCADDocu:Sandbox o una pagina personale con il proprio nome Sandbox:Yourname. Le pagine Sandbox devono essere inserite nella categoria Sandbox. Questo viene fatto aggiungendo
[[Category:Sandbox]]
in fondo al codice wiki. - Si prega di fare attenzione alle traduzioni. Il wiki di FreeCAD utilizza il supporto della traduzione automatizzata per fornire pagine in molte lingue. Per ogni pagina possono esistere versioni in più lingue. In molte pagine ci saranno tag come
<translate>...</translate>
e molti tag singoli come<!--T:8-->
. Questi ultimi contrassegnano le cosiddette unità di traduzione e vengono creati dal sistema di traduzione, non andrebbero mai creati manualmente. Collegano i titoli e i paragrafi alle loro versioni tradotte. Non vanno cambiati perché ciò distruggerebbe i collegamenti. È comunque possibile spostare paragrafi o modificare il testo purché i tag rimangano con essi. Se si rimuove un'intestazione o un paragrafo andrebbe rimosso anche il tag che gli appartiene. Tenere presente che le modifiche ai titoli e ai paragrafi esistenti influiscono sulle traduzioni esistenti. Le modifiche dovrebbero valerne la pena. Non preoccuparsi di aggiungere nuovo materiale perché il sistema aggiungerà automaticamente i nuovi tag dopo le modifiche. Per ulteriori informazioni vedere Localizzazione e la Mediawiki:Extension:Translate pagina originale.
Linee guida generali
Descrizioni concise
Quando si descrive FreeCAD si deve cercare di essere concisi e diretti ed evitare ripetizioni. Descrivere cosa fa FreeCAD, non cosa non fa FreeCAD. Evitare anche espressioni colloquiali come "una coppia". Utilizzare "alcuni" quando si ha a che fare con un numero indeterminato o specificare la quantità corretta.
- Descrizione errata
- Ambiente PartDesign: PartDesign è un ambiente di lavoro per la progettazione di parti che mira a fornire strumenti per la modellazione di parti solide complesse.
- Descrizione corretta
- Ambiente PartDesign: mira a fornire strumenti per la modellazione di parti solide complesse.
Informazioni centralizzate
Evitare di duplicare le stesse informazioni in luoghi diversi. Inserire le informazioni in una nuova pagina e collegarsi a questa pagina da altre pagine che richiedono queste informazioni.
Non utilizzare la transclusione delle pagine (Help:Editing#Templates and transclosure pagine), poiché ciò rende difficile la traduzione del wiki. Utilizzare solo i modelli descritti di seguito in #Templates.
Stile
I modelli vengono utilizzati per definire lo stile delle pagine della guida. Conferiscono alla documentazione un aspetto coerente. C'è un modello per i comandi di menu, File → Salva, un modello per definire lo stile dei tasti da premere, Shift, per mostrare un valore booleano, true
, ecc. Per favore acquisire familiarità con la sezione #Templates prima di scrivere pagine di aiuto.
Flag temporanei
Se si sta lavorando su una pagina di grandi dimensioni è consigliabile contrassegnare la pagina come work in progress o come incompiuta. Ciò garantisce che gli amministratori wiki non contrassegnino la tua pagina come pronta per la traduzione mentre la si sta ancora modificando.
Per contrassegnare una pagina, aggiungere come prima linea {{Page in progress}}
o {{UnfinishedDocu}}
. Con {{UnfinishedDocu}}
si invitano gli altri a collaborare per finire la pagina, mentre {{Page in progress}}
indica che si svolgerà il lavoro da solo e che gli altri dovrebbero lasciarti un po' di tempo.
Una volta terminato il lavoro, non dimenticare di rimuovere i flag!
Esempi
Per acquisire rapidamente familiarità con la struttura e lo stile del wiki di FreeCAD, guardare la pagina del modello: modello di base.
Struttura
L'Hub degli utenti fornisce un Sommario. Viene utilizzato come riferimento principale per creare automaticamente la guida offline raggiungibile da FreeCAD, nonché la documentazione PDF offline.
Il Template:Docnav viene utilizzato per collegare in sequenza le pagine, seguendo la struttura del Sommario. Vedere #Templates per un elenco di tutti i modelli.
Nomi delle pagine
I nomi delle pagine dovrebbero essere brevi e dovrebbero usare le maiuscole: ogni parola dovrebbe iniziare con una lettera maiuscola, a meno che non si tratti di articoli, preposizioni, congiunzioni o altre particelle grammaticali (ad esempio 'di', 'su', 'in', 'a ', 'uno', 'e').
- Nome della pagina errato
- Construction of AeroCompany airplanes
- Nome della pagina corretto
- Construction of AeroCompany Airplanes
I nomi delle pagine dell'ambiente di lavoro del livello superiore devono avere questo formato: XYZ Workbench
, dove XYZ
è il nome del workbench, ad esempio PartDesign Workbench. E i nomi delle pagine che descrivono i comandi (o strumenti) appartenenti a un ambiente devono avere questo formato: Comando XYZ
, ad esempio PartDesign Pad. Tenere presente che si dovrebbe utilizzare il nome del comando così come appare nel codice sorgente.
Intestazioni
I titoli dei paragrafi dovrebbero essere brevi e utilizzare maiuscole e minuscole: tutte le parole, tranne la prima e i nomi propri, dovrebbero essere in minuscolo. Non si dovrebbero utilizzare le intestazioni H1
(= Heading =
) nel markup della wiki, in quanto nel titolo della pagina viene aggiunto automaticamente come intestazione principale H1
.
Link
Si dovrebbe utilizzare il nome del collegamento originale per i collegamenti quando possibile. Questo rende più evidente la pagina di riferimento nella documentazione stampata oppure offline. Si prega di evitare parole prive di significato per il collegamento.
- Collegamento errato
- Per ulteriori informazioni sul disegno di oggetti 2D, fare clic qui.
- Collegamento corretto
- Per ulteriori informazioni sul disegno di oggetti 2D fare riferimento a Draft.
Il formato preferito per un collegamento è:
[[Name_of_Page/it|Name of Page]]
Tradotto
[[Name_of_Page/fr|Nom de la Page]]
Tenere presente che per la parte prima del carattere |
, ovvero il link effettivo, è rilevante la distinzione tra maiuscole e minuscole. Se il nome della pagina è Name_of_page
il collegamento non funzionerà se si digita Name_of_Page
(P maiuscola). Prima del carattere |
tutti gli spazi devono essere sostituiti da trattini bassi (_
). Questo serve per aiutare i traduttori che utilizzano software di traduzione, senza i caratteri di sottolineatura il collegamento verrebbe tradotto dal software, il che è indesiderabile.
Per collegarsi a un determinato paragrafo aggiungere un segno #
e le sue intestazioni al nome della pagina. Esempio:
[[WikiPages#Links|WikiPages]]
Tradotto
[[WikiPages/fr#Liens|WikiPages]]
All'interno della stessa pagina si può omettere il nome della pagina. Esempio:
[[#Links|Links]]
Per collegarsi alla parte superiore della pagina è possibile utilizzare:
</translate>{{Top}}<translate>
Questo template dovrebbe visualizzare automaticamente il testo corretto a seconda della lingua della pagina. Un collegamento alla parte superiore della pagina è particolarmente utile per le pagine lunghe poiché consente all'utente di tornare rapidamente al sommario. Lo si può mettere alla fine di ogni paragrafo. Assicurarsi che ci sia una riga vuota prima e dopo il template.
Per utilizzare un'immagine come collegamento:
[[Image:Draft_Wire.svg|24px|Testo facoltativo che viene mostrato quando passi il mouse sull'immagine|link=Draft_Wire]]
- Immagine del Collegamento + testo del collegamento
Draft Wire
Se si tralascia il testo facoltativo, il collegamento stesso verrà mostrato quando si passa sull'immagine, il che è preferibile, e si dovrebbe anche aggiungere un collegamento testuale dopo il collegamento dell'immagine:
[[Image:Draft_Wire.svg|24px|link=Draft_Wire]] [[Draft_Wire|Draft Wire]]
Pagine degli Ambienti di lavoro
Una pagina dell'ambiente di livello superiore dovrebbe iniziare con:
- Una descrizione dello scopo per cui viene utilizzato l'ambiente.
- Un'immagine per illustrarne la descrizione.
Vedere #Istantanee dello schermo per le convenzioni su come inserire le immagini.
Pagine dei comandi
Le pagine dei comandi che descrivono gli strumenti dell'ambiente di lavoro non dovrebbero essere troppo lunghe, dovrebbero solo spiegare cosa può fare un comando e cosa no, e come usarlo. Si dovrebbe ridurre al minimo le immagini e gli esempi. I tutorial si possono espandere riguardo l'utilizzo dello strumento e fornire dettagli passo passo.
Per ulteriori dettagli, fare riferimento alla pagina dei Modelli per la descrizione dei comandi.
Tutorial
Un tutorial ben scritto dovrebbe insegnare come ottenere rapidamente determinati risultati pratici. Non dovrebbe essere troppo lungo, ma dovrebbe includere immagini e istruzioni passo passo sufficienti per guidare l'utente. Man mano che FreeCAD si evolve, i tutorial potrebbero diventare obsoleti, quindi è importante menzionare la versione di FreeCAD utilizzata o richiesta per un tutorial.
Per esempi visitare la pagina dei Tutorial.
Templates
Lo stile delle pagine wiki di FreeCAD si ottiene attraverso l'uso di modelli (Help:Editing#Templates_and_transcluding_pages). Garantiscono un aspetto standardizzato in tutte le pagine e consentono anche di rimodellare il wiki. È possibile visualizzare l'elenco completo dei modelli definiti accedendo a Special:PrefixIndex/Template:. Si prega tuttavia di utilizzare solo i modelli elencati nelle tabelle seguenti. Solo in casi molto particolari si possono utilizzare direttamente i tag HTML.
Fare clic sul collegamento del modello per visualizzare le istruzioni di utilizzo di un modello e per visualizzarne l'implementazione. I modelli sono una potente funzionalità del software MediaWiki. Si dovrebbe essere un utente wiki esperto per proporre aggiunte e modifiche ai modelli esistenti. Se implementati in modo errato, i template rendono difficile la traduzione delle pagine in altre lingue, quindi il loro utilizzo dovrebbe essere limitato alla formattazione del testo e la transclusione delle pagine dovrebbe essere evitata. Vedere MediaWiki Help:Templates per ulteriori informazioni.
Template semplici
Questi template accettano un parametro semplice di testo e lo formattano con uno stile particolare.
Template | Aspetto | Descrizione |
---|---|---|
Top | Utilizzato per aggiungere un link che porta all'inizio della pagina. | |
Emphasis | emphasis | Utilizzato per enfatizzare una parte di testo. |
KEY | Alt | Utilizzato per indicare un tasto della tastiera che deve essere premuto. |
ASCII | Utilizzato per indicare un tasto ascii in un'immagine (.svg) che deve essere premuto. E' necessario fornire il carattere desiderato oppure il numero del codice ascii del carattere. | |
Button | Cancel | Utilizzato per indicare un pulsante nell'interfaccia utente grafica che deve essere premuto. |
RadioButton | Utilizzato per indicare un pulsante di un'opzione nell'interfaccia utente grafica che deve essere | |
CheckBox | Utilizzato per indicare una casella di controllo nell'interfaccia utente grafica che deve essere | |
SpinBox | 1.50 |
Utilizzato per indicare una casella numerica nell'interfaccia utente grafica che può essere modificata. |
ComboBox | Menu 1 |
Utilizzato per indicare una casella combinata nell'interfaccia utente grafica che può essere modificata. |
LineEdit | Metal Nickel (Ni) | Utilizzato per indicare un LineEdit nell'interfaccia utente grafica che può essere modificato. |
FALSE, false | false , false
|
Utilizzato per indicare un valore booleano falso, ad esempio, come proprietà nell'editor delle proprietà. Questa è una scorciatoia. Poiché si tratta di un valore, preferire il Template Value false
|
TRUE, true | true , true
|
Utilizzato per indicare un valore booleano vero, ad esempio, come proprietà nell'editor delle proprietà. Questa è una scorciatoia. Poiché si tratta di un valore, preferire Template Value true
|
MenuCommand | File → Save | Utilizzato per indicare la posizione di un comando all'interno di un particolare menu. |
FileName | File name | Utilizzato per indicare il nome di un file o di una cartella. |
SystemInput | Type this text | Utilizzato per indicare il testo di input digitato dall'utente. |
SystemOutput | Output text | Utilizzato per indicare l'output di testo dal sistema. |
Incode | import FreeCAD
|
Utilizzato per includere il codice sorgente in linea con un carattere a spaziatura fissa. Dovrebbe stare in una riga. |
PropertyView | VistaColor | Utilizzato per indicare una proprietà View nell'editor delle proprietà. Esempi di proprietà di visualizzazione includono Line Color, Line Width, Point Color, Point Size, ecc.. |
PropertyData | DatiPosition | Utilizzato per indicare una proprietà Data nell'editor delle proprietà. Le proprietà dei dati sono diverse per i diversi tipi di oggetti. |
Properties Title / TitleProperty | Base | Utilizzato per indicare il titolo di un gruppo di proprietà nell'editor delle proprietà. Il titolo non verrà incluso nel sommario automatico. |
Obsolete | obsolete in version 0.19 | Utilizzato per indicare che una funzionalità è diventata obsoleta nella versione di FreeCAD specificata. |
Version | introduced in version 0.18 | Utilizzato per indicare che una funzionalità è stata introdotta nella versione di FreeCAD specificata. |
VersionMinus | version 0.16 and below | Utilizzato per indicare che una funzionalità è disponibile nella versione di FreeCAD specificata e nelle versioni precedenti. |
VersionPlus | version 0.17 and above | Utilizzato per indicare che una funzionalità è disponibile nella versione di FreeCAD specificata e nelle versioni successive. |
ColoredText | Colored Text | Questo modello è utilizzato per colorare lo sfondo, il testo o lo sfondo e il testo. (Pagina ColoredText per ulteriori esempi) |
ColoredParagraph | Colored Paragraph
|
Questo modello è utilizzato per colorare lo sfondo, il testo o lo sfondo e il testo di un intero paragrafo. (Pagina ColoredParagraph per ulteriori esempi) |
Template complessi
Questi template richiedono più parametri di input o producono un blocco di testo con un formato particolare.
Template | Aspetto | Descrizione |
---|---|---|
Prettytable | This table | Utilizzato per formattare tabelle come questa. È possibile aggiungere ulteriori proprietà alla tabella. |
Caption | Some caption for an image |
Utilizzato per aggiungere una didascalia sotto un'immagine. Può essere allineato a sinistra o al centro. |
Clear | Utilizato per cancellare le colonne. Seguire la definizione del modello per una spiegazione dettagliata. Viene spesso utilizzato per impedire al testo di scorrere accanto a immagini non correlate. | |
Code | import FreeCAD
|
Utilizzato per includere esempi di codice su più righe con un carattere a spaziatura fissa. Il linguaggio predefinito è Python, ma è possibile specificare altri linguaggi.
Il codice Python deve aderire alle raccomandazioni generali stabilite da PEP8: Style Guide for Python Code. In particolare, le parentesi dovrebbero seguire immediatamente il nome della funzione e uno spazio dovrebbe seguire una virgola. Ciò rende il codice più leggibile. |
CodeDownload | Utilizzato per creare un collegamento su una pagina di una macro. | |
Codeextralink | Temporary code for external macro link. Do not use this code. This code is used exclusively by Addon Manager. Link for optional manual installation: Macro # This code is copied instead of the original macro code # to guide the user to the online download page. # Use it if the code of the macro is larger than 64 KB and cannot be included in the wiki # or if the RAW code URL is somewhere else in the wiki. from PySide import QtGui, QtCore diag = QtGui.QMessageBox(QtGui.QMessageBox.Information, "Information", "This macro must be downloaded from this link\n" "\n" "https://wiki.freecad.org/Main_Page" + "\n" "\n" "Quit this window to access the download page") diag.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint) diag.setWindowModality(QtCore.Qt.ApplicationModal) diag.exec_() import webbrowser webbrowser.open("https://wiki.freecad.org/Main_Page") |
Utilizzato se il codice di una macro è troppo grande per essere ospitato sul Wiki. Il codice può quindi essere ospitato da qualche altra parte e il collegamento non elaborato ad esso può essere specificato con questo modello. Addon Manager utilizzerà questo collegamento. |
Fake heading | Utilizzato per creare un'intestazione che non verrà inclusa automaticamente nel sommario. | |
GuiCommand | See GuiCommand model | Utilizzato per creare un riquadro con informazioni utili per documentare i comandi dell'ambiente di lavoro (strumenti). |
TutorialInfo | See for example Basic modeling tutorial | Utilizzato per creare un box con informazioni utili per documentare i tutorial. |
Macro | See for example Macro FlattenWire | Utilizzato per creare un box con informazioni utili per documentare le macro. |
Docnav | Utilizzato per creare una barra con frecce e collegamenti appropriati, adatto a disporre le pagine in una sequenza particolare. | |
VeryImportantMessage | Important Message
|
Utilizzato per creare una casella evidenziata con un messaggio molto importante. Utilizzare con parsimonia, solo per indicare gravi problemi nella funzionalità del software, interruzione degli strumenti e cose simili. |
Page in progress | Utilizzato per le pagine che sono ancora in elaborazione o che sono attualmente in fase di rielaborazione. Non dimenticarsi di rimuoverlo quando la pagina è completata. | |
UnfinishedDocu | This documentation is not finished. Please help and contribute documentation. GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands. See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute. |
Utilizzato per creare una casella evidenziata che indica una pagina di documentazione incompleta. |
Softredirect | Utilizzato al posto del reindirizzamento normale, quando si sta reindirizzando a una pagina speciale (come Media: o Categoria:), nei quali casi il reindirizzamento normale è disabilitato. | |
Quote |
|
Utilizzato per creare una casella di testo con una citazione letterale e un riferimento. |
Userdocnavi, Powerdocnavi | Utilizzati per creare caselle di navigazione per la documentazione per l'utente, la documentazione per utenti esperti e la documentazione per sviluppatori. Ciò consente di saltare rapidamente tra le diverse sezioni della documentazione. Inoltre inseriscono la pagina corrispondente nella categoria corretta. |
Grafica
Immagini e screenshot sono necessari per produrre una documentazione completa di FreeCAD. Sono particolarmente utili per illustrare esempi e tutorial. Le immagini devono essere mostrate nella loro dimensione originale, in modo che presentino dettagli sufficienti e siano leggibili se includono testo. Le immagini Bitmap non devono essere ridimensionate.
Evitare le immagini animate (GIF) nelle pagine generiche di aiuto. Le animazioni e i video devono essere riservati ai tutorial non destinati a essere utilizzati come documentazione PDF offline.
Le immagini possono essere caricate tramite la pagina Special:Upload.
Nome
Dare nomi significativi alle proprie immagini. Se si ha un'immagine che mostra le caratteristiche di un particolare comando, si dovrebbe usare il nome di quel comando con _example
alla fine. Ad esempio per il comando Draft Offset l'immagine dovrebbe essere chiamata Draft_Offset_example.png
.
Istantanee dello schermo
Le dimensioni consigliate per le istantanee dello schermo sono:
- Nativo 400x200 (o larghezza=400 e altezza<=200), per le pagine di riferimento dei comandi, per consentire all'immagine di adattarsi alla parte sinistra della pagina e per altre istantanee standard.
- Nativo 600x400 (o larghezza=600 e altezza<=400), per le pagine di riferimento dei comandi, quando si ha davvero bisogno di un'immagine più grande e si consente comunque all'immagine di adattarsi alla parte sinistra della pagina e per altre istantanee standard.
- 1024x768 nativo (o larghezza=1024 e altezza<=768), solo per immagini a schermo intero.
- Sono possibili taglie più piccole quando si mostrano i dettagli.
- Evitare immagini con risoluzioni maggiori, poiché non saranno molto trasferibili su altri tipi di display o sulla documentazione PDF stampata.
Non si dovrebbe dipendere da una configurazione personalizzata del proprio desktop o sistema operativo quando si creano schermate e si dovrebbero utilizzare le impostazioni visive predefinite dell'interfaccia di FreeCAD quando possibile.
Per creare uno screenshot si possono utilizzare le opzioni fornite dal proprio sistema operativo, oppure una di queste macro: Macro Snip e
Macro Screen Wiki.
Testo
Per facilitare le traduzioni della documentazione, cercare di evitare screenshot che contengono testo. Se non lo si può evitare, prendere in considerazione l'idea di acquisire screenshot separati dell'interfaccia e della Vista 3D. L'immagine della vista 3D può essere riutilizzata in ogni traduzione, mentre un traduttore può, se necessario, acquisire uno screenshot dell'interfaccia localizzata.
Icone e grafica
Fare riferimento alla pagina Artwork per tutti gli elementi grafici e le icone che sono state create per FreeCAD e che possono essere utilizzate anche nelle pagine di documentazione. Se si desidera contribuire alle icone, leggere le Linee guida per le Artwork.
Traduzioni
Per consenso generale, la pagina di riferimento nel wiki è la pagina in inglese, che dovrebbe venire creata per prima. Se si desidera modificare o aggiungere contenuto a una pagina, si dovrebbe farlo prima sulla pagina inglese e, solo una volta completato l'aggiornamento, trasferire la modifica sulla pagina tradotta.
Il wiki di FreeCAD supporta un'estensione di traduzione che consente di gestire più facilmente le traduzioni tra le pagine; per i dettagli, vedere Tradurre il wiki.
Altre risorse utili sono:
- ISO language codes per identificare il codice di due lettere per una particolare lingua in cui si desidera tradurre.
- Google Translate per l'aiuto con le traduzioni.
- Deepl translator per l'aiuto con le traduzioni.
Alcuni consigli per i traduttori
Tradurre GuiCommand
{{GuiCommand |Name=FEM EquationFlux |MenuLocation=Solve → Flux equation |Workbenches=[[FEM_Workbench|FEM]] |Shortcut={{KEY|F}} {{KEY|S}} |Version=0.17 |SeeAlso=[[FEM_tutorial|FEM tutorial]] }}
Tradotto:
{{GuiCommand/fr |Name=FEM EquationFlux |Name/fr=FEM Équation d'écoulement |MenuLocation=Solveur → Équation de flux |Workbenches=[[FEM_Workbench/fr|Atelier FEM]] |Shortcut={{KEY|F}} {{KEY|S}} |Version=0.17 |SeeAlso=[[FEM_tutorial/fr|FEM Tutoriel]] }}
{{FEM_Tools_navi}}
Tradotto:
{{FEM_Tools_navi/fr}}
Tradurre link
[[Part_Module|Part Module]]
Tradotto:
[[Part_Module/fr|Atelier Part]]
{{Docnav |[[About_FreeCAD|About FreeCAD]] |[[Installing_on_Windows|Installing on Windows]] }}
Tradotto:
{{Docnav/fr |[[About_FreeCAD/fr|À propos de FreeCAD]] |[[Installing_on_Windows/fr|Installation sous Windows]] }}
Esempio con le icone:
{{Docnav |[[Std_Save|Save]] |[[Std_SaveCopy|SaveCopy]] |[[Std_File_Menu|Std File Menu]] |IconL=Std_Save.svg |IconR=Std_SaveCopy.svg |IconC=Freecad.svg }}
Tradotto:
{{Docnav/fr |[[Std_Save/fr|Enregistrer]] |[[Std_SaveCopy/fr|Enregistrer une copie]] |[[Std_File_Menu/fr|Menu fichier]] |IconL=Std_Save.svg |IconR=Std_SaveCopy.svg |IconC=Freecad.svg }}
Creare, rinominare ed eliminare le pagine
Creare pagine
Prima di creare una nuova pagina si dovrebbe prima verificare se esiste già una pagina simile. In questo caso, di solito è meglio prima modificare la pagina esistente. In caso di dubbi, aprire prima un topic nel forum delle Wiki.
Per creare una nuova pagina, effettuare una delle seguenti operazioni:
- Visitare l'URL con il nome della pagina desiderata, ad esempio:
https://wiki.freecadweb.org/My_New_Page
, e fare clic su 'create this page'. - Effettuare una ricerca nel wiki per il nome della pagina e fare clic sul testo in rosso in 'Create the page "My New Page" on this wiki!'.
Rinominare le pagine
Poiché FreeCAD è un progetto in costante sviluppo, a volte è necessario rivedere il contenuto del wiki. Se i nomi dei comandi vengono modificati nel codice sorgente, anche le pagine wiki che li documentano dovranno essere rinominate. Questo può essere fatto solo dagli amministratori del wiki. Per informarli, aprire un argomento nel Forum delle Wiki ed elencare l'operazione di ridenominazione necessaria in questo modulo:
old name new name Old_page_name_1 New_page_name_1 Old_page_name_2 New_page_name_2 ...
Eliminare file e pagine
Nel caso in cui sia necessario eliminare un file, andare alla relativa pagina (https://www.freecadweb.org/wiki/File:***.***
) e modificarlo. Non importa se la pagina è vuota o meno, aggiungere quanto segue come primo elemento: {{Delete}}
e direttamente sotto descrivere il motivo per cui la pagina dovrebbe essere eliminata. Inoltre, aprire un topic nel Forum delle Wiki.
Per le pagine la procedura è la stessa.
Discussioni
Il Development/Wiki subforum nel Forum di FreeCAD fornisce uno spazio dedicato per discutere argomenti wiki, l'aspetto delle wiki e qualsiasi altra cosa relativa al wiki. Indirizzare lì le proprie domande e i suggerimenti.
Terminologia - politica di denominazione
Inglese
Vedere il Glossario.