Harukiya Archives

2005/06/05

category / HTML

WEBページにプログラミングソース(いろいろあるらしい、CとかDとか)やCSS・javascript・HTMLそのものを表示させる時に、何でマークアップするか?について。

これはもう圧倒的に<pre><code> 〜 </code></pre>派が多いようだけど、僕は<textarea> 〜 </textarea>派だった(過去形)。多くのブラウザは<textarea>上での全選択・コピーメニューが実装されているのがその理由。ソースコードは性質上ユーザがコピーしやすい方が便利かなーなんて思ったりしてた。とかいいつつ、その時の酒量 気分で<div class="code"> 〜 </div>とかインライン使ったりとか、もーメチャメチャだったりもする。

<pre>を避けていたのは、横スクロールバーの扱いでうまい方法が思いつかないって理由もある。(<textarea>なら適当な所で改行してくれる)ただ<pre>の、インデントをそのまま表現したり、他の要素を入れ子にして強調したりアンカーを張ったりできるって点は捨てがたい。

何かいい方法はないかなーと思っていたら、答えはすぐ近くにあった。Another HTML-lint gateway様だ(叱られてもタダは起きない)ここではソースコードを<ol>(序列リスト)で表している。ソースコードを文字列が集まったリストと考えるのは妥当だし、環境ごとの表示幅の違いによって途中で折り返しされたとしても論理行は保持される。コピーのさい行番号は選択されないので使い勝手も悪くない。Firefox1では行番号(リストマーク含む)がコピーされます。IE6ではどちらもコピーされない。(追記:2005-06-06)何よりソースの説明する時「XX行目のhogeをpageに修正してください」という使い方ができる。イケてるじゃんキミ(どこの立場からモノ言ってるんだ、オレは)

マークアップは単純なのだが、ソースが長くなるとめんどくさいんでスクリプトを書いた 。

オマケスクリプト(使い方は入力支援とかとほぼ同じ)

自分用に書いたんでしょぼいです。需要があればちゃんとするかも。これで過去記事のソースコード部分を書き直していくショゾン。

RSSを拾ってくださってる方へ。「春木屋、更新してるじゃん」と思われても、それは過去記事(のしかもマークアップ部分)です。紛らわしくてスミマセン。(エントリタイトルと全然無関係に終ってゆくのであった)


  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <html lang="ja">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
  5. <meta http-equiv="Content-Style-Type" content="text/css">
  6. <meta http-equiv="Content-Script-Type" content="text/javascript">
  7. <title>src convert</title>
  8. <script type="text/javascript">
  9. <!--
  10. var x;
  11.  
  12. function remove() {
  13.  x = document.getElementsByTagName( 'textarea' )[0].value.replace( /&/g,'&amp;' ).replace( /</g,'&lt;' ).replace( />/g,'&gt;' );
  14.  x = x.replace( /\x0D\x0A/g,'\n' ).replace( /\x0D/,'\n' ).replace( /\x0A/,'\n' ).replace( /\n$/,'' );
  15.  x = x.replace( /^\s*\d+\. |^\s*\* /g,'' ).replace( /\n\s*\d+\. |\n\s*\* /g,'\n' );
  16. }
  17. function input() {
  18.  x = document.getElementsByTagName( 'textarea' )[0].value.replace( /&/g,'&amp;' ).replace( /</g,'&lt;' ).replace( />/g,'&gt;' );
  19.  x = x.replace( /\x0D\x0A/g,'\n' ).replace( /\x0D/,'\n' ).replace( /\x0A/,'\n' ).replace( /\n$/,'' );
  20.  x = x.replace( /\n /g,'\n&nbsp;' ).replace( /  /g,'&nbsp; ' ).replace( /  /g,' &nbsp;' ).replace( /\t/g,'&nbsp; &nbsp; ' );
  21. }
  22.  
  23. function output() {
  24.  document.getElementsByTagName( 'textarea' )[0].value = x;
  25.  document.getElementsByTagName( 'DIV' )[0].innerHTML = x;
  26. }
  27. function make_ol() {
  28.  input();
  29.  x = '<ol class="code">\n<li><code>' + x.replace( /\n/g,'<\/code><\/li>\n<li><code>' ) + '<\/code><\/li>\n<\/ol>';
  30.  output();
  31. }
  32.  
  33. function make_pre() {
  34.  input();
  35.  x = '<pre class="code"><code>\n' + x + '\n<\/code><\/pre>';
  36.  output();
  37. }
  38.  
  39. function make_textarea() {
  40.  input();
  41.  x = '<textarea cols="56" rows="4" class="code">' + x + '<\/textarea>';
  42.  output();
  43. }
  44. function cleanup() {
  45.  remove();
  46.  x = '<textarea cols="56" rows="4" class="code">' + x + '<\/textarea>';
  47.  output();
  48. }
  49. //-->
  50. </script>
  51.  
  52. <style type="text/css">
  53. <!--
  54. body {
  55. padding: 0; margin: 1em 2em;
  56. }
  57.  
  58. ol.code {
  59. font-family: monospace;
  60. font-size: .85em;
  61. margin: 0; padding: .5em;
  62. padding-right: 1.5em;
  63. height: 200px;
  64. overflow: auto;
  65. border: 1px solid #303030;
  66. }
  67. ol.code li {
  68. color: #999;
  69. line-break: strict;
  70. word-break: break-all;
  71. word-wrap: break-word;
  72. padding: 0; margin: 0;
  73. margin-left: 3em;
  74. }
  75. ol.code code {
  76. color: #303030;
  77. font-size: 1.2em;
  78. line-height: 1.1;
  79. }
  80.  
  81. pre.code {
  82. width: 95%;
  83. height: 200px;
  84. overflow: scroll;
  85. padding: 0; margin: 1em 0;
  86. border: 1px solid #303030;
  87. }
  88. pre.code code {
  89. color: #303030;
  90. display: block;
  91. padding: 1em;
  92. }
  93.  
  94. textarea.code {
  95. color: #303030;
  96. width: 95%;
  97. height: 200px;
  98. padding-left: 1em;
  99. border: 1px solid #303030;
  100. }
  101. div {
  102. margin: 1em 0;
  103. }
  104. .copy {
  105. margin: 0;
  106. text-align: center;
  107. }
  108. -->
  109. </style>
  110. </head>
  111. <body>
  112. <h1>src convert</h1>
  113. <p> | <a href="javascript:x='';output()" title="入力欄を空にする">clear</a> | <a href="javascript:make_ol()" title="序列リストでマーク">&lt;ol&gt;</a> | <a href="javascript:make_pre()" title="整形済みテキストでマーク">&lt;pre&gt;</a> | <a href="javascript:make_textarea()" title="テキストエリアでマーク">&lt;textarea&gt;</a> | <a href="javascript:cleanup()" title="リストマーク除去">clean up</a> |</p>
  114. <textarea style="width: 100%; height: 150px;" onblur="if ( this.value == '' ) this.value='ソースを貼り付けてください';" onfocus="if ( this.value == 'ソースを貼り付けてください' ) this.value='';">ソースを貼り付けてください</textarea>
  115. <p>プレビュー</p>
  116. <hr>
  117. <div>
  118. </div>
  119. <hr>
  120. <div class="copy"><a href="http://blog.fc2.com/" title="FC2 BLOG">&#169;2004-2005 FC2</a></div></body>
  121. </html>

丸ごとコピペ → hoge.htmで保存すれば、ローカルで使えます。たぶん。


writeback

  1. no name : >コピーのさい行番号は選択されないので使い勝手も悪くない。
    これ、UA依存では…?
    Firefoxでは行番号がついちゃいます。
    ctrl-a→ctrl-cが楽でいいので、私はtextarea派…かな。
    -05日22時
  2. みりばーる : こんにちは。ソースコードのマークアップには悩みますよね。こんなリンク集もあるようです。
    「ソースコードのマークアップに関する議論リンク集」
    http://www.akatsukinishisu.net/itazuragaki/source_markup.html
    > コピーのさい行番号は選択されない
    実はFirefoxだとol要素の行番号やul要素のマーカーもコピペされちゃうんですよ(この機能は便利だと思ってたんですが)。
    自分は面倒なのでpreを使っていますがolも悪くないと思います。-05日22時
  3. マス : >いらっしゃいませ、no nameさん。
    >>コピーのさい行番号は選択されないので使い勝手も悪くない。
    報告ありがとうございます。おっしゃる通りでした。記事を修正しときます。
    ディスプレイの選択範囲に含まれないんで、てっきりコピーされないものかと・・・
    >私はtextarea派…かな。
    僕もソース見るとコピペしてみたくなるんでそうしてました。
    上級者(謎)の読者が多いサイト向けだと思います。

    >いらっしゃいませ、みりばーるさん。
    >こんなリンク集もあるようです。
    拾い読みしてみました。みなさん熟考されてますね。うちなんかが思いつきで書くのとは雲泥の差です。
    >olも悪くないと思います。
    すでにマークアップ部分をolに修正しちゃったんで、しばらくコレで様子見します。不便なようなら再修正ということで。
    -06日20時
  4. マス : 泥縄的にちょっと修正。
    http://blog2.fc2.com/s/sug/file/srcconv.htm
    clean up で Firefox(など)からコピーしたソースの中から、行番号・リストマークを除去します。-06日21時
  5.  


< 何故なら前後がわかりやすいし | 生きろ > | 表紙へ戻る | 探す | 案内


ホームページ アフィリエイト レンタルサーバー FC2ブログ キャッシング