同步操作将从 zoowii/highlight.js 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
Highlight.js highlights syntax in code examples on blogs, forums and, in fact, on any web page. It's very easy to use because it works automatically: finds blocks of code, detects a language, highlights it.
Autodetection can be fine tuned when it fails by itself (see "Heuristics").
Link the library and a stylesheet from your page and hook highlighting to the page load event:
<link rel="stylesheet" href="styles/default.css">
<script src="highlight.pack.js"></script>
<script>hljs.initHighlightingOnLoad();</script>
This will highlight all code on the page marked up as <pre><code> .. </code></pre>
.
If you use different markup or need to apply highlighting dynamically, read
"Custom initialization" below.
You can download your own customized version of "highlight.pack.js" or use the hosted one as described on the download page: http://softwaremaniacs.org/soft/highlight/en/download/
Style themes are available in the download package or as hosted files. To create a custom style for your site see the class reference in the file classref.txt from the downloaded package.
Highlight.js can be used under node.js. The package with all supported languages is installable from NPM:
npm install highlight.js
Alternatively, you can build it from the source with only languages you need:
python tools/build.py -tnode lang1 lang2 ..
Using the library:
var hljs = require('highlight.js');
// If you know the language
hljs.highlight(lang, code).value;
// Automatic language detection
hljs.highlightAuto(code).value;
You can replace TAB ('\x09') characters used for indentation in your code
with some fixed number of spaces or with a <span>
to give them special
styling:
<script type="text/javascript">
hljs.tabReplace = ' '; // 4 spaces
// ... or
hljs.tabReplace = '<span class="indent">\t</span>';
hljs.initHighlightingOnLoad();
</script>
If you use different markup for code blocks you can initialize them manually
with highlightBlock(code, tabReplace, useBR)
function. It takes a DOM element
containing the code to highlight and optionally a string with which to replace
TAB characters.
Initialization using, for example, jQuery might look like this:
$(document).ready(function() {
$('pre code').each(function(i, e) {hljs.highlightBlock(e)});
});
You can use highlightBlock
to highlight blocks dynamically inserted into
the page. Just make sure you don't do it twice for already highlighted
blocks.
If your code container relies on <br>
tags instead of line breaks (i.e. if
it's not <pre>
) pass true
into the third parameter of highlightBlock
to make highlight.js use <br>
in the output:
$('div.code').each(function(i, e) {hljs.highlightBlock(e, null, true)});
Autodetection of a code's language is done using a simple heuristic: the program tries to highlight a fragment with all available languages and counts all syntactic structures that it finds along the way. The language with greatest count wins.
This means that in short fragments the probability of an error is high
(and it really happens sometimes). In this cases you can set the fragment's
language explicitly by assigning a class to the <code>
element:
<pre><code class="html">...</code></pre>
You can use class names recommended in HTML5: "language-html",
"language-php". Classes also can be assigned to the <pre>
element.
To disable highlighting of a fragment altogether use "no-highlight" class:
<pre><code class="no-highlight">...</code></pre>
File export.html contains a little program that allows you to paste in a code snippet and then copy and paste the resulting HTML code generated by the highlighter. This is useful in situations when you can't use the script itself on a site.
For the license terms see LICENSE files. For the list of contributors see AUTHORS.en.txt file.
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。