Attività e strumenti
Prima di iniziare
Prima di tutto
- Per contribuire a UserBase devi creare un account. Leggi quali vantaggi ti offre nella pagina Avvio rapido. Qui troverai anche aiuto su come registrarti e connetterti.
- Sii consapevole che il tuo contributo verrà gestito con due licenze. In ogni pagina sono presenti icone/collegamenti nella barra laterale. Fai clic sulle immagini nel pannello di navigazione per leggere i dettagli. Stai accettando che il tuo contributo sia disponibile pubblicamente e che altri possano utilizzare le informazioni nei propri siti.
- Utilizza la pagina Discussione per comunicare con gli altri collaboratori o per chiedere aiuto. Normalmente qualcuno ti risponderà entro un giorno.
Pertinenza
Il tuo contributo dovrebbe riguardare il software KDE, direttamente o indirettamente. Pensato quindi:
per i nuovi utenti, come aiuto per iniziare;- per gli utenti comuni, per imparare nuove funzioni e per suggerimenti;
- per gli utenti esperti, ma utilizzando sottopagine.
Non per gli sviluppatori: Techbase è il sito a loro dedicato.
Come contribuire
Aggiornando il contenuto esistente
- Aggiornare un'immagine sostituendola con una più nuova.
- Creare una schermata
- Modificare il contenuto esistente, correggere l'ortografia, chiarire una descrizione, aggiungere ulteriori dettagli.
Aggiungere nuove pagine
- Creare una nuova pagina, mostrare una panoramica di un'applicazione, introdurre un nuovo concetto.
- Scrivere un manuale. Devi conoscere un'applicazione abbastanza bene e probabilmente essere in contatto con l'autore. Ti possiamo aiutare.
Lavorare con le lingue
- Preparing a page for translation needs more patience than skill. If you can spare short periods of time, frequently, this is a very helpful task.
- Translate a page. You need to be fluent in a language, but not a professional translator to translate a wiki page. Translating manuals is the skill of a special team. That page also points you to instructions for translating sidebar links.
- Translate with Off-Line Tools. Get the essentials for Gettext and Import.
- How To Convert UserBase Manual to Docbook gives you an insight into the process that takes place on your finished manual.
- WikiSentinel is a specialized feed reader that collects the translated pages that need to be updated. It allows you to see a preview of the changes in the selected page and open it directly in the web browser: ready to translate.
Ricorda
È importante essere coerenti, particolarmente nei manuali, ecco dunque alcune regole generali:
- Fai attenzione ai livelli dei titoli delle sezioni: iniziamo con il secondo livello (Mediawiki usa il primo livello per il nome della pagina) utilizzando ==.
- Assicurati di fare riferimento spesso a questa pagina e a Linee guida tipografiche.
- Controlla che tutte le celle delle tabelle abbiano uno spazio dopo il carattere pipe. Questa regola è conforme alla tradizionale formattazione dei wiki.
- Fai in modo che la formattazione dei nomi delle applicazioni sia coerente (evita di usare Amaroks, utilizza Amarok's).
- Assicurati che tutte le immagini siano in formato PNG (puoi utilizzare anche il JPEG, ma in questo caso dovresti convertire poi le immagini in PNG). Risparmia tempo convertendole prima di iniziare
.
- Rimuovi tutti i caratteri non stampabili dai nomi delle immagini.
Consigli e suggerimenti
Attention
Se una pagina è obsoleta e dovrebbe essere rimossa, aggiungila in Pagine da eliminare e un amministratore se ne occuperà.
Alcune impostazioni che possono aiutare:
- Se non hai i collegamenti [modifica] di fianco alle sezioni, apri le tue (nella sezione della barra laterale) e cerca e in imposta .
- Sempre tra queste impostazioni attiva : mentre stai facendo una modifica puoi dare un'occhiata all'originale come riferimento.
- La visualizzazione predefinita prevede l'anteprima sopra la casella di modifica. Se preferisci che la casella di modifica sia sopra, puoi modificare questa impostazione sempre nella stessa sezione delle preferenze.