Istruzioni su GitHub e OpenDesktop per Andrea

[gusbemacbe]

Buonasera, @Bonandry!

Anche in mia assenza, non sentirti solo. Non sarai abbandonato. Cercherò di contattare gli utenti specifici che intendo invitare e con cui intendo comunicare.

Qui sotto ho preparato delle istruzioni passo per passo per aiutarti ad aggiornare la tua repository su GitHub ed i tuoi progetti su OpenDesktop/Pling.

Ti chiedo solo una cosa importante: NON avere paura d’utilizzare il terminale, va bene? So molto bene che, in passato, preferivi GitHub Desktop, ed l’ho compreso perfettamente. Tuttavia, utilizzare alcuni comandi semplici nel terminale è sicuro, non può danneggiare il sistema e ti darà più controllo. Ti guiderò con calma.

---

GitHub

1. Creare il token d’accesso

Per prima cosa, devi generare un token d’accesso personale dettagliato (in inglese: fine-grained access token).

Puoi pensarlo come una password speciale per il tuo computer, usata solo da git per accedere a GitHub.

Basta andare semplicemente a questo link: https://github.com/settings/personal-access-tokens

Clicca su «Generate new token». Guarda lo screenshot qui sotto e clicca sull’immagine per ingrandirla in una nuova scheda:

Compila così:

• In «Token name», scrivi, ad esempio: Computer di Bonandry;
• Nella descrizione, puoi scrivere qualcosa come: Il token per il computer di Bonandry per poter scaricare, caricare ed aggiornare le repository;
• Scegli una data di validità (nota che, quando scade, dovrai semplicemente crearne uno nuovo)
• Seleziona «All repositories» (in italiano: tutte le repository)
• Aggiungi questi permessi:
  • Actions
  • Administration
  • Commit statuses
  • Contents (molto importante)
  • Issues
  • Merge queues
  • Pages
  • Pull requests

Infine, clicca su «Generate token».

2. Salvare il token

Apri Gedit e copia il token appena generato.

In primo luogo, su Nautilus, prima di creare il file, ricordati di premere Ctrl + H per mostrare e nascondere i file che hanno un punto all’inizio.

Ora crea un file chiamato .git-credentials nella cartella dell’utente (la tua home) e aprilo con Gedit.

Guarda lo screenshot:

Dentro il file, scrivi una riga come questa (è solo un esempio):

Bonandry:TOKEN@github.com

Sostituisci TOKEN con il token vero che hai copiato.

3. Creare il file di configurazione

Sempre nella cartella dell’utente, crea un file chiamato .gitconfig e aprilo con Gedit. Copia e incolla esattamente questo contenuto:

[color]
  ui = auto
[core]
  editor    = "$(which gedit)"
  quotePath = false
[credential]
  helper = store
[filter "lfs"]
  clean     = git-lfs clean -- %f
  process   = git-lfs filter-process --skip
  required  = true
  smudge    = git-lfs smudge --skip -- %f
[help]
  autocorrect = 1
[http]
  postBuffer = 12M
[init]
  defaultBranch = main
[pull]
  ff = only
[user]
  email    = bonandry@gmail.com
  name     = Andrea Bonanni
  username = Bonandry

Questi sono solo parametri di configurazione: non possono danneggiare nulla.

4. Scaricare (clonando) la repository

Ora puoi creare una nuova cartella chiamata GitHub nella cartella dell’utente.

Apri il terminale e digita:

cd ~/GitHub
git clone https://github.com/Bonandry/adwaita-plus

Questo comando scarica una copia del progetto sul tuo computer. Verrà creata automaticamente la cartella adwaita-plus.

5. Lavorare e salvare le modifiche

A questo punto puoi aggiungere tutte le modifiche che hai già fatto tra il 2021 e il 2024.

Quando hai finito:

Apri il terminale e digita:

cd ~/GitHub/adwaita-plus
git add .

Poi esegui:

git commit

Gedit si aprirà automaticamente.

• Scrivi un messaggio semplice, ad esempio: Aggiornamento icone 2024;
• Quando hai finito, salva con Ctrl + S e chiudi Gedit.

Infine, aggiorna la repository con:

git push

Come vedi, è possibile lavorare tranquillamente anche senza GitHub Desktop.

Preparerò a breve anche le istruzioni per aggiornare il tuo progetto su OpenDesktop.

[gusbemacbe]

Good evening, @L4ki!

How are you?

I would like to reach out to you to invite you to our conversation.

I decided no longer to continue, update, or maintain for many reasons. I have also talked to @Bonandry yesterday and today. He told me he has also no longer time to update his icons theme, as Adwaita++ and Yaru++.

Then, we would like to offer the transfer of ownership of our repositories to you because I saw you are a potential icons themes designer and developer who actively maintains and updates the excellent icons theme that are ones of the most rated in the icons theme category. Observe that Adwaita++, Suru++, and Yaru++ also are ones of the most rated. I believe that these icons themes will help you to receive more donations.

Do you accept receiving our icons themes?

Thank you for your attention, patience, understanding, and help!