Loading…
TarasPanchenko
Translation changed |
|
TarasPanchenko
Translation changed |
<p>
<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>
<p>
<b><big>Відсоткове кодування</big></b><br> Це складне питання. Рекомендується уникати зарезервованих символів пробілів силах символи черги друку, Коли це "незарезервовані символи символами є літери у верхньому та нижньому регістрах, десяткові цифри, дефіс, крапка, підкреслення і тильда. Навіть дефіс, крапка, тильда і різні регістри можуть в у деяких випадках, призвести до проблем у назві черги друку CUPS можна використовувати тільки букви, цифри, Таким чином, найкраще використовувати лише літери в нижньому регістрі, цифри і URI, коли це можливо.<br> Зарезервовані символи повинні бути кодовані відсотком (т.зв. URL-кодування).<br> Якщо поле вводу в діалозі приймає тільки одне значення одної компоненти URI (наприклад, окремі поля вводу для імені користувача і пароля), і спеціальні символи як є Для таких полів вводу усі пробіли і зарезервовані символи будуть автоматично закодовані відсотком. Наприклад, якщо пароль дійсно «Foo%20Bar» (не кодований відсотком), пароля в діалозі. кодування буде «Foo%2520Bar», бо зберігається в URI.<br> З іншого боку, коли поле введення в діалозі приймає більше одного значення одної компоненти URI (наприклад, одне поле введення для всіх необов'язкових параметрів типу «option1=value1&option2=value2&option3=value3» або одне поле введення для всього URI), ви повинні вводити про тому що автоматичне відсоткове кодування більше неможливе. Припустимо, що у необов'язковому параметрі значення «option=this&that Але символ «&» також є роздільником різних необов'язкових параметрів, тому «option=this&that» URI означає перший параметр «option=this» та другий параметр «that». Таким чином єдиний параметр «option=this&that» повинен бути кодований відсотком ось так: «option=this%26that».<br> Поля вводу, що вимагають кодування відсотком, позначаються підказкою «[відсоткове кодування]».<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> |
TarasPanchenko
Translation changed |
<p>
<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>
<p>
<b><big>Відсоткове кодування</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), ви повинні вводити пропуски і зарезервовані символи через кодування відсотком, тому що автоматичне відсоткове кодування більше неможливе. Припустимо, що у необов'язковому параметрі ' значення ' Але символ «&» також є роздільником різних необов'язкових параметрів, тому « перший параметр Таким чином єдиний параметр « повинен бути кодований відсотком ось так: « Поля вводу, що вимагають кодування відсотком, позначаються підказкою «[відсоткове кодування]».<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> |
Things to check
Source string description
ConnectionWizardDialog help 3/7:Flags
c-format
<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>Відсоткове кодування</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), ви повинні вводити
пробіли та зарезервовані символи через кодування відсотком,
тому що автоматичне відсоткове кодування більше неможливе.
Припустимо, що у необов'язковому параметрі «option=value»
значення «this&that», тобто весь параметр
«option=this&that».
Але символ «&» також є роздільником різних необов'язкових
параметрів, тому «option=this&that» URI означає
першийпараметр «option=this» та другий параметр «that».
Таким чиномєдиний параметр «option=this&that»
повинен бути кодованийвідсотком ось так:
«option=this%26that».<br>Поля вводу, що вимагають кодування відсотком,
позначаються підказкою «[відсоткове кодування]».<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>