Supportare la guida
Nota: Questa comunità usa una guida non ufficialmente gestita da Acidanthera. Per favore non segnalare issue riguardo a questa guida ad Acidanthera.
Vuoi aiutare supportando la guida? Bene ci sono molte modi in cui puoi aiutare!
Nota: Per chi vuole contribuire economicamente, veramente lo apprezziamo ma siamo un'organizzazione non-profit. Lo facciamo per insegnare, non per fare soldi. Se hai alcuni soldi rimasti, ti raccomandiamo altamente di donarli in carità. Crohn's and Colitis Canada è ciò che raccomandiamo se non ne hai nessuno in mente.
Contribuire via Issue
Contribuire via Issue è piuttosto semplice ma qui ecco alcune regole:
- La zona issue è dedicata solo ai problemi della guida, nessun issue del proprio hackintosh. Non è un posto dove discutere i problemi di installazione.
- Se è per un errore di trascrizione oppure un chiarimento, per favore indica in quale pagina sia. Lo apprezzeremmo per non andare noi a esplorare in quale pagina possa essere.
Puoi trovare il bugtracker qui: Bugtracker
Contribuire via PR
Alcune linee guida quando contribuisci tramite PR:
- Usa il tuo cervello (per favore).
- Dimostra le tue affermazioni.
- Le Pull Request possono essere rifiutate se non corrispondono o hanno informazioni inaccurate. Generalmente motiveremo perché viene rifiutata o perché viene richiesta una revisione.
- Apprezziamo le fonti per qualsiasi grande proposta, per rendere più semplice la verifica della attendibilità delle tue affermazioni
- Le immagini devono essere scaricate localmente nella repository dentro la cartella
/.vuepress/public/images/
- La tua PR deve aver superato un markdown lint e aver sistemato tutti i problemi.
- In generale, evitare quando possibile di usare strumenti "non-Acidanthera". Generalmente vogliamo evitare di usare qualsiasi strumento di terze parti - tranne quando è impossibile, quindi aggiungi il link a questo.
- Tool esplicitamente banditi:
- UniBeast, MultiBeast e KextBeast
- Più informazioni possono essere trovate qui: Tonymacx86-stance (EN)
- TransMac
- Famoso per creare dischi USB rotti
- Installer Niresh
- Vorremmo evitare la pirateria in queste guide
- UniBeast, MultiBeast e KextBeast
- Tool esplicitamente banditi:
Come contribuire
Il miglior modo di testare i tuoi commit ed essere sicuro che siano formattati correttamente è di scaricare Node.js dopo usare il comando npm install
per installare le dipendenze. Quando scrivi npm run dev
, imposterà un server web locale in cui puoi connetterti per vedere le modifiche fatte. npm test
troverà ogni errore riguardo alla formattazione e anche nello spellcheck. Se vuoi fare il markdownlint
per sistemare automaticamente gli errori di lint, usa npm run fix-lint
.
Semplici step:
- Esegui un fork della repo
- Installa i tool richiesti:
- Esegui le tue modifiche.
- Compila il sito:
npm install
(Per installare tutti i plugin richiesti)npm run dev
(Crea un'anteprima del sito)- La puoi trovare su
http://localhost:8080
- La puoi trovare su
- Controlla il lint:
npm run lint
per avviare i testnpm run fix-lint
Per risolvere quasi ogni tipo di errore
Suggerimenti
Alcuni tool per fare in modo che contribuire sia più facile:
- Visual Studio Code
- Typora per avere le modifiche al markdown in tempo reale.
- TextMate per fare facilmente un massivo find/replace.
- Github Desktop per avere una GUI più user friendly.
Contribuire via Traduzioni
Mentre le guide Dortania sono basate sull'Inglese in maniera primaria, sappiamo che ci sono altri miliardi di lingue nel mondo (come l'Italiano) e che non tutti sono bravi con l'Inglese. Se vuoi aiutare traducendo la guida in lingue differenti, saremo molto felici di aiutarti.
Le cose da ricordare:
- Traduzioni devono essere un fork dedicato e non diventeranno un merge delle guide Dortania
- I fork devono indicare che sono traduzioni di Dortania e che non sono ufficiali
- I fork devono contenere la nostra licenza License
Se riconosci tutti i requisiti, sei libero di pubblicare liberamente la tua traduzione senza esitazioni! I siti Dortania sono compilati con VuePress usando GitHub Actions e infine hostati su Github Pages, perciò non c'è nessun costo per la tua traduzione personale.
Se hai domande o dubbi riguardo le traduzioni o l'hosting, sii libero di raggiungere il nostro Bugtracker.
Traduzioni correntemente conosciute:
- InyextcionES (Spagnolo)
- macOS86 (Italiano! Da poco riabilitata, cerchiamo aiuto per tradurla)
- Technopat (Turco)
- ThrRip (Cinese)
- Shijuro (Russo)
- viOpenCore (Vietnamita)
E nota che queste traduzioni sono soggette alle preferenze degli autori, ai cambiamenti delle traduzioni e agli errori umani. Per favore ricordatene quando le leggi e ricordati che non sono ufficiali, al contrario delle guide Dortania.