GNU/Linux >> Linux Esercitazione >  >> Linux

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

Introduzione

Se pensi di voler scrivere per Atlantic.Net, dovresti iniziare completando il nostro modulo di registrazione se non l'hai già fatto.

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

Sezioni (tra cui Introduzione, Pubblico di destinazione 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 Che cos'è dovrebbe iniziare con la sezione Pubblico di destinazione, indicata con intestazioni H5. Il pubblico di destinazione dovrebbe specificare quale livello di esperienza o conoscenza presumi che il lettore debba possedere per comprendere l'argomento di cui scriverai. Il livello minimo di esperienza per il pubblico di destinazione di un articolo What-Is dovrebbe essere professionisti IT di livello base. Qualsiasi argomento che presuppone che un lettore abbia familiarità con il materiale trattato in un altro articolo di Atlantic.Net può essere collegato qui.

Esempio:

Pubblico di destinazione

Questo articolo presuppone che tu abbia familiarità con i concetti di base alla base dell'infrastruttura a chiave pubblica (PKI). Per un ripasso, dai un'occhiata a questo primer sulle basi della crittografia a chiave pubblica.

Dopo il pubblico di destinazione dovrebbe esserci la sezione Introduzione, che descrive brevemente lo scopo dell'articolo. La parola "Introduzione" dovrebbe essere contenuta nelle intestazioni di H3.

La maggior parte dell'articolo segue l'introduzione.

Formato

Gli articoli What-Is 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

H1 dovrebbe essere utilizzato per il titolo dell'articolo. Il titolo dovrebbe essere sempre la prima parte di qualsiasi articolo.

H2 dovrebbe essere utilizzato per sezioni significative dell'articolo.

H3 dovrebbe essere utilizzato per "Introduzione", "Pubblico di destinazione" e sottosezioni.

Blocchi di codice

Gli articoli What-Is dovrebbero evitare di utilizzare codice o blocchi di codice (questo utilizzo è più diffuso in un articolo How-To). Tuttavia, se evidenzi l'aspetto del codice relativo al tuo argomento, dovrebbe essere racchiuso in un blocco di codice.

Se fai riferimento al codice in linea, puoi utilizzare il code etichetta. Questo uso dovrebbe limitarsi a fare riferimento a una porzione di codice la cui forma o funzione è rilevante per l'argomento. Tieni presente che l'obiettivo della maggior parte degli articoli What-Is non è insegnare a qualcuno come portare a termine un compito, ma spiegare in un senso più generale un concetto relativo alla tecnologia.

Esempio:

L'eredità comune di UNIX condivisa da molti sistemi operativi successivi è evidente in alcuni dei comandi che condividono tutti, come cp per la copia.

Formato di informazioni variabile/personalizzato

Le variabili o le informazioni specifiche dell'host dovrebbero essere rare in un articolo What-Is. Tuttavia, le variabili o le voci di configurazione personalizzate (come i nomi host) dovrebbero essere in corsivo se necessario. 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 . Anche in questo caso, questo tipo di inclusione dovrebbe essere raro in un articolo What-Is.

Esempio:

Il Enter la chiave può ancora essere chiamata Return tasto su alcune tastiere, tornando al suo utilizzo sulle macchine da scrivere per indicare un ritorno a capo.

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

Esempio:

La combinazione di tasti di Ctrl+Alt+Del guadagnato, in alcuni ambienti, l'appellativo di “saluto con tre dita”.

Immagini

Incoraggiamo l'uso di immagini e schermate per aiutare a chiarire molti dei punti che possono essere sollevati in un argomento Che cos'è. Le immagini devono avere una larghezza massima di 730 pixel. Puoi creare l'immagine tu stesso o utilizzare un'immagine concessa in licenza per il riutilizzo in base a una licenza come Creative Commons, ad esempio.

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-what_is_a_vpn-01 ).
Testo alternativo :una breve descrizione dell'immagine se non viene caricata.
Didascalia :una breve descrizione che appare sotto l'immagine.
Attribuzione :se si utilizza un'immagine concessa in licenza per il riutilizzo, comprese le informazioni di attribuzione appropriate (titolo, autore, fonte, licenza, ecc.)

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. Atlantic.Net non tollererà il plagio o il riutilizzo di lavori già esistenti.

Allo stesso modo, anche tutte le immagini e gli screenshot dovrebbero essere univoci, ad eccezione di quelle immagini il cui uso rispetta correttamente una licenza attribuita in modo appropriato.

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


Linux
  1. Bash For Loop Guida ed esempi

  2. Cos'è Linux? Una guida per utenti non tecnici

  3. 10 guide ai contenitori per gli amministratori di sistema

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

  5. Procedura:Guida di stile per gli articoli di Atlantic.Net

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