GNU/Linux >> Linux の 問題 >  >> Linux

Atlantic.NetのフォーマットガイドWhat-IsArticles

はじめに

Atlantic.Netに書き込みたいと思われる場合は、まだ登録フォームに記入していない場合は、まず登録フォームに記入する必要があります。

Atlantic.Netの記事は、以下のセクションに示されている標準に準拠している必要があります。

セクション(概要、対象読者、チュートリアル自体を含む)
フォーマット(マークダウンまたは単純なHTML)
画像/スクリーンショット
オリジナル作品

追加のガイダンスについては、スタイルガイドも確認してください。

セクション

各What-Is記事は、H5ヘッダーで示されるターゲットオーディエンスセクションで始まる必要があります。ターゲットオーディエンスは、読者があなたが書くトピックを理解するために持っていると想定する経験または知識のレベルを指定する必要があります。 What-Is記事の対象読者の最低経験レベルは、エントリーレベルのITプロフェッショナルである必要があります。読者が別のAtlantic.Netの記事で取り上げられている資料に精通していることを前提としたトピックは、ここにリンクできます。

例:

ターゲットオーディエンス

この記事は、公開鍵インフラストラクチャ(PKI)の背後にある基本的な概念に精通していることを前提としています。 refesherについては、公開鍵暗号の基本に関するこの入門書を確認してください。

ターゲットオーディエンスの後には、記事の範囲を簡単に説明する「はじめに」セクションがあります。 「はじめに」という単語は、H3ヘッダー内に含める必要があります。

記事の大部分ははじめに続きます。

フォーマット

Atlantic.NetのWhat-Is記事は、Markdownまたは単純なHTMLで送信できます。

サポートされているテキスト形式:ヘッダーテキスト、コードブロック、インラインコード(コマンドとキーストローク用)、斜体(変数用)、太字(強調用)。

ヘッダー

記事のタイトルにはH1を使用する必要があります。タイトルは常に記事の最初の部分である必要があります。

H2は、記事の重要なセクションに使用する必要があります。

H3は、「はじめに」、「対象読者」、およびサブセクションに使用する必要があります。

コードブロック

What-Isの記事では、コードまたはコードブロックの使用を避ける必要があります(この使用法は、ハウツー記事でより一般的です)。ただし、トピックに関連するコードを強調表示する場合は、コードブロックで囲む必要があります。

コードをインラインで参照する場合は、codeを使用できます 鬼ごっこ。この使用は、フォームまたは機能がトピックに関連するコードの一部を参照することに限定する必要があります。ほとんどのWhat-Is記事の目的は、タスクを実行する方法を誰かに教えることではなく、より一般的な意味でテクノロジーに関連する概念を説明することであることに注意してください。

例:

後続の多くのオペレーティングシステムが共有するUNIXの共通の遺産は、cpなど、すべてが共有するコマンドの一部で明らかです。 コピー用。

変数/カスタム情報フォーマット

What-Isの記事では、変数またはホスト固有の情報はまれである必要があります。ただし、必要に応じて、変数またはカスタム構成エントリ(ホスト名など)を斜体にする必要があります。また、パーサーはすべてのイタリック体のエントリに色を付けます緑 。

強調

強調したい場合は、太字を使用してください 。

キーストローク

テキストとインラインでキーストロークを参照する場合は、code spanで囲みます。 。繰り返しになりますが、この種の包含は、What-Isの記事ではめったに行われないはずです。

例:

Enter キーは引き続きReturnと呼ばれる場合があります 一部のキーボードのキーを押し、タイプライターでの使用法を思い起こさせて、キャリッジリターンを示します。

複数のキーを同時に押す必要があるキーストロークの場合は、キーの間にプラス記号(+)を使用します。

例:

Ctrl+Alt+Delのキーストロークの組み合わせ 一部のサークルでは、「3本指の敬礼」の愛称を獲得しました。

画像

画像とスクリーンショットを使用して、What-Isトピックで取り上げられる可能性のある多くのポイントを明らかにすることをお勧めします。画像の最大幅は730ピクセルである必要があります。自分で画像を作成することも、クリエイティブコモンズなどのライセンスの下で再利用が許可されている画像を使用することもできます。

現在ホストされているURLを使用して画像へのリンクを含めてください。出版が承認された記事には、関連するすべての画像がダウンロードされ、サーバーにホストされます。画像に加えて、次のものが必要です。

画像名 :フォーマットanet-articlename-## (ここで## 数字に置き換えられます(例:anet-what_is_a_vpn-01) )。
Alt-Text :画像が読み込まれない場合の画像の簡単な説明。
キャプション :画像の下に表示される簡単な説明。
アトリビューション :適切な帰属情報(タイトル、作成者、ソース、ライセンスなど)を含む、再利用が許可された画像を使用する場合

一意に識別できる情報は、できれば目立つプレースホルダー名(「example.com」や「192.168.0.2」など)を使用して隠しておく必要があります。

オリジナル作品

Atlantic.Net向けに書かれたすべての記事は、オリジナルの作品でなければなりません。 Atlantic.Netは、盗用や既存の作業の再利用を容認しません。

同様に、すべての画像とスクリーンショットも一意である必要があります。ただし、適切に帰属するライセンスに適切に準拠して使用されている画像は除きます。

VPSホスティングサービスとVPSホスティング価格の詳細をご覧ください。


Linux
  1. 初心者向けのLinuxターミナルガイド

  2. BashForループガイドと例

  3. Linuxとは何ですか?非技術ユーザー向けガイド

  1. システム管理者向けの10のコンテナガイド

  2. Linux – USBドライブにLinuxをインストールする場合、最高のパフォーマンスを得るためにフォーマットするにはどのファイルシステムを使用する必要がありますか?

  3. 方法:Atlantic.Net記事のスタイルガイド

  1. Atlantic.Netハウツー記事のフォーマットガイド

  2. Atlantic.NetFAQのために書く

  3. Atlantic.NetがNGINXを選んだ理由