Справка/Основы работы системы Bard-Wiki
Введение
В этом разделе справки мы пройдемся по тому - как устроена система Bard-Wiki и что делать, чтобы она работала и как ее не поломать.
Имена
По большому счету вся работа Вики на основе расширений PageForms и Cargo, которыми мы пользуемся, строится на именах - названиях страниц, данных полей. И, желательно, в них не ошибаться.
Страницы песен
Как ни странно - Бард-Вики все равно, как называются страницы песен. Поиск идет по полям шаблонов. Но, как всегда, есть нюанс.
Если вы создаете страницу при помощи формы "Создать страницу песни" - то здесь все должно быть жестко. Формат следующий:
- Название песни (Автор Музыки - Автор Слов - пер. Переводчик)
- Название песни (Автор Музыки - Автор Слов)
- Название песни (Автор Песни)
Если в каком-то из разделов авторов несколько - они разделяются запятыми.
При таком названии данные автоматически перенесутся в форму - при создании страницы система выделит отдельно название, авторов (именно в таком порядке) и внесет их в нужные поля шаблона {{Song}}.
Имена авторов
С именами авторов все сложнее.
Несколько пунктов:
- Вики не работает нормально с падежами в именах. Попыток было много, но все не увенчались успехом. Поэтому принимаем как данность - имена-фамилии в именительном падеже.
- Вики не очень хорошо работает с порядком слов в фамилии-имени-отчестве. Тут и выборки, сортировки и многое другое. Это уже касается не только русского языка, хотя мы с отчествами вносим дополнительную суету во всю систему. Поэтому в русской Википедии приняли следующее:
- На каждую персону есть 2 странички. На одной стоит общепринятное обращение, например "Сергей Никитин". Вторая страничка начинается с фамилии "Никитин, Сергей Яковлевич". И именно эта страничка является основной. По ней делаются выборки, сортировки и пр. А на первой - с именем-фамилией - ставится только безусловная переадресация на вторую. И больше ничего, она пустая. И служит только для правильной переадресации.
- Запятую после фамилии мы ставим тоже не просто-так - по ней мы вычисляем, что это основная страница персоны. Но все (почти все) переадресации со страниц с песнями и других страниц идут на первую страницу - где имя-фамилия. И в авторах музыки или слов мы указываем не "Никитин, Сергей Яковлевич", а "Сергей Никитин".
- Это не наше изобретение - так уже давно работает Википедия. Попытки вычленить фамилию и делать сортировки по ней убивают на порядок больше сил и ресурсов, чем просто две странички с переадресацией одной на другую.
- Тёзки. Проблема не решаемая, поскольку Вики работает с текстами, а на с индексами, то есть мы не можем сделать две странички с одинаковыми названиями. Поэтому, если у нас есть два человека с одинаковым именем - либо мы пишем отличительную черту (например, город), либо мы ставим цифры (I), (II), (III), (IV). Так у нас есть Геннадий Васильев (Красноярск) и Геннадий Васильев (Челябинск). Сложность и неприятность в том, что именно так надо будет писать и на страничках песен. Но на самом деле - это не так и сложно.
.png)
Шаблоны и тэги страницы с песней
Вся работа с базой данных 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", "Вильям Шекспир" или "Жак Брель".
Вот примеры заполненного шаблона:
{{Song
|Name=Размытый путь
|FirstString=Размытый путь и вдоль кривые тополя.
|Composer=Александр Дулов
|Lyric=Николай Рубцов, Александр Дулов
|Genre=АП,классическая АП
|Tag=Грусть, Родина, Разлука, Отъезд, Путь, Поле, Тополь, Пристань
|Chords=Да
|Authorized=Нет
}}
{{Song
|Name=Философская песня вечного члена жюри
|FirstString=Я – добрый, красивый, везучий
|Composer=Игорь Решетов
|Lyric=Сергей Гринберг
|Genre=АП,классическая АП,юмор
|Tag=Жюри, Конкурс, Барды, Ирония, Творчество, Оценка, Процесс
|Date=2003
|Chords=Нет
|Authorized=Нет
}}
{{Song
|Name=Когда б я был царем царей
|FirstString=Когда б я был царем царей
|Composer=Алексей Иващенко
|Lyric=Ваганты
|Translation=Лев Гинзбург
|Genre=АП,актерская песня,баллада,современная АП
|Tag=Царь, Любовь, Королева, Тайна, Кровь, Власть, Ночь
|Chords=Нет
|Authorized=Нет
}}
Текст
Текст песни обрамляется тегами <poem> и </poem>.
У нас переписан код этого расширения по сравнению с тем, что есть в стандартной MediaWiki. Я предпочитаю, чтобы, когда показывался текст на экране компьютера, текст шел в 2 колонки (иногда в 3, но это отдельная история). Система смотрит на ширину экрана и, соответственно, в зависимости от этого показывает 2 или 1 колонку. На экранах смартфона также будет либо 2, либо 1 колонка, в зависимости от ориентации.
Можно принудительно указать максимальное количество колонок. Для этого есть модификация <poem c=1> (одна колонка) и <poem c=3> (три колонки). Аккорды, например, предпочтительно, чтобы шли в 1 колонку. В блоке аккордов тогда надо поставить <poem c=1>.
Эпиграфы перед песней можно сделать разными тегами. Если там просто текст, то предпочтительней использовать <blockquote></blockquote> - в этом система сама делит по строчкам по ширине страницы. Если же у нас стихотворный текст, разбитый на строчки, то лучше использовать <pre></pre>, иначе все строчки выйдут в одну строку. Но этот вариант можно использовать и во всех случаях, просто вручную покрошить текст на строчки - в противном случае длинные строки будут вылезать за края экрана.
Дата и место написания просто ставятся после закрытия тега </poem>, но если хотите сделать красиво - поставьте <small>''2003''</small> - он будет таким же по размеру как и текст песни, при этом курсивом. После него - обязательно пустая строка.
Подвал
После песни выводится информация о ней. Чтобы она выводилась - ставим вызов шаблона {{Подвал}}. Получается то, что показано на картинке:
Дополнительные разделы
После подвала можно поставить дополнительные разделы, такие как Аккорды и/или Комментарии, Примечания, Варианты и, по большому счету, любые, например текст исходного стихотворения, если он отличается от текста песни. (см. Размытый путь (Александр Дулов - Николай Рубцов, Александр Дулов))
Мы не ограничиваем пользователей. Если они предпочитают, чтобы аккорды шли в основном тексте песни — никаких возражений. Сами же мы предпочитаем, чтобы аккорды шли отдельно от текста. Поэтому после подвала можно сделать раздел "===Аккорды===" и поставить там текст с аккордами (также обрамляя его тегами <poem c=1> и </poem>).
Точно так же вставляются Комментарии и всё что душе угодно.
Исполнение
В какой-то момент, еще в самом начале создания Бард-Вики, внезапно возник вопрос - а как же с исполнителями? И вот тут мы встряли. Делать вначале песни ссылки на исполнение - можно, конечно. Но это никак не будет каталогизироваться и собираться в базу. Но ведь есть прекрасные исполнители, которые заведут (или мы заведем сами - ушедшим) странички у нас и на них будет пусто. Либо вручную собирать.
Пробовали разные варианты и решили, что надо добавить к функционалу странички песен еще и шаблон "Исполнение". И на страничках персон также добавить список со ссылками на исполняемые песни. Конечно, у авторов это будет тогда два порой очень больших списка. Но пусть будет.
Сложность заключалась в том, что исполнений одной песни может быть не одно, а несколько. И тогда пришлось делать шаблон с возможностью нескольких вызовов с одной страницы. В самом шаблоне названия песни нет - он берет ее из основного шаблона. Поэтому выглядит несколько куцо, но он вполне функционален.
Вот шаблон со странички Малость запоздалая кантата на отъезд возлюбленного брата (Владимир Ланцберг). Здесь в качестве исполнителей - Лев Юфит и Сергей Нотик.
{{Performance
|performer=Сергей Нотик, Лев Юфит
|link=https://disk.yandex.ru/d/I2PiEEkWJDZ6Bw
|type=аудио
|comm=С диска Льва Юфита «50/50»
}}
А вот двойной шаблон - этот со страницы Так вот мое начало (Геннадий Гладков - Юрий Визбор). Там сразу два исполнения Юрия Визбора - одно в аудио, другое - видео.
{{Performance
|performer=Юрий Визбор
|link=https://www.youtube.com/watch?v=u9F6uteX41I
|type=видео
|comm=Музыка Геннадия Гладкова для спектакля «Автоград-XXI»
}}
{{Performance
|performer=Юрий Визбор
|link=https://my.mail.ru/music/songs/юрий-визбор-так-вот-мое-начало-другой-вариант-бонус-трек-4b00caed3accbb3cc3b50a7e11c00b6e
|type=аудио
|comm=Музыка Геннадия Гладкова для спектакля «Автоград-XXI»
}}
Вот как этот блок выглядит на странице песни:
А на странице персоны собираются все "исполнения", в которых указана персона и выводятся в отдельный блок. Выглядит он на странице персоны вот так:
Если же вы заполняете этот блок из формы песни, то там блок заполнения выглядит следующим образом:
Громоздко, но лучше сделать не удалось. Но оно работает.
Теперь отступление по поводу - откуда брать ссылки. Про видео вы и сами всё знаете. А с аудиопомойками - ссылки на ВК не поставить, там нужна авторизация. Все пиратские помойки типа, зайцев.нет и пр - то пропадают, то появляются. Если вы уверены в себе - можно ставить ссылку на свой диск в яндексе. Есть шанс, что яндекс еще какое-то время будет жить. Я пока пользуюсь музыкой на mail.ru - там можно поставить ссылку на воспроизведение конкретной композиции (у многих этого нет), в принципе - база там похоже из ВК, то есть большая, ну и есть шанс, что будет работать. Размещать видео и аудио на нашем сайте у нас нет денег, сил и законных оснований.
Авторы, исполнители и другие персоны
Страницы персон - авторов, исполнителей и всех-всех тоже сделаны с помощью шаблонов Cargo.
Основной шаблон
Рассмотрим шаблон Persona.
{{Persona
|Name= # Имя Фамилия. Именно так, как ставится в песнях. "Сергей Никитин" или "Геннадий Васильев (Челябинск)"
|FullName= # Полные Фамилия, Имя Отчество. С запятой. "Никитин, Сергей Яковлевич"
|OriginalName= # Имя Фамилия на языке оригинала. Если есть. Формат не важен.
|BirthName= # Имя при рождении. Например у Корнея Чуковского тут будет стоять "Николай Корнейчук"
|Pseudonym= # Известные псевдонимы. Формат не важен.
|Image= # Имя файла с фотографией
|ImageDes= # Описание фотографии - Дата, фотограф, место - Формат не важен. Если есть.
|DateBirth= # Дата рождения. Формат: 1939-11-11
|PlaceBirth= # Место рождения. Города - просто как город. Если село - можно с уточнениями. Напр "Село Улу-Теляк, Башкирия"
|DateDeath= # Дата смерти. Формат: 2020-09-25
|PlaceDeath= # Место смерти.
|Country= # Страны проживания. Через запятую.
|City= # Города проживания. Через заппятую
|Occupation= # Род деятельности в АП. Лучше заполнять из формы - там есть список категорий. Через обратный слэш
|Genre= # Жанр. Для авторов и исполнителей. Тоже заполнять из формы. Ткнуть в галочки, что ближе всего данному автору. Через запятую.
|Profession= # Род занятий помимо АП - список, через запятую
|YearsActive= # Годы творчества - текстовая
|Teams= # Участие в объединениях - список страниц, через запятую
|Ensemble= # Участие в коллективах - список страниц, через запятую
|Festival= # Участие в организации фестивалей - список страниц, через запятую
|Avards= # Лауреатство/дипломы в конкурсах/фестивалях - список, через запятую
|Nocat= # Да/Нет - Исключить из поиска. Поле есть, но не работает.
|Authorized= # Да/Нет - Проверено и сверено
}}
Обязательные поля Name, FullName и Occupation. Объединения, коллективы и фестивали пока не очень функциональны - еще не сделан скелет под них. Но заполнять уже можно.
Ну и самое главное - два поля - Name и FullName.
В поле Name должно стоять то самое имя, которое используется в поле "автор" на странице песни. "Сергей Никитин", "Александр Галич" и пр. То, под которым вероятнее всего обычный человек будет искать данную персону. Опять же в случае с тёзками - в этом поле мы указываем дополнительный признак: "Геннадий Васильев (Красноярск)", "Геннадий Васильев (Челябинск)".
Поле FullName - полное имя. Фамилия, Имя Отчество. "Никитин, Сергей Яковлевич", "Галич, Александр Аркадьевич", "Васильев, Геннадий Михайлович". С запятой после фамилии.
Примеры:
{{Persona
|Name=Михаил Кукулевич
|FullName=Кукулевич, Михаил Анатольевич
|Image=Михаил Кукулевич.jpg
|DateBirth=1939-11-11
|PlaceBirth=Ленинград
|DateDeath=2020-09-25
|PlaceDeath=Мытищи
|Country=Россия
|City=Санкт-Петербург, Москва
|Occupation=Автор (полный)\Автор музыки (композитор)\Автор стихов (поэт)\Исполнитель\Литератор\Педагог АП
|Genre=АП,классическая АП
|Nocat=Нет
|Authorized=Нет
}}
{{Persona
|Name=Геннадий Васильев (Красноярск)
|FullName=Васильев, Геннадий Михайлович
|Image=Васильев Геннадий Красноярск.jpg
|DateBirth=1959-06-23
|PlaceBirth=Томск
|Country=Россия
|City=Красноярск
|Occupation=Автор (полный)\Автор стихов (поэт)\Исполнитель\Организатор концертов\Организатор фестивалей
|Genre=АП,актерская песня,сатира,современная АП,туристская,юмор
|Profession=журналист
|Nocat=Нет
|Authorized=Нет
}}
{{Persona
|Name=Сергей Нотик
|FullName=Нотик, Сергей Александрович
|Image=NotikS.jpg
|DateBirth=1969-04-20
|PlaceBirth=Тольятти
|Country=Россия
|City=Тольятти, Санкт-Петербург
|Occupation=Автор (полный)\Автор музыки (композитор)\Аккомпаниатор\Гитарист\Исполнитель\Руководитель клуба, творческого объединения\Журналист\Звукорежиссер\Специалист IT (soft)
|Genre=АП,актерская песня,классическая АП
|Profession=полиграфия, IT
|YearsActive=1985-
|Teams=КСП "Струг" (Тольятти), Бард-клуб "Парус" (СПб), Бард-Радио
|Ensemble=Ансамбль "Куст", Дуэт "ПтицаЕнот"
|Nocat=Нет
|Authorized=Нет
}}
Как создавать страницы персон?
Я бы рекомендовал вначале сделать хотя бы одну страницу с песней. Тогда страница персоны в минимальной комплектации (без биографии, без дополнительной информации в шаблоне Persona), но вполне функциональная, будет создана автоматически.
Вот пример
{{Persona
|Name=Аполлон Апухтин
|FullName=Апухтин, Аполлон
}}
Краткая информация
==Биография==
Текст биографии
{{Подвал автора}}
После этого можно войти на страничку и при помощи формы заполнить страничку персоны.
Биография
Как правильно заполнить биографию.
Биография делится на две части - "Краткая информация" и "Всё остальное".
Зачем так сделано?
Краткая информация - то, что стоит до раздела "Биография". То, что указано в этой части будет выводиться на заглавной странице Бард-Вики вместе с фотографией. Вот пример:
Остальное - только на самой странице персоны.
Что писать в разделе "Биография"? Какие разделы ставить?
Ограничений нет. То, как вы хотите. Можно делать большие биографии, можно очень кратко. Можно создавать подстраницы с дополнительными материалами. В общем - Вики в чистом виде.
Посмотрите как сделаны другие страницы.
Обычно разделы следующие:
- Биография - тут понятно что писать
- Творчество - акцент на творчестве - особенности, достижения и пр.
- Издания - книги, диски
- Ссылки - ссылки на различные страницы в инете - от биографии в википедии и официального сайта до страничек в разных коллекциях песен и канала на ютубе.
Можно добавить фото в разные годы жизни, можно добавить видео (ссылками с поддерживаемых источников).
Одно ограничение - пока вы "юный", точнее начинающий пользователь - у вас нет разрешения загружать файлы. Вам нужно либо получить права "Автора" или "Куратора", либо подождать, когда система автоматически подтвердит вас как "Пользователя" (для этого нужна неделя и 10 правок).
Но об этом больше написано в Руководстве по безопасности и правам доступа. Оно сейчас пишется.