Редагування розмітки

From KDE UserBase Wiki
Revision as of 13:01, 22 March 2013 by Yurchor (talk | contribs) (Created page with "* На деяких сторінках є посилання на розділи тієї самої сторінки, часто у форматі <nowiki>...</n...")

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

  • На сторінці настанов з форматування наведено вказівки зі стандартного форматування, що використовуються для полегшення перекладу, та перетворення на офіційні підручники (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»). Знову ж таки, слід переконатися, що відповідну прив’язку вказано у коді сторінки (див. вище)!
  • If the page 'OtherPage' is not marked up for translation yet then you should omit the <translate> and </translate> tags.
  • If a paragraph is moved or removed, take the corresponding tags with it.

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

  • Identify all keyboard key-names, and tag, e.g. <keycap>Enter</keycap>
  • Include concurrent keypresses in the <keycap> tag, e.g. Ctrl + Alt + F1. Note that the separator is (space)+(space)
  • Treat menu sequences in a similar manner, using the <menuchoice> tag, e.g.System Settings -> Account Details -> Social Desktop. Note that the separator is (space)->(space)

Warning

NEVER add translate section tags (the ones that look like <!--T:18-->). The software will do any handling of tags that is required, and manually changing them will break the system.


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

  • Identify program names and mark them as bold type, e.g. 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 /home/user/share/contacts"

Tip

Simplified definitions - Programs are launched by users, components are used by programs


Issues that cause Translate problems

Several issues have been identified and discussed, and solutions proposed in the following sections:

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.
  • Use Preview and read through the whole of your work. If you are satisfied, save the page.
  • 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.