Changes between Initial Version and Version 1 of 0.12/TranslationRu/TracSyntaxColoring

Timestamp:

Jul 16, 2012, 9:22:15 PM (12 years ago)

Author:

trac

Comment:

—

0.12/TranslationRu/TracSyntaxColoring

@@ +1 @@
+= Syntax Coloring of Source Code =
+[[TranslatedPages(revision=0)]]
+
+= Подсветка синтаксиса в исходных кодах = 
+Trac поддерживает подсветку синтаксиса языков программирования в [wiki:WikiFormatting wiki-форматированных] текстах и [wiki:TracBrowser SVN-репозитории]. 
+
+Trac использует внешние библиотеки с поддержкой большого числа языков программирования. 
+
+В настоящее время Trac поддерживает подсветку синтаксиса, используя один или больше следующих пакетов:
+
+ * [http://www.codento.com/people/mtr/genscript/ GNU Enscript] 
+ * [http://silvercity.sourceforge.net/ SilverCity]
+ * [http://pygments.pocoo.org/ Pygments] (но нуждается в плагине для 0.10, см. [#AboutPygments ниже])
+
+Чтобы включить подсветку синтаксиса, просто установите или один (или больше) из этих пакетов. Никакая дополнительная конфигурация не требуется, однако чтобы изменить цвета, взгляните на 'trac/htdocs/css/code.css'. 
+
+Если Вы не знаете, почему trac не может найти установленной библиотеки, попытайтесь включить ведение логов Trac. Обычно с Trac не работает SilverCity 0.9.6. В таком случае используйте текущую версию 0.9.7 или старше 0.9.5 http://trac.edgewall.org/wiki/TracFaq#why-is-my-css-code-not-being-highlighted-even-though-i-have-silvercity-installed
+
+Trac автоматически отдает приоритет !SilverCity прежде Enscript если возможно (см. примечание ниже).
+
+Если никакой из этих пакетов не доступен, Trac отобразит простой plain-текст.
+
+'''Примечание:''' Enscript поддерживает большее число языков, однако !SilverCity быстрее работает, потому что реализован в виде библиотеки и не выполняется во внешнем процессе.
+
+=== !SilverCity ===
+!SilverCity использует лексический анализатор (lexer) [http://www.scintilla.org/ Scintilla]. Scintilla поддерживает больше языков, чем !SilverCity. Если вы хотите добавить к !SilverCity еще один язык, уже поддерживаемый Scintiilla, это совсем не трудно. См. [http://trac.edgewall.org/wiki/SilverCityAddLanguage SilverCityAddLanguage] для дополнительной информации.
+
+=== Pygments ===
+Начиная с версии trac 0.11 [http://pygments.org/ pygments] будет новым модулем подсветки синтаксиса по умолчанию. Эта библиотека реализована на чистом python, очень быстрая, легко расширяется и [http://pygments.org/docs/ хорошо документирована]. Пока не поддерживает столь же много языков, как Enscript или Scintilla, но в целом исполнение более качественное.
+
+Чтобы использовать pygments в trac 0.11 вы должны установить pygments 0.5.1 или выше. Для использования в trac 0.10 вы должны также установить [http://trac-hacks.org/wiki/TracPygmentsPlugin TracPygmentsPlugin] из trac hacks. Если вы нашли любой баг, пожалуйста обращайтесь к [http://dev.pocoo.org/projects/pygments/ pygments trac].
+
+Возможно, приведенная ниже таблица уже устарела, потому что список поддерживаемых языков анализатором pygments пополняется каждую неделю. Просто взгляните на страницу [http://pygments.org/docs/lexers/ поддержки языкового анализатора] pygments.
+
+== Выделение синтаксиса исходников ==
+
+|| || !SilverCity || Enscript || Pygments ||
+|| Ada      ||   || X || ||
+|| Asm      ||   || X || ||
+|| Apache Conf (htaccess)) || || || X ||
+|| * ASP    || X || X || ||
+|| * C      || X || X || X ||
+|| * C#     ||   || X(2) || X ||
+|| * C++    || X || X || X ||
+|| * CMake  || ? || ? || X ||
+|| * Java   || X(4)|| X || X ||
+|| Awk      ||   || X || ||
+|| Boo || || || X ||
+|| CSS      || X ||   || X ||
+|| Python Doctests || || || X ||
+|| Diff     ||   || X || X ||
+|| Eiffel   ||   || X || ||
+|| Elisp    ||   || X || ||
+|| Fortran  ||   || X(3) || ||
+|| Haskell  ||   || X || X ||
+|| Genshi || || || X ||
+|| HTML     || X || X || X ||
+|| IDL      ||   || X || ||
+|| INI || || || X ||
+|| Javascript || X || X || X ||
+|| Lua || || || X ||
+|| m4       ||   || X || ||
+|| Makefile ||   || X || X ||
+|| Mako || || || X ||
+|| Matlab   ||   || X (5) || ||
+|| Mygthy || || || X ||
+|| Objective-C|| || X || ||
+|| OCaml    ||   ||   || X ||
+|| Pascal   ||   || X || X ||
+|| * Perl   || X || X || X ||
+|| * PHP    || X ||   || X ||
+|| PSP      || X ||   || ||
+|| Pyrex    ||   || X || ||
+|| * Python || X || X || X ||
+|| * Ruby   || X || X (1) || X ||
+|| Scheme   ||   || X || X ||
+|| Shell    ||   || X || X ||
+|| Smarty || || || X ||
+|| SQL      || X || X || X ||
+|| Troff    ||   || X || X ||
+|| TCL      ||   || X || ||
+|| Tex      ||   || X || X ||
+|| Verilog  || X(4) || X || ||
+|| VHDL     ||   || X || ||
+|| Visual Basic |||| X || X ||
+|| VRML     ||   || X || ||
+|| XML      || X ||  || X ||
+
+''(*) Supported as inline code blocks in [wiki:WikiFormatting Wiki text] using WikiProcessors.''
+
+''(1) Ruby highlighting is not included in the Enscript distribution.  Highlighting rules for Ruby can be obtained from: http://neugierig.org/software/ruby/
+
+''(2) C# highlighting is not included in the Enscript distribution.  Highlighting rules for C# can be obtained from: http://wiki.hasno.info/index.php/Csharp.st
+
+''(3) Fortran: as packaged, Enscript only supports the fixed source form. Highlighting rules for Fortran 90x/2003 can be obtained from: http://wiki.hasno.info/index.php/F90.st
+
+''(4) since Silvercity 0.9.7 released on 2006-11-23
+
+''(5) By default `.m` files are considered Objective-C files. In order to treat `.m` files as MATLAB files, add "text/x-matlab:m" to the "mime_map" setting in the [wiki:TracIni#mimeviewer-section "[mimeviewer] section of trac.ini"].
+
+== Extra Software ==
+ * GNU Enscript -- http://directory.fsf.org/GNU/enscript.html
+ * GNU Enscript for Windows -- http://gnuwin32.sourceforge.net/packages/enscript.htm
+ * !SilverCity -- http://silvercity.sf.net/
+ * Pygments -- http://pygments.org/
+
+----
+См. также: WikiProcessors, WikiFormatting, TracWiki, TracBrowser
+