「google-code-prettify」のドキュメント「README.md」を翻訳する

For which languages does it work?

prettify.jsの説明は、信頼できるものですが、しかし、字句解析器は、 Cとその仲間、Java、Python、Bash、SQL、HTML、XML、CSS、Javascript、MakefileとRustを含む、多くの言語で動作するはずです。

それは、Ruby、PHP、VBとawkとPerlとRubyの適切なサブセットで、まずまず、動作しますが、 コメント記法のため、言語拡張なしでは、Smalltalk、OCamlなどでは動作しません。

他の言語は、拡張機能を通してサポートされます。：

Apollo; Basic; Clojure; CSS; Dart; Erlang; Go; Haskell; Lasso; Lisp, Scheme; Llvm; Logtalk; Lua; Matlab; MLs: F#, Ocaml,SML; Mumps; Nemerle; Pascal; Protocol buffers; R, S; RD; Rust; Scala; SQL; Swift; TCL; Latek; Visual Basic; VHDL; Wiki; XQ; YAML

あなたが、お気に入りの言語のための拡張を追加したい場合、src/lang-lisp.jsを確認し、pull リクエストを送信ししてください。

How do I specify the language of my code?

PR.prettyPrint()が推測するので、言語を指定する必要はありません。 あなたは、prettyprintクラスと一緒に言語拡張機能を指定することで、言語を指定することができます。：

また、あなたは、language-javaスタイルのクラスを使用して、PREにコード要素を組み込んで、HTML5記法を使用することができます。

<pre class="prettyprint lang-html">
  The lang-* class specifies the language file extensions.
  File extensions supported by default include
    "bsh", "c", "cc", "cpp", "cs", "csh", "cyc", "cv", "htm", "html",
    "java", "js", "m", "mxml", "perl", "pl", "pm", "py", "rb", "sh",
    "xhtml", "xml", "xsl".
</pre>

  The lang-* class specifies the language file extensions.
  File extensions supported by default include
    "bsh", "c", "cc", "cpp", "cs", "csh", "cyc", "cv", "htm", "html",
    "java", "js", "m", "mxml", "perl", "pl", "pm", "py", "rb", "sh",
    "xhtml", "xml", "xsl".

It doesn't work on <obfuscated code sample>?

はい。難読化されたコードを飾り立てることは、ブタに口紅をやるようなものです。－すなわち、このツールの範囲外です。

Which browsers does it work with?

IE 6、Firefox 1.5＆2、Safari 2.0.4からテストされています。テストを見て、ブラウザで動作するかどうかを確認してください。

What's changed?

変更ログを参照してください。

Why doesn't Prettyprinting of strings work on WordPress?

見たところ、wordpressは、閉じる引用符を変更する「スマートな引用」をします。これにより、閉じる引用符は、開いた引用符と一致しません。

これは、コード・サンプルのコピーと貼り付けと同様に飾り立てを分割します。 コード・スニペットのスマートな引用を止める方法については、WordPressヘルプセンターを参照してください。

How do I put line numbers in my code?

あなたは、linenumsクラスを使用して行番号を付けることができます。 あなたのコードが、行番号1で開始しない場合、あなたは、linenums：52のように、そのクラスの最後にコロンと行番号を追加することができます。

例えば、

<pre class="prettyprint linenums:4">// This is line 4. これは、行4です。
foo();
bar();
baz();
boo();
far();
faz();
</pre>

// This is line 4. これは、行4です。
foo();
bar();
baz();
boo();
far();
faz();

How do I prevent a portion of markup from being marked as code?

あなたは、nocodeクラスを使用して、コードでないマークアップの範囲を識別することができます。

<pre class=prettyprint>
int x = foo();  /* This is a comment  <span class="nocode">This is not code</span>Continuation of comment */
int y = bar();
</pre>

int x = foo();  /* This is a comment  This is not codeContinuation of comment */
int y = bar();

より完全な例は、issue22のテストケースを参照してください。

I get an error message "a is not a function" or "opt_whenDone is not a function"

あなたが、イベント・ハンドラで、prettyPrintを呼び出す場合、それを関数でラップします。行う代わりに、

addEventListener('load', PR.prettyPrint, false);

以下のようなクロージャでラップします。

addEventListener('load', function (event) { PR.prettyPrint() }, false);

そのため、ブラウザは、混乱させるPR.prettyPrintに、イベントオブジェクトを渡しません。

How can I customize the colors and styles of my code?

Prettifyは、コードの種類を記述するクラスで<span>を追加します。あなたは、これらのクラスに一致させるために、CSSスタイルを作成することができます。

例については、テーマギャラリーを参照してください。

I can't add classes to my code (because it comes from Markdown, etc.)

<pre class="prettyprint ..." >の代わりに、あなたは、処理命令を持続する、 コメントや処理命令を使用することができます。：<？prettify ...？>は、「はじめに」で説明したとおりに動作します。

Prettifyは、HTMLのリスト要素に行を配置します。そのため、行番号は、コピー・ペーストによって捕えられません。 そして、行の番号付けは、デフォルトのスタイルシートprettify.cssのCSSによって制御されています。

<style>
li.L0, li.L1, li.L2, li.L3,
li.L5, li.L6, li.L7, li.L8
{ list-style-type: decimal !important }
</style>

他の行のために、行の番号付けを戻す必要があります。