Данное руководство функционирует как небольшой чек-лист для корректного переноса оформления при переводе статей на русский. Оно подразумевает, что при переводе вы работаете с исходным кодом страницы (найти его можно, нажав на + Options, затем Page Source на исходной статье).
Шаг 1: Лишние элементы
После копирования исходного кода страницы необходимо убрать следующие блоки:
| Начало блока | Окончание блока | Описание |
|---|---|---|
[[include :scp-wiki:info:start-standalone]] | [[include :scp-wiki:info:end-standalone]] | Модуль Info |
[[include :scp-wiki:info:start]] | [[include :scp-wiki:info:end]] | Модуль Info, объединённый с модулем рейтинга ([[module Rate]]) |
[[include :scp-wiki:component:info-cw]] | — | Модуль Info с предупреждением о 18+ содержимом |
[[include :scp-wiki:component:author-label-source start=-- | [[include :scp-wiki:component:author-label-source end=-- | Подпись об авторах |
[[include :scp-wiki:component:info-ayers | — | Блок с дополнительной информацией от автора |
[[include component:wikimodule]] | — | Блок с другими статьями автора |
[[include :scp-wiki:component:license-box]] | [[include :scp-wiki:component:license-box-end]] | Блок с информацией о лицензировании |
[[include :scp-wiki:component:adult-content-warning | — | Плашка-предупреждение о 18+ содержимом |
[[include :scp-wiki:component:adult-splash]] | — | Плашка-предупреждение о 18+ содержимом |
И убрать элементы с запрещённой символикой:
[[include :scp-wiki:component:scp-pride]][[include :scp-wiki:component:pride-highlighter]][[include :scp-wiki:component:pride-logos]][[include :scp-wiki:theme:scp-trans-pride]][[include :scp-wiki:theme:3law-pride]](заменить на[[include theme:3law]])
Отдельно стоит упомянуть нестандартные визуальные темы. Существует несколько тем-"фреймворков", которые нередко используются в качестве основы для новых тем (на момент написания очерка такими темами-"фреймворками" являются Black Highlighter, Bedrock и BASALT). В нашем филиале тема-зависимость всегда встраивается в производную тему, поэтому если вы видите в статье, например, [[include :scp-wiki:theme:black-highlighter-theme]], после которого идёт [[include]] с ещё одной темой, то строчку с подключением (в данном случае) Black Highlighter, скорее всего, следует убрать.
Узнать, требует ли используемая в статье тема дополнительных [[include]], можно либо на самой странице темы, либо через обратные ссылки тем-"фреймворков" (если там указана используемая в статье тема, значит тема-зависимость уже встроена, и дополнительные [[include]] не нужны).
Шаг 2: "Собачки"
Проверьте наличие в коде строк наподобие @@@@ или @@ @@. Если такие строчки присутствуют и кроме четырёх собачек и пробелов на них отсутствуют иные символы (т.е. если они используются для создания пустых строк), то замените их на синтаксис [[lines 1]], где 1 необходимо заменить на количество таких строк, идущих подряд.
Шаг 3: Чиним [[include]]
В любых блоках [[include ]] необходимо стереть название вики (первую часть имени подключаемой страницы) при наличии оного. Чаще всего это :scp-wiki:, однако там также могут быть :topia:, :kaktuskontainer:, :snippets: или другие значения.
Если после удаления названия вики вы всё ещё наблюдаете сообщение «Вставленная страница не существует», попробуйте заменить у подключаемой страницы категорию на component: или theme:.
Если после действий выше сообщение «Вставленная страница не существует» так и не исчезло, обратитесь к Tech-Staff, занимающимся переносом компонентов, с просьбой о переносе темы или визуального элемента (если в оригинальной статье в [[include]] указан не :scp-wiki:, а иной домен, не забудьте это упомянуть).
Если же вы не наблюдаете сообщение, но и результат не соответствует оригиналу, проверьте страницу вставляемого элемента (https://scpfoundation.net/название:подключаемой_страницы_с_категорией, на этих страницах нередко содержится документация или инструкция по использованию) или обратитесь с Tech-Staff, занимающимся сломанной разметкой.
Шаг 4: Перенос файлов
По правилам сайта любые медиаматериалы или файлы, подключаемые/прилагаемые к статье, необходимо перезаливать на наш сайт. Базовый алгоритм выглядит следующим образом:
- У оригинальной статьи в нижнем меню нажмите
Filesи скачайте все файлы оттуда. - При публикации переведённого варианта статьи на нашем сайте (в частности, после сохранения статьи на Полигоне или в Основном пространстве) в нижнем меню нажмите
Файлыи загрузите предварительно скачанные файлы туда. - Подождите пару минут, пока файлы кешируются, затем обновите страницу и удостоверьтесь, что все файлы на месте, а картинки отображаются корректно.
Однако этих шагов может быть недостаточно. Поэтому перед загрузкой файлов на наш сайт вам необходимо проверить ещё два момента: подключение файлов из других источников и наличие корректного пути к файлу.
Первым делом найдём файлы из других статей или с других вики на WikiDot. Это делается через поиск подстроки /local--files/ по исходнику (в браузерах и Visual Studio Code обычно это сочетание клавиш Ctrl+F). Прежде чем исправлять эти ссылки, не забудьте скачать файлы, на которые они указывают. Затем у каждой ссылки измените доменное имя и адрес статьи на ваши. Далее приведён пример такой ссылки:
[[image http://scpsandboxcn.wdfiles.com/local--files/testing-zone/Site-CN-09-LOGO]]
Оригинальная ссылка в формате WikiDot
Здесь синим отмечено доменное имя, а зелёным — адрес статьи, из которой берётся файл. Исправленный вариант будет выглядеть так:
[[image https://files.scpfoundation.net/local--files/fragment:facilities-map-int/Site-CN-09-LOGO.png]]
Исправленная ссылка в формате русскоязычного филиала
Также вы могли заметить, что в оригинале у файла не было указано расширение (выделено красным). Если при загрузке файла на наш сайт он отображается в списке файлов с расширением, вам необходимо его указать, иначе ссылка не будет работать.
Далее найдём файлы, подключаемые с других сайтов (например, Discord или Imgur). И тут никаких хитростей, увы, нет. Самым надёжным решением будет просто проверить все ссылки через поиск подстрок http: и https: соответственно. Не забудьте исправить ссылки и на такие файлы, корректный формат для нашего филиала указан выше.
Пара слов об иконках внесистемных классов для плашки ACS
Иконки для часто используемых внесистемных классов можно подгружать со страницы component:anomaly-class-bar-source, однако можно и загружать в свою статью как обычные файлы.
Не стоит забывать и о ещё одном немаловажном моменте — локализации изображений. Если в переводимой вами статье присутствует инфографика, схемы или иные изображения с надписями на английском, их требуется отредактировать и перевести надписи.
Шаг 5: Разбираемся с ссылками
В статьях других филиалов нередко используются ссылки формата [*/страница текст] или [/страница текст]. Ссылки такого типа должны использоваться для внешних ресурсов, а не страниц на том же сайте, поэтому любые ссылки с одинарными скобками [ ], ведущие на другие статьи, необходимо заменить на ссылки с тройными скобками [[[|]]]. Это позволяет движку сайта проверять, существует ли страница, на которую ведёт ссылка. На основании этих данных формируются списки обратных ссылок у статей и содержимое модуля WantedPages.
Примеры преобразований:
[*/scp-2521 ●●|●●●●●|●●|●] -> [[[*scp-2521|●●|●●●●●|●●|●]]]
[/scp-2521 ●●|●●●●●|●●|●] -> [[[scp-2521|●●|●●●●●|●●|●]]]
[http://scpwiki.com/scp-2521 ●●|●●●●●|●●|●] -> [[[scp-2521|●●|●●●●●|●●|●]]]
Ссылки на пользователей
В некоторых статьях будут встречаться ссылки на авторов (особенно часто это происходит на страницах хабов, компонентов и очерков).
Для корректной работы подобных ссылок необходимо добавлять external: перед именем пользователя.
Примеры:
[[*user djkaktus]] -> [[*user external:djkaktus]]
[[user djkaktus]] -> [[user external:djkaktus]]
Шаг 6: Корректировка предпросмотра
В нашем филиале вместо Предпросмотр статей для Crom используются специальные модули сайта, поэтому случаи использования данного компонента необходимо заменять.
Во-первых, проверьте, есть ли в переводимой вами статье блок следующего вида:
В качестве примера используется SCP-6183.
[[include :scp-wiki:component:preview
text=ADMONITION: Intermission
]]
[[div style="display: none;"]]
[[include :scp-wiki:component:image-block
| name=https://scp-wiki.wikidot.com/local--files/admonition/blackbox.png
| caption=ADMONITION
| width=100%
| align=center]]
[[/div]]
Учтите: Вместо [[include component:image-block]] может находится просто [[image]], а сам div может быть без отступа ([[div_]]).
Алгоритм действий выглядит следующим образом:
- Замените
[[include component:preview text=]]на[[module PageDescription]][[/module]]. - Между открывающей и закрывающей частью модуля
PageDescriptionдолжно находится содержимое параметраtext. Если в оригинальной статьеcomponent:previewне было, модуль заполняется переводчиком по собственному усмотрению. - Следом за модулем
PageDescriptionдобавьте[[module PageImage src=""]]и передайте в параметрsrcURL изображения из приведённого выше блока, исправленный в соответствии с шагом 4. Если в оригинальной статье такой блок отсутствует, модуль можно пропустить или заполнить по собственному усмотрению. - Удалите из вашего перевода
[[include component:preview]]со всеми параметрами и скрытый блок[[div style="display:none;"]]с изображением. - После сохранения изменений рекомендуем проверить корректную работу компонента через отправку ссылки на ваш перевод в какой-либо мессенджер, поддерживающий эмбеды ссылок.
Корректный результат для приведённого выше примера:
[[module PageDescription]]
НАЗИДАНИЕ: Антракт
[[/module]]
[[module PageImage src="blackbox.png"]]