Differenze tra le versioni di "KDE5 file template"
m (blocchi codice) |
m (Pagina categorizzata anche su KDE) |
||
(3 versioni intermedie di un altro utente non mostrate) | |||
Riga 1: | Riga 1: | ||
− | 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 | + | {{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''. | ||
− | + | [[File:Kde_menu_crea.png|center|600px]] | |
− | = Creazione delle cartelle e del file.desktop = | + | == Creazione delle cartelle e del file.desktop == |
− | + | Apriamo un terminale e posizioniamoci nella cartella seguente | |
cd .local/share | cd .local/share | ||
− | + | 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 | ||
− | + | mkdir .source | |
− | Nella cartella templates | + | 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 | + | cp /usr/share/templates/HTMLFile.desktop CppFile.desktop |
− | = Personalizzazione = | + | == Personalizzazione == |
Il contenuto sarà all'incirca il seguente: | Il contenuto sarà all'incirca il seguente: | ||
Riga 29: | Riga 33: | ||
Analizziamo i campi di questo file: | Analizziamo i campi di questo file: | ||
− | * Name: è il testo che comparirà nel menu ''Crea'' di KDE ( | + | * 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> | + | Tornando al modello C++, il file <code>CppFile.desktop</code> può essere modificato come segue: |
[Desktop Entry] | [Desktop Entry] | ||
Riga 51: | 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 | ||
− | + | {{Note | |
− | + | |type=example | |
− | + | |text=CppFile.cpp | |
− | + | <pre> | |
− | + | #include <iostream> | |
− | + | using namespace std; | |
− | + | ||
+ | int main(int argc, char** argv) { | ||
+ | |||
+ | |||
+ | return 0; | ||
+ | }</pre> | ||
+ | }} | ||
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 | + | 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
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.
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 nomeHTMLFile.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
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.