Differenze tra le versioni di "KDE5 file template"

Da GolemWiki.
Jump to navigation Jump to search
(Prima bozza (senza immagini))
 
m (Pagina categorizzata anche su KDE)
 
(5 versioni intermedie di un altro utente non mostrate)
Riga 1: Riga 1:
Il gestore di file per KDE, Dolphin, mette a disposizione un menù per la creazione di nuovi file, tra cui un template HTML. Un template (modello) è un file di esempio che contiene la struttura base da riempire con contenuti propri. Potrebbe essere comodo, ad esempio per un programmatore, aggiungere un nuovo template per file C++ che contenga l'intestazione e la funzione <code>main</code>.
+
{{Note
 +
|type=warning
 +
|text=Questa procedura fa riferimento a KDE5
 +
}}
 +
Il gestore di file per [https://www.kde.org KDE], [https://www.kde.org/applications/system/dolphin Dolphin], mette a disposizione un menu per la creazione di nuovi file, tra cui un template HTML. Un '''template''' (modello) è un file di esempio che contiene la struttura base da riempire con contenuti propri. Potrebbe essere comodo, ad esempio per un programmatore, aggiungere un nuovo template per file C++ che contenga l'intestazione e la funzione ''main''.
  
Per far questo dobbiamo mettere mano al terminale. '''NOTA: questa procedura fa riferimento a KDE5'''
+
[[File:Kde_menu_crea.png|center|600px]]
  
= Creazione delle cartelle e del file.desktop =
+
== Creazione delle cartelle e del file.desktop ==
Posizioniamoci nella cartella seguente
+
Apriamo un terminale e posizioniamoci nella cartella seguente
 
  cd .local/share
 
  cd .local/share
Creaiamo la cartella templates ed entriamoci
+
Creiamo la cartella templates ed entriamoci
 
  mkdir templates
 
  mkdir templates
 
  cd templates
 
  cd templates
 
Creiamo infine una sottocartella che ci servirà dopo
 
Creiamo infine una sottocartella che ci servirà dopo
  mkdr .source
+
  mkdir .source
  
Nella cartella templates dobbiamo aggiungere un file con estensione <code>.desktop</code> per ogni modello (ad esempio CFile.desktop, CPPFile.desktop, PHPFile.desktop, etc...). Invece di scrivere da zero il file (procedura noiosa e incline a errori) possiamo copiare il file HTML di esempio dalla cartella template di sistema:
+
Nella cartella templates dovremo aggiungere un file con estensione <code>.desktop</code> per ogni modello (ad esempio CFile.desktop, CppFile.desktop, PhpFile.desktop, etc...). Invece di scrivere da zero il file (procedura noiosa e incline a errori) possiamo copiare il file HTML di esempio dalla cartella template di sistema:
  
  cp /usr/share/templates/HTMLFile.desktop CPPFile.desktop
+
  cp /usr/share/templates/HTMLFile.desktop CppFile.desktop
  
= Personalizzazione =
+
== Personalizzazione ==
 
Il contenuto sarà all'incirca il seguente:
 
Il contenuto sarà all'incirca il seguente:
  
<code>
+
[Desktop Entry]
[Desktop Entry]
+
Name=HTML File...
Name=HTML File...
+
Name[it]=File HTML...
Name[it]=File HTML...
+
Comment=Enter HTML filename:
Comment=Enter HTML filename:
+
Comment[it]=Inserisci il nome del file HTML:
Comment[it]=Inserisci il nome del file HTML:
+
Type=Link
Type=Link
+
URL=.source/HTMLFile.html
URL=.source/HTMLFile.html
+
Icon=text-html
Icon=text-html
 
</code>
 
  
 
Analizziamo i campi di questo file:
 
Analizziamo i campi di questo file:
* Name: è il testo che comparirà nel menu ''Crea'' di KDE (vedi immagine)
+
* Name: è il testo che comparirà nel menu ''Crea'' di KDE (come nell'immagine in alto)
 
* Comment: è il titolo della finestra di dialogo che permette l'inserimento del nome del file
 
* Comment: è il titolo della finestra di dialogo che permette l'inserimento del nome del file
'''NOTA:''' KDE prevede per ogni output testuale la localizzazione in tutte le lingue supportate. Per semplicità si consiglia di lasciare l'inglese (sempre valido) e la lingua in uso nel sistema, nel nostro caso l'italiano.
+
'''NOTA:''' KDE prevede per ogni output testuale la localizzazione in tutte le lingue supportate. Per semplicità si consiglia di lasciare l'inglese (sempre valido) e la lingua in uso nel sistema, nel nostro caso l'italiano. Tutte le altre sono state omesse.
 
* Type: indica che stiamo creando un file e non un'applicazione o un dispositivo (voci che compaiono in basso nel menu ''Crea'')
 
* Type: indica che stiamo creando un file e non un'applicazione o un dispositivo (voci che compaiono in basso nel menu ''Crea'')
* URL: è il percorso in cui il modello HTML effettivamente si trova. Per default Dolphin se lo aspetta nella sottocartella <code>.source</code> e col nome <HTMLFile.html>.  
+
* URL: è il percorso in cui il modello HTML effettivamente si trova. Per default Dolphin se lo aspetta nella sottocartella <code>.source</code> e col nome <code>HTMLFile.html</code>.
 
* Icon: è l'icona che comparirà nel menu. Si rimanda all'ultimo paragrafo per la personalizzazione dell'icona.
 
* Icon: è l'icona che comparirà nel menu. Si rimanda all'ultimo paragrafo per la personalizzazione dell'icona.
  
Tornando al modello C++, il file <code>CPPFile.desktop</code> può essere modificato come segue:
+
Tornando al modello C++, il file <code>CppFile.desktop</code> può essere modificato come segue:
<code>
+
 
[Desktop Entry]
+
[Desktop Entry]
Name=C++ File...
+
Name=C++ File...
Name[it]=File C++...
+
Name[it]=File C++...
Comment=Enter C++ filename:
+
Comment=Enter C++ filename:
Comment[it]=Inserisci il nome del file C++:
+
Comment[it]=Inserisci il nome del file C++:
Type=Link
+
Type=Link
URL=.source/CppFile.cpp
+
URL=.source/CppFile.cpp
Icon=text-x-c++src
+
Icon=text-x-c++src
</code>
 
  
 
A questo punto non resta che creare il modello vero e proprio. Muoviamoci nella cartella creata precedentemente
 
A questo punto non resta che creare il modello vero e proprio. Muoviamoci nella cartella creata precedentemente
Riga 54: Riga 55:
 
E creiamo con l'editor di testo preferito il file CppFile.cpp (il nome '''deve''' corrispondere con quello inserito nel file <code>.desktop</code>) e scriviamo il nostro contenuto. Per un file C++ avremo ad esempio
 
E creiamo con l'editor di testo preferito il file CppFile.cpp (il nome '''deve''' corrispondere con quello inserito nel file <code>.desktop</code>) e scriviamo il nostro contenuto. Per un file C++ avremo ad esempio
  
<code>
+
{{Note
 +
|type=example
 +
|text=CppFile.cpp
 +
<pre>
 
#include <iostream>
 
#include <iostream>
 
using namespace std;
 
using namespace std;
  
 
int main(int argc, char** argv) {
 
int main(int argc, char** argv) {
 +
  
 
     return 0;
 
     return 0;
}
+
}</pre>
</code>
+
}}
  
 
Fine! Possiamo chiudere e riaprire Dolphin e avremo un modello C++ pronto con un paio di click.
 
Fine! Possiamo chiudere e riaprire Dolphin e avremo un modello C++ pronto con un paio di click.
  
= Personalizzare l'icona =
+
== Personalizzare l'icona ==
Per far comparire l'icona giusta nel menu dobbiamo inserire il tipo MIME alla voce ''Icon''. Nel caso di un sorgente C++ il tipo MIME è <code>text/x-c+src</code> e pertanto scriveremo
+
Per far comparire l'icona giusta nel menu dobbiamo inserire il '''tipo MIME''' alla voce ''Icon''. Nel caso di un sorgente C++ il tipo MIME è <code>text/x-c++src</code> e pertanto scriveremo
 
  Icon=text-x-c++src
 
  Icon=text-x-c++src
 
Osserviamo che la sintassi non prevede slash (/) ma solo trattini (-).
 
Osserviamo che la sintassi non prevede slash (/) ma solo trattini (-).
Se non siamo sicuri del tipo MIME possiamo aprire il menu KDE e, alla voce applicazioni, cercare tra i tipi conosciuti, come mostrato in nell'immagine.
+
Se non siamo sicuri del tipo MIME possiamo aprire le impostazioni e, alla voce applicazioni, cercare tra i tipi conosciuti come mostrato nell'immagine sottostante.
 +
 
 +
[[File:Kde_associazione_file.png|center|1000px]]
  
 
[[Category: Howto]]
 
[[Category: Howto]]
 +
[[Category: KDE]]

Versione attuale delle 10:23, 30 mar 2024

Golem-template-note-warning.png Questa procedura fa riferimento a KDE5


Il gestore di file per KDE, Dolphin, mette a disposizione un menu per la creazione di nuovi file, tra cui un template HTML. Un template (modello) è un file di esempio che contiene la struttura base da riempire con contenuti propri. Potrebbe essere comodo, ad esempio per un programmatore, aggiungere un nuovo template per file C++ che contenga l'intestazione e la funzione main.

Kde menu crea.png

Creazione delle cartelle e del file.desktop

Apriamo un terminale e posizioniamoci nella cartella seguente

cd .local/share

Creiamo la cartella templates ed entriamoci

mkdir templates
cd templates

Creiamo infine una sottocartella che ci servirà dopo

mkdir .source

Nella cartella templates dovremo aggiungere un file con estensione .desktop per ogni modello (ad esempio CFile.desktop, CppFile.desktop, PhpFile.desktop, etc...). Invece di scrivere da zero il file (procedura noiosa e incline a errori) possiamo copiare il file HTML di esempio dalla cartella template di sistema:

cp /usr/share/templates/HTMLFile.desktop CppFile.desktop

Personalizzazione

Il contenuto sarà all'incirca il seguente:

[Desktop Entry]
Name=HTML File...
Name[it]=File HTML...
Comment=Enter HTML filename:
Comment[it]=Inserisci il nome del file HTML:
Type=Link
URL=.source/HTMLFile.html
Icon=text-html

Analizziamo i campi di questo file:

  • Name: è il testo che comparirà nel menu Crea di KDE (come nell'immagine in alto)
  • Comment: è il titolo della finestra di dialogo che permette l'inserimento del nome del file

NOTA: KDE prevede per ogni output testuale la localizzazione in tutte le lingue supportate. Per semplicità si consiglia di lasciare l'inglese (sempre valido) e la lingua in uso nel sistema, nel nostro caso l'italiano. Tutte le altre sono state omesse.

  • Type: indica che stiamo creando un file e non un'applicazione o un dispositivo (voci che compaiono in basso nel menu Crea)
  • URL: è il percorso in cui il modello HTML effettivamente si trova. Per default Dolphin se lo aspetta nella sottocartella .source e col nome HTMLFile.html.
  • Icon: è l'icona che comparirà nel menu. Si rimanda all'ultimo paragrafo per la personalizzazione dell'icona.

Tornando al modello C++, il file CppFile.desktop può essere modificato come segue:

[Desktop Entry]
Name=C++ File...
Name[it]=File C++...
Comment=Enter C++ filename:
Comment[it]=Inserisci il nome del file C++:
Type=Link
URL=.source/CppFile.cpp
Icon=text-x-c++src

A questo punto non resta che creare il modello vero e proprio. Muoviamoci nella cartella creata precedentemente

cd .source

E creiamo con l'editor di testo preferito il file CppFile.cpp (il nome deve corrispondere con quello inserito nel file .desktop) e scriviamo il nostro contenuto. Per un file C++ avremo ad esempio

Golem-template-note-example.png CppFile.cpp

#include <iostream>
using namespace std;

int main(int argc, char** argv) {


    return 0;
}


Fine! Possiamo chiudere e riaprire Dolphin e avremo un modello C++ pronto con un paio di click.

Personalizzare l'icona

Per far comparire l'icona giusta nel menu dobbiamo inserire il tipo MIME alla voce Icon. Nel caso di un sorgente C++ il tipo MIME è text/x-c++src e pertanto scriveremo

Icon=text-x-c++src

Osserviamo che la sintassi non prevede slash (/) ma solo trattini (-). Se non siamo sicuri del tipo MIME possiamo aprire le impostazioni e, alla voce applicazioni, cercare tra i tipi conosciuti come mostrato nell'immagine sottostante.

Kde associazione file.png