Help:Reading (Italiano)

Translation Status:
This article is a localized version of
Help:Reading
. Last translation date: 2022-09-17. You can help to synchronize the translation, if there were
changes
in the English version.
Articoli correlati
Help:Browsing
Help:Style
Poiché la maggior parte di ArchWiki contiene indicazioni che potrebbero richiedere chiarimenti per i nuovi utenti di Arch Linux (o GNU/Linux in generale), e' stata redatta questa rassegna di procedure di base sia per evitare confusione nell'assimilazione degli articoli sia per scoraggiare la ripetizione dei contenuti stessi.
Organizzazione
La maggior parte degli articoli ArchWiki non adottano un approccio olistico nel tentativo di illustrare un singolo argomento; questi contributi sono al contrario scritti sulla base del principio
DRY
, e dell'assunto che l'utente provvederà a cercare e leggere ogni tipologia di materiale di supporto relativo agli argomenti di cui non abbia ancora piena comprensione. Ove possibile, detto materiale viene indicato all'interno dell'articolo mediante una formattazione speciale, vedere
#Formattazione
.
In ragione di questo tipo di organizzazione, potrebbe essere necessario esaminare diverse fonti correlate per comprendere a pieno il contenuto di un articolo ArchWiki. In particolare, i nuovi utenti Arch (o GNU/Linux in generale) possono avere la ragionevole aspettativa di dover leggere un numero consistente di articoli per risolvere anche i problemi più semplici. È oltremodo importante studiare il materiale di supporto prima di chiedere ulteriore aiuto ad altri utenti.
Formattazione
link a una sezione del presente articolo:
#Organizzazione
link a
un altro articolo ArchWiki
link a
una pagina web esterna
link a una
pagina del manuale
:
intro(1)
una
pagina del manuale
disponibile esclusivamente offline:
foo(1)
link a un pacchetto nei
repository ufficiali
:
foobar
link a un pacchetto nell'
AUR
:
foobar
AUR
Utente normale o root
Alcune righe di comando sono riportate come segue:
# mkinitcpio -p linux
mentre altre hanno un prefisso diverso:
$ makepkg -s
Il cancelletto o hashtag (
#
) indica che un comando deve essere eseguito come utente
root
, mentre il simbolo del dollaro (
$
) segnala che il comando va eseguito come
utente normale
.
Nota
I comandi con prefisso
#
devono essere eseguiti da una
shell root
, alla quale è ad esempio possibile accedere facilmente utilizzando il comando
sudo -i
. L'esecuzione di
sudo
comando
da una shell senza privilegi root anziché di
comando
da una shell root è altresì una soluzione che funzionerà nella maggior parte dei casi, con alcune significative eccezioni quali la
redirezione
e la
sostituzione di comandi
, che richiedono obbligatoriamente una shell root. Vedere anche
sudo
.
Un'eccezione rilevante alla quale prestare attenzione:
# This alias makes ls colorize the listing
alias ls='ls --color=auto'
In questo esempio, il contesto in cui si trova il cancelletto comunica che il testo dopo di esso non deve essere eseguito come comando; questa linea è invece destinata a essere inserita in un file. Pertanto, in questo caso, il cancelletto denota un
commento
. Un commento può rappresentare un testo con funzione esplicativa che non verrà interpretato dal programma associato. Incidentalmente, l'indicazione dei commenti negli script
Bash
coincide con il simbolo root
PS1
.
A un ulteriore esame, si rileva che gli elementi che segnalano che non si tratta di un comando includono il carattere maiuscolo immediatamente dopo il segno
#
. Di norma, i comandi Unix non sono scritti in questo modo e nella maggior parte dei casi si tratta di abbreviazioni anziché parole inglesi riportate per esteso (ad esempio.,
Copy
diventa
cp
).
In ogni caso, il più delle volte gli articoli semplificano l'identificazione di questi casi segnalandoli esplicitamente al lettore:
Aggiungere
alla fine del file
~/path/to/file
:
# This alias makes ls colorize the listing
alias ls='ls --color=auto'
Apporre, aggiungere, creare, modificare
Quando si riceve l'istruzione di
aggiungere alla fine di un file
(il termine inglese
append
indica l'azione di aggiungere un contenuto esattamente alla fine), di
aggiungere a
(il termine inglese
add
indica l'azione di aggiungere senza alcun vincolo di posizione), di
creare
o di
modificare
uno o più file, si presuppone l'utilizzo di uno dei seguenti metodi.
Per creare o modificare file con più linee si consiglia l'utilizzo di un
editor di testo
. Ad esempio, per utilizzare
nano
per modificare il file
/etc/bash.bashrc
eseguire il seguente comando:
# nano /etc/bash.bashrc
Per creare o sovrascrivere un file da una stringa potrebbe risultare più semplice utilizzare la
redirezione dell'output
. Il seguente esempio crea o sovrascrive il contenuto del file
/etc/hostname
con il testo
myhostname
.
# echo myhostname > /etc/hostname
La redirezione dell'output può essere utilizzata anche per aggiungere una stringa alla fine di un file. Il seguente esempio aggiunge il testo
[custom-repo]
alla fine del file
/etc/pacman.conf
.
# echo "[custom-repo]" >> /etc/pacman.conf
Quando viene data l'istruzione di creare una
cartella
, utilizzare il comando
mkdir
:
# mkdir /mnt/boot
Rendere un file eseguibile
Dopo aver creato un file, se questo deve essere eseguito come script (manualmente o da parte di un altro programma) sarà necessario renderlo
eseguibile
, ad esempio con il comando:
$ chmod +x
script
Vedere
chmod
. Alcune applicazioni quali i
file manager
potrebbero fornire delle interfacce grafiche per eseguire questa operazione.
Source
Determinate applicazioni, in particolare le
shell della riga di comando
, utilizzano degli script per gestire la propria configurazione: dopo averli modificati, questi script devono essere
sourced
affinché le modifiche vengano effettivamente applicate. Nel caso di
bash
, ad esempio, questa operazione si esegue con il comando (è altresì possibile sostituire
source
con
.
):
$ source ~/.bashrc
Nei casi in cui la wiki suggerisce di modificare uno di questi script di configurazione, non verrà ricordata esplicitamente la necessità di eseguire l'operazione di
source
del file, e solo in alcuni casi sarà presente un link che rimanda a questa sezione come promemoria.
Installazione di pacchetti
Quando un articolo invita a installare dei pacchetti in modo convenzionale, non indicherà le istruzioni dettagliate per eseguire questa operazione, limitandosi invece a menzionare i nomi dei pacchetti da installare.
Nota
Spesso vengono utilizzati link
installare
o
installato
che rimandano al presente articolo. Tuttavia è necessario che JavaScript sia abilitato affinché questi link funzionino.
I sottoparagrafi di seguito forniscono una panoramica delle procedure generiche di installazione a seconda del tipo di pacchetto.
Pacchetti ufficiali
Per i pacchetti presenti nei
repository ufficiali
si leggerà un testo di questo tipo:
Installare il pacchetto
foobar
.
Ciò significa che si dovrà eseguire il comando:
# pacman -S foobar
L'articolo
pacman
illustra in modo dettagliato le nozioni per una corretta gestione dei pacchetti in Arch Linux.
Arch User Repository
Per i pacchetti presenti nell'
Arch User Repository
(AUR) si leggerà un testo di questo tipo:
Installare il pacchetto
foobar
AUR
.
Ciò significa che occorre in generale seguire il link
foobar
AUR
, scaricare l'archivio PKGBUILD, estrarlo,
verificarne il contenuto
e infine eseguire, nella medesima cartella:
$ makepkg -si
Nota
Per compilare i programmi presenti nell'AUR o per utilizzare il sistema
ABS
è necessario installare il gruppo di pacchetti
base-devel
.
L'articolo
Arch User Repository
contiene tutte le spiegazioni dettagliate e le migliori pratiche per la gestione dei pacchetti AUR.
Controllo delle unità systemd
Quando un articolo invita a
avviare
,
abilitare
,
arrestare
o
riavviare
determinate unità systemd (ad es. un servizio), non riporterà le istruzioni dettagliate per eseguire queste operazioni, bensì sarà presente un testo di questo tipo:
Avviare
example.service
.
Ciò significa che si dovrà eseguire il comando:
# systemctl start example.service
Un comando degno di nota che non segue esattamente questo schema è
systemctl daemon-reload
, che viene invocato senza argomenti.
La sezione
systemd#Utilizzo delle unità
contiene un elenco strutturato delle azioni disponibili (come
start
,
enable
,
enable e start
, ecc.) con i corrispondenti comandi
systemctl
.
Configurazione a livello di sistema o specifica per utente
È importante ricordare che in un sistema GNU/Linux sono due i tipi di configurazione possibili. Una configurazione
a livello di sistema
riguarda tutti gli utenti. Dal momento che le impostazioni a livello di sistema si trovano di norma nella cartella
/etc
, per modificarle è necessari possedere i privilegi di root. Ad esempio, per applicare un'impostazione Bash per tutti gli utenti si dovrà modificare il file
/etc/bash.bashrc
.
Una configurazione
specifica per utente
riguarda esclusivamente un singolo utente. A tal fine si utilizzano i cosiddetti
dotfiles
. Ad esempio, il file
~/
.
bashrc
è il file di configurazione specifico per l'utente. L'idea alla base di questo approccio è la possibilità per ogni utente di definire le proprie impostazioni, quali alias, funzioni e altre caratteristiche interattive quali il prompt, senza incidere su quelle degli altri utenti.
Nota
~/
e
$HOME
sono scorciatoie per la cartella home dell'utente, di norma
/home/
nome utente
/
.
File comuni della shell
Bash e altre shell compatibili con quest'ultima, come
Zsh
, eseguono il
sourcing
di file diversi a seconda che si tratti di
shell di login
o di
shell interattiva
. Vedere
Bash#Configuration files
e
Zsh#Startup/Shutdown files
per maggiori dettagli.
Pseudo-variabili negli esempi di codice
Alcuni blocchi di codice possono contenere le cosiddette
pseudo-variabili
le quali, come in effetti testimoniato dal nome, non sono vere e proprie variabili utilizzate nel codice. Si tratta invece di segnaposto generici che devono essere sostituiti manualmente con elementi specifici di configurazione del sistema
prima
che il codice possa essere eseguito o analizzato. Le shell di comune utilizzo come
bash
e
zsh
offrono la funzione di
tab-completion
per completare in modo automatico i parametri dei comandi più comuni come ad esempio
systemctl
.
Negli articoli che si conformano alle regole di
formattazione e punteggiatura
, le
pseudo-variabili
sono formattate in stile italico. Ad esempio:
Abilitare
il servizio
dhcpcd@
nome_interfaccia
.service
per l'interfaccia di rete identificata dall'output del comando
ip link
.
In questo caso
nome_interfaccia
viene utilizzato come una
pseudo-variabile
segnaposto in un'unità modello systemd. Tutte le unità modello systemd, identificabili in virtù della presenza del carattere
@
, richiedono un elemento di configurazione specifico per il sistema come argomento. Vedere
Systemd#Using units
.
Il comando
dd if=
sorgente_dati
of=/dev/sd
X
bs=
dimensione_settori
count=
numero_settori
seek=
settore_inizio_partizioni
può essere eseguito come utente root per cancellare una partizione con i parametri specificati.
In questo caso le
pseudo-variabili
sono utilizzate per descrivere i parametri che devono essere inseriti al loro posto. I dettagli su come individuare tali parametri sono disponibili nella sezione
Securely wipe disk#Calculate blocks to wipe manually
, nella quale è descritto il comando.
This article or section needs expansion.
Reason:
Menzionare altri esempi, idealmente da altre categorie di dispositivi (ad es. archiviazione), con link che rimandino ad articoli di descrizione del background. Gli esempi hanno la finalità di evitare la ripetizione di spiegazioni già esistenti in altri articoli. (Discuss in
Help talk:Reading (Italiano)
)
Nel caso di esempi con file, incollando le pseudo-variabili all'interno di file di configurazione veri e propri si potrebbe causare il malfunzionamento dei relativi programmi.
Ellissi
Nella maggior parte dei casi le ellissi (
...
) non sono parte dell'effettivo contenuto del file o dell'output di codice, ma rappresentano testo omesso o opzionale, non rilevante per l'argomento trattato.
Ad esempio
HOOKS="... encrypt ... filesystems ..."
o:
/etc/X11/xorg.conf.d/50-synaptics.conf
Section "InputClass"
    ...
    Option      "CircularScrolling"          "on"
    Option      "CircScrollTrigger"          "0"
    ...
EndSection
Occorre tuttavia essere consapevoli che, in alcuni casi, le ellissi possono essere parte integrante della sintassi del codice: gli utenti più esperti non avranno difficoltà a riconoscere questi casi in base al contesto.