Дана сторінка надає інструкцію людям, які хочуть редагувати вміст wiki.debian.org.
Швидкий початок для нових редакторів.
Див. також: Довідка про усмішки :-), Довідка про макроси, Довідка про посилання та коротка Довідка про редагування.
Для загальної допомоги з форматування під moinmoin wiki, читайте сторінки HelpContents. Є також довідка з розмітки тексту. Експериментуйте у WikiSandBox.
Якщо Ви не згідні з чимось написаним нижче, прокоментуйте це, потім розпочніть нову дискусію на сторінці обговорення.
Ваша обліківка
Ваше користувацьке імʼя має бути у форматі «ІмяПрізвище» («ПсевдонімIrc» або імʼя входу розробника Debian).
Налаштуйте часовий пояс на сторінці userprefs.
Ваша особиста сторінка на цій Вікі
Для створення особистої сторінки використовуйте ШаблонОсобистоїСторінки. Там зібрано поради для вмісту зі вже наявних персональних сторінок.
- Ваше повне імʼя.
- Ваша основна домашня сторінка поза цією вікі.
- Ваша електронна адреса.
Ваше місцезнаходження (місто і країна) добре для узгодженості часових поясів і т.і..
- Якщо Ви користуєтеся IRC — вкажіть свій звиклий сервер, канал і псевдонім.
Якщо Ви розробник Debian (DD) — вкажіть своє імʼя входу (з посиланням на https://qa.debian.org/developer.php?login=foobar@debian.org).
Якщо Ви не розробник Debian — можете вказати посилання на https://bugs.debian.org/from:foo@bar.com.
- Ваші зацікавлення (не обмежується Debian).
- Ваш список «Зробити/Зроблено».
- (Частково) Ваш вклад в open source (звітування про вади; написання/переклад; розробка/підтримка...)
Переконайтеся, що в кінці вашої сторінки вказано CategoryHomepage (в шаблоні HomepageTemplate є за замовчуванням).
Ваші контакти
Якщо Ви часто редагуєте вікі, можете додати контактну інформацію на свою сторінку й долучитися до поштової розсилки debian-www або до IRC-каналу #debian-www (веб-версія).
Підписка на сторінки
- Можна підписуватися на сторінки, які відповідають Вашим зацікавленням.
Забули пароль
Якщо Ви забули пароль від wiki.debian.org — перейдіть на сторінку recoverpass, потім слідуйте за інструкціями (введіть свою адресу електронної пошти, потім натисніть «Вислати мені мої дані облікового запису»).
Стиль написання / Вікіетикет
Є пʼять основних типів вікісторінок:
DocumentMode (документо-подібні)
ThreadMode (?ПотоковіСторінки)
CategoryHomepage (?КатегоріяОсобистіСторінки)
Стиль кожного типу пояснюється ширше на їхніх окремих сторінках.
Намагайтеся підтримувати рівновагу під час написання. Під рівновагою розуміється візуальний баланс та уникання упередженості. Якщо Ви виявили, що Ваші коментарі суперечливі, підпишіть їх, щоб інші могли поставити під сумнів їхню публічність.
Не створюйте БудьЩо під БезкорисливоюНазвоюВікі. Майте на увазі, що створення нової сторінки це найтяжча частина ВікіСтилю.
НещаднийРефакторинг У ВікіВсесвіті нема жодної закінченої сторінки. Увесь вміст можна уточнювати. На RefactoringWikiPages є багато корисних думок.
Якщо тема сторінки досить довга, тоді напишіть окремим абзацом уверху сторінки короткий огляд того, що обговорювалося в цій темі. Якщо підсумковий абзац неможливо написати легко, то, можливо, неправильно підібрано масштаб теми, і його слід або розділити на підтеми, або обʼєднати з іншими в одну більшу тему. Таке часто буває коли ПотоковіСторінки виходять за межі теми.
Див. також: GoodStyle
Посилання
Не зловживайте посиланнями. Якщо їх забагато, читач не знатиме які корисні. Можна помістити деякі посилання внизу сторінки в розділ «Див. також» (але ще раз — не надто багато).
Якщо посилання веде на сторінку іншою мовою, додайте «($language)», наприклад: ?НазваСторінки (французькою)
Див. також: Довідка про посилання
Внутрішні посилання
Внутрішні посилання (в межах цієї вікі)
[[FooPage]] зазвичай, надають перевагу саме цій розмітці
[[SomeParentPagewith/FooPage|FooPage]] часто використовується для скорочення адрес підсторінок.
[[EditorGuide|editor guide]] може використовуватися для надання посиланню звичайної назви з малої букви.
Не «перейменовуйте» сторінку [[НазваСторінки|Інша назва]] (якщо Вам потрібно це зробити, це означає, що сторінку названо неправильно).
У будь-якому випадку, переконайтеся, що назва посилання зрозуміла відвідувачам, і посилання не веде в якесь неочікуване місце (бажано, щоб назва посилання збігалася з назвою сторінки).
Щоб зробити посилання на місце всередині сторінки, потрібно створити якір використовуючи <<Anchor(bar)>> (див. HelpOnMacros), потім вказуйте [[#bar|Розділ Bar]] або [[Foo#bar|Розділ Bar]] (де Розділ Bar — наявна назва абзацу).
Посилання на зовнішні сайти
Кращий спосіб зробити посилання на зовнішній ресурс:
https://www.debian.org/doc/ — репозиторій офіційної документації Debian.
(Уникайте нотації [[https://www.example.com|link label]] , що приховує цільову URL-адресу, якщо тільки контекст не дає зрозуміти про що йдеться, як напр.: «John Doe надає скрипт під назвою test.sh.»)
- Згрупуйте зовнішні посилання в останньому розділі сторінки.
Назвіть цей розділ Зовнішні посилання.
У цьому розділі можна розмістити будь-яке посилання на зразок «домашньої сторінки проєкту». Якщо це не зовнішнє посилання, то розмістіть його в розділі Див. також.
Використовйте формат InterWiki, щоб робити посилання на deb-пакунки, помилки, RFC та статті Вікіпедії.
Посилання зі зовнішніх сайтів
Якщо на якусь (важливу) сторінку посилаються зовнішні джерела, позначте її міткою CategoryPermalink, щоб хтось ненароком її не видалив.
Форматування
Шапка сторінки
Уверху сторінки зазвичай знаходиться така інформація:
- посилання на переклади сторінок (спочатку переконайтеся що вони існують!):
Переклад(и): [[de/DebianWiki/EditorGuide|Deutsch]] - [[fr/DebianWiki/EditorGuide|Français]]
посилання на обговорення (суперечливого матеріялу): (!) [[/Discussion|Discussion]]
порівняйте з DefaultTemplate
не використовуйте для перекладених сторінок макрос <<Include()>>. Тому що, якщо він буде на кожній сторінці, це перевантажує вікі-сервер. Frontpage є винятком.
Банер усунення неоднозначності
Інколи назви сторінок можуть бути неоднозначними. Якщо це не можливо усунути, розмістіть уверху сторінки щось на зразок такого:
Неоднозначність : Ця сторінка про Конференції Debian. |
Зразок:
||<tablestyle="width:65%;margin-left:35%;padding-left:30pt" style="border:1pt solid #b48;border-left:5pt solid #d4a">'''Неоднозначність :''' Ця сторінка про ''Конференції Debian''.<<BR>> Про ''Систему керування налаштуваннями Debian'' дивіться [[debconf]].||
Банер «офіційні матеріяли» Debian
Often, the content of a Debian wiki page is also covered by some piece of "official" Debian Documentation (or in some other "reference" location). The wiki page can still be useful for collaboration. It's a good idea to add a link to the reference location at the top of the page.
Sample link presentation to some official page, related to the current subject.
https://www.debian.org/somewhere - Sample topic
Зразок:
{{{#!wiki debian https://www.debian.org/somewhere - Sample topic }}}
The logo's license is Portal/IDB#debian-official-doc-modif-fpiat.
Розділи змісту
Якщо сторінка стає довгою, можете додати Зміст. Дивіться приклад уверху цієї сторінки!
Зразок (зверніть увагу на відступ одним пробілом):
<<TableOfContents(2)>>
Розділи ЧаП
Типовий розділ ЧаП може форматуватися так:
- П. Як я можу зробити XXXX?
- В1) Ви можете зробити XXXX зробивши X.
- В2) Ви можете зробити XXXX зробивши Y.
Зразок (зверніть увагу на пробіли на початку рядків):
П. Як я можу зробити XXXX? :: В1) Ви можете зробити XXXX зробивши X. :: В2) Ви можете зробити XXXX зробивши Y.
Нижня частина сторінки
Material that naturally belongs in an (optional) "footer" area at the end of the page includes:
- "See also" sections
Link to "Parent Page : ?ParentPageName" (if the page is a SubPage).
Categories to mark connections with other pages
Credits for attachements
Compare DefaultTemplate
Фрагменти сторінки
Not only code can be be reused - page content can too! If you notice that a given paragraph has to be repeated on many pages, you can reuse ("include") a page fragment each time. (Do not abuse this to duplicate content everywhere!)
- A page meant to be included in another should be named */!PageFragment/*
Add a hidden comment (##) at the top of the page so people understand why it's "incomplete" (a fragment!)
See the <<Include()>> macro in HelpOnMacros
A sample is available at InstallingDebianOn and InstallingDebianOn/PageFragments/Philosophy. Also note how the page is included inside a table (but don't use this hack to bypass moinmoin formatting limitations: see Complex Formatting).
Розширене форматування/Комплексне форматування
Avoid using "advanced" formatting (using tables, include, etc.)
- It's difficult to understand and maintain for you and other wiki editors.
It's difficult to read the diff of complex formatting.
- The GUI editor may break your layout.
Зображення, медія і прикріплення
Див. також: HelpOnLinking.
Авторські права і подяки
Додайте інформацію про авторські права і подяки внизу сторінки де Ви прикріпили зображення:
## attachments: ## openlogo-100.jpg Copyright 1999 "Software in the Public Interest" from https://www.debian.org/logos/openlogo-100.jpg
Розташування прикріплення
It's often a good idea to attach the image to the parent page (in case the image is reused in other subpages).
For translated pages, attach the image to the English version (internationalized/localized images should be attached to the internationalized/localized pages).
Знімки екрана
Якщо Вам потрібно розмістити знімок екрана, то спочатку відвантажте його на https://screenshots.debian.net, потім використовуйте :
[[https://screenshots.debian.net/screenshot/amide|{{https://screenshots.debian.net/thumbnail/amide|Screenshot|width=160}}]]
Зверніть увагу, що назва пакунка згадується двічі в цьому блоці.
Приклад:
Розташування зображень
|
Завдяки CSS-параметру: float:right, зображення можна розмістити в правій частині сторінки:
||<tablestyle="float:right; width:100px; background:transparent; margin: 0 0 1em 1em;" style="padding:0.5em; border-style:none;"> {{https://www.debian.org/logos/openlogo-nd-75.jpg}} ||
Примітка: змінюйте width:100px під свої потреби.
Мітки «Потрібна робота»
Переклад(и): English - español - Português (Brasil) - Українська
Мітка — це вікіназва, що має особливе значення для спільноти. Вона використовується для групування сторінок, шляхом пошуку мітки та перегляду всіх сторінок, на яких вона є. У вікі MoinMoin слід користуватися категоріями.
На даний час використовуються такі вікімітки:
FixMe — на сторінці є щось, що потрібно виправити.
ToDo — на сторінці є щось, що потрібно допомогти доробити.
CleanMe — ця вікімітка повʼязана з останнім переходом із рушія Kwiki до поточного рушія MoinMoin.
Наступні категорії також містять сторінки, які потребують роботи
Попередження: не використовуйте інструкцію обробки #deprecated, оскільки це заважає подальшому редагуванню сторінки (як-от виправлення неробочих посилань). Якщо потрібно позначити сторінку, як сторінку яку треба покращити/вилучити, використовуйте відповідну вікімітку замість цього.
Ці мітки призначені для редакторів вікі, а не для відвідувачів, тому не робіть їх надто навʼязливими; замість того щоб розмістити зауваження зверху сторінки, вставте його в підвалі сторінки.
Сторінки
Загальноприйняте найменування URL/сторінок
Use only CamelCase formatting (as opposed to Underscore_Separated).
- The first letter of the first word should be upper case.
- Special characters should be avoided in page names.
Slashes function to create (directory-style) groups of related subpages. If your page clearly belongs to a collection, you might consider creating it as a subpage - see for example the Moinmoin documentation SubPages.
For translated pages, see Translation section.
- Picking an appropriate name is important. It should clearly state what the page is about and should contain the word visitors will search for.
- Avoid ambiguous names - don't use, for instance:
- "About"... about what? About the Debian OS, community, wiki...?
- "Release"... does it mean previous releases, the current stable release, the release life-cycle, future release status, release process, release team, etc...
Створення сторінок
Перед створенням сторінки задайте собі питання:
- Чи сторінка дійсно потрібна? Можливо така сторінка вже існує під іншою назвою? Чи можна додати вміст до наявної сторінки?
Чи відповідає вона інструкціям вмісту wiki.debian.org?
Якщо Ви вирішили продовжити:
Оберіть для сторінки унікальну назву — дивіться Загальноприйняте найменування URL/сторінок.
Пошукайте на сторінці CategoryPortal відповідний портал (можна шукати більше ніж один — оберіть найкращі) і клацніть по ньому.
- На сторінці порталу клацніть ланку Правка і додайте назву нової сторінки, яку бажаєте створити (з форматуванням «посилання»), до наявного списку сторінок.
- Збережіть відредаговану сторінку порталу і натисніть посилання «?» на початку назви нової сторінки, яку потрібно створити; це перенаправить Вас на сторінку, де буде опція створити нову сторінку.
Ви можете створити порожню сторінку, але рекомендується обрати відповідний шаблон — рекомендується DefaultTemplate
Якщо Ваша сторінка повʼязана з темою, яка вже описана в офіційній документації Debian, вкажіть посилання на неї вверху (дивіться Офіційні матеріяли Debian)
- Якщо сторінку завершено, додайте посилання на неї з повʼязаних сторінок (одного посилання часто достатньо).
- Інші поради:
- Перечитайте її через два дні (чи вона виглядає добре?)
- Підпишіться на цю сторінку.
- Ця сторінка не «Ваша», тому не ображайтеся, якщо інші люди будуть «покращувати» її.
Дивіться також: Довідка зі створення сторінок від moinmoin.
Перейменування сторінок
Класні URI не змінюються (w3). Однак, інколи корисно перейменувати сторінку, коли її назва не точно описує її вміст.
Перед перейменуванням сторінки:
Перевірте чи сторінку не позначено міткою CategoryPermalink.
Використайте Google (чи еквівалент), щоб перевірити чи є зовнішні посилання на цю сторінку. Пошукайте link:wiki.debian.org/FooBar. Якщо є посилання — подумайте двічі, перед тим, як перейменовувати. If you rename the page, consider creating a redirect page and contacting the owner of the referring page to get the links updated.
- Check if this page is linked from inside this wiki (open the page and click on the title to get the list of back links).
If you decide to actually rename the page:
Choose a name for a page. see URL/page naming conventions.
- Make sure you update all the pages that used to point to the old name (type the previous page name into the search bar, then click "Text"!).
- Also take care of translated versions of the page.
Примітка: Якщо сторінку можна «перенаправити», це може означати, що сторінку не слід перейменовувати!
Видалення сторінок
Прочитайте про перейменування сторінки, оскільки воно застосовується тут також.
Якщо Ви вважаєте, що сторінку слід видалити, то виконайте наступні кроки:
- Видаліть сторінку самостійно (напишіть своє обґрунтування в полі для коментарів).
або позначте сторінку міткою «CategoryProposedDeletion», щоб інші користуачі могли зреагувати (напр. можете розмістити мітку та пояснення внизу сторінки).
Не будьте грубими: не робіть так, що спочатку скопіювали/вставили вміст існуючої сторінки на нову сторінку, а потім видалили стару — це втратить історію сторінки. Використовуйте замість цього Обʼєднання і розділення сторінок.
Ще раз, якщо є перекладені версії, узгодьте їх!
Обʼєднання і розділення сторінок
Reorganizing pages is a good idea. You are encouraged to:
- Merge "duplicate" pages covering the same subject.
- Merge similar page, if both are "too short".
Split long pages that cover more than one topic (but consider adding a <<TableOfContents>> instead.).
Try to preserve page history:
- Use the Comment field to record the "before" and "after" page-names in splits or mergers.
- Merge pages into one of the existing pages, not into a newly created page.
For translations: if you can't merge/split translated pages, add directions (comments) in the translated version so translators can keep up!
Перенаправлення сторінок
У деяких випадках Вам може знадобитися «перенаправлення» сторінки (що самостійно перенаправляє вебоглядач на потрібну сторінку).
Не зловживайте цією функцією.
зразок :
#redirect DestinationPage go to [[DestinationPage]]
Зверніть увагу, що #refresh не працює в цій вікі.
Див. також: HelpOnProcessingInstructions.
Категорії
довідкова сторінка moinmoin: використання категорій.
Перелік категорій, що використовуються в цій вікі: CategoryCategory.
Портали
Портали — це набір сторінок, що містять посилання на статті. Вони доповнюють реляційну структуру запропоновану CategoryCategory та вбудованою системою пошуку.
Сторінки порталів повинні створюватися на основі шаблону PortalTemplate.
Додавання сторінок у портали
Щоб додати Вашу сторінку на сторінку порталу, додайте мітку CategoryPortal у підвал сторінки і знайдіть відповідний портал до якого її можна приєднати.
Не створюйте портали з безліччю мертвих посилань.
База даних зображень
Часто вживані значки і логотипи порталів згруповано на Portal/IDB. Це зручно для перекладених порталів і для узгодженості графіки.
Переклади
Уверху кожної сторінки є посилання на такі самі сторінки іншими мовами — див. заголовки і для прикладу шаблон сторінки.
Принципи:
- Будь-яка тема, яка є на вікісторінці може мати багато перекладів, але завжди має бути одна «основна» сторінка.
- Оскільки основна копія повинна бути якоюсь мовою, ми стандартно використовуємо англійську версію.
Перекладені сторінки використовують таку схему найменування "код_мови" + "/" + "АнглійськаНазва" — для прикладу:
основна версія: Hardware
французький переклад: fr/Hardware
- Якщо Ви змінили перекладену сторінку, оновіть або повідомте англійську версію.
- Намагайтеся дотримуватися однакового макету на кожній сторінці, це спрощує синхронізацію (особливо, коли редактори, які не володіють вільно Вашою мовою зможуть знайти й оновити потрібні елементи).
Якщо сторінки не існує англійською, створіть її. Якщо Вам некомфортно писати англійською, просто створіть сторінку зі звичайною шапкою і посиланням на Вашу перекладену сторінку, додайте до Вашої сторінки позначку UpdateEnglish.
- Якщо сторінки не існує Вашою мовою, скопіюйте/вставте її з англійської версії й оновіть шапку сторінки, щоб відповідала назві сторінки, потім дивіться нижче.
Синхронізація перекладів
Коли Ви оновлюєте сторінку, щоб вона відповідала іншій іншою мовою (напр. «синхронізуєте» версії), то:
- Усі версії сторінки повинні мати однаковий макет (форматування, порядок розділів тощо).
- Зберігайте чітким стан редагування сторінки:
- (або) оновіть усю сторінку за раз, і змініть відповідний номер «ревізії» в заголовку
(або) додайте коментар на кшталт ## TRANSLATION UPDATE STOPPED here там де Ви зупинилися.
- Якщо перекладена сторінка новіша за англійську:
- (або) оновіть англійську версію самостійно, якщо можете (не хвилюйтеся за дрібні мовні помилки — хтось виправить їх)
(або) допишіть внизу сторінки мітку «UpdateEnglish» і додайте "+ IMPROVEMENTS" до коментаря змін англійської сторінки.
Перекладачі вікі
Люди, що беруть участь у перекладі вікісторінок Debian повинні додати CategoryWikiTranslator на свою особисту сторінку і надавати допомогу в перекладі інших частин Debian.
Допомога wiki.debian.org
Кожен може допомогти покращити wiki.debian.org:
- Покращуючи вміст будь-якої сторінки, там де можете.
- Додаючи поправки і запитання внизу вікісторінок, які Ви відвідали.
- Перевіряючи правопис сторінок (багато внеску зроблено людьми, для яких англійська не є рідною).
Перекладаючи сторінки.
Шукаючи зворотні посилання для FixMe і ToDo.
Роблячи рефакторинг усього, що можете.
Оновляючи сторінки, що містять ?застарілий текст.
Очищаючи (див. ThreadMode)
- Доповнюючи своїми знаннями про те, як встановляти або користуватися Debian
- Якщо Ви не працюєте в IT, то можете створити сторінку з поясненням того, як Ви використовуєте компʼютери в щоденній роботі. Поясніть проблеми й потреби.
Debian потребує людей з не-IT-навичками (право; маркетинг; організація подій; fund-raising; публічні відносини; та багато іншого). Див. також https://www.debian.org/intro/help.
Популяризування wiki.debian.org
Найкращий і найлегший спосіб популяризувати цю вікі це використовувати її для себе і робити її корисною для інших, доповнюючи корисними матеріялами (майте на увазі вказівки для вмісту).
Коли Ви відповідаєте на запитання в поштовій розсилці, на форумах або irc-каналі,
- найперше і найкраще перенаправляти запити на офіційну документацію Debian (www.debian.org/* , man-сторінки, README тощо), пропонуючи автору або супровіднику вдосконалення, якщо це необхідно;
- друге найкраще — оновити відповідну вікісторінку, переконавшись, що вона відповідає на запитання і дати на неї вказівку.
Часті запитання
- П) Чи можна отримати список усіх сторінок цієї вікі?
В) Так, дивіться TitleIndex
- П) Чи буде ця вікі кориснішою, якщо її краще організовати?
- В) Імовірно, але структурована вікі матиме багато суперечливих термінів. Важливіше надати їй хорошого змісту.
- Q) Is there a way to show just the orphan articles?
A) No (OrphanedPages is broken; links in the form [[PageName|Link Label]] aren't counted). But being an orphan is only a problem if there are pages that should link to it and don't (so fix those), or if the page fails to show up in searches (so make sure it includes the appropriate keywords).
- П) Як я можу відстежувати зміни?
- В) Використовуючи дві функції, які доступні в меню бічної панелі:
посилання на сторінку ОстанніЗміни (обмежено тижнем для відвідувачів, 90 днями для користувачів, що ввійшли);
- опція Стежити, яка надсилатиме сповіщення на електронну пошту, якщо сторінка зміниться.
Технічна інформація
Ця вікі працює на програмному забезпеченні moinmoin версії 1.9 (відомості про налаштування вікі). Зараз вона працює на машині, яку надають Dembach Goo Informatik GmbH & Co KG (апаратне забезпечення, розташування сервера та пропускну здатність).