X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=public%2Fhighlight%2FREADME.ru.md;fp=public%2Fhighlight%2FREADME.ru.md;h=198c029329eefb476e45dae4a515ba8bca52845f;hb=4c462ab66e6c65c15df7bd5fe6d2673884c639a0;hp=0000000000000000000000000000000000000000;hpb=7f4e70ea88d180cfa25f25f3846f842c5958ebf4;p=pharext%2Fpharext.org diff --git a/public/highlight/README.ru.md b/public/highlight/README.ru.md new file mode 100644 index 0000000..198c029 --- /dev/null +++ b/public/highlight/README.ru.md @@ -0,0 +1,101 @@ +# Highlight.js + +Highlight.js â ÑÑо подÑвеÑÑик ÑинÑакÑиÑа, напиÑаннÑй на JavaScript. Ðн ÑабоÑÐ°ÐµÑ +и в бÑаÑзеÑе, и на ÑеÑвеÑе. Ðн ÑабоÑÐ°ÐµÑ Ñ Ð¿ÑакÑиÑеÑки лÑбой HTML ÑазмеÑкой, не +завиÑÐ¸Ñ Ð¾Ñ ÐºÐ°ÐºÐ¸Ñ -либо ÑÑеймвоÑков и ÑÐ¼ÐµÐµÑ Ð°Ð²ÑомаÑиÑеÑки опÑеделÑÑÑ ÑзÑк. + + +## ÐаÑало ÑабоÑÑ + +ÐинимÑм, ÑÑо нÑжно ÑделаÑÑ Ð´Ð»Ñ Ð¸ÑполÑÐ·Ð¾Ð²Ð°Ð½Ð¸Ñ highlight.js на веб-ÑÑÑаниÑе â ÑÑо +подклÑÑиÑÑ Ð±Ð¸Ð±Ð»Ð¸Ð¾ÑекÑ, CSS-ÑÑили и вÑзÑваÑÑ [`initHighlightingOnLoad`][1]: + +```html + + + +``` + +ÐиблиоÑека найдÑÑ Ð¸ ÑаÑкÑаÑÐ¸Ñ ÐºÐ¾Ð´ внÑÑÑи Ñегов `
`, попÑÑавÑиÑÑ
+авÑомаÑиÑеÑки опÑеделиÑÑ ÑзÑк. Ðогда авÑоопÑеделение не ÑÑабаÑÑваеÑ, можно Ñвно
+ÑказаÑÑ ÑзÑк в аÑÑибÑÑе class:
+
+```html
+...
+```
+
+СпиÑок поддеÑживаемÑÑ
клаÑÑов ÑзÑков доÑÑÑпен в [ÑпÑавоÑнике по клаÑÑам][8].
+ÐлаÑÑ Ñакже можно пÑедваоиÑÑ Ð¿ÑеÑикÑами `language-` или `lang-`.
+
+ЧÑÐ¾Ð±Ñ Ð¾ÑклÑÑиÑÑ Ð¿Ð¾Ð´ÑвеÑÐºÑ Ð´Ð»Ñ ÐºÐ°ÐºÐ¾Ð³Ð¾-Ñо блока, иÑполÑзÑйÑе клаÑÑ `nohighlight`:
+
+```html
+...
+```
+
+## ÐниÑиализаÑÐ¸Ñ Ð²ÑÑÑнÑÑ
+
+ЧÑÐ¾Ð±Ñ Ð¸Ð¼ÐµÑÑ ÑÑÑÑ Ð±Ð¾Ð»ÑÑе конÑÑÐ¾Ð»Ñ Ð·Ð° иниÑиализаÑией подÑвеÑки, Ð²Ñ Ð¼Ð¾Ð¶ÐµÑе
+иÑполÑзоваÑÑ ÑÑнкÑии [`highlightBlock`][2] и [`configure`][3]. Таким обÑазом
+можно ÑпÑавлÑÑÑ Ñем, *ÑÑо* подÑвеÑиваÑÑ Ð¸ *когда*.
+
+ÐÐ¾Ñ Ð¿ÑÐ¸Ð¼ÐµÑ Ð¸Ð½Ð¸ÑиализаÑиÑ, ÑквиваленÑной вÑÐ·Ð¾Ð²Ñ [`initHighlightingOnLoad`][1], но
+Ñ Ð¸ÑполÑзованием jQuery:
+
+```javascript
+$(document).ready(function() {
+ $('pre code').each(function(i, block) {
+ hljs.highlightBlock(block);
+ });
+});
+```
+
+ÐÑ Ð¼Ð¾Ð¶ÐµÑе иÑполÑзоваÑÑ Ð»ÑбÑе Ñеги ÑазмеÑки вмеÑÑо ``. ÐÑли
+иÑполÑзÑеÑе конÑейнеÑ, не ÑоÑ
ÑанÑÑÑий пеÑÐµÐ²Ð¾Ð´Ñ ÑÑÑок, вам нÑжно ÑказаÑÑ
+highlight.js иÑполÑзоваÑÑ Ð´Ð»Ñ Ð½Ð¸Ñ
Ñег `
`:
+
+```javascript
+hljs.configure({useBR: true});
+
+$('div.code').each(function(i, block) {
+ hljs.highlightBlock(block);
+});
+```
+
+ÐÑÑгие опÑии можно найÑи в докÑменÑаÑии ÑÑнкÑии [`configure`][3].
+
+
+## УÑÑановка библиоÑеки
+
+Highlight.js можно иÑполÑзоваÑÑ Ð² бÑаÑзеÑе пÑÑмо Ñ CDN Ñ
оÑÑинга или ÑкаÑаÑÑ
+индивидÑалÑнÑÑ ÑбоÑкÑ, а Ñакже ÑÑÑановив модÑÐ»Ñ Ð½Ð° ÑеÑвеÑе. Ðа
+[ÑÑÑаниÑа загÑÑзки][4] подÑобно опиÑÐ°Ð½Ñ Ð²Ñе ваÑианÑÑ.
+
+ÐбÑаÑиÑе внимание, ÑÑо библиоÑека не пÑедназнаÑена Ð´Ð»Ñ Ð¸ÑполÑÐ·Ð¾Ð²Ð°Ð½Ð¸Ñ Ð² виде
+иÑÑ
одного кода на GitHub, а ÑÑебÑÐµÑ Ð¾ÑделÑной ÑбоÑки. ÐÑли вам не подÑ
Ð¾Ð´Ð¸Ñ Ð½Ð¸
+один из гоÑовÑÑ
ваÑианÑов, ÑиÑайÑе [докÑменÑаÑÐ¸Ñ Ð¿Ð¾ ÑбоÑке][5].
+
+
+## ÐиÑензиÑ
+
+Highlight.js ÑаÑпÑоÑÑÑанÑеÑÑÑ Ð¿Ð¾Ð´ лиÑензией BSD. ÐодÑобнее ÑиÑайÑе Ñайл
+[LICENSE][10].
+
+
+## СÑÑлки
+
+ÐÑиÑиалÑнÑй ÑÐ°Ð¹Ñ Ð±Ð¸Ð»Ð¸Ð¾Ñеки ÑаÑположен по адÑеÑÑ .
+
+Ðолее подÑÐ¾Ð±Ð½Ð°Ñ Ð´Ð¾ÐºÑменÑаÑÐ¸Ñ Ð¿Ð¾ API и дÑÑгим Ñемам ÑаÑположена на
+ .
+
+ÐвÑоÑÑ Ð¸ конÑÑибÑÑÑоÑа пеÑеÑиÑлена в Ñайле [AUTHORS.ru.txt][9] file.
+
+[1]: http://highlightjs.readthedocs.org/en/latest/api.html#inithighlightingonload
+[2]: http://highlightjs.readthedocs.org/en/latest/api.html#highlightblock-block
+[3]: http://highlightjs.readthedocs.org/en/latest/api.html#configure-options
+[4]: https://highlightjs.org/download/
+[5]: http://highlightjs.readthedocs.org/en/latest/building-testing.html
+[8]: http://highlightjs.readthedocs.org/en/latest/css-classes-reference.html
+[9]: https://github.com/isagalaev/highlight.js/blob/master/AUTHORS.ru.txt
+[10]: https://github.com/isagalaev/highlight.js/blob/master/LICENSE