GNU/Linux >> Linux Esercitazione >  >> Linux

Guida al formato per gli articoli How-To di Atlantic.Net

Introduzione

Se pensi di voler scrivere per Atlantic.Net, dovresti iniziare completando il nostro modulo di registrazione.

Gli articoli di istruzioni per Atlantic.Net devono essere conformi agli standard indicati nelle sezioni seguenti:

Sezioni (inclusi Introduzione, Prerequisiti e il tutorial stesso)
Formato (markdown o HTML semplice)
Immagini/Screenshot
Opera originale

Consulta anche la nostra guida di stile per ulteriori indicazioni.

Sezioni

Ogni articolo How-To dovrebbe iniziare con la sezione Introduzione, che descrive brevemente lo scopo dell'articolo. La parola "Introduzione" dovrebbe essere contenuta nelle intestazioni di H3.

La seguente introduzione dovrebbe essere Prerequisiti, indicati con le intestazioni H3. I prerequisiti dovrebbero includere il sistema operativo a cui è pertinente l'articolo, inclusa la distribuzione appropriata (ad es. "Ubuntu 14.04 e precedenti" o "Windows Server 2012 e Windows Server 2012 R2").

Dovresti anche includere i pacchetti, i ruoli o le funzionalità richieste e la cui installazione, e questo articolo non tratterà la configurazione. Verificare che esista un articolo che copre tale installazione/configurazione e includere un collegamento.

Esempio:(estratto da Installa WordPress su un server cloud Fedora 22.)

Prerequisito

– È richiesto un server Fedora 22 che esegue LAMP o LEMP. Consulta le nostre istruzioni per Fedora 22 LAMP o LEMP.

La maggior parte dell'articolo, il tutorial, segue la sezione Prerequisiti.

Formato

Gli articoli How-To per Atlantic.Net possono essere inviati in Markdown o in HTML semplice.

Formattazione del testo supportata:testo dell'intestazione, blocchi di codice, codice inline (per comandi e sequenze di tasti), corsivo (per variabili) e grassetto (per enfasi).

Intestazioni

H2 dovrebbe essere utilizzato per le sezioni principali del tutorial.

H3 dovrebbe essere utilizzato per "Introduzione", "Prerequisiti" e sottosezioni del tutorial.

Blocchi di codice

Qualsiasi codice che deve essere inserito come parte del tutorial deve essere incluso in un blocco di codice.

Nella maggior parte dei casi, il codice inline verrà utilizzato per spiegare le variabili o le opzioni che potrebbero essere richieste dai comandi. Se fai riferimento al codice in linea, puoi utilizzare il code etichetta. Questo uso dovrebbe limitarsi a fare riferimento a una porzione di codice già inclusa in un blocco di codice vicino.

Esempio:

Fai attenzione quando usi -r opzione con rm . Tenta ricorsivamente di eliminare tutti i file subordinati al percorso che indichi.

Formato di informazioni variabile/personalizzato

I segnaposto per le variabili o le voci di configurazione personalizzate (come i nomi host) devono essere in corsivo. Il nostro parser tinterà anche tutte le voci in corsivo verde .

Enfasi

Se desideri indicare l'enfasi, usa il grassetto .

Premute sui tasti

Quando si tratta di fare riferimento a sequenze di tasti in linea con il testo, racchiuderle in un code span .

Esempio:

Premi Enter chiave.

Per le sequenze di tasti che richiedono la pressione simultanea di più tasti, utilizzare un segno più (+) tra i tasti.

Esempio:

Per uscire, premi Ctrl+C .

Per cambiare utente, premi prima Ctrl+Alt+Del .

.

Immagini

Le istruzioni dovrebbero includere schermate appropriate, mostrando elementi visivi come dove fare clic o come dovrebbe apparire una schermata (come una pagina phpinfo, per esempio). Le immagini devono avere una larghezza massima di 730 pixel.

Si prega di includere un collegamento all'immagine utilizzando l'URL in cui è attualmente ospitata. Gli articoli accettati per la pubblicazione avranno tutte le immagini associate scaricate e ospitate sui nostri server. Insieme alle immagini, abbiamo bisogno di quanto segue:

Nome immagine :formato anet-articlename-## (dove il ## è sostituito da un numero, ad esempio anet-how_to_install_lamp_debian_8-01 ).
Testo alternativo :una breve descrizione dell'immagine nel caso non venga caricata.
Didascalia :breve descrizione che compare sotto l'immagine.

Qualsiasi informazione identificabile in modo univoco dovrebbe essere oscurata, preferibilmente attraverso l'uso di nomi segnaposto prominenti (come "example.com" o "192.168.0.2").

Opera originale

Tutti gli articoli scritti per Atlantic.Net devono essere opere originali. Se hai già scritto un tutorial particolare altrove e vorresti fare qualcosa di simile con noi, allora cogli l'occasione per migliorare il tuo sforzo iniziale! Atlantic.Net non tollererà il plagio né il riutilizzo di lavori già esistenti.

Allo stesso modo, anche tutte le immagini e gli screenshot dovrebbero essere univoci.

Scopri di più sui nostri servizi di hosting VPS e sul prezzo di hosting VPS.


Linux
  1. Bash For Loop Guida ed esempi

  2. 10 guide ai contenitori per gli amministratori di sistema

  3. Linux:durante l'installazione di Linux su un'unità USB, quale filesystem dovrei usare per formattare per ottenere le migliori prestazioni?

  4. Guida al formato per gli articoli What-Is di Atlantic.Net

  5. Come formattare il codice all'interno delle pagine web

Atlantic.Net Cloud:come posso aggiornare le informazioni sui miei clienti per il mio account cloud

Atlantic.Net Cloud – Posso aumentare la scalabilità del mio server cloud?

Atlantic.Net Cloud – Come eseguire il reprovisioning di un server cloud

Atlantic.Net – Guida alla connessione VPN

Come configurare l'e-mail Atlantic.Net

Atlantic.Net Trusted Access – Guida all'autenticazione a più fattori