Edit Markup/uk: Difference between revisions

From KDE Wiki Sandbox
(Created page with "=== Спеціальні теґи ===")
No edit summary
 
(36 intermediate revisions by 2 users not shown)
Line 13: Line 13:
* На багатьох сторінках для форматування відступів використовуються декілька пробілів. Таке форматування було використано у застарілій документації до mediawiki. Втім, зараз це форматування не використовується через проблеми з експортуванням даних у інші формати. Тому намагайтеся замінити такі відступи відступами у один пробіл. У невпорядкованих списках можна використовувати вкладені списки.
* На багатьох сторінках для форматування відступів використовуються декілька пробілів. Таке форматування було використано у застарілій документації до mediawiki. Втім, зараз це форматування не використовується через проблеми з експортуванням даних у інші формати. Тому намагайтеся замінити такі відступи відступами у один пробіл. У невпорядкованих списках можна використовувати вкладені списки.


* ASCII smilies cause problems and must be removed. They can be replaced by oxygen icons in a small size (11px?) &mdash; you can use the <code><nowiki>{{Smiley}}</nowiki></code> template {{Smiley}}. Many more are available from Wikimedia Commons - details to be added here.
* Емоційки (смайлики) символами ASCII спричиняють проблеми, тому їх слід позбуватися. Такі емоційки можна замінити піктограмами Oxygen малого розміру (11px?), — можна скорситатися шаблоном <code><nowiki>{{Smiley}}</nowiki></code> {{Smiley}}. Інші зображення можна знайти у [https://commons.wikimedia.org/wiki/Smiley Вікісховищі].


* Internal links in the form <nowiki>[[Translation Workflow]]</nowiki> should be edited to the complete form, showing link, then visible text such as <nowiki>[[Special:myLanguage/Translation_Workflow|Translation Workflow]]</nowiki>
* Внутрішні посилання у форматі <nowiki>[[Translation Workflow]]</nowiki> слід вказувати повністю: посилання, потім видимий текст, наприклад <nowiki>[[Special:myLanguage/Translation_Workflow|Translation Workflow]]</nowiki>


* Many styles have been used to display input text, including <nowiki><code>, <pre></nowiki> and tables and boxes. Text intended to be input by the user should use the Input template, <nowiki>{{Input|1=input text (can be multi-line or single)}}</nowiki>. You can still use <nowiki><code></nowiki> for very short input, if you don't want the text to appear on a separate line.  
* Для показу тексту, який має бути введено користувачем, використовувалося різне форматування, зокрема <nowiki><code>, <pre></nowiki>, таблиці та панелі. Тепер слід використовувати для цього шаблон вікі, <nowiki>{{Input|1=текст (може бути багаторядковим або однорядковим)}}</nowiki>. Для коротких фрагментів можна використовувати <nowiki><code></nowiki>, якщо текст має бути розміщено у одному блоці з іншим текстом.  


* Output from terminal and error messages have been similarly marked with a variety of methods. These should be replaced with the Output template, <nowiki>{{Output|1=terminal output}}</nowiki>
* Для показу даних, виведених до термінала, та повідомлень про помилки також використовувалися різні способи. Тепер же, слід використовувати шаблон виведення: <nowiki>{{Output|1=дані, виведені до термінала}}</nowiki>


* Every page should end with a Category statement. These must be standardized categories. A current list of categories can be found on any of the translators' pages linked from [[Translation_Help_Needed|this language page]]
* На кожній зі сторінок має бути плашка категорії. Перелік категорій має бути стандартизовано. З поточним списком категорій можна ознайомитися на будь-якій зі сторінок перекладу категорій, посилання на які розміщено на [[Translation_Help_Needed|цій сторінці]].


* Make sure that there are no unbalanced brackets in any section. If you find unbalanced brackets then add the missing bracket(s) &mdash; possibly in a comment like this: {{Input|1=<nowiki><!--(--> a)</nowiki>}}
* У блоках тексту не повинно бути непарних дужок. Якщо вами буде виявлено такі дужки, додайте дужки, можливо у такий спосіб: {{Input|1=<nowiki><!--(--> a)</nowiki>}}


* There should be a blank line between bullets in lists. See the sections on lists beginning with  [[Special:myLanguage/Toolbox#Bulleted Lists|Bulleted Lists]].
* Між пунктами у невпорядкованому списку з позначками мають бути порожні рядки. Див. розділи у списках пункту [[Special:myLanguage/Toolbox#Bulleted Lists|невпорядковані списки]].


* Tables should be split in a similar manner, so that there is a blank line between each row. The first and last items will need to have curly braces balanced.
* Рядки у таблицях слід також розділяти порожніми рядками. У першому і останньому рядку слід врівноважити кількість дужок (див. вище).


* The old method of beginning a line with a colon (":") to denote an indent causes some serious display problems, not least the navigation panel disappearing to beneath the rest of the content. If you find any such lines, please remove the colon.
* Використовуваний раніше спосіб формування відступів у рядку за допомогою двокрапки («:») призводив до серйозних проблем з показом даних, зникнення панелі навігації або її розташовування під рештою тексту. Якщо ви виявите подібні рядки, слід вилучити двокрапку.


== Stage 2 - Guide to new markup ==
{{Info_(uk)|1=Останнє твердження вже не є повністю чинним. Двокрапки часто використовуються у списках визначень і, здається, з ними немає ніяких проблем. Якщо у вас виникають проблеми із відступами, створеними за допомогою двокрапок, повідомте нам про них за допомогою сторінки обговорення.}}


=== Marking Links for Translation ===
== Другий етап. Настанови щодо нової розмітки ==


* A stand-alone link, such as the application-names in Applications/Internet, should use the form <nowiki>[[Special:myLanguage/Ark|&lt;translate>Ark&lt;/translate>]]</nowiki>
=== Зміна форматування посилань для полегшення перекладу ===


* Where the link is within a sentence the whole of the link should be kept within the translatable message.
* Окремі посилання, зокрема назви програм на сторінці Програми/Інтернет, слід вказувати у форматі <nowiki>[[Special:myLanguage/Ark|&lt;translate>Ark&lt;/translate>]]</nowiki>


=== Marking sections for subpage linking ===
* Якщо посилання є частиною речення, таке посилання слід залишати у межах придатного до перекладу блоку.


Links of the form <nowiki>[[OtherPage#Section|...]]</nowiki> do not work well with the translation system. Whenever you come across this kind of links there are a few things, that must be done:
=== Позначення розділів для посилань на розділи у межах сторінки ===


* The links itself should be changed in the usual way to <nowiki>[[Special:myLanguage/OtherPage#Section|...]]</nowiki>  
Система перекладу погано працює з посиланнями у форматі <nowiki>[[OtherPage#Section|...]]</nowiki>. Якщо вам трапляються подібні посилання, слід вчинити так:


* In the page 'OtherPage' you should check that there is an anchor right before the section 'Section'. It should have the form {{Input|1=<nowiki>&lt;/translate><span id="Section"></span>&lt;translate></nowiki>}}(where of course the string "Section" should be the actual title of the section). There should be a blank line between the anchor and the section header.
* Змінити посилання у звичайний для цієї вікі спосіб <nowiki>[[Special:myLanguage/OtherPage#Section|...]]</nowiki>  


* Some pages have links to their own sections - often of the form <nowiki>[[#Section|...]]</nowiki>. These links should be changed just like all other subpage links to <nowiki>[[Special:myLanguage/ThisPage#Section|...]]</nowiki> (assuming the name of the page is 'ThisPage'); and do remember to check, that the corresponding anchor exists!
* На сторінці «OtherPage» перевірити наявність прив’язки перед розділом «Section». Таку прив’язку має бути вказано у форматі {{Input|1=<nowiki>&lt;/translate><span id="Section"></span>&lt;translate></nowiki>}}(де, звичайно ж, «Section» — заголовок відповідного розділу). Між прив’язкою та рядком заголовка розділу має залишатися порожній рядок.


* If the page 'OtherPage' is not marked up for translation yet then you should omit the <nowiki>&lt;translate> and &lt;/translate></nowiki> tags.
* На деяких сторінках є посилання на розділи тієї самої сторінки, часто у форматі <nowiki>[[#Section|...]]</nowiki>. Такі посилання слід перетворювати до типової форми: <nowiki>[[Special:myLanguage/ThisPage#Section|...]]</nowiki> (тут ми припускаємо, що назвою сторінки є «ThisPage»). Знову ж таки, слід переконатися, що відповідну прив’язку вказано у коді сторінки  (див. вище)!


* If a paragraph is moved or removed, take the corresponding tags with it.
* Якщо сторінку «OtherPage» ще не позначено для перекладу, не слід використовувати теґи <nowiki>&lt;translate> і &lt;/translate></nowiki>.
 
* У разі пересування або вилучення абзацу пересувайте або вилучайте відповідні теґи разом з цим абзацом.


=== Спеціальні теґи ===
=== Спеціальні теґи ===


* Identify all keyboard key-names, and tag, e.g. <nowiki><keycap>Enter</keycap></nowiki>
* Позначайте написи на всіх клавішах клавіатури відповідним теґом, наприклад <nowiki><keycap>Enter</keycap></nowiki>
* Include concurrent keypresses in the <nowiki><keycap></nowiki> tag, e.g. <keycap>Ctrl + Alt + F1</keycap>. Note that the separator is (space)+(space)
* Клавіші у комбінації клавіш слід також позначати теґом <nowiki><keycap></nowiki>, ось так: <keycap>Ctrl + Alt + F1</keycap>. Зверніть увагу на роздільник: (пробіл)+(пробіл)
* Treat menu sequences in a similar manner, using the <nowiki><menuchoice></nowiki> tag, e.g.<menuchoice>System Settings -> Account Details -> Social Desktop</menuchoice>.  Note that the separator is (space)->(space)
* Послідовності пунктів меню також слід позначати схожим чином, за допомогою теґу <nowiki><menuchoice></nowiki>, наприклад <menuchoice>Системні параметри -> Параметри облікового запису -> Соціальна стільниця</menuchoice>.  Зверніть увагу на роздільник: (пробіл)+(пробіл).


{{Warning|1=<span style="color:red">NEVER</span> add translate section tags (the ones that look like <nowiki>&lt;!--T:18--></nowiki>). The software will do any handling of tags that is required, and manually changing them will break the system.}}
{{Warning_(uk)|1=<span style="color:red">НІКОЛИ</span> не додавайте теґи модулів перекладу до розділів вручну (тобто не додавайте теґи, подібні до <nowiki>&lt;!--T:18--></nowiki>). Такі теґи додаються програмно, внесення до них змін вручну може зашкодити роботі системи перекладу.}}


=== Напівжирний шрифт ===
=== Напівжирний шрифт ===


* Identify program names and mark them as bold type, e.g. '''Klipper'''
* Назви програм слід позначати напівжирним шрифтом, наприклад, '''Klipper'''
* Identify labels and names that cannot be changed by the user, and mark them as bold type.
* Мітки і написи, які не може бути змінено користувачем, слід також позначати напівжирним шрифтом.
* Remove any bold type marking that were previously entered, but do not match this guideline.   (See below for emphasizing a word or phrase.)
* Вилучайте позначення напівжирним шрифтом з усіх інших фрагментів тексту. (Настанови щодо виокремлення певних фрагментів тексту наведено нижче.)
* Window captions and Icon labels are also marked as bold type.
* Заголовки вікон та мітки піктограм слід також позначати напівжирним шрифтом.


===Курсив===
===Курсив===


* Italics can be used to give emphasis as you might in non-technical writing
* Курсивом можна скористатися для акцентування фрагментів тексту.
* Use italics on the first appearance of an unfamiliar word or phrase, and if possible link it to #Glossary or a dictionary entry.
* Курсив використовується для позначення першого використання якогось незвичного терміна або фрази з можливим посиланням на розділ глосарія або запис у словнику.
* When referencing other (external) works, titles are italicized.
* У посиланнях на зовнішні роботи для назв робіт також можна використовувати курсив.


=== Combined Bold and Italics ===
=== Поєднання курсиву з напівжирним шрифтом ===


* This should only be used in the context of an example where the user has to substitute text, e.g. "Your new addressbook records are in <tt>/home/</tt>'''''user'''''<tt>/share/contacts</tt>"
* Таке поєднання слід використовувати лише у прикладає, де користувач має замінити своїми даними якийсь фрагмент тексту, наприклад, «Записи вашої нової адресної книги зберігатимуться у теці <tt>/home/</tt>'''''користувач'''''<tt>/share/contacts</tt>".


{{Tip|1=Simplified definitions - ''Programs'' are launched by users, ''components'' are used by programs}}
{{Tip_(uk)|1=Спрощені визначення: ''програми'' — те, що запускають користувачі, ''компоненти'' — те, що використовується програмами для виконання певних завдань.}}


== Issues that cause Translate problems ==
== Форматування, яке може спричинити проблеми для перекладачів ==


Several issues have been identified and discussed, and solutions proposed in the following sections:
З проблемами, які було виявлено і обговорено раніше, та вирішеннями таких проблем можна ознайомитися у таких розділах:


* [[Special:myLanguage/Typographical_Guidelines#Lists|Splitting lists for readability]]
* [[Special:myLanguage/Typographical_Guidelines#Lists|Поділ списків на пункти для того, щоб такі списки було простіше читати]]
* [[Special:myLanguage/Typographical_Guidelines#Keeping_things_together|Other "readability" breaks]]
* [[Special:myLanguage/Typographical_Guidelines#Keeping_things_together|Інші варіанти поділу для зручності читання]]
* [[Special:myLanguage/Typographical_Guidelines#Unbalanced_brackets|Brackets split across sections]]
* [[Special:myLanguage/Typographical_Guidelines#Unbalanced_brackets|Розподіл тексту у дужках на розділи]]


These are usually noticed after the first markup, and it may be necessary to re-arrange spacing and/or structure to avoid the problems.
Подібні проблеми зазвичай спливають після початкового етапу форматування тексту для перекладу. Тому, якщо було виявлено подібні проблеми, слід повернутися до редагування початкової сторінки і вирішити їх.


== Almost finished ==
== Остаточні зауваження ==


* In the summary field at the bottom, enter that you are doing a markup edit.
* У полі резюме редагування, у нижній частині сторінки редагування, зазначте, що було виконано редагування, пов’язане з форматуванням (markup).
* Use <menuchoice>Preview</menuchoice> and read through the whole of your work. If you are satisfied, save the page.
* Натисніть кнопку <menuchoice>Попередній перегляд</menuchoice> і переконайтеся, що текст показано належним чином. Якщо все гаразд, натисніть кнопку збереження тексту сторінки.
* Use the link in the sidebar to request release - it takes you to a page where you can add the URL of the page you have edited. Pasting your link there tells us that you believe the page to be ready for translators to work with. We will scan it, and if satisfied we will enable it for translation.
* Скористайтеся посиланням на бічній панелі, щоб надіслати адміністраторам вікі запит щодо перекладу сторінки. У відповідь на натискання посилання буде відкрито сторінку, на якій ви зможете вказати адресу сторінки, яку ви редагували. Додавання адреси сторінки означає, що ви впевнені, що сторінка готова до перекладу. Адміністратори перевірять сторінку, і, якщо все гаразд, виконають остаточні дії з форматування її для подальшого перекладу.


[[Category:Власний внесок/uk]]
[[Category:Власний внесок/uk]]

Latest revision as of 18:18, 17 February 2018

Доступні інструменти

  • На сторінці настанов з форматування наведено вказівки зі стандартного форматування, що використовуються для полегшення перекладу, та перетворення на офіційні підручники (DocBook). Будь ласка, звертайтеся до цієї сторінки частіше, оскільки, можливо, форматування буде поліпшуватися з метою спрощення перекладу сторінок.

Перший етап обробки 1

Виправлення застарілого форматування

  • Після кожного з заголовків розділів та підрозділів має бути додано порожній рядок.
  • На багатьох сторінках для форматування відступів використовуються декілька пробілів. Таке форматування було використано у застарілій документації до mediawiki. Втім, зараз це форматування не використовується через проблеми з експортуванням даних у інші формати. Тому намагайтеся замінити такі відступи відступами у один пробіл. У невпорядкованих списках можна використовувати вкладені списки.
  • Емоційки (смайлики) символами ASCII спричиняють проблеми, тому їх слід позбуватися. Такі емоційки можна замінити піктограмами Oxygen малого розміру (11px?), — можна скорситатися шаблоном {{Smiley}} . Інші зображення можна знайти у Вікісховищі.
  • Внутрішні посилання у форматі [[Translation Workflow]] слід вказувати повністю: посилання, потім видимий текст, наприклад [[Special:myLanguage/Translation_Workflow|Translation Workflow]]
  • Для показу тексту, який має бути введено користувачем, використовувалося різне форматування, зокрема <code>, <pre>, таблиці та панелі. Тепер слід використовувати для цього шаблон вікі, {{Input|1=текст (може бути багаторядковим або однорядковим)}}. Для коротких фрагментів можна використовувати <code>, якщо текст має бути розміщено у одному блоці з іншим текстом.
  • Для показу даних, виведених до термінала, та повідомлень про помилки також використовувалися різні способи. Тепер же, слід використовувати шаблон виведення: {{Output|1=дані, виведені до термінала}}
  • На кожній зі сторінок має бути плашка категорії. Перелік категорій має бути стандартизовано. З поточним списком категорій можна ознайомитися на будь-якій зі сторінок перекладу категорій, посилання на які розміщено на цій сторінці.
  • У блоках тексту не повинно бути непарних дужок. Якщо вами буде виявлено такі дужки, додайте дужки, можливо у такий спосіб:
    <!--(--> a)
  • Між пунктами у невпорядкованому списку з позначками мають бути порожні рядки. Див. розділи у списках пункту невпорядковані списки.
  • Рядки у таблицях слід також розділяти порожніми рядками. У першому і останньому рядку слід врівноважити кількість дужок (див. вище).
  • Використовуваний раніше спосіб формування відступів у рядку за допомогою двокрапки («:») призводив до серйозних проблем з показом даних, зникнення панелі навігації або її розташовування під рештою тексту. Якщо ви виявите подібні рядки, слід вилучити двокрапку.
Інформація
Останнє твердження вже не є повністю чинним. Двокрапки часто використовуються у списках визначень і, здається, з ними немає ніяких проблем. Якщо у вас виникають проблеми із відступами, створеними за допомогою двокрапок, повідомте нам про них за допомогою сторінки обговорення.


Другий етап. Настанови щодо нової розмітки

Зміна форматування посилань для полегшення перекладу

  • Окремі посилання, зокрема назви програм на сторінці Програми/Інтернет, слід вказувати у форматі [[Special:myLanguage/Ark|<translate>Ark</translate>]]
  • Якщо посилання є частиною речення, таке посилання слід залишати у межах придатного до перекладу блоку.

Позначення розділів для посилань на розділи у межах сторінки

Система перекладу погано працює з посиланнями у форматі [[OtherPage#Section|...]]. Якщо вам трапляються подібні посилання, слід вчинити так:

  • Змінити посилання у звичайний для цієї вікі спосіб [[Special:myLanguage/OtherPage#Section|...]]
  • На сторінці «OtherPage» перевірити наявність прив’язки перед розділом «Section». Таку прив’язку має бути вказано у форматі
    </translate><span id="Section"></span><translate>
    (де, звичайно ж, «Section» — заголовок відповідного розділу). Між прив’язкою та рядком заголовка розділу має залишатися порожній рядок.
  • На деяких сторінках є посилання на розділи тієї самої сторінки, часто у форматі [[#Section|...]]. Такі посилання слід перетворювати до типової форми: [[Special:myLanguage/ThisPage#Section|...]] (тут ми припускаємо, що назвою сторінки є «ThisPage»). Знову ж таки, слід переконатися, що відповідну прив’язку вказано у коді сторінки (див. вище)!
  • Якщо сторінку «OtherPage» ще не позначено для перекладу, не слід використовувати теґи <translate> і </translate>.
  • У разі пересування або вилучення абзацу пересувайте або вилучайте відповідні теґи разом з цим абзацом.

Спеціальні теґи

  • Позначайте написи на всіх клавішах клавіатури відповідним теґом, наприклад <keycap>Enter</keycap>
  • Клавіші у комбінації клавіш слід також позначати теґом <keycap>, ось так: Ctrl + Alt + F1. Зверніть увагу на роздільник: (пробіл)+(пробіл)
  • Послідовності пунктів меню також слід позначати схожим чином, за допомогою теґу <menuchoice>, наприклад Системні параметри -> Параметри облікового запису -> Соціальна стільниця. Зверніть увагу на роздільник: (пробіл)+(пробіл).
Попередження
НІКОЛИ не додавайте теґи модулів перекладу до розділів вручну (тобто не додавайте теґи, подібні до <!--T:18-->). Такі теґи додаються програмно, внесення до них змін вручну може зашкодити роботі системи перекладу.


Напівжирний шрифт

  • Назви програм слід позначати напівжирним шрифтом, наприклад, Klipper
  • Мітки і написи, які не може бути змінено користувачем, слід також позначати напівжирним шрифтом.
  • Вилучайте позначення напівжирним шрифтом з усіх інших фрагментів тексту. (Настанови щодо виокремлення певних фрагментів тексту наведено нижче.)
  • Заголовки вікон та мітки піктограм слід також позначати напівжирним шрифтом.

Курсив

  • Курсивом можна скористатися для акцентування фрагментів тексту.
  • Курсив використовується для позначення першого використання якогось незвичного терміна або фрази з можливим посиланням на розділ глосарія або запис у словнику.
  • У посиланнях на зовнішні роботи для назв робіт також можна використовувати курсив.

Поєднання курсиву з напівжирним шрифтом

  • Таке поєднання слід використовувати лише у прикладає, де користувач має замінити своїми даними якийсь фрагмент тексту, наприклад, «Записи вашої нової адресної книги зберігатимуться у теці /home/користувач/share/contacts".
Підказка
Спрощені визначення: програми — те, що запускають користувачі, компоненти — те, що використовується програмами для виконання певних завдань.


Форматування, яке може спричинити проблеми для перекладачів

З проблемами, які було виявлено і обговорено раніше, та вирішеннями таких проблем можна ознайомитися у таких розділах:

Подібні проблеми зазвичай спливають після початкового етапу форматування тексту для перекладу. Тому, якщо було виявлено подібні проблеми, слід повернутися до редагування початкової сторінки і вирішити їх.

Остаточні зауваження

  • У полі резюме редагування, у нижній частині сторінки редагування, зазначте, що було виконано редагування, пов’язане з форматуванням (markup).
  • Натисніть кнопку Попередній перегляд і переконайтеся, що текст показано належним чином. Якщо все гаразд, натисніть кнопку збереження тексту сторінки.
  • Скористайтеся посиланням на бічній панелі, щоб надіслати адміністраторам вікі запит щодо перекладу сторінки. У відповідь на натискання посилання буде відкрито сторінку, на якій ви зможете вказати адресу сторінки, яку ви редагували. Додавання адреси сторінки означає, що ви впевнені, що сторінка готова до перекладу. Адміністратори перевірять сторінку, і, якщо все гаразд, виконають остаточні дії з форматування її для подальшого перекладу.