Справка/Основы работы системы Bard-Wiki: различия между версиями
Admin (обсуждение | вклад) |
Admin (обсуждение | вклад) |
||
| Строка 25: | Строка 25: | ||
# Вики не работает нормально с падежами в именах. Попыток было много, но все не увенчались успехом. Поэтому принимаем как данность - имена-фамилии в именительном падеже. | # Вики не работает нормально с падежами в именах. Попыток было много, но все не увенчались успехом. Поэтому принимаем как данность - имена-фамилии в именительном падеже. | ||
# Вики не очень хорошо работает с порядком слов в фамилии-имени-отчестве. Тут и выборки, сортировки и многое другое. Это уже касается не только русского языка, хотя мы с отчествами вносим дополнительную суету во всю систему. Поэтому в русской Википедии приняли следующее: <br> | # Вики не очень хорошо работает с порядком слов в фамилии-имени-отчестве. Тут и выборки, сортировки и многое другое. Это уже касается не только русского языка, хотя мы с отчествами вносим дополнительную суету во всю систему. Поэтому в русской Википедии приняли следующее: <br> | ||
**На каждую персону есть 2 странички. На одной стоит общепринятное обращение, например "Сергей Никитин". Вторая страничка начинается с фамилии "Никитин, Сергей Яковлевич". И именно эта страничка является основной. А на первой ставится безусловная переадресация на вторую. Запятую мы ставим тоже не просто-так - по ней мы вычисляем, что это основная страница персоны. Но вот все (почти все) переадресации идут на первую страницу. И в авторах музыки или слов мы указываем не "Никитин, Сергей Яковлевич", а "Сергей Никитин". Это не наше изобретение - так уже давно работает Википедия. Попытки вычленить фамилию и делать сортировки по ней убивают на порядок больше сил и ресурсов, чем просто две странички с переадресацией одной на другую. | |||
# Тёзки. Проблема не решаемая, поскольку Вики работает с текстами, а на с индексами, то есть мы не можем сделать две странички с одинаковыми названиями. Поэтому, если у нас есть два человека с одинаковым именем - либо мы пишем отличительную черту (например, город), либо мы ставим цифры (I), (II), (III), (IV). Так у нас есть [[Геннадий Васильев (Красноярск)]] и [[Геннадий Васильев (Челябинск)]]. Сложность и неприятность в том, что именно так надо будет писать и на страничках песен. Но на самом деле - это не так и сложно. | # Тёзки. Проблема не решаемая, поскольку Вики работает с текстами, а на с индексами, то есть мы не можем сделать две странички с одинаковыми названиями. Поэтому, если у нас есть два человека с одинаковым именем - либо мы пишем отличительную черту (например, город), либо мы ставим цифры (I), (II), (III), (IV). Так у нас есть [[Геннадий Васильев (Красноярск)]] и [[Геннадий Васильев (Челябинск)]]. Сложность и неприятность в том, что именно так надо будет писать и на страничках песен. Но на самом деле - это не так и сложно. | ||
[[Файл:Пример имена - Геннадий Васильев (Челябинск).png|735x735пкс]] | [[Файл:Пример имена - Геннадий Васильев (Челябинск).png|735x735пкс]] | ||
Версия от 17:09, 1 июля 2025
Введение
В этом разделе справки мы пройдемся по тому - как устроена система Bard-Wiki и что делать, чтобы она работала и как ее не поломать.
Имена
По большому счету вся работа Вики на основе расширений PageForms и Cargo, которыми мы пользуемся, строится на именах - названиях страниц, данных полей. И, желательно, в них не ошибаться.
Страницы песен
Как ни странно - Бард-Вики все равно, как называются страницы песен. Поиск идет по полям шаблонов. Но, как всегда, есть нюанс.
Если вы создаете страницу при помощи формы "Создать страницу песни" - то здесь все должно быть жестко. Формат следующий:
- Название песни (Автор Музыки - Автор Слов - пер. Переводчик)
- Название песни (Автор Музыки - Автор Слов)
- Название песни (Автор Песни)
Если в каком-то из разделов авторов несколько - они разделяются запятыми.
При таком названии данные автоматически перенесутся в форму - при создании страницы система выделит отдельно название, авторов (именно в таком порядке) и внесет их в нужные поля шаблона {{Song}}.
Имена авторов
С именами авторов все сложнее.
Несколько пунктов:
- Вики не работает нормально с падежами в именах. Попыток было много, но все не увенчались успехом. Поэтому принимаем как данность - имена-фамилии в именительном падеже.
- Вики не очень хорошо работает с порядком слов в фамилии-имени-отчестве. Тут и выборки, сортировки и многое другое. Это уже касается не только русского языка, хотя мы с отчествами вносим дополнительную суету во всю систему. Поэтому в русской Википедии приняли следующее:
- На каждую персону есть 2 странички. На одной стоит общепринятное обращение, например "Сергей Никитин". Вторая страничка начинается с фамилии "Никитин, Сергей Яковлевич". И именно эта страничка является основной. А на первой ставится безусловная переадресация на вторую. Запятую мы ставим тоже не просто-так - по ней мы вычисляем, что это основная страница персоны. Но вот все (почти все) переадресации идут на первую страницу. И в авторах музыки или слов мы указываем не "Никитин, Сергей Яковлевич", а "Сергей Никитин". Это не наше изобретение - так уже давно работает Википедия. Попытки вычленить фамилию и делать сортировки по ней убивают на порядок больше сил и ресурсов, чем просто две странички с переадресацией одной на другую.
- Тёзки. Проблема не решаемая, поскольку Вики работает с текстами, а на с индексами, то есть мы не можем сделать две странички с одинаковыми названиями. Поэтому, если у нас есть два человека с одинаковым именем - либо мы пишем отличительную черту (например, город), либо мы ставим цифры (I), (II), (III), (IV). Так у нас есть Геннадий Васильев (Красноярск) и Геннадий Васильев (Челябинск). Сложность и неприятность в том, что именно так надо будет писать и на страничках песен. Но на самом деле - это не так и сложно.
Шаблоны
Вся работа с базой данных Cargo ведется через шаблоны - они позволяют структурировать информацию и создавать заполняемые поля.
При работе через формы в это все вникать не нужно, но кто хочет покопаться внутри (и не поломать) - может будет интересно.
Шаблон Song
Вот краткое описание шаблона Song. Именно по данным этого шаблона ведется база песен. Если на странице песни нет этого шаблона - она не попадет в базу, на страницу авторов и пр.
{{Song
|Name= # Полное оригинальное название (тут не указываются авторы, как в названии страницы)
|AlterName= # Альтернативные названия, если есть
|FirstString= # Первая строка. Или, если первая строка очень короткая, первая+вторая строки
|Composer= # Автор музыки
|Lyric= # Автор стихов
|Translation= # Переводчик (если нет - тег отсутствует)
|Genre= # Если имеет отношение к бардовской песне - "АП", остальное по желанию. Но есть список жанров - должно быть точно, как в этом списке. Так что лучше это поле заполнять через форму.
|Tag= # 7-9 ключевых слов в единственном числе с заглавной буквы, через запятую с пробелом. Фактически - это списки, куда попадет песня. Есть список "Весна", есть список "Лето", есть список "Море". Их несколько сотен.
|Date= # ГГГГ год написания
|CV= # Ссылка на ChordsVault - очень уважаемый сайт с аккордами. Там не так много песен, зато грамотные аккорды с табулатурами
|Chords= # есть ли на странице песни аккорды - "Да" или "Нет"
|Movie= # Если есть указание фильма, спектакля или пьесы. Фильм (год) Спектакль (театр, режиссер) Название пьесы. Если нет - тег отсутствует.
|Authorized= # Текст выверен - автором или тем, кто заполняет страницу.
}}
Минимально должны быть заполнены поля Name, FirstString, Composer, Lyric, Genre. Если это стихотворение - то поле Composer убирается. При создании страницы через форму - поле Composer есть всегда, и в случае со стихотворением - его нужно убрать или очистить. Также, если это стихотворение, то Genre лучше поставить "Поэзия" - тогда можно делать по стихам отдельную выборку.
Автор музыки, Автор стихов и Переводчик - указываются так, как это принято - "Сергей Никитин", "Юрий Визбор". Если же у нас ситуация с тёзками, то придется указывать как, например "Геннадий Васильев (Красноярск)". Если у нас два, например, композитора, то пишем через запятую: "Виктор Берковский, Сергей Никитин". С переводчиком точно также: "Самуил Маршак". Есть проблема с иностранными авторами - тут правил общих нет - писать ли их латиницей или по-русски. Но нужно смотреть, есть ли уже страница автора, и указывать так, как указано там. Например "Les Reed", "Вильям Шекспир" или "Жак Брель".