チュートリアルガイド · 1 min read · Oct 07, 2025

チュートリアルフォーマットガイド

チュートリアルフォーマットガイド

バージョン 1.3

HowtoForgeにチュートリアルを公開したい場合は、このガイドを読んで、チュートリアルをHowtoForgeの外観に合わせてフォーマットし、できるだけ多くの読者に魅力的に見えるようにする方法を学んでください。これらのガイドラインは、ドキュメントのサイズを最小限に抑えるのにも役立ちます。

1 どのプログラムを使ってHowToを書くのですか?

DreamweaverのようなHTMLエディタや、無料の代替品であるBluegriffon http://www.bluegriffon.org/ など、妥当なHTMLを生成する他のHTMLエディタを使用してください。MS Wordを使用してHTMLコンテンツを作成しないでください。なぜなら、Wordは「奇妙な」HTMLを生成するからです…

2 どうやって始めるのですか?

さて、あなたはHTMLエディタの前に座って、始める準備ができていますが、次は何ですか?このHTMLスケルトンをエディタにコピーしてください:

| |

今、あなたはチュートリアルをとタグの間に書きます。

3 フォーマット

3.1 通常のテキスト

常に通常のテキストと見出しのためにデフォルトフォントを使用してください!タグを使用せず、独自のCSSクラスを定義しないでください。すべてのフォーマットは、HowtoForgeにチュートリアルを公開した後、HowtoForgeのCSSクラスによって行われます。

例えば、次のようなものは

これは文です。

避けるべきです。単に次のように使用してください:

これは文です。

HowtoForgeでは、次のように見えます:

これは文です。

3.2 見出し

見出しをフォーマットするには、

、または
を使用してください。再度、タグやCSSクラスを使用してフォーマットしないでください。

見出し

これは見出しです

はHowtoForgeでは次のように見えます:

これは見出しです

3.3 コマンド

シェルコマンドをフォーマットするには、CSSクラス.command(HTMLスケルトンの…セクションで定義されています)を使用してください。これにより、読者はそれがシェルで実行する必要があるものであることを知ることができます。例えば、

chmod 755 /path/to/file

はHowtoForgeでは次のように見えます:

chmod 755 /path/to/file

3.4 ファイルの内容

ファイルの内容は

で囲む必要があります。例えば、/etc/resolv.confの内容を読者に示したい場合、次のようにします:

search server  
 nameserver 145.253.2.75  
 nameserver 193.174.32.18  
 nameserver 194.25.0.60

これはHowtoForgeでは次のように見えます:

search server
nameserver 145.253.2.75
nameserver 193.174.32.18
nameserver 194.25.0.60

3.5 ファイル名、プロトコル名、システム仕様、技術仕様など

コマンドではないLinuxシステムに関連する項目について書いている場合でも、特別な方法でフォーマットしたい場合は、CSSクラス.systemを使用できます。例えば、通常のテキスト内でファイル名に言及する場合、次のようにフォーマットするのが良いアイデアです:

次に、/etc/network/interfacesを編集して、次のようにします:...

HowtoForgeでは、次のように見えます:

次に、/etc/network/interfacesを編集して、次のようにします:…

3.6 ハイライト

何かを強調表示したい場合は、CSSクラス.highlightを使用できます。例えば、

server1:

は次のように見えます:

server1:

5 画像

幅が550ピクセルを超える画像は使用しないでください!

4 チュートリアルを公開する

チュートリアル(章1 - 3に従って作成されたHTMLファイル)を画像と一緒にzipし、zipファイルを[email protected]にメールしてください。チュートリアルをあなたの名前で公開できるように、メールにHowtoForgeのユーザー名を含めてください。

6 管理者の承認

新しいチュートリアルはすぐには公開されません。管理者の1人がそれを確認し(フォーマット、内容など)、おそらくあなたのチュートリアルは承認されます。その後、HowtoForgeで利用可能になります。

Share: X/Twitter LinkedIn

新しい投稿を受信箱で受け取る

スパムはありません。いつでも購読を解除できます。