Comunità


Contatti

Discussioni e aiuto per gli utenti

Mailing list degli utenti: lilypond-user@gnu.org

Questa mailing list è il principale luogo dove gli utenti possono discutere e aiutarsi.

iscrizione e informazioni su lilypond-user

archivio 1 della lista degli utenti archivio 2

Nota: Quando poni domande, usa gli Esempi minimi!

LilyPond Snippet Repository

Il LilyPond Snippet Repository è una grande raccolta di esempi proposti dagli utenti, che possono essere liberamente copiati e usati nei tuoi lavori. Guarda quello che hanno scritto altre persone, e aggiungi i tuoi esempi!

http://lsr.di.unimi.it

Esempi particolarmente istruttivi provenienti dal LSR sono inclusi nella nostra documentazione ufficiale, in Frammenti.

IRC

Un certo livello di supporto è fornito nel nostro canale IRC,

#lilypond@irc.freenode.net

Questo canale non ha un archivio pubblico, dunque qualsiasi domanda che potrebbe essere utile per altri dovrebbe essere inviata a una delle mailing list.

irc name:

Altre lingue

mailing list francese

gruppo portoghese

mailing list spagnola

forum tedesco

LilyPond Blog

Leggi il blog gestito dalla comunità, ‘Scores of Beauty’:

https://lilypondblog.org

Mailing list dei rilasci: info-lilypond@gnu.org

Questa mailing list è una lista a basso volume e in sola lettura che riceve notifiche dei nuovi rilasci.

iscrizione e informazioni su info-lilypond

archivio 1 della lista info archivio 2

Luoghi di discussione per sviluppatori e traduttori

Mailing list degli sviluppatori: lilypond-devel@gnu.org

Le discussioni tra sviluppatori hanno luogo in questa lista. Le ‘patch’ possono essere inviate anche qui.

iscrizione e informazioni su lilypond-devel

archivio 1 della lista devel archivio 2

Mailing list dei bug: bug-lilypond@gnu.org

Questa lista è dedicata alla segnalazione di bug e alle discussioni sui problemi di LilyPond. Non inviare ‘patch’ qui.

iscrizione e informazioni su bug-lilypond

archivio 1 della lista bug archivio 2

Nota: Prima di inviare un messaggio alla lista bug, leggi le nostre linee guida per la Segnalazione bug.

Mailing list dei traduttori: translations@lilynet.org

Tutte le discussioni relative alla traduzione dei manuali di LilyPond deve avere luogo qui. Non inviare patch a questa lista.

Archivio della mailing list dei traduttori


Esempi minimi

Cosa sono gli “Esempi minimi”?

Un esempio minimo è un esempio dal quale niente può essere tolto.

Perché crearli?

  • Più l’esempio è semplice, più rapidamente potenziali solutori possono comprenderlo e aiutarti.
  • Un esempio minimo dimostra che hai tentato di risolvere il problema da solo. Quando le persone inviano grandi porzioni di codice, sembra che non si preoccupino che li possiamo aiutare o no.
  • Creare un esempio minimo ti aiuta a capire cosa sta succedendo. Molte segnalazioni di un falso problema possono essere evitate se si prova a creare un esempio minimo; se non riesci a ricreare un “bug” in un esempio minimo, allora probabilmente il problema è una conoscenza di LilyPond insufficiente, non un vero bug!

Come crearli?

  • Includi il numero di versione nel comando \version.
  • Crea un esempio piccolo! Gli esempi che riguardano la spaziatura o la formattazione di pagina potrebbero richiedere molte battute, ma la maggior parte dei problemi può essere riprodotta con meno di una battuta.
  • Durante la preparazione di un esempio, cerca di commentare (% o %{ … %}) le sezioni del tuo file. Se riesci a commentare una porzione di codice riuscendo a mantenere chiara l’idea principale, allora elimina il materiale commentato!
  • Evita di usare note, tonalità o segni di tempo complessi a meno che il malfunzionamento non riguardi proprio il comportamento di questi elementi.
  • Non usare i comandi \override o \set, a meno che il malfunzionamento non riguardi questi comandi in particolare.
  • Eventualmente, allega un’immagine che mostri il risultato grafico desiderato.

Quanto piccoli devono essere?

Il codice seguente è un esempio minimo?

\version "2.14.1"
\include "english.ly"

\score {
  \new Staff {
    \key d \major
    \numericTimeSignature
    \time 2/4
    <cs' d'' b''>16 <cs' d'' b''>8.
    %% Here: the tie on the D's looks funny
    %% Too tall? Left-hand endpoint is not aligned with the B tie?
    ~
    <cs' d'' b''>8 [ <b d'' a''> ]
  }
}

Non è poi così grande, ma un vero esempio minimo è il seguente:

\version "2.14.1"
{
  % middle tie looks funny here:
  <c' d'' b''>8. ~ <c' d'' b''>8
}

Sono pochi gli esempi minimi che superano 10 righe di codice - spesso 4 righe sono sufficienti per illustrare il problema!


Segnalazione bug

Se hai un codice di input che produce un crash o un output sbagliato, allora si tratta di un bug.

Passo 1: Bug noti

Potremmo già essere a conoscenza di questo bug. Controlla qui:

https://gitlab.com/lilypond/lilypond/-/issues

Nota: Per favore NON aggiungere segnalazioni di bug direttamente nel bug tracker. Una volta che il problema è stato aggiunto al tracker, aggiungi pure maggiori informazioni nella segnalazione.

Passo 2: Creare una segnalazione bug

Se hai scoperto un bug che non è ancora stato riportato, puoi aiutarci creando una segnalazione bug.

Nota: Accettiamo segnalazioni bug esclusivamente nella forma di Esempi minimi. Abbiamo risorse molto limitate, quindi qualsiasi esempio non minimo sarà scartato. Quasi ogni bug può essere dimostrato con quattro note o meno!

Ecco un esempio di una valida segnalazione bug:

% Le alterazioni dovrebbero comparire solo nella
% prima nota di una legatura di valore, ma questa
% versione mostra il bemolle accanto a entrambe le note.
\version "2.10.1"

\relative c'' {
 bes1 ~
 bes1
}

Passo 3: Inviare una segnalazione bug

Dopo aver verificato che il problema non sia già noto e aver creato una segnalazione bug, inviacela!

Purtroppo non esiste più un’interfaccia per pubblicare messaggi sulla lista bug-lilypond senza essere iscritti; vedi

https://lists.gnu.org/mailman/listinfo/bug-lilypond

per maggiori informazioni.

Passo 4: Attendi una risposta

Una volta che la segnalazione bug è stata inviata alla lista, la nostra Squadra Bug la esaminerà e forse ti chiederà maggiori informazioni. Verrai avvisato quando la segnalazione viene aggiunta al bug tracker. Una risposta può richiedere fino a 4 giorni, perché abbiamo un numero limitato di volontari per questo compito.

Una volta che un bug è stato aggiunto al tracker, puoi commentarlo per aggiungere informazioni a riguardo. Per ricevere automaticamente delle notifiche su qualsiasi attività relativa al bug, puoi iscriverti cliccando sul simbolo della busta vicino al titolo del bug.

Aiuto facoltativo: mostra il comportamento desiderato

Dopo che il problema è stato aggiunto al tracker, può essere molto utile poter vedere l’output desiderato. Aggiungi pure del codice di input e/o delle immagini (se possibile, create con altri strumenti) che mostrino come dovrebbe apparire secondo te!


Aiutaci

Abbiamo bisogno di te!

Ti ringraziamo per l’interesse nel darci una mano — ci farebbe molto piacere vederti partecipare! Il tuo contributo aiuterà tanti utenti a scrivere belle partiture.

Anche lavorare su piccoli compiti può avere un grande impatto: occuparsi di questi compiti permette agli sviluppatori esperti di lavorare sui compiti complessi, invece di impiegare il tempo in quelli semplici.

In un progetto complesso come LilyPond, talvolta è difficile sapere da dove iniziare. Oltre alle possibilità proposte sotto, puoi inviare un email alla mailing list lilypond-devel@gnu.org, e ti aiuteremo nel tuo percorso iniziale.

Compiti semplici

Non è necessario saper programmare!

  • Supporto nelle mailing list: rispondi alle domande degli utenti. (Ciò potrebbe implicare di aiutarli a muoversi nella documentazione online; in questi casi potrebbe essere appropriato dirigerli a percorsi URL privi di una versione specifica, come /latest/ o /stable/, che vengono rediretti automaticamente.)
  • Segnalazione bug: aiuta gli utenti a creare una Segnalazione bug corretta e/o entra nel Bug Squad per l’organizzazione dei Problemi.
  • Documentazione: puoi proporre piccole modifiche seguendo le linee guida per i Consigli per la documentazione.
  • LilyPond Snippet Repository (LSR): crea e correggi i frammenti di codice seguendo le linee guida in Aggiungere e modificare i frammenti di codice.
  • Discussioni, revisioni e prove: gli sviluppatori chiedono spesso delle opinioni sulla documentazione, possibili cambiamenti di sintassi e il test di nuove funzionalità. Contribuisci a queste discussioni!

Compiti avanzati

Questi compiti di solito richiedono il codice sorgente e la capacità di compilare LilyPond.

Nota: Consigliamo ai collaboratori che usano Windows o MacOS X di non cercare di configurare il proprio ambiente di sviluppo; si consiglia invece di usare Lilydev come spiegato in Avvio rapido.

Anche i collaboratori che usano Linux o FreeBSD possono usare Lilydev, ma se preferiscono il proprio ambiente di sviluppo, devono leggere Lavorare col codice sorgente e Compilare.

Si consiglia di iniziare con la lettura del Sommario per programmatori esperti.


Sponsor

Remunerazioni (bounty)

In passato,

  • alcuni utenti hanno pagato per avere nuove funzionalità
  • alcuni sviluppatori hanno aggiunto nuove funzionalità a pagamento

Il progetto LilyPond non coordina queste iniziative; non appoggiamo né scoraggiamo tali accordi. Qualsiasi contratto tra individui privati è affar loro, non nostro.

Linee guida

Gli utenti che desiderano offrire del denaro in cambio di lavoro devono tenere a mente i seguenti punti:

  • Gli sviluppatori di LilyPond talvolta pubblicizzano i propri servizi sulle liste email di lilypond.
  • Qualsiasi accordo tra singoli individui deve includere le normali precauzioni da prendere quando si conduce un affare: chi paga, quanto paga, con quale metodo di pagamento e in base a quali condizioni. Suggeriamo di risolvere qualsiasi ambiguità o incertezza su tali questioni prima che il lavoro inizi.

Sviluppatori interessati

Di seguito riportiamo una lista di persone interessate a lavorare dietro remunerazione. Si noti che la quantità di lavoro fatto da parte dei singoli varia nel corso degli anni. Non garantiamo che questa lista sia aggiornata, né che le persone qui elencate abbiano particolari abilità. L’unico criterio è "XYZ ha chiesto di essere inserito in questa pagina".

Un buon modo per sapere quali sono gli sviluppatori più attivi e preparati è guardare la storia del repository git. Statistiche fino alla versione 2.21.2:

storia complessivaultimo annoultimi tre mesi

Sviluppatori interessati:

mailing list degli sviluppatori di LilyPond

In questo momento nessuno programmatore si è proposto per fornire miglioramenti di LilyPond a pagamento, ma è comunque possibile provare a chiedere nella mailing list degli sviluppatori.


Sviluppo

Sviluppo di LilyPond 2.21.2

Nota: Queste sono le versioni instabili e di sviluppo. Se hai un minimo dubbio su come usare o installare LilyPond, ti raccomandiamo di usare il download per la versione stabile, e leggere i manuali stabili.

Numeri di versione

LilyPond viene distribuito in due versioni: la versione stabile e quella di sviluppo o instabile. Le versioni stabili hanno un numero di versione ‘minore’ pari (per esempio 2.14, 2.16, 2.18). Le versioni di sviluppo hanno un numero di versione ‘minore’ dispari (per esempio 2.15, 2.17, 2.19).

Download

Le istruzioni su git e la compilazione sono nella Guida del Collaboratore.

repository git di lilypond

Gli editor della Documentazione e i tester generalmente vorranno scaricare l’ultimo binario:

GNU/Linux x86: LilyPond 2.21.2-1

GNU/Linux 64: LilyPond 2.21.2-1

GNU/Linux PPC: LilyPond 2.21.2-1

FreeBSD i386: LilyPond 2.21.2-1

FreeBSD amd64: LilyPond 2.21.2-1

Mac OS X x86 32-bit: LilyPond 2.21.2-1

Mac OS X PPC: LilyPond 2.21.2-1

Mac OS X x86 64-bit (non ufficiale)

Windows: LilyPond 2.21.2-1

Source: lilypond-2.21.2.tar.gz

Guida del Collaboratore

Lo sviluppo di LilyPond è piuttosto complesso. Per aiutare i nuovi collaboratori e mantenere l’intero sistema (tendenzialmente) stabile, abbiamo scritto un manuale per i compiti di sviluppo.

Collaudi di regressione

Manuali