Loading…
nikitamaynagashev
Translation uploaded |
Things to check
Source string description
ConnectionWizardDialog help 3/7:Flags
c-format
Loading…
nikitamaynagashev
Translation uploaded |
<b><big>Percent Encoding</big></b><br>
The issue is complicated.
It is recommended to avoid reserved characters and spaces
for component values in URIs if the values are under your control
(e.g. you cannot avoid it when you must specify such characters
in values for an URI to access a remote print queue
but the remote print queue is not under your control).
Whenever possible use only so called 'unreserved characters'.
Unreserved characters are uppercase and lowercase letters,
decimal digits, hyphen, period, underscore, and tilde.
Even hyphen, period, tilde, and case sensitivity
could cause special issues in special cases
(e.g. only letters, digits, and underscore are known to work
for a CUPS print queue name and case is not significant there).
Therefore it is best to use only lowercase letters, digits,
and underscore for all values in all URIs if possible.<br>
Reserved characters and space characters in the value of a component
must be percent-encoded (also known as URL encoding).<br>
When an input field in the dialog is intended to enter
only a single value for a single component of the URI
(e.g. separated input fields for username and password),
you must enter spaces and reserved characters literally
(i.e. non-percent-encoded).
For such input fields all spaces and reserved characters
will be automatically percent-encoded.
For example if a password is actually 'Foo%20Bar' (non-percent-encoded),
it must be entered literally in the password input field in the dialog.
The automated percent-encoding results 'Foo%2520Bar' which is how
the value of the password component is actually stored in the URI.<br>
In contrast when an input field in the dialog is intended to enter
more that a single value for a single component of the URI
(e.g. a single input field for all optional parameters
like 'option1=value1&option2=value2&option3=value3'
or a single input field to enter the whole URI),
you must enter spaces and reserved characters percent-encoded
because an automated percent-encoding is no longer possible.
Assume in an optional parameter 'option=value'
the value would be 'this&that' so that the whole
optional parameter would be 'option=this&that' (literally).
But a literal '&' character denotes
the separation of different optional parameters
so that 'option=this&that' in an URI means
a first optional parameter 'option=this' and
a second optional parameter which is only 'that'.
Therefore a single optional parameter 'option=this&that'
must be entered percent-encoded as 'option=this%26that'<br>
Input fields which require percent-encoded input
are denoted by a '[percent-encoded]' hint.<br>
Listing of characters and their percent encoding:<br>
space ' ' is percent encoded as %20<br>
exclamation mark ! is percent encoded as %21<br>
number sign # is percent encoded as %23<br>
Dollar sign $ is percent encoded as %24<br>
percentage % is percent encoded as %25<br>
ampersand & is percent encoded as %26<br>
apostrophe / single quotation mark ' is percent encoded as %27<br>
left parenthesis ( is percent encoded as %28<br>
right parenthesis ) is percent encoded as %29<br>
asterisk * is percent encoded as %2A<br>
plus sign + is percent encoded as %2B<br>
comma , is percent encoded as %2C<br>
slash / is percent encoded as %2F<br>
colon : is percent encoded as %3A<br>
semicolon ; is percent encoded as %3B<br>
equals sign = is percent encoded as %3D<br>
question mark ? is percent encoded as %3F<br>
at sign @ is percent encoded as %40<br>
left bracket [ is percent encoded as %5B<br>
right bracket ] is percent encoded as %5D<br>
For details see 'Uniform Resource Identifier (URI): Generic Syntax' at<br>
http://tools.ietf.org/html/rfc3986
</p>
<b><big>
Процентное кодированиеPercent-encoded</big></b><br>Это сложный вопрос.
Рекомендуется избегать зарезервированных символов и пробелов
в значениях компонентов URI, если это в ваших силах
(т.е. вы не можете этого избежать, если такие символы
есть в значениях для URI доступа к удал
ёенной очереди печати,но удал
ёенной очередью печати управляете не вы).Когда это только возможно используйте только т.н.
'"незарезервированные символы'".Незарезервированными символами являются буквы в верхнем и нижнем регистрах,
десятичные цифры, дефис, точка, подч
ёеркивание и тильда.Даже дефис, точка, тильда и разные регистры могут
в некоторых случаях привести к проблемам
(например, в имени очереди печати CUPS можно использовать только буквы, цифры и
подч
ёеркивание, а регистр роли не играет).Таким образом, лучше всего использовать только буквы в нижнем регистре, цифры
и подч
ёеркивание во всех значениях всех URI, если это возможно.<br>Зарезервированные символы и пробелы в значениях компонентов
должны быть кодированы процентом (т.н. URL-кодирование).<br>
Если поле ввода в диалоге принимает только одно значение
одного компонента URI (например, раздельные поля ввода
для имени пользователя и пароля),
вы должны вводить пробелы и специальные символы как есть
(т.е. не кодированными процентом).
Для таких полей ввода все пробелы и зарезервированные символы
будут автоматически кодированы процентом.
Например, если пароль действительно
«"Foo%20Bar»" (не кодированный процентом),то так он и должен быть введ
ёен в поле ввода пароля в диалоге.Результат автоматического процентного кодирования будет
«"Foo%2520Bar»", т.к.именно так значение пароля хранится в URI.<br>
С другой стороны, когда поле ввода в диалоге принимает больше
одного значения одного компонента URI (например, одно поле
ввода для всех необязательных параметров типа
«"option1=value1&option2=value2&option3=value3»"или одно поле ввода для всего URI), вы должны вводить
пробелы и зарезервированные символы кодированными процентом,
потому что автоматическое
процентное кодированиеpercent-encoded более невозможно.Предположим, в необязательном параметре
'"параметр=значение'"значение будет
'"это&то'", т.е. весь параметр будет'"параметр=это&то'".Но символ
«"&»" также является разделителем различных необязательныхпараметров, так что
«"параметр=это&то»" в URI означаетпервый параметр
«"параметр=это»" и второй параметр«то»"то".Таким образом единый параметр
«"параметр=это&то»"должен быть кодирован процентом вот так:
«"параметр=это%то»".<br>Поля ввода, требующие кодирования процентом,
обозначаются подсказкой
«[процентное кодирование]»"[percent-encoded]".<br>Список символов и их процентных кодов:<br>
пробел
« »" " кодируется процентом как %20<br>восклицательный знак ! кодируется процентом как %21<br>
знак номера # кодируется процентом как %23<br>
знак доллара $ кодируется процентом как %24<br>
знак процента % кодируется процентом как %25<br>
амперсанд & кодируется процентом как %26<br>
апостроф/одиночная кавычка
'" кодируется процентом как %27<br>левая скобка ( кодируется процентом как %28<br>
правая скобка ) кодируется процентом как %29<br>
зв
ёездочка * кодируется процентом как %2A<br>знак плюс + кодируется процентом как %2B<br>
запятая , кодируется процентом как %2C<br>
косая черта / кодируется процентом как %2F<br>
двоеточие : кодируется процентом как %3A<br>
точка с запятой ; кодируется процентом как %3B<br>
знак равно = кодируется процентом как %3D<br>
вопросительный знак ? кодируется процентом как %3F<br>
знак собаки @ is кодируется процентом как %40<br>
левая квадратная скобка [ кодируется процентом как %5B<br>
правая квадратная скобка ] кодируется процентом как %5D<br>
Подробнее см.
«"Uniform Resource Identifier (URI): Generic Syntax»"<br>по адресу http://tools.ietf.org/html/rfc3986
</p>