Lunar Linux - User contributions [en]

Module Writing it

2008-11-14T08:05:01Z

Sbarbi:

__TOC__

Scrivere [[modules|moduli]] per Lunar può essere difficilissimo oppure facilissimo, ed è molto simile a seguire i passi per l'installazione di [[package|pacchetti]] manualmente. Ci sono parecchie variabili a cui pensare durante la scrittura di un [[modules|moduli]] ed è difficile ottenere un buon risultato se sono le prime volte che li scrivete.

==Prima di iniziare==
Prendete un pò di tempo per pensare ai motivi che vi spingono a scrivere un nuovo [[modules|modulo]] ci possono essere molte variabili che impediscono la scrittura di un [[modules|modulo]].
Ecco alcune linee guida...

* Cercate se il pacchetto è già presente in Lunar [[moonbase]]. Nulla è peggio di scoprire di aver sprecato tempo per un lavoro già fatto.
* Controllate le dipendenze necessarie al modulo, controllate che anche per quelle siano soddisfatti tutte le dipendenze. A volte scrivere un nuovo modulo può essere molto lungo e non valerne la pena.
* Controllate che non sia meglio installare manualmente o tramite un binario. Avere una abbondanza di moduli è bello, ma a volte è più facile installare un binario nella propria /home.
==Iniziamo il modulo==

Si deve lavorare nella sezione [[zlocal]]. Nel tuo sistema si trova in "/var/lib/lunar/moonbase".

cd /var/lib/lunar/moonbase/zlocal
mkdir miomodulo
cd mimodulo

Ogni modulo è costituito da un insieme di file e directory tra cui il file [[DETAILS]]. Quindi bisogna creare un file [[DETAILS]]

MODULE=miomodulo
VERSION=1.0
SOURCE=$MODULE-$VERSION.tar.bz2
SOURCE_URL=http://my.site.org/files/
SOURCE_VFY=sha1:e96df66f703c5ab1a295e216b5035ee14d6202b2
WEB_SITE=http://my.site.org/
ENTERED=20050808
UPDATED=20050808
SHORT="Scrivere un modulo semplice"

cat<<EOF
MioModulo è un esempio di cosa bisogna scrivere nel file
details.
EOF

Questo è un file [[DETAILS]] di base ma con tutto il necessario. Come potete notare è del semplice codice bash.

''Tutti i moduli di Lunar e i file che li compongono sono codice bash. Ciò significa che si dovrebbe prestare particolare attenzione ai meta-caratteri della shell e alla corretta sintassi''

Questo file [[DETAILS]] potrebbe già essere tutto ciò di cui abbiamo bisogno per compilare, a seconda di come il modulo deve essere compilato.

== Formato del modulo ==

Vedere anche [[Module Basics]] e [[Module Guidelines]] per dettagli e esempi su moduli più complessi e i restanti file e scripts.

Moonbase it

2008-11-12T09:36:54Z

Sbarbi: New page: ==Moonbase== __TOC__ ===Cosa è moonbase?=== Moonbase è la collezione completa di tutti i pacchetti software (modules) che Lunar Linux mette a disposizione dei suoi utenti. Ques...

==Moonbase==

__TOC__

===Cosa è moonbase?===
Moonbase è la collezione completa di tutti i pacchetti software ([[module]]s) che [[Lunar Linux]] mette a disposizione dei suoi utenti. Questo è organizzato in una scala gerarchica di directory e files; nel nostro sistema lo possiamo trovare in <code>/var/lib/lunar/moonbase</code>. Generalizzando moonbase è solo una directory che contiene altre directory e file.

===Sezioni===
Il primo livello della struttura/organizzazione di moonbase è una [[section]]. Una sezione è il nome che serve per classificare e organizzare un gruppo di [[modules]] in più partizioni logiche. Ogni [[section]] è semplicemente una sotto-directory che risiede a destra sotto la radice di [[moonbase]] o all'interno di un'altra sezione. Le sezioni possono essere nidificate anche in altre sezioni.

Esistono due sezioni dal significato speciale:
* '''zbeta''' contiene software ''*-cvs'' o ''*-svn'' il cui codice sorgente viene scaricato direttamente dal repository del progetto o moduli che i tester di Lunar non sono in grado di testare ampiamente. Questi moduli non possono essere garantiti come funzionanti in ogni momento e su tutto l'hardware.
* '''zlocal''' è dove l'user sviluppa i propri moduli o dove si può copiare e editare i moduli già presenti in moonbase senza correre il rischio che l'aggiornamento di moonbase li cancelli o li riscriva.

===Moduli===
[[Modules]] sono all'interno delle [[section]]. Un modulo consinste nell'insieme di file e altre sotto-direcotory. Queste sub-directory rappresentano il singolo modulo che appartiene a quella sezione. Un modulo è l'insieme delle istruzioni per la compilazione e l'installazione del software. Se noi abbiamo un modulo chiamato FooGame, questo sarà inserito nella sezione "games" di [[moonbase]], Quindi troveremo una directory chiamata FooGame in <code>/var/lib/lunar/moonbase/games/FooGame</code>.

Per riassumere, il software installabile è chiamato modulo. La collezione di tutti i moduli si chiama moonbase, che altro non che una directory che contiene altre directory (section) che a loro volta contengono le directory dei moduli.

[[Moonbase]]
\--[[section]]
|--[[section]]
| \--[[module]]
| \-- files
\--[[module]]
\-- files

Module Writing it

2008-11-11T18:15:12Z

Sbarbi:

__TOC__

Scrivere [[modules]] per Lunar può essere difficilissimo oppure facilissimo, ed è molto simile a seguire i passi per l'installazione di [[package]] manualmente. Ci sono parecchie variabili a cui pensare durante la scrittura di un [[modules]] ed è difficile ottenere un buon risultato se sono le prime volte che li scrivete.

==Prima di iniziare==
Prendete un pò di tempo per pensare ai motivi che vi spingono a scrivere un nuovo [[modules]] ci possono essere molte variabili che impediscono la scrittura di un [[modules]].
Ecco alcune linee guida...

* Cercate se il pacchetto è già presente in Lunar [[moonbase]]. Nulla è peggio di scoprire di aver sprecato tempo per un lavoro già fatto.
* Controllate le dipendenze necessarie al modulo, controllate che anche per quelle siano soddisfatti tutte le dipendenze. A volte scrivere un nuovo modulo può essere molto lungo e non valerne la pena.
* Controllate che non sia meglio installare manualmente o tramite un binario. Avere una abbondanza di moduli è bello, ma a volte è più facile installare un binario nella propria /home.
==Iniziamo il modulo==

Si deve lavorare nella sezione [[zlocal]]. Nel tuo sistema si trova in "/var/lib/lunar/moonbase".

cd /var/lib/lunar/moonbase/zlocal
mkdir miomodulo
cd mimodulo

Ogni modulo è costituito da un insieme di file e directory tra cui il file [[DETAILS]]. Quindi bisogna creare un file [[DETAILS]]

MODULE=miomodulo
VERSION=1.0
SOURCE=$MODULE-$VERSION.tar.bz2
SOURCE_URL=http://my.site.org/files/
SOURCE_VFY=sha1:e96df66f703c5ab1a295e216b5035ee14d6202b2
WEB_SITE=http://my.site.org/
ENTERED=20050808
UPDATED=20050808
SHORT="Scrivere un modulo semplice"

cat<<EOF
MioModulo è un esempio di cosa bisogna scrivere nel file
details.
EOF

Questo è un file [[DETAILS]] di base ma con tutto il necessario. Come potete notare è del semplice codice bash.

''Tutti i moduli di Lunar e i file che li compongono sono codice bash. Ciò significa che si dovrebbe prestare particolare attenzione ai meta-caratteri della shell e alla corretta sintassi''

Questo file [[DETAILS]] potrebbe già essere tutto ciò di cui abbiamo bisogno per compilare, a seconda di come il modulo deve essere compilato.

== Formato del modulo ==

Vedere anche [[Module Basics]] e [[Module Guidelines]] per dettagli e esempi su moduli più complessi e i restanti file e scripts.

Module Writing it

2008-11-11T15:42:58Z

Sbarbi: New page: __TOC__ Scrivere modules per Lunar può essere difficilissimo oppure facilissimo, ed è molto simile a seguire i passi per l'installazione di package manualmente. Ci sono parecchi...

__TOC__

Scrivere [[modules]] per Lunar può essere difficilissimo oppure facilissimo, ed è molto simile a seguire i passi per l'installazione di [[package]] manualmente. Ci sono parecchie variabili a cui pensare durante la scrittura di un [[modules]] ed è difficile ottenere un buon risultato se sono le prime volte che li scrivete.

==Prima di iniziare==
Prendete un pò di tempo per pensare ai motivi che vi spingono a scrivere un nuovo [[modules]] ci possono essere molte variabili che impediscono la scrittura di un [[modules]].
Ecco alcune linee guida...

* Cercate se il pacchetto è già presente in Lunar [[moonbase]]. Nulla è peggio di scoprire di aver sprecato tempo per un lavoro già fatto.
* Check the dependencies required for the module, and see if those also meet these requirements. Sometimes a module might take so much time to write that it's not worth it.
* Check if you're not better off installing it manually or using a binary. Plenty of packages are so easy to install into your home directory and even though a module would be nice, it's often just easier to install it manually.

==Starting the module==

Find a good spot in [[moonbase]]. You should always work in the [[zlocal]] section. Your system [[moonbase]] is located in "/var/lib/lunar/moonbase".

cd /var/lib/lunar/moonbase/zlocal
mkdir mymodule
cd mymodule

Every module is defined as the group of files and directories including a [[DETAILS]] file in a directory. So we need a [[DETAILS]] file:

MODULE=mymodule
VERSION=1.0
SOURCE=$MODULE-$VERSION.tar.bz2
SOURCE_URL=http://my.site.org/files/
SOURCE_VFY=sha1:e96df66f703c5ab1a295e216b5035ee14d6202b2
WEB_SITE=http://my.site.org/
ENTERED=20050808
UPDATED=20050808
SHORT="Makes module writing easy"

cat<<EOF
MyModule is a simple tool to explain module writing in
detail. It doesn't actually exist but is used as an example
for educational purposes.
EOF

This is a basic [[DETAILS]] file with all required components. As you can see it's just plain shell code.

''All lunar module files are bash code. This means that you should pay special attention to shell meta characters and proper syntax''

This [[DETAILS]] file already can be all you need for writing a module, depending on the way "mymodule" needs to be compiled.

== Module Format ==

See [[Module Basics]] and [[Module Guidelines]] for detailled information about available module scripts and module examples.