レンダリング時にコードが異なる色で強調表示されることがあることに気付きました。
- 構文の強調表示とは何ですか?
- どのように機能しますか?
- コードが正しく強調表示されないのはなぜですか?
- バグを報告したり、新しい言語をリクエストしたりするにはどうすればよいですか?
- シンタックスハイライトを使用するにはどうすればよいですか?
- Stack Exchangeで現在使用できる言語は何ですか?
コメント
回答
何構文の強調表示はありますか?
構文の強調表示を使用すると、投稿内のコードを記述された言語に基づいて強調表示して、読みやすくすることができます。
どのように機能しますか?
Stack Exchangeには、独自の構文強調表示エンジンがありません。 highlight.js であり、必ずしもそのライブラリの最新リリースを使用しているとは限りません。したがって、構文の強調表示に関するバグや機能のリクエストは、StackExchangeで処理できません。
構文の強調表示は、タグに基づいて、投稿を作成または編集するときに、5秒間入力を停止するとすぐにプレビューに割り当てられます。
コードが正しく強調表示されないのはなぜですか?
1。使用しているサイトでシンタックスハイライトが有効になっていることを確認してください
完全なリストはメタで利用できます。シンタックスハイライトが有効になっていない場合サイトはこの質問の指示に従います。
2。言語がhighlight.jsでサポートされていることを確認します
を確認しますハイライト.jsでサポートされている言語のリスト。ご使用の言語がリストにない場合は、Stack Exchangeでデプロイする前に、highlight.jsプロジェクト内で言語を作成する必要があります。
言語はすでにリストにありますが、Stack Exchangeで使用されていません。ここでメタで機能リクエストを送信して、ネットワークにデプロイしてください。
3。言語がStackExchangeで使用されていることを確認してください
devCDNの heightlight-loader.js ファイルを見て、お気に入りのエディターで開き、言語のヒントを検索します。たとえば、 " dart "を検索すると、 hljs.registerLanguage("dart", ...で構成される行。これは、lang-dartが利用可能な言語ヒントであることを意味します。 " psh "または" powershell "は結果を返しません。つまり、pshはStackExchangeバージョンのhighlight.jsでサポートされていません。
4。質問のタグで構文の強調表示が有効になっていることを確認してください
舞台裏では、StackExchangesは質問のタグを使用して、使用している言語を判別します。各タグには、プロパティで指定された強調表示言語があります。または言語なし。強調表示言語が指定されているタグが複数ある場合、またはタグが指定されていない場合は、デフォルトを使用して、highlight.jsに使用するのに最適な言語を推測させます。同じ質問で使用されている強調表示言語は、回答でも使用されています。
そのタグにアクセスします wiki ページ。タグ( javascript ")、[" 詳細… "、およびそのタグに現在使用されている言語ヒント(存在する場合)は、に表示されます。一番下の、wikiのボタンの下:
タグに強調表示言語が指定されていない場合は、作成します。サイトごとのメタで feature-request をリクエストします(タグの強調表示言語を変更できるのはモデレーターのみです)。
バグを報告したり、新しい言語をリクエストしたりするにはどうすればよいですか?
シンタックスハイライト自体のバグである場合は、既存のレポートを確認してください。 最初に、すでに報告されているかどうかを確認します。報告されていない場合は、先に進んでそこで報告します。 highlight.jsによってすでに実装されているがここでは機能しないバグ修正と機能については、highlight.jsの新しいバージョンが定期的にサイトにデプロイされるので、しばらくお待ちください。最新バージョンはまだデプロイされていません。 (長期間デプロイされていない場合は、Metaで機能リクエストを発生させて、highlight.jsの新しいバージョンのデプロイをリクエストできます。)
Stack Exchange このシンタックスハイライトは(新しいバージョンのインストールを除いて)維持されません。また、ここMetaにバグレポートや機能リクエストを投稿しても、修正または実装されません。
お前に何かをする場合は、「正しい強調表示がオンになっていることを確認してください。
構文の強調表示を使用するにはどうすればよいですか?
すべての条件が満たされている限り上記の「コードが正しく強調表示されないのはなぜですか?」セクションで、質問のタグに基づいてコードブロックで強調表示が自動的に開始されます( 4を参照してください。質問のタグでは、これがどのように機能するかについて、上記の構文の強調表示が有効になっています。)インラインコード(例:this)は強調表示されません。
明示的にオーバーライドします。これは、コードフォーマットのコードフェンス(```)メソッドを使用する場合にのみサポートされることに注意してください。 CommonMarkの実装以降、4スペースインデントメソッドを使用したコードブロックでの実装はサポートされなくなりました*:
```lang-or-tag-here code goes here ```
言語コードまたは タグ名 aのいずれかを使用できます>言語ヒントで、構文の強調表示をアクティブにします。ハイライト.jsでサポートされている言語コードの完全なリストについては、以下を参照してください。
例:
Here is a code block with language code (with "lang-" prefix) as a hint: ```lang-js function greet(person) { return "Hello " + person; } var user = "John Doe"; alert(greet(user)); ``` Here is a code block with tag name (no "lang-" prefix) as a hint: ```typescript var arr = [0, 1, 2]; // will highlight if typescript tag exists ```
必要ない場合構文を強調表示するには、lang-none言語を使用できます。
```lang-none [code here] ```
言語ヒントを適用することもできます投稿のすべてのコードブロックに追加するため、投稿の上部にHTMLコメントを追加することで、各ブロックの前にヒントを追加する必要はありません。ヒントは、投稿内のすべてのコードブロックに適用されます。これには、4つのスペースのインデントまたはHTMLを使用するものも含まれます<pre><code>:
<!-- language-all: lang-or-tag-here -->
質問で使用する場合、回答の強調表示言語を上書きしないことに注意してください。 これらは、質問のタグに従ってデフォルトで引き続き強調表示されます。
StackExchangeで現在利用可能な言語コード
これは、ユーザーが使用するすべての識別子の完全なリストです。シンタックスハイライトの言語ヒントで使用できます。各グループの言語ヒントはすべて同じハイライトを指します。highlight.jsで設定された他の言語エイリアスが機能する場合がありますが、StackExchangeで公式にサポートされているのは次の識別子のみです。
- デフォルト:コードを解釈して推測します
lang-default - なし:シンタックスハイライトを明示的に使用しない
lang-none、lang-plaintext、lang-text、lang-txt - バッシュ
lang-bash、lang-sh、lang-zsh - C、C ++ 、およびその他のCライク
lang-c、lang-h、lang-cpp、lang-hpp、lang-c++、lang-h++、lang-cc、lang-hh、lang-cxx、lang-hxx、lang-c-like - C#
lang-cs、lang-csharp、lang-c# - Clojure
lang-clojure、lang-clj - CoffeeScript
lang-coffee、lang-coffeescript、lang-cson、lang-iced - CSS
lang-css - ダート
lang-dart - Erlang
lang-erl、lang-erlang - 移動
lang-go、lang-golang - Haskell
lang-hs、lang-haskell - HTML、XML、XSLなど。
lang-html、lang-xml、lang-xsl、lang-xhtml、lang-rss、lang-atom、lang-xjb、lang-xsd、lang-plist、lang-wsf、lang-svg - HTTPヘッダー
lang-http、lang-https - IniとTOML
lang-ini、lang-toml - Java
lang-java、lang-jsp - JavaScript
lang-js、lang-javascript、lang-jsx、lang-mjs、lang-cjs - JSON
lang-json - コトリン
lang-kotlin、lang-kt - LaTeX、 TeX
lang-latex、lang-tex - 少ない
lang-less - Lisp
lang-lisp - Lua
lang-lua - Makefile
lang-makefile、lang-mk、lang-mak - マークダウン
lang-markdown、lang-md、lang-mkdown、lang-mkd - MATLAB
lang-matlab - 目的-C
lang-objectivec、lang-mm、lang-objc、lang-obj-c - OCaml
lang-ocaml、lang-ml - パスカル、デルファイ
lang-pascal、lang-delphi、lang-dpr、lang-dfm、lang-pas、lang-freepascal、lang-lazarus、lang-lpr、lang-lfm - Perl
lang-pl、lang-perl、lang-pm - PHP
lang-php、lang-php3、lang-php4、lang-php5、lang-php6、lang-php7 - PHPテンプレート
lang-php-template - プロトコルバッファ
lang-protobuf - Python
lang-py、lang-python、lang-gyp、lang-ipython - R
lang-r - ルビー
lang-rb、lang-ruby、lang-gemspec、lang-podspec、lang-thor、lang-irb - 錆
lang-rs、lang-rust - スカラ
lang-scala - スキーム
lang-scheme - SCSS
lang-scss - シェル
lang-shell、lang-console - SQL
lang-sql - スウィフト
lang-swift - TypeScript
lang-typescript、lang-ts - VHDL
lang-vhdl - VB。NET
lang-vbnet、lang-vb - YAML
lang-yaml、lang-yml
ハイライト.jsによって認識されない投稿で使用される言語識別子は、機能的にデフォルトでlang-defaultになります。
ヒント:タグ
サイトに存在する任意のタグを指定でき、そのタグに現在関連付けられている言語コードを使用します( em> null (ヒントなし)、 default 、または固有の言語コード)。
デフォルトではすべてタグは、言語コードとしてnoneで始まります。言語コードとしてnoneが指定されているタグは、無視されになり、lang-default。
noneキーワードを使用して、noneキーワードを使用して構文の強調表示を手動で指定することもできます。上記のdivid = “17805e05be”>
コード。
*強調表示言語を指定する前者の方法は、引き続きHTMLコードブロックに使用できます。HTMLコメントを配置します。 <!-- language: lang-or-tag-here -->の前に<pre><code>タグを付けると、機能します。
また、この前者メソッドは、4スペースインデントコードブロックでは完全に削除されていませんが、単に非推奨になっています。4スペースインデントコードブロックでは当面は機能しますが、将来削除される可能性があります。
編集者への注意:
追加しないでくださいあなたが100%シュールでない限り、上記のリストにe存在します。
何かを入力しただけで、強調表示されているように見えます。 正しく は識別子が実際にシステムに存在することを意味しません 。無効な識別子はデフォルトに戻ることに注意してください。
さらに、 highlight.jsのドキュメントは、StackExchangeバージョンの highlight.js では実際にはサポートされていない可能性があります。 StackExchangeにデプロイされていない可能性のある個別のモジュール。
これらの点があるため、メタの質問にリンクしてください。リストに新しいヒントを追加するときに、編集サマリーにヒントが存在することを確認します。
コメント投稿者への注意:
このFAQへのコメントは、FAQで理解できない可能性のある事項の説明を求めて、修正できるようにするためのものです。 特定の言語が将来サポートされるかどうかを尋ねないでください。これはではありません Stack Exchangeはこのハイライターを維持していないため、回答できる質問です。言語サポートについては、 highlight.js にアクセスしてください。
コメント
- 'この回答に 設定 (ルールではない)が示されている必要があります 言語コード または タグ名 (おそらくいくつかの修飾子付き)のいずれかを使用するためですか?例えば。 " Zを除き、YよりもXを使用することをお勧めします。" (MSOに関するある程度関連する質問(コメント内) ): シンタックスハイライトに関する2つのコードフォーマットスタイル(コードフェンスとインデントブロック)の違いは何ですか' ? )
- そのタグに現在関連付けられている言語コードを使用しますこれらのマッピングの公式リストはどこでも利用できますか?
- セクション4、 " 4。質問のタグで構文の強調表示が有効になっていることを確認してください" 、@ JoshGoebelを見つけるためのすべての情報があります
- @Josh直接の質問へ、'現在、関連する言語のすべてのタグを含むリストがどこかにあるとは思いません。また、'この情報にはSEDEを使用してアクセスできるようには見えません。また、'はタグテーブルにありません。
https://github.com/highlightjs/プロジェクトの標準色を使用しますか、それともSEサイトは独自の色のセットを使用しますか?色と色のトーンを変更できますか?Language Categories=AllとThemes=Stackoverflow Lightは、まったく同じテーマです。 SEサイトで?lang-defaultに使用される言語はどれですか?