Toolbox/uk: Difference between revisions
No edit summary |
No edit summary |
||
Line 150: | Line 150: | ||
[http://techbase.kde.org/Schedules наш план дій]. Посилання вказуватиме безпосередньо на відповідну сторінку techbase. | [http://techbase.kde.org/Schedules наш план дій]. Посилання вказуватиме безпосередньо на відповідну сторінку techbase. | ||
Варто пам’ятати: під час попереднього перегляду сторінки посиланнями вже можна користуватися. Це корисно з двох причин: ви можете перевірити (наведенням вказівника миші), чи правильно вказано посилання, і ви можете скористатися посиланнями червоного кольору для створення сторінок. | |||
:{| | :{| |
Revision as of 12:33, 17 June 2011
Додавання вступного знімка вікна та опису
Сторінку програми слід починати саме з такого зображення. Відповідний код:
{|class="tablecenter vertical-centered" |[[Image:Ваш_знімок.png|250px|thumb]] |Ваш опис |}
Форматування тексту
Використання заголовків
Додавання заголовка призводитиме до автоматичного створення розділу у «Змісті», отже визначає структуру документа. Місце у змісті визначається кількістю символів «=» доданих перед і після заголовка. Не використовуйте одинарні символи — так позначається заголовок сторінки. Заголовки найвищого рівня слід позначати так: «==Текст заголовка==», наступного рівня — «===Інший заголовок===» тощо.
Додайте вступний знімок екрана і опис
Одинарні лапки позначають слова напівжирним та курсивним шрифтом.
Використовуйте форматування '''текст жирним''', щоб отримати текст жирним', і ''текст курсивом'', щоб отримати текст курсивом.
Щоб спростити і зробити точнішим переклад, будь ласка, дотримуйтеся настанов щодо форматування.
Додавання фрагмента коду
Нами створено шаблони, які допоможуть вам у правильному форматуванні фрагментів коду. Приклади використання шаблонів у різних випадках можна знайти на настанов щодо форматування.
Якщо у вас виникають проблеми з символом вертикальної риски («|») у фрагменті коду, будь ласка, ознайомтеся з поясненням та порадами щодо форматування на відповідній сторінці.
Додавання відступів
- «:» призначено для створення відступів. На деяких застарілих сторінках цей символ використовується по декілька разів. Цей спосіб створення відступів слід вважати застарілим, оскільки він спричиняє певні проблеми, отже такі кратні відступи має бути вилучено у разі їх виявлення. Одинарна двокрапка, «:», створює відступ на чотири символи.
Форматування дат
Якщо дату буде вказано лише за допомогою послідовності чисел, цю дату буде важко розібрати через відмінності у представленнях дати, характерні для країн різних регіонів. Будь ласка, вказуйте дати у форматі
18 Mar 2011
Слід вказувати повну назву місяця або її скорочену форму та рік у форматі з чотирма цифрами. День можна вказувати однією або двома цифрами.
Списки з позначками
Списки з позначками створюються за допомогою символу *. Другий рівень списку можна додати за допомогою послідовності **:
* Мигдаль<!--}}--> * Горіхи ** Ліщина * Родзинки
дасть нам
- Мигдаль
- Горіхи
- Ліщина
- Родзинки
Переліки
Переліки або нумеровані списки можна отримати у подібний же спосіб за допомогою «#».
# Просіяти # Змішати ## Ретельно розмішати # Запекти
Отримаємо
- Просіяти
- Змішати
- Ретельно розмішати
- Запекти
Поєднання списків з позначками та нумерованих списків
У списку з позначками можна створити допоміжний перелік, і навпаки. Ось так:
* Горіхи *# Ліщина *# Отримати на горіхи * Інші речі
Отримаємо:
- Горіхи
- Ліщина
- Отримати на горіхи
- Інші речі
Код
# Горіхи #* Ліщина #* Отримати на горіхи # Інші речі
дасть нам
- Горіхи
- Ліщина
- Отримати на горіхи
- Інші речі
Списки
Списки можна створювати за допомогою додавання на початку рядка ; та : відповідно. Ними можна користуватися для створення коротких описів групи пов’язаних об’єктів.
;Тварини : Вони рухаються і їдять інших істот. ;Рослини : Вони мають корені і споживають воду з ґрунту та сонячні промені.
відповідає такому списку:
- Тварини
- Вони рухаються і їдять інших істот.
- Рослини
- Вони мають корені і споживають воду з ґрунту та сонячні промені.
Додавання посилань
Передбачено два різних типи посилань: внутрішні (на сторінки UserBase) та зовнішні (на інші сторінки інтернету).
Для внутрішніх посилань працездатним є формат [[Назва_сторінки]], де у дужках слід вказати назву сторінки, але цей варіант не є ідеальним з точки зору локалізації. Краще вказувати адреси у форматі [[Special:myLanguage/Назва_сторінки|Назва сторінки]], оскільки такий варіант надає змогу створювати посилання на переклади сторінок. Перехід за таким посиланням здійснюється на перекладену сторінку, якщо переклад вже було виконано. Часто посилання є частиною речення, тоді слід користуватися таким кодом:
[[Special:myLanguage/PageLayout|ця сторінка]]
Буде показано:
Формат посилань на зовнішні сторінки є дещо іншим:
[http://techbase.kde.org/Schedules наш план дій]
буде показано так:
наш план дій. Посилання вказуватиме безпосередньо на відповідну сторінку techbase.
Варто пам’ятати: під час попереднього перегляду сторінки посиланнями вже можна користуватися. Це корисно з двох причин: ви можете перевірити (наведенням вказівника миші), чи правильно вказано посилання, і ви можете скористатися посиланнями червоного кольору для створення сторінок.
:{| |[[Image:help-hint.png]]||'''Підказка'''||Щось, про що важливо пам’ятати |} |
:{| |[[Image:dialog-warning.png|32px]]||'''Попередження'''||Це небезпечно |} |
Для показу нотатки або попередження, яке є достатньо важливим, щоб наголосити на них, призначено два шаблони Info і Warning. Використання:
{{info|Це інший спосіб показу вашої інформації}}
або
{{warning|Виконання цієї дії є дуже небезпечним}}
Версії програм для KDE3 і KDE SC 4
Типово вважається, що програму створено для KDE SC 4. Якщо версія для KDE SC 4 ще не готова до використання або версії для KDE 4 взагалі не існує, ймовірно, варто розповісти про версію для KDE3. У такому разі додайте піктограму {{KDE3}}, яку буде показано так: . Якщо ви маєте намір викласти дані щодо версій для KDE3 і KDE SC 4 на одній сторінці, скористайтеся піктограмою нової версії: {{KDE4}} ( )
Корисні шаблони
Останні зауваження, стосуються програм, які не є частиною основного набору програм KDE. Позначити це можна за допомогою відповідної піктограми, яку слід додати за допомогою коду {{Community-app}}
наприкінці речення або рядка, подібно до того, як позначається підрядкова примітка у книжках. Якщо ви додасте {{Community-app-footnote}}, буде створено підрядкову примітку, ось так:
Подробиці щодо цієї програми можна знайти на домашній сторінці відповідного проекту
Внесення значних змін до вже створених сторінок
If this notice persists for an unreasonable time, please either notify irc.freenode.org #kde-www or report on Annew's Talk page
Note: Pages should not normally be marked for translation while they are being actively worked on
Не забудьте вилучити шаблон, коли завершите редагування!
Додавання нової складної сторінки
Додавання списку підсторінок
є дуже корисним, якщо вам потрібен список підсторінок з активними посиланнями, ось такий:
Підсторінки Toolbox/uk
Поєднати введення з виведенням можна за допомогою підсвічування синтаксису GeSHi. Область введення даних виглядатиме так
{{Input|<syntaxhighlight lang="php" line> # Ініціалізація типового коду $preIP = dirname( __FILE__ ); require_once( "$preIP/includes/WebStart.php" ); </syntaxhighlight>}}
отримаємо:
# Ініціалізація типового коду $preIP = dirname( __FILE__ ); require_once( "$preIP/includes/WebStart.php" );
Багато хто створює чернетку майбутньої сторінки на власній сторінці обговорення, а потім пересуває результати за бажаною адресою. Іноді з певних причин можна одразу розпочинати створення сторінки за остаточною її адресою. Якщо ви створюєте сторінку за остаточною адресою, вам варто додати перед основним текстом шаблон {{Construction}}. В результаті додавання цього шаблону буде показано таке повідомлення:
Намагайтеся не створювати структури, рівень вкладеності у якій перевищує три. Здебільшого, достатньою для викладу буде така структура:
Якщо можливо, варто розпочати основну сторінку програми саме з цього елемента. Відповідний код:
Використання заголовків
Одинарні лапки використовуються для позначення слів з напівжирною та курсивною гарнітурою.
* призначено для створення ненумерованих списків. Комбінацію ** призначено для створення пунктів другого рівня вкладеності:
:* Одна зірка ===Додавання окремого зображення, вирівняного за центром=== <div style="white-space:pre;"> :{|style="width:95%; border:2px dotted #BCBCBC; background:lemonchiffon" align="center" |<nowiki>{|class=tablecenter |[[Image:Desktop-config-customized.png|230px|center]]||[[Image:Desktop-settings-rightclick.png|230px|center]] |- |[[Image:Desktop-theme-details-dialog.png|230px|center]]||[[Image:Plasma-multiple-themes.png|230px|center]] |}
|}
{{Info|Це важлива інформація}} відповідатиме тексту
{{Note|Якась важлива інформація}} відповідатиме тексту
{{Tip|Корисна порада, щось, що слід запам’ятати}} відповідатиме тексту
{{Warning|Обережно! Це небезпечно!}} відповідатиме тексту
Програми спільноти
Якщо редагування сторінки відбувається протягом тривалого періоду часу, виникає небезпека конфліктів: хтось інший може вносити зміни до тексту сторінки одночасно з вами, у результаті збереження нової версії ваші зміни або зміни внесені іншим автором буде втрачено. Подібних неприємностей можна уникнути, якщо додати безпосередньо на початку сторінки шаблон {{Being_Edited}}. На відповідному місці буде показано повідомлення
Якщо вам потрібен певний час на наведення ладу на сторінці (декілька днів), ви можете скористатися шаблоном Construction: {{Construction}}. Буде показано:
Посилання на сусідні сторінки
Ви можете додавати посилання на попередню або наступну сторінку за допомогою таких шаблонів:
{{Prevnext/uk|Назва попередньої сторінки|Назва наступної сторінки|Сторінка перед цієї сторінкою|Сторінка, яка має йти наступною}}
Якщо сторінка є першою (немає попередньої сторінки) або останньою (немає наступної сторінки), скористайтеся таким кодом:
{{Next|Назва наступної сторінки|Цю сторінку вам слід читати далі}}
- Toolbox/uk
- Цю сторінку вам слід читати далі →
{{Prev|Назва попередньої сторінки|Ця сторінка передує поточній}}
- ← Ця сторінка передує поточній
- Toolbox/uk
Заголовки автоматично стають частиною Змісту, отже під час їх використання слід враховувати структуру сторінки. Їх місце у ієрархії визначається кількістю символів «=», доданих по обидва боки від заголовка. Не використовуйте заголовки з одинарним «=»: одинарні «=» позначають заголовок сторінки, слід використовувати автоматично створені заголовки. Основні заголовки мають бути такими: «==Текст заголовка==», наступний рівень: «===Текст заголовка===» тощо.