Pubblicare Estensioni per LibreOffice

Copyright
Il presente documento rilasciato sotto Copyright 2011 dei collaboratori di seguito elencati. possibile distribuire e!o modificare il documento rispettando i termini della "#$ "eneral Public License %http://www.gnu.org/licenses/gpl.html&' (ersione ) o successi(a' o della Creati(e Commons *ttribution License %http://creativecommons.org/licenses/by/3.0/&' (ersione ).0 o successi(a. +utti i marchi registrati presenti in ,uesta guida appartengono ai legittimi proprietari.
Collaboratori

*ndreas -ant.e /a(id #elson "usta(o 0u11atti Pacheco 2a1el 3ussman Laurent 0alland4Poirier 56lm6n 71alai

+om /a(ies
Commenti e suggerimenti

Per commenti o suggerimenti su ,uesto documento ri(olgersi a8 documentation@libreoffice.org

Data di pubblicazione e versione del software

Pubblicato il 29 7ettembre 2011. 0asato su LibreOffice ).:.

Nota per gli utenti Mac

*lcuni tasti e (oci di menu sono di(ersi su un -ac rispetto a ,uelli utili11ati in ;indo<s e Linu=. La tabella seguente fornisce le sostitu1ioni pi> comuni per le istru1ioni di ,uesto capitolo. Per una lista pi> dettagliata (edere l?*iuto dell?applica1ione. Windows/Linux Strumenti Opzioni sele1ione menu Clic destro Ctrl (Control !" !$$ Equivalente in Mac LibreOffice Preferenze Control+clic (Comando #aiusc++!" @% Effetto *ccesso alle op1ioni di installa1ione *pre un menu contestuale $sato in combina1ione con altri tasti *pre il #a(igatore *pre la finestra 7tili e Aormatta1ione.

ndice
Copyright......................................................................................................................................... & 'ota per gli utenti #ac..................................................................................................................... & (ntrodu)ione..................................................................................................................................... * Creare un +rogetto per un ,oftware................................................................................................" -ggiungere una se)ione .ilasci.....................................................................................................$0 -ggiungere file............................................................................................................................... $3 -ggiungere un file scaricabile....................................................................................................$3 -ggiungere un collegamento per un file ospitato all/esterno......................................................$" +ubblicare un rilascio..................................................................................................................... $0

+ubblicare 1stensioni per 2ibre3ffice

ntroduzione
Potete incrementare le fun1ionalitB di LibreOffice con le estensioni. sufficiente installare ,uesti piccoli programmi in LibreOffice e' dopo a(er ria((iato il programma' potrete usufruire dei nuo(i ser(i1i. 7e siete uno s(iluppatore di estensioni' potete utili11are di(ersi linguaggi per s(iluppare estensioni di LibreOffice. I linguaggi di programma1ione supportati sono 0asic' Python' Ca(a7cript e Ca(a. Per un maggiore li(ello di integritB e fun1ionalitB potete utili11are i linguaggi C@@' Python e Ca(a per s(iluppare estensioni basate su complementi $#O. Come componenti $#O' potete fornire nuo(e implementa1ioni per fun1ionalitB giB esistenti o componenti speciali11ati come *dd4Ins per Calc' *dd4Ons' /ataPilots' Chart *dd4Ins' oppure componenti linguistici8 controllo ortografico' sillaba1ione' di1ionario dei sinonimi. Potete anche creare estensioni per fornire -odelli addi1ionali' "alleria di immagini e +esti *utomatici. LibreOffice si impegna a fornire agli utenti soft<are di ,ualitB reali11ati con licen)e di free softwaree' come tale' il nostro catalogo di estensioni e modelli pubblicato sotto licen)e di free software. Dueste estensioni sono gratuite . Duesto manuale descri(e i passi basilari necessari alla pubblica1ione di un?estensione nel repository ufficiale delle estensioni per LibreOffice' che potete tro(are all?indiri11o http://e4tensions.libreoffice.org/. Ei in(itiamo a leggere ,uesto documento prima di ini1iare la pubblica1ione di un?estensione' soprattutto per raccogliere le informa1ioni di base che (i ser(iranno per compilare i campi obbligatori.

+ubblicare 1stensioni per 2ibre3ffice

Creare un Progetto per un Software

Prima di tutto do(ete registrar(i sul sito delle Estensioni. *prite il sito delle Estensioni nel (ostro bro<ser' e fate clic sul pulsante !egistra nell?angolo in alto a destra. Completate il #odulo di .egistra)ione e fate clic su !egistra.

3ice(erete una e4mail contenente un lin. che (i permetterB di impostare la (ostra pass<ord e completare il processo di registra1ione. /o(rete impostare una pass<ord prima della data di scaden1a indicata nella e4mail. /opo ,uesta data do(rete utili11are il lin. FPass<ord dimenticataF per ottenerne una nuo(a.

/opo il completamento del processo di registra1ione' potrete accedere e creare un nuo(o progetto di estensione.

+ubblicare 1stensioni per 2ibre3ffice

"

#ell?angolo in alto a destra fate clic su "atti riconoscere per cominciare.

In seguito' fate clic su Centro 1stensioni e' successi(amente' su nvia la tua #stensione' nella 1ona (erde sulla destra.

*pparirB ,uindi il modulo -ggiungi +rogetto di ,oftware .

+ubblicare 1stensioni per 2ibre3ffice

In ,uesto modulo ci sono alcuni campi obbligatori nella scheda Predefinita 8 $itolo' Categorie' Progetto !iepilogo' Descrizione dell%intero progetto e Contatti. Ogni campo ha una bre(e descri1ione sotto il nome del campo stesso.

&ttenzione 7i consiglia di non utili11are caratteri speciali come FGGF' FHHF' FIF' FJF' FKF o simili nel
campo del $itolo . Ei preghiamo di utili11are solo testo in italiano standard.

#el campo Categoriepotete sele1ionare pi> di un?op1ione premendo Ctrl. Potete (edere una lista di categorie e la loro spiega1ione nella tabella seguente. Categorie
+utti i moduli Contenuti della "allery 7trumenti per la lingua ;riter Calc Impress /ra< 0ase -ath

Descrizione
Estensioni per tutti i moduli del programma Estensioni per tutti i moduli del programma Estensioni per tutti i moduli del programma Estensioni per ;riter Estensioni per Calc Estensioni per Impress Estensioni per /ra< Estensioni per 0ase Estensioni per -ath

Esempio
Estensioni da utili11are con ,ualsiasi modulo del programma. Aoto' 7fondi' ... /i1ionari e simili Estensioni da utili11are per ampliare il modulo di elabora1ione testi. Estensioni da utili11are per ampliare il modulo del foglio elettronico. Estensioni da utili11are per ampliare il modulo di presenta1ione Estensioni da utili11are per ampliare il modulo di disegno. Estensioni da utili11are per ampliare il modulo di database Estensioni da utili11are per ampliare il modulo per le formule.

In Contatti' utili11ate mailto: prefisso per il contatto e4mail oppure http:// prefisso per un sito <eb esterno.
+ubblicare 1stensioni per 2ibre3ffice 5

#ella tabella seguente' sono elencati i campi del modulo -ggiungere il +rogetto ,oftware . Campo +itolo Categorie 3iepilogo del progetto /escri1ione dell?intero progetto Contatti Descrizione +itolo del progetto di soft<are. Categorie in cui do(rebbe apparire l?elemento. 0re(e riepilogo del progetto. /escri1ione completa del progetto. Contatti per il progetto. $tili11ate il prefisso mailto8 oppure http8!! a seconda del metodo di contatto che preferite usare. 7e il progetto ha una home page esterna inseritene l?$3L. 7e il progetto contiene una parte di documenta1ione ospitata esternamente' inseritene l?$3L. 7e il progetto ha un repository per il codice' inseritene l?$3L. 7e il progetto ha un tracciatore di errori esterno inseritene l?$3L. $3L della pagina di informa1ioni!archi(i della mailing list o del forum di supporto' se il progetto ne ha uno. Potete aggiungere un logo per il progetto %oppure organi11a1ione o a1ienda& facendo clic sul pulsante F7fogliaF. -assimo 1L0=ML pi=els %se pi> grande (errB ridimensionato&. $3L al ,uale il logo do(rebbe collegarsi' se pertinente. Potete aggiungere una schermata facendo clic sul pulsante F7fogliaF. -assimo N00=900 %se pi> grande (errB ridimensionata&.

2ome page $3L del repository della documenta1ione $3L del repository di controllo della (ersione $3L per un tracciatore di errori $3L di mailing list o forum di supporto Logo

Collegamento del logo 7chermata

/opo a(er riempito il modulo' fate clic su Salva.

&ttenzione *ssicurate(i che il campo Lingua sulla pagina #etadati del (ostro progetto sia Lingua
neutra. *ltrimenti il progetto non sarB (isibile per gli utenti che hanno impostato sul bro<ser altre lingue.

+ubblicare 1stensioni per 2ibre3ffice

Il progetto della (ostra Estensione (errB ,uindi creato. +utta(ia' a ,uesto punto' non potete aggiungere rilasci' documenta1ione o proposte di fun1ionalitB. Per ottenere ciO' do(ete presentare il (ostro progetto per l?appro(a1ione. Per farlo' fate clic sul collegamento Stato' nvia per approvazione ' sul lato destro della barra (erde.

Lo stato del (ostro progetto cambierB in Stato' in attesa di approvazione' finchK non sarB appro(ato da un re(isore. Per l?appro(a1ione potrebbero essere necessari alcuni giorni. /opo l?appro(a1ione lo stato cambierB in Stato' Pubblico e a ,uesto punto potrete aggiungere rilasci' documenta1ione e proposte di fun1ionalitB.

Nota

#on rice(erete nessuna notifica per l?appro(a1ione del progetto. /o(rete (erificarne lo stato sul sito <eb.

+ubblicare 1stensioni per 2ibre3ffice

&ggiungere una sezione !ilasci

/opo l?appro(a1ione andate su &ggiungi nuovo ( Sezione !ilasci per creare un nuo(o spa1io di la(oro per le (ostre informa1ioni di rilasci e file.

7ul modulo -ggiungi ,e)ione .ilasci ' sulla scheda #etadati ' do(ete impostare la lingua su Lingua neutra' per rendere la se1ione (isibile a tutti gli utenti. Duindi fate clic sul pulsante Salva .

&ttenzione 7i consiglia di non utili11are caratteri speciali come FGGF' FHHF' FIF' FJF' FKF o simili nel
campo del $itolo . Ei preghiamo di utili11are solo testo in italiano standard.

La cartella .ilasci sarB creata e potrete aggiungere un nuo(o rilascio facendo clic su &ggiungi nuovo ( !ilascio Software.
$0 +ubblicare 1stensioni per 2ibre3ffice

/o(rete ,uindi compilare il modulo -ggiungere .ilascio ,oftware .

*lcuni campi della scheda Predefinito sono obbligatori8 )ersione' !iepilogo !ilasci' Licenza e Compatibilit*.

+ubblicare 1stensioni per 2ibre3ffice

$$

+utti i campi del modulo -ggiungere .ilascio software sono descritti nell?elenco seguente8

Campo
Eersione

Descrizione
Duesto campo utili11ato anche nell?$3L dell?elemento' ,uindi non utili11ate spa1i o caratteri speciali. Inoltre siete pregati di non includere alfa' beta oppure lo stato del candidato al rilascio poichK curato dal flusso di la(oro. Esempio8 ?0.1?. $na bre(e descri1ione dei punti pi> importanti del rilascio. #on uno storico della (ersione' ma in modo semplice spiegare ,uali sono i principali (antaggi del rilascio. #ome in codice per il rilascio' se ne a(ete uno. +esto completo del rilascio. Log dettagliato dei cambiamenti rispetto al rilascio precedente. "estore del rilascio per ,uesto rilascio. e4mail di contatto per il "estore del 3ilascio /ata dopo la ,uale non (erranno pi> associate Proposte di -iglioramento al rilascio /ata oltre la ,uale non (erranno pi> aggiunte nuo(e caratteristiche al rilascio /ata in cui si presume che (errB effettuato o stato effettuato un rilascio finale Licen1a del 3ilascio8 Ei preghiamo di esaminare con atten1ione il tipo di licen1a che scegliete per il (ostro contributo #on potrB essere cambiata dopo il rilascio. Le op1ioni sono8 "PL 4 "#$ "eneral Public License L"PL 4 "#$ Lesser "eneral Public License -PL P -o1illa Public License 07/ License %re(ised& Public /omain *ltre appro(ate dall?O7I /o(ete sele1ionare almeno una licen1a' ma potete sceglierne fino a tre. +estato e fun1ionante con le (ersioni sele1ionate Proposte di miglioramento per caratteristiche da inserire in ,uesta (ersione. $3L del ramo del repository di controllo di (ersione per il rilascio

3iepilogo 3ilasci

nome in codice /escri1ione completa del 3ilascio Changelog "estore del 3ilascio Contatto E4mail del "estore del 3ilascio Aree1e date per proposte Aree1e date per caratteristiche /ata di 3ilascio %presunta& Licen1a

CompatibilitB Proposte di caratteristiche associate 3amo del repository

/opo a(er completato il modulo -ggiungere .ilascio del ,oftware ' fate clic su Salva.

&ttenzione Ei preghiamo di assicurar(i che il campo Lingua sulla pagina #etadati del (ostro rilascio

sia Lingua neutraQ *ltrimenti il rilascio non sarB (isibile per gli utenti che hanno altre linuge impostate sul loro bro<ser.

$&

+ubblicare 1stensioni per 2ibre3ffice

&ggiungere file
Ora' dopo a(er creato la cartella 3ilasci' a(ete due op1ioni per i file del rilascio8 aggiungere un file scaricabile o aggiungere un collegamento per un file ospitato esternamente. Dueste op1ioni sono spiegate in dettaglio nelle due se1ioni seguenti.

&ggiungere un file scaricabile

Per la prima op1ione' fate clic su &ggiungere nuovo ( "ile scaricabile sulla barra (erde.

+ubblicare 1stensioni per 2ibre3ffice

$3

#el modulo -ggiungere file scaricabile mostrato ,ui di seguito' do(ete scegliere soltanto il file dell?estensione nel campo "ile e definire il sistema operati(o nel campo Piattaforma .

In fondo al modulo fate clic su Salva.

&ttenzione *ssicurate(i che il campo Lingua sulla pagina #etadati del (ostro file scaricabile sia

Lingua neutraQ *ltrimenti il progetto non sarB (isibile per gli utenti che hanno impostato sul bro<ser altre lingue. Lasciate il campo Descrizione "ile (uoto. *ltrimenti il file a(rB ,uesto campo come nome. pulsante !inomina 8 'uovo 'ome 8reve sta per il nome del file mentre 'uovo %itolo sta per la descri1ione del file.

&ttenzione Potete inserire la descri1ione del file in seguito sulla scheda del rilascio Contenuti ' con il

$*

+ubblicare 1stensioni per 2ibre3ffice

&ggiungere un collegamento per un file ospitato all%esterno

Per aggiungere un file ospitato esternamente' basta fare clic su &ggiungere nuovo ( "ile ospitato esternamente sulla barra (erde e compilare il modulo -ggiungere file ospitato esternamente . Per i file ospitati esternamente+ solo i campi Piattaforma e ,!L sono obbligatori.

Aate clic su Salva per completare.

&ttenzione *ssicurate(i che il campo Lingua sulla pagina #etadati del (ostro file ospitato

esternamente sia Lingua neutraQ *ltrimenti il progetto non sarB (isibile per gli utenti che hanno impostate sul bro<ser altre lingue.

+ubblicare 1stensioni per 2ibre3ffice

$"

Pubblicare un rilascio
/opo a(er aggiunto un file scaricabile o un collegamento per un file ospitato esternamente per il rilascio' (edrete il rilascio dell?Estensione e i%l& file.

Aate clic sul collegamento indietro alla pagina del rilascio per cambiare lo stato del rilascio. Pe pubblicare il rilascio' andate al menu Stato' Non rilasciato e definite il nuo(o stato' per esempio !ilascia rilascio finale.

Infine' eseguite il log out e andate sulla nuo(a pagina dell?estensione per (edere la (ostra estensione pubblicataQ
$0 +ubblicare 1stensioni per 2ibre3ffice