Различия

Показаны различия между двумя версиями страницы.

--- faq:редактирование [2024/09/14 20:18] – KG
+++ faq:редактирование [2024/09/15 22:25] (текущий) – [Зачем в заголовке моего нового лётного места написано [ЧЕРНОВИК]?] KG
@@ Строка 6: / Строка 6: @@
 ===== Частые вопросы =====
+==== Кто может править страницы? ====
+Эта база знаний построена на принципе wiki, то есть технически править страницы может любой человек с правами редактора (их надо сначала попросить [[https://t.me/meles_volans|у админа лично]] или [[https://t.me/+sL7n74r-NZNlYWYy|в официальной группе проекта]]). Но лучше придерживаться следующей политики:
+  - Если страницы **ещё нет** - создайте её. Обычно это не требует согласования - просто внимательно почитайте этот FAQ перед созданием. Если вы готовы её поддерживать и актуализировать и дальше (=стать ответственным за неё), то честь вам и хвала. Напишите об этом в официальной группе, тегнув админа, и последующие крупные правки люди будут согласовывать с вами (по крайней мере, постараются) :)
+    - :!: Если вы хотите как-то значительно изменить структуру предложенного шаблона страницы (добавить или удалить раздел, например), то лучше сначала отпишитесь об этом в официальной группе. Возможно, ваше предложение настолько хорошее, что мы захотим поправить шаблон страницы и обновить другие существующие страницы.
+  - Если страница **уже есть**, а вам хочется её как-то исправить или дополнить:
+    - Если правка мелкая, а вы на сто процентов уверены, что она верна (например, поменялась стоимость завоза на старт), то вперёд! Не забудьте постфактум уведомить ответственного за страницу, что вы что-то поправили.
+    - Если вы видите, что в странице остался незаполненным кусок шаблона (легко определяется по <информации в угловых скобках> или слову FIXME), то это аналогично предыдущему пункту. Можно править с уведомлением постфактум.
+    - Если правка крупная (новый раздел, изменение большого куска текста, удаление неактуального блока), то лучше сначала спросить в официальной группе, стоит ли её делать, тегнув ответственного за страницу.
+  - :!::!: В следующих случаях консультация с ответственным за страницу **и** админом **__обязательна__** (пишите в оффгруппу и тегайте обоих):
+      - Если вы хотите добавить на любую страницу принадлежащий кому-то файл (например, маршрутные точки или непубличную фотографию)
+      - Если вы хотите опубликовать непубличный контакт какого-либо человека или непубличную ссылку на чат
+      - Если вам точно известно, что кто-то недвусмысленно выступает против опубликования информации
+      - Если публикуемая информация нарушает какие-либо законы (один из примеров - трек полёта по очевидным запреткам)
+__[[:pageowners|Список ответственных за страницы (доступно только редакторам)]]__
 ==== Как создать новую страницу? ====
   * Самый простой способ - это с главной страницы вики, [[https://paraspots.wiki/start#%D0%B4%D0%BE%D0%B1%D0%B0%D0%B2%D0%B8%D1%82%D1%8C_%D0%BD%D0%BE%D0%B2%D1%83%D1%8E_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%83|в соответствующем разделе]].
@@ Строка 11: / Строка 27: @@
 ==== Я создал страницу, а на ней сразу что-то написано. Что это, откуда это? ====
-Это шаблон, который призван облегчить создание новых страниц. Посмотреть его публичную версию можно [[места:тестовое|вот здесь]].
+<WRAP center round alert 100%>
+Пожалуйста, внимательно прочитайте этот раздел. **Это важно.** \\
+У многих редакторов поначалу возникает естественное желание удалить всё подставленное в страницу автоматом и написать своё с нуля. \\
+Это **очень плохая идея**, потому что из-за этого наша база знаний может превратиться в __хаотичную свалку разнородного текста__!
+</WRAP>
+При создании страницы в неё автоматически подставляется шаблон текста, который призван облегчить создание новых страниц. Посмотреть публичную версию шаблона лётного места можно [[места:тестовое|вот здесь]]. \\
+В целом, всё, что нужно для написания достаточно неплохой статьи о лётном месте - это заменить обозначенные угловыми скобками места в шаблоне на свою информацию, тем более, что в большинстве разделов приведены примеры того, что должно получиться в итоге. :!: Некоторые угловые скобки в шаблоне - это разметка, а не обозначение участков, которые нужно заменить. Таких мест очень мало, очевидные примеры - это %%<gallery>%%, %%<imgcaption>%%, %%<hidden>%% и %%<WRAP>%%. :!:  \\
+__Например, из вот этого:__
+<code - Шаблон>
+**Расположение:** <координаты (4 знака после запятой) + ссылка на гуглокарты, пример: [[https://maps.app.goo.gl/5ASFHnwDBw8voPGp6|4.4136,-76.1521]]><опционально пометка: **:!: южное полушарие**>
+</code>
+__Должно получиться вот это:__
+<code - Результат>
+**Расположение:** [[https://maps.app.goo.gl/5ASFHnwDBw8voPGp6|4.4136,-76.1521]] **:!: южное полушарие**
+</code>
+__И на странице это будет выглядеть вот так:__ \\
+**Расположение:** [[https://maps.app.goo.gl/5ASFHnwDBw8voPGp6|4.4136,-76.1521]] **:!: южное полушарие** \\
+Конечно, некоторые разделы шаблона могут быть неприменимы для конкретной страницы и их иногда можно удалять целиком. Руководствуйтесь здравым смыслом, спрашивайте непонятное в официальной телеграм-группе. \\
+Всё нюансы описать в двух абзацах сложно. Изучайте разметку на уже существующих страницах, чтобы понять, как что сделано, и в итоге у нас получится красивая и единообразная база знаний :)
+==== Зачем в заголовке моего нового лётного места написано [ЧЕРНОВИК]? ====
+Для того, чтобы отделить свежесозданные и ещё не отредактированные заглушки от нормальных страниц.
+Перед тем, как удалять слово [ЧЕРНОВИК] из заголовка, убедитесь, что страница выглядит хоть немного полезной:
+  * заполнена шапка шаблона, оставлены нужные формы рельефа, проставлена ссылка на страну и координаты
+  * заполнена таблица "Как, сколько, для кого" в начале раздела "Полёты"
+  * написано что-то про старт, завоз и подбор
+  * и так далее, руководствуйтесь здравым смыслом
 ==== Что важно не забыть при редактировании? ====
@@ Строка 30: / Строка 74: @@
   - Дальше нажать "копировать ссылку", скопируется ссылка вида [[https://maps.app.goo.gl/syjtzf26rWxHvEzu7|https://maps.app.goo.gl/syjtzf26rWxHvEzu7]]
 Далее полученную ссылку можно использовать для вставки в статью стандартным для движка способом. В качестве текста ссылки часто удобно использовать координаты, округлённые до 4 знака после запятой.
+==== Как загружать и вставлять в статью файлы и картинки? ====
+FIXME нужно более подробное описание \\
+  * загрузка картинок неплохо описана [[https://www.dokuwiki.org/ru:media_manager|в официальной доке]] (можно и походить там по ссылкам)
+  * вставка картинок в текст описана [[https://www.dokuwiki.org/ru:images|там же рядом]]
+  * лучше загружать все связанные картинки в пространство имён, совпадающее или как-то похожее на имя статьи (см. :olu, :solonovka)
+  * подписи к картинкам можно делать с помощью вот такого элемента разметки: <nowiki><imgcaption image1|Подпись>{{:картинка.jpg?400}}</imgcaption></nowiki>, где в фигурных скобках пишется стандартная разметка для вставки картинки
+  * если необходимо красиво разместить несколько картинок с функциональностью галереи, то можно использовать соответствующую разметку. Пример можно изучить [[https://paraspots.wiki/места/тестовое#фотографии|в конце шаблона лётного места]]
 ==== Я хочу много знаний про синтаксис разметки и нюансы редактирования. Как мне их получить? ====
-  * Вам стоит почитать [[https://www.dokuwiki.org/wiki:syntax|официальный мануал движка]] и множество связанных страниц.
+  * Вам стоит почитать [[https://www.dokuwiki.org/wiki:syntax|официальный мануал движка]] и множество связанных страниц. Если очень хочется, то версия руководства по синтаксису разметки есть даже [[https://www.dokuwiki.org/ru:wiki:syntax|на русском языке!]]
-  * Ещё можно спросить [[https://t.me/meles_volans|админа]]. Это обычно тоже работает, но рано или поздно он задолбается отвечать.
+  * Ещё можно спросить [[https://t.me/meles_volans|админа]]. Это пока тоже работает, но рано или поздно он задолбается отвечать.
 ----
 FIXME написать больше пунктов по итогам обратной связи от пользователей...