Documentazione/Funzioni di Calc/Linee guida

    From The Document Foundation Wiki
    This page is a translated version of the page Documentation/Calc Functions/Guidelines and the translation is 100% complete.


    Linee guida

    Anche se modificare le pagine wiki può sembrare complicato, seguire alcune linee guida e pratiche rende il processo molto più semplice. Questa pagina menziona tutta l'attenzione ai dettagli che si deve offrire migliorando le pagine wiki per le funzioni di Calc.

    Conterrà un breve riassunto della funzione.

    Sintassi

    • Questa sezione menziona il formato della formula trasmessa.
    • Se sono presenti parametri opzionali, vengono menzionati tra parentesi quadre [ ] ad esempio,
      INT.MATURATO.PER(Problema; PrimoInteresse; Insediamento; Rata; [Par]; Frequenza[; Basi])
    • Nel caso in cui un argomento sia necessario solo se vengono passati gli argomenti precedenti, utilizzare le parentesi quadre nidificate [ ] ad esempio,
      DEV.ST(Numero 1 [; Numero 2 [; … [; Numero 255]]])
    • Rendete gli argomenti grassetto. Seguite questo stile per gli argomenti in tutta la pagina.

    Restituisce

    • Questa sezione descrive il tipo di valore restituito dalla funzione.
    • Menziona cosa fa la funzione con gli argomenti passati menzionati nella sintassi.
    • Una funzione può restituire un numero reale, testo, valori logici, ecc.
    • Menziona anche l'intervallo del risultato restituito nel caso di numeri reali.
    • Ad esempio, considerate la funzione DISTRIB.CHI,
      Restituisce un numero reale che rappresenta la probabilità della coda destra della distribuzione chi quadrato. È una probabilità quindi varia da 0 a 1, cioè [0,1].

    Argomenti

    • Questa sezione descrive ciascun argomento in dettaglio.
    • Per ciascun argomento menzionare l'intervallo di input consentito dalla funzione, ad esempio se l'argomento viene passato come numero intero, numero reale, testo, come riferimento a una cella, come array di numeri reali/testo, come riferimento a un intervallo di cellule, ecc.
    • Descrivere tutti i casi limite e i casi di errore per i vari valori degli argomenti passati. In caso di errore, spiegare quali errori vengono restituiti dalla funzione per un particolare tipo o intervallo di argomenti.

    Dettagli aggiuntivi

    • Questa sezione contiene qualsiasi altra informazione che non è stato possibile modificare nelle sezioni precedenti.
    • Questa sezione può contenere un'immagine del grafico o un'illustrazione di una funzione che mostra come la funzione varia con l'intervallo di argomenti specificato. Ad esempio, SENH funzione OR TAN funzione
    • Questa sezione può contenere una formula implementata dalla funzione. Ad esempio, la funzione DISTRIB.CHI ha la seguente equazione
      Chidist.png
    • Questa sezione può contenere un collegamento a Wikipedia per coloro che sono interessati a saperne di più su qualsiasi argomento trattato dalla funzione.
    • Questa sezione può contenere istruzioni sull'attivazione di determinate funzionalità come caratteri jolly, espressioni regolari, ecc.
    • Questa sezione può contenere un messaggio di avviso, di nota o di suggerimento per l'utente. Si prega di utilizzare i modelli indicati di seguito.
      Warning.svg

      Attenzione:
      Aggiungete testo qui

      Note pin.svg

      Nota:
      Aggiungete testo qui

      Tip.svg

      Suggerimento:
      Aggiungete testo qui

    • Nel caso in cui non ci siano ulteriori dettagli da menzionare, questa sezione dice "Nessuno".

    Esempi

    • Questa sezione è piena di tutti i tipi di esempi per la funzione specificata.
    • Aggiungete quegli esempi in cui la funzione restituisce casi di errore per determinati argomenti non validi per fare in modo che la pagina della funzione soddisfi completamente tutte le query dell'utente.
    • Siete pregati di utilizzare il formato tabellare per inserire gli esempi menzionati nell'esempio seguente.
    Formula Descrizione Restituisce
    =DEV.ST(3; 4; 5; 6; 2; 3; 1) Calcola la deviazione standard campionaria dei dati 1,71824938596845
    =DEV.ST(3; 4; −5; 6,05; 2; 3; −1,5) Calcola la deviazione standard campionaria dei dati 3,71472295961175
    =DEV.ST(3; "alpha"; −5; 6,05; 2; 3; −1,5) La funzione restituisce un valore di errore, poiché uno dei numeri è una stringa. Err:504
    =DEV.ST(A1:A5)

    dove A1:A5 contiene 1, 2, 3, 4, 5

    Calcola la deviazione standard campionaria dei dati passati come riferimento alle celle. 1,58113883008419
    =DEV.ST(3) La funzione restituirà un errore di divisione poiché sono disponibili meno di 2 argomenti. #DIV/0!
    • Aggiunge una tabella aggiuntiva per indicare il riferimento alla cella come di seguito. Questo è necessario per formule come
       =CERCA.VERT("Charlie"; A1:E4; 3; FALSO())
    
    A B C D
    1 Avery Hazel Jack William
    2 Carter Grayson James Scarlett
    3 Charlie Harper Lily Jackson
    4 Ella Julian Lillian Mason

    Funzioni di LibreOffice correlate

    • Questa sezione contiene un collegamento a tutte le funzioni correlate disponibili in LibreOffice. Per i dettagli su quali funzioni sono correlate, fate riferimento alla funzione corrispondente nella sezione ODF. Aggiungete il collegamento come di seguito (ad esempio per la funzione ACCRINTM):

    [[Special:MyLanguage/Documentation/Calc_Functions/ACCRINTM|{{Calc_fn_name|ACCRINTM|{{PAGELANGUAGE}}}}]]

    Standard ODF

    • Questa sezione collega la pagina wiki della funzione alla corrispondente funzione ODF.
    • Il collegamento ODF della funzione può essere trovato da qui e aggiunto come mostrato di seguito:

    Section 6.14.5, part 2

    • Assicuratevi di menzionare correttamente il numero di sezione della funzione.
    • Nel caso in cui non esista esattamente la stessa funzione ODF, questa sezione dice "Nessuno".

    Funzioni equivalenti (o simili) di Excel

    • Nel caso in cui non esista una funzione Excel molto simile, equivalente o strettamente correlata, questa sezione dice "Nessuno".

    Suggerimenti

    Dove fare riferimento

    Copyright

    • Quando aggiungete testo, immagine o formula, assicuratevi che nessuno di essi sia simile o preso alla lettera da qualsiasi sito Web come documentazione di MS Excel, documenti di Fogli Google, ecc.

    Immagini, Grafici e Formule

    • Per immagini e grafici, generate immagini utilizzando Calc o utilizzando librerie di visualizzazione come Matplotlib in Python.
    • Per la formula, acquisite un'immagine della sezione ODF o generate un'immagine della formula utilizzando l'applicazione Javascript o Latex o qualsiasi altro processo che fornisca un'immagine PNG/jpg/jpeg.
    • Assicuratevi che le immagini per i grafici e le illustrazioni indichino il nome della funzione nella didascalia, abbiano il formato thumb e siano centrate. (SENH grafico sopra)
    • Assicuratevi che le immagini per la formula abbiano il formato none e siano centrate. (DISTRIB.CHI equazione sopra)
    • Assicuratevi di non acquisire immagini da qualsiasi fonte che potrebbe essere soggetta a copyright come menzionato nella sezione precedente.