Поддержка кодировок символов - Revision history

Cher at 05:27, 8 April 2012

2012-04-08T05:27:15Z

Anna at 08:46, 22 February 2012

2012-02-22T08:46:16Z

Anna at 08:45, 22 February 2012

2012-02-22T08:45:57Z

Anna at 08:45, 22 February 2012

2012-02-22T08:45:43Z

Anna: Created page with "Навигация: Главная страница/Система ejudge/Использование/Конфигурационные файлы/[[По..."

2012-02-21T14:42:02Z

Created page with "Навигация: Главная страница/Система ejudge/Использование/Конфигурационные файлы/[[По..."

New page

Навигация: [[Main Page|Главная страница]]/[[Система ejudge]]/[[Использование]]/[[Конфигурационные файлы]]/[[Поддержка кодировок символов]]

@@ Line 1: / Line 1: @@
 Навигация: [[Main Page|Главная страница]]/[[Система ejudge]]/[[Использование]]/[[Конфигурационные файлы]]/[[Поддержка кодировок символов]]
-Система <tt>ejudge</tt> не привязана к какой-либо конкретной кодировке символов, а может работать с произвольной однобайтовой кодировкой, которая поддерживается функцией <tt>iconv</tt>
+Система <tt>ejudge</tt> не привязана к какой-либо конкретной кодировке символов, а может работать с произвольной однобайтовой кодировкой, которая поддерживается функцией <tt>iconv</tt> стандартной библиотеки языка Си. Ограничение на то, что кодировка должна быть однобайтовой накладывается тем, что для работы со строками используются функции стандартной библиотеки предполагающие, что строка оканчивается нулевым байтом. К однобайтовым здесь отнесена и кодировка <tt>utf-8</tt> в которой один символ может кодироваться группой подряд расположенных байтов. Другие примеры однобайтных кодировок: <tt>koi8-r, windows-1251, cp866, iso8859-1</tt>.
-Кодировка, используемая для хранения строк в памяти программ системы <tt>ejudge</tt>, далее называется внутренней кодировкой. Это может быть произвольная однобайтовая кодировка,
+Кодировка, используемая для хранения строк в памяти программ системы <tt>ejudge</tt>, далее называется внутренней кодировкой. Это может быть произвольная однобайтовая кодировка, поддерживаемая функцией <tt>iconv</tt> стандартной библиотеки. Внутренняя кодировка задаётся с помощью опции <tt>--enable-charset</tt> программы <tt>[[configure]]</tt> при компиляции системы. Если внутренняя кодировка с помощью этой опции не задана, в качестве внутренней кодировки используется <tt>utf-8</tt>.
-При запуске внешних программ (например, программ участников на тестирование, или
+При запуске внешних программ (например, программ участников на тестирование, или проверяющих программ, или скриптов компиляции) взаимодействие с ними ведётся во внутренней кодировке <tt>ejudge</tt>. Другими словами, текст из памяти копируется на вход внешних программ без изменений и наоборот, вывод внешних программ считывается в память тоже без изменений. В случае кодировки UTF-8 проверяется корректность текста в этой кодировке и некорректные байтовые последовательности заменяются на знак '?'.
-Генерация HTML страниц также ведётся во внутренней кодировке. Несмотря на то, что
+Генерация HTML страниц также ведётся во внутренней кодировке. Несмотря на то, что в конфигурационных файлах присутствует параметр <tt>charset</tt>, позволяющий менять заголовок HTML-страниц, перекодирование текста сообщения из внутренней кодировки в кодировку HTML-страницы не происходит.
-Кроме того, если включена поддержка локализованных сообщений, при переключении
+Тем не менее, в некоторых случаях можно указывать кодировки файлов, отличные от внутренней кодировки системы <tt>ejudge</tt>. Эти случаи рассмотрены далее.
-Тем не менее, в некоторых случаях можно указывать кодировки файлов, отличные от
+=== Кодировка конфигурационных файлов ===
-=== Кодировка конфигурационных файлов ===
+Кодировка конфигурационных файлов в формате XML (<tt>[[ejudge.xml]]</tt>, <tt>[[register.xml]]</tt>, <tt>[[users.xml]]</tt>, <tt>[[contest.xml]]</tt>, <tt>[[userlist.xml]]</tt>, <tt>[[serve-control.xml]]</tt>) задаётся непосредственно в заголовке соответствующего файла, например,
-Кодировка конфигурационных файлов в формате XML (<tt>[[ejudge.xml]]</tt>, <tt>[[register.xml]]</tt>,
+  <?xml version="1.0" encoding="utf-8"?>
-<tt>[[users.xml]]</tt>, <tt>[[contest.xml]]</tt>, <tt>[[userlist.xml]]</tt>, <tt>[[serve-control.xml]]</tt>) задаётся непосредственно в заголовке соответствующего файла, например,
+Как уже было сказано выше, поддерживаются любые однобайтовые кодировки, поддерживаемые функцией <tt>iconv</tt> стандартной
-  <?xml version="1.0" encoding="koi8-r"?>
+библиотеки языка Си.
-Кодировка конфигурационных файлов в текстовом формате (<tt>[[serve.cfg]], [[master.cfg]],
+Кодировка конфигурационных файлов в текстовом формате (<tt>[[serve.cfg]], [[master.cfg]], [[judge.cfg]], [[team.cfg]]</tt>) задается в первой строке соответствующего файла, например,
-[[judge.cfg]], [[team.cfg]]</tt>) в настоящее время не может быть задана явно, и всегда подразумевается внутренняя кодировка.
+ # -*- coding: utf-8 -*-
 === Кодировка генерируемых файлов ===
-Для конфигурационных файлов утилит в формате XML (<tt>[[register.xml]], [[users.xml]],
+Текст всех HTML-страниц генерируется во внутренней кодировке системы <tt>ejudge</tt>. В конфигурационных файлах существует параметр <tt>charset</tt>, который позволяет изменять кодировку генерируемых файлов, однако в текущей версии этот параметр влияет только на генерируемый заголовок HTML-страницы (поле <tt>Content-type:</tt>), а не на содержимое страницы. Поэтому использование этих параметров '''не рекомендуется'''.
 [[serve-control.xml]]</tt>) кодировка генерируемой страницы указывается с помощью
-атрибута <tt>charset</tt> элемента верхнего уровня. Например, в конфигурационном файле
+Для конфигурационных файлов утилит в формате XML (<tt>[[register.xml]], [[users.xml]], [[serve-control.xml]]</tt>) кодировка генерируемой страницы указывается с помощью атрибута <tt>charset</tt> элемента верхнего уровня. Например, в конфигурационном файле <tt>register.xml</tt> кодировка может быть задана следующим образом:
   <?xml version="1.0" encoding="koi8-r"?>
   <register_config
@@ Line 53: / Line 33: @@
     <nowiki><!-- прочие элементы --></nowiki>
   </register_config>
-Для конфигурационных файлов утилит в текстовом формате (<tt>[[serve.cfg]], [[master.cfg]],
+Для конфигурационных файлов утилит в текстовом формате (<tt>[[serve.cfg]], [[master.cfg]], [[judge.cfg]], [[team.cfg]]</tt>) кодировка генерируемых html-страниц указывается с помощью параметра charset, например, следующим образом:
   charset = "koi8-r"

@@ Line 28: / Line 28: @@
 === Кодировка конфигурационных файлов ===
 Кодировка конфигурационных файлов в формате XML (<tt>[[ejudge.xml]]</tt>, <tt>[[register.xml]]</tt>,
-<tt>[[users.xml]]</tt>, <tt>[[contest.xml]]</tt>, <tt>[[userlist.xml]]</tt>, ,tt>[[serve-control.xml]]</tt>) задаётся непосредственно в заголовке соответствующего файла, например,
+<tt>[[users.xml]]</tt>, <tt>[[contest.xml]]</tt>, <tt>[[userlist.xml]]</tt>, <tt>[[serve-control.xml]]</tt>) задаётся непосредственно в заголовке соответствующего файла, например,
   <?xml version="1.0" encoding="koi8-r"?>
 Как уже было сказано выше, поддерживаются любые однобайтовые кодировки, поддерживаемые функцией <tt>iconv</tt> стандартной библиотеки языка Си.

@@ Line 51: / Line 51: @@
     <nowiki><!-- прочие атрибуты --></nowiki>
+  >
-  <nowiki><!-- прочие элементы --></nowiki>
+   <nowiki><!-- прочие элементы --></nowiki>
   </register_config>
 Для конфигурационных файлов утилит в текстовом формате (<tt>[[serve.cfg]], [[master.cfg]],

← Older revision		Revision as of 08:45, 22 February 2012
Line 1:		Line 1:
	Навигация: [[Main Page\|Главная страница]]/[[Система ejudge]]/[[Использование]]/[[Конфигурационные файлы]]/[[Поддержка кодировок символов]]		Навигация: [[Main Page\|Главная страница]]/[[Система ejudge]]/[[Использование]]/[[Конфигурационные файлы]]/[[Поддержка кодировок символов]]
		+
		+	Система <tt>ejudge</tt> не привязана к какой-либо конкретной кодировке символов, а может работать с произвольной однобайтовой кодировкой, которая поддерживается функцией <tt>iconv</tt>
		+	стандартной библиотеки языка Си. Ограничение на то, что кодировка должна быть однобайтовой накладывается тем, что для работы со строками используются функции стандартной
		+	библиотеки предполагающие, что строка оканчивается нулевым байтом. К однобайтовым
		+	здесь отнесена и кодировка <tt>utf-8</tt> в которой один символ может кодироваться группой подряд расположенных байтов. Другие примеры однобайтных кодировок: <tt>koi8-r, windows-1251, cp866, iso8859-1</tt>. При работе с кодировкой <tt>utf-8</tt> возможны неожиданные визуальные эффекты из-за обрезания строк.
		+
		+	Кодировка, используемая для хранения строк в памяти программ системы <tt>ejudge</tt>, далее называется внутренней кодировкой. Это может быть произвольная однобайтовая кодировка,
		+	поддерживаемая функцией <tt>iconv</tt> стандартной библиотеки. Внутренняя кодировка задаётся
		+	с помощью опции <tt>--enable-charset</tt> программы <tt>[[configure]]</tt> при компиляции системы. Если внутренняя кодировка с помощью этой опции не задана, в качестве внутренней кодировки
		+	используется <tt>iso8859-1</tt>.
		+
		+	При запуске внешних программ (например, программ участников на тестирование, или
		+	проверяющих программ, или скриптов компиляции) взаимодействие с ними ведётся во внутренней кодировке <tt>ejudge</tt>. Другими словами, текст из памяти копируется на вход внешних
		+	программ без изменений и наоборот, вывод внешних программ считывается в память тоже
		+	без изменений.
		+
		+	Генерация HTML страниц также ведётся во внутренней кодировке. Несмотря на то, что
		+	в конфигурационных файлах присутствует параметр <tt>charset</tt>, позволяющий менять заголовок HTML-страниц, перекодирование текста сообщения из внутренней кодировки в кодировку HTML-страницы не происходит.
		+
		+	Кроме того, если включена поддержка локализованных сообщений, при переключении
		+	в русское языковое окружение автоматически включается локализация <tt>ru_RU.KOI8-R</tt>, то
		+	есть все тексты сообщений окажутся в кодировке <tt>koi8-r</tt>.
		+
		+	Тем не менее, в некоторых случаях можно указывать кодировки файлов, отличные от
		+	внутренней кодировки системы <tt>ejudge</tt>. Эти случаи рассмотрены далее.
		+
		+	=== Кодировка конфигурационных файлов ===
		+	Кодировка конфигурационных файлов в формате XML (<tt>[[ejudge.xml]]</tt>, <tt>[[register.xml]]</tt>,
		+	<tt>[[users.xml]]</tt>, <tt>[[contest.xml]]</tt>, <tt>[[userlist.xml]]</tt>, ,tt>[[serve-control.xml]]</tt>) задаётся непосредственно в заголовке соответствующего файла, например,
		+	<?xml version="1.0" encoding="koi8-r"?>
		+	Как уже было сказано выше, поддерживаются любые однобайтовые кодировки, поддерживаемые функцией <tt>iconv</tt> стандартной библиотеки языка Си.
		+
		+	Кодировка конфигурационных файлов в текстовом формате (<tt>[[serve.cfg]], [[master.cfg]],
		+	[[judge.cfg]], [[team.cfg]]</tt>) в настоящее время не может быть задана явно, и всегда подразумевается внутренняя кодировка.
		+
		+	=== Кодировка генерируемых файлов ===
		+	Текст всех HTML-страниц генерируется во внутренней кодировке системы <tt>ejudge</tt>. В
		+	конфигурационных файлах существует параметр <tt>charset</tt>, который позволяет изменять
		+	кодировку генерируемых файлов, однако в текущей версии этот параметр влияет только
		+	на генерируемый заголовок HTML-страницы (поле <tt>Content-type:</tt>), а не на содержимое
		+	страницы. Поэтому использование этих параметров '''не рекомендуется'''.
		+
		+	Для конфигурационных файлов утилит в формате XML (<tt>[[register.xml]], [[users.xml]],
		+	[[serve-control.xml]]</tt>) кодировка генерируемой страницы указывается с помощью
		+	атрибута <tt>charset</tt> элемента верхнего уровня. Например, в конфигурационном файле
		+	<tt>register.xml</tt> кодировка может быть задана следующим образом:
		+	<?xml version="1.0" encoding="koi8-r"?>
		+	<register_config
		+	charset = "KOI8-R"
		+	<nowiki><!-- прочие атрибуты --></nowiki>
		+	>
		+	<nowiki><!-- прочие элементы --></nowiki>
		+	</register_config>
		+	Для конфигурационных файлов утилит в текстовом формате (<tt>[[serve.cfg]], [[master.cfg]],
		+	[[judge.cfg]], [[team.cfg]]</tt>) кодировка генерируемых html-страниц указывается с помощью
		+	параметра charset, например, следующим образом:
		+	charset = "koi8-r"