はじめに
この記事を読めば、HTMLでソースコードを埋め込む方法を理解し、簡単に実践できるようになります。
初心者の方でも安心して取り組めるよう、徹底解説した11種類の方法を紹介していきます。
サンプルコードや応用例も用意しているので、理解を深められます。
●HTMLでソースコードを埋め込む方法
○1. <pre>タグと<code>タグを使う
HTMLでソースコードを表示する基本的な方法は、<pre>タグと<code>タグを使うことです。
<pre>タグは前後の空白や改行をそのまま表示するので、ソースコードのインデントが維持されます。
<code>タグはソースコードを示すことを意味します。
これらを組み合わせることで、ソースコードを埋め込むことができます。
<pre><code>
<html>
<head>
<title>サンプルページ</title>
</head>
<body>
こんにちは、世界!
</body>
</html>
</code></pre>
○2. エスケープ文字を使う
HTMLでソースコードを表示する際には、<や>などの特殊文字をエスケープする必要があります。
次のようにエスケープ文字を使って、ソースコードを埋め込むことができます。
<pre><code>
<!-- これはHTMLのコメントです -->
</code></pre>
○3. インラインスタイルで装飾する
ソースコードを見やすくするために、インラインスタイルを使って装飾することができます。
例えば、文字の色や背景色、フォントを変更して見やすくすることができます。
<pre style="color: #333; background-color: #f8f8f8; font-family: 'Courier New', monospace;"><code>
<html>
<head>
<title>サンプルページ</title>
</head>
<body>
こんにちは、世界!
</body>
</html>
</code></pre>
○4. CSSで装飾する
より柔軟な装飾を行うために、CSSを使ってソースコードをスタイリングすることができます。
CSSを使ってソースコードの見た目を変更する例を紹介します。
<style>
.code {
color: #333;
background-color: #f8f8f8;
font-family: 'Courier New', monospace;
}
</style>
<pre class="code"><code>
<html>
<head>
<title>サンプルページ</title>
</head>
<body>
こんにちは、世界!
</body>
</html>
</code></pre>
○5. シンタックスハイライトを適用する
シンタックスハイライトを適用することで、ソースコードの可読性が向上します。
JavaScriptライブラリを利用してシンタックスハイライトを適用することができます。
例えば、Prism.jsやhighlight.jsなどがあります。
Prism.jsを使った例を紹介します。
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.25.0/themes/prism.min.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.25.0/prism.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.25.0/components/prism-html.min.js"></script>
<pre><code class="language-html">
<html>
<head>
<title>サンプルページ</title>
</head>
<body>
こんにちは、世界!
</body>
</html>
</code></pre>
●応用例とサンプルコード
○6. ソースコード内の特定の部分を強調表示する
ソースコード内の特定の部分を強調表示するには、<mark>タグを使用します。
次の例では、「<title>」タグの部分を強調表示しています。
<pre><code>
<html>
<head>
<mark><title>サンプルページ</title></mark>
</head>
<body>
こんにちは、世界!
</body>
</html>
</code></pre>
○7. ソースコードに行番号を表示する
ソースコードに行番号を表示することで、コードの指定や説明がしやすくなります。
シンタックスハイライトライブラリの機能を利用して行番号を表示できます。
Prism.jsの行番号プラグインを使用した例を紹介します。
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.25.0/themes/prism.min.css">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.25.0/plugins/line-numbers/prism-line-numbers.min.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.25.0/prism.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.25.0/components/prism-html.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.25.0/plugins/line-numbers/prism-line-numbers.min.js"></script>
<pre class="line-numbers"><code class="language-html">
<html>
<head>
<title>サンプルページ</title>
</head>
<body>
こんにちは、世界!
</body>
</html>
</code></pre>
○8. ソースコードを折りたたみ表示にする
ソースコードが長い場合、折りたたみ表示にすることで、ページの見た目をスッキリさせることができます。
jQueryを使ってソースコードを折りたたみ表示にする例を紹介します。
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<style>
.toggle-btn {
cursor: pointer;
color: #007bff;
}
</style>
<script>
$(function() {
$('.toggle-btn').on('click', function() {
$(this).next().toggle();
$(this).text($(this).text() === '表示' ? '非表示' : '表示');
});
});
</script>
<p class="toggle-btn">表示</p>
<pre style="display: none;"><code>
<html>
<head>
<title>サンプルページ</title>
</head>
<body>
こんにちは、世界!
</body>
</html>
</code></pre>
この例では、jQueryを利用して折りたたみ表示のトグル機能を実装しています。
折りたたみ表示のボタン(.toggle-btn)がクリックされると、次の<pre>要素の表示状態が切り替わります。
そして、ボタンのテキストが「表示」と「非表示」で切り替わるようになっています。
まとめ
以上の方法を参考に、ソースコードを埋め込む際に、読者に分かりやすく、見た目も魅力的な表示ができるように工夫してみてください。
この記事を読めば、HTMLソースコードの埋め込みやカスタマイズ方法について理解し、実際に応用することができるようになります。
また、SEOを意識した記事作成にも役立つことでしょう。