GNU/Linux >> Tutoriels Linux >  >> Linux

Guide de format pour les articles What-Is d'Atlantic.Net

Présentation

Si vous pensez que vous souhaitez écrire pour Atlantic.Net, vous devez commencer par remplir notre formulaire d'inscription si vous ne l'avez pas déjà fait.

Les articles What Is pour Atlantic.Net doivent être conformes aux normes indiquées dans les sections ci-dessous :

Sections (y compris l'introduction, le public cible et le didacticiel lui-même)
Format (Markdown ou HTML simple)
Images/Captures d'écran
Œuvre originale

Veuillez également consulter notre guide de style pour obtenir des conseils supplémentaires.

Sections

Chaque article What-Is doit commencer par la section Public cible, indiquée par les en-têtes H5. Le public cible doit spécifier le niveau d'expérience ou de connaissances que vous supposez que le lecteur doit posséder pour comprendre le sujet sur lequel vous allez écrire. Le niveau d'expérience minimum pour le public cible d'un article What-Is devrait être des professionnels de l'informatique débutants. Tous les sujets qui supposent qu'un lecteur est familier avec le matériel couvert dans un autre article d'Atlantic.Net peuvent être liés ici.

Exemple :

Public cible

Cet article part du principe que vous connaissez les concepts de base de l'infrastructure à clé publique (PKI). Pour un rappel, consultez cette introduction sur les bases de la cryptographie à clé publique.

Après le public cible devrait être la section Introduction, qui décrit brièvement la portée de l'article. Le mot "Introduction" doit être contenu dans les en-têtes H3.

La majeure partie de l'article suit l'introduction.

Formater

Les articles What-Is pour Atlantic.Net peuvent être soumis en Markdown ou en HTML simple.

Formatage de texte pris en charge :texte d'en-tête, blocs de code, code en ligne (pour les commandes et les frappes), italique (pour les variables) et gras (pour l'emphase).

En-têtes

H1 doit être utilisé pour le titre de l'article. Le titre doit toujours être la première partie de tout article.

H2 doit être utilisé pour les sections importantes de l'article.

H3 doit être utilisé pour « Introduction », « Audience cible » et les sous-sections.

Blocs de code

Les articles What-Is doivent éviter d'utiliser du code ou des blocs de code (cette utilisation est plus répandue dans un article How-To). Cependant, si vous mettez en surbrillance à quoi ressemble le code lié à votre sujet, il doit être enfermé dans un bloc de code.

Si vous référencez du code en ligne, vous pouvez utiliser le code étiquette. Cette utilisation doit se limiter à faire référence à une portion de code dont la forme ou la fonction est pertinente pour le sujet. Gardez à l'esprit que le but de la plupart des articles What-Is n'est pas d'apprendre à quelqu'un comment accomplir une tâche mais d'expliquer de manière plus générale un concept lié à la technologie.

Exemple :

L'héritage commun d'UNIX que de nombreux systèmes d'exploitation ultérieurs partagent est évident dans certaines des commandes qu'ils partagent tous, telles que cp pour copie.

Format des informations variables/personnalisées

Les variables ou les informations spécifiques à l'hôte doivent être rares dans un article What-Is. Cependant, les variables ou les entrées de configuration personnalisées (telles que les noms d'hôte) doivent être en italique si nécessaire. Notre analyseur teintera également toutes les entrées en italique vert .

Souligné

Si vous souhaitez mettre l'accent sur l'accent, utilisez le gras .

Touches

Lorsqu'il s'agit de référencer des frappes en ligne avec le texte, placez-les dans une code span . Encore une fois, ce type d'inclusion devrait être peu fréquent dans un article What-Is.

Exemple :

Le Enter la clé peut encore s'appeler le Return sur certains claviers, rappelant son utilisation sur les machines à écrire pour indiquer un retour chariot.

Pour les frappes nécessitant plusieurs touches simultanément, utilisez un signe plus (+) entre les touches.

Exemple :

La combinaison de touches de Ctrl+Alt+Del gagné, dans certains cercles, le surnom de "le salut à trois doigts".

Images

Nous encourageons l'utilisation d'images et de captures d'écran pour aider à éclairer de nombreux points qui peuvent être soulevés dans un sujet What-Is. Les images doivent avoir une largeur maximale de 730 pixels. Vous pouvez créer l'image vous-même ou utiliser une image autorisée à être réutilisée sous une licence telle que Creative Commons, par exemple.

Veuillez inclure un lien vers l'image en utilisant l'URL où elle est actuellement hébergée. Les articles acceptés pour publication auront toutes les images associées téléchargées et hébergées sur nos serveurs. Outre les images, nous avons besoin des éléments suivants :

Nom de l'image :format anet-articlename-## (où le ## est remplacé par un nombre, par exemple, anet-what_is_a_vpn-01 ).
Texte alternatif  :une brève description de l'image si elle ne se charge pas.
Légende  :une brève description apparaissant sous l'image.
Attribution  :si vous utilisez une image sous licence pour la réutilisation, y compris les informations d'attribution appropriées (titre, auteur, source, licence, etc.)

Toute information identifiable de manière unique doit être masquée, de préférence en utilisant des noms d'espace réservé bien en vue (tels que "exemple.com" ou "192.168.0.2").

Œuvre originale

Tous les articles écrits pour Atlantic.Net doivent être des œuvres originales. Atlantic.Net ne tolérera pas le plagiat ou la réutilisation de travaux déjà existants.

De même, toutes les images et captures d'écran doivent également être uniques, à l'exception des images dont l'utilisation respecte correctement une licence attribuée de manière appropriée.

En savoir plus sur nos services d'hébergement VPS et le prix de l'hébergement VPS.


Linux
  1. Bash For Loop Guide et exemples

  2. Guide de style pour les articles d'Atlantic.Net

  3. Guide de format pour les articles pratiques d'Atlantic.Net

  4. Pourquoi Atlantic.Net a choisi NGINX

  5. NuGet pour .NET Core sous Linux

Atlantic.Net Cloud – Comment puis-je mettre à jour mes informations client pour mon compte Cloud

Atlantic.Net Cloud – Puis-je faire évoluer mon serveur cloud ?

Atlantic.Net Cloud – Comment reprovisionner un serveur cloud

Atlantic.Net – Guide de connexion VPN

Comment configurer Atlantic.Net Email

Atlantic.Net Trusted Access - Guide de l'authentification multifacteur