SCP Foundation

Данное руководство функционирует как небольшой чек-лист для корректного переноса оформления при переводе статей на русский. Оно подразумевает, что при переводе вы работаете с исходным кодом страницы (найти его можно, нажав на + Options, затем Page Source на исходной статье).

Шаг 1: Лишние элементы

После копирования исходного кода страницы необходимо убрать следующие блоки:

• Плашку с дополнительной информацией от автора (начинается с [[include :scp-wiki:component:info-ayers)
• Модуль информации о статье
  • Первый вариант, объединённый с модулем рейтинга, начинается с [[include :scp-wiki:info:start]] и заканчивается [[include :scp-wiki:info:end]] (не забудьте вернуть [[module Rate]] на место удалённого блока)
  • Второй вариант, отдельный, начинается с [[include :scp-wiki:info:start-standalone]] и заканчивается [[include :scp-wiki:info:end-standalone]]
• Блок с информацией о лицензировании (начинается с [[include :scp-wiki:component:license-box]] и заканчивается [[include :scp-wiki:component:license-box-end]])
• Подпись об авторах (начинается с [[include :scp-wiki:component:author-label-source start=-- и заканчивается [[include :scp-wiki:component:author-label-source end=--)
• Плашку-предупреждение о 18+ содержимом (начинается с [[include :scp-wiki:component:adult-content-warning либо [[include :scp-wiki:component:adult-splash]])
• Элементы с запрещённой символикой:
  • [[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 необходимо заменить на количество таких строк, идущих подряд.

Затем найдите остальные случаи использования @@. Если между двумя парами "собачек" стоят только пробелы, такой синтаксис не сработает на нашем филиале. Необходимо первую пару символов заменить на [[span style="white-space: pre-wrap"]], а вторую на [[/span]]. Пробелы между парами "собачек" удалять не нужно.

Шаг 3: Чиним [[include]]

В любых блоках [[include ]] необходимо стереть название вики (первую часть имени подключаемой страницы), при наличии оного. Чаще всего это :scp-wiki:, однако там также могут быть :topia:, :kaktuskontainer:, :snippets: или другие значения.

Если после удаления названия вики, вы всё ещё наблюдаете сообщение «Вставленная страница не существует», попробуйте заменить у подключаемой страницы категорию на component: или theme:.

Если после действий выше, сообщение «Вставленная страница не существует» так и не исчезло, обратитесь к Tech-Staff, занимающимся переносом компонентов, с просьбой о переносе темы или визуального элемента (если в оригинальной статье в [[include]] указан не :scp-wiki:, а иной домен, не забудьте это упомянуть).

Если же вы не наблюдаете сообщение, но и результат не соответствует оригиналу, проверьте страницу вставляемого элемента (https://scpfoundation.net/название:подключаемой_страницы_с_категорией, на этих страницах нередко содержится документация или инструкция по использованию) или обратитесь с Tech-Staff, занимающимся сломанной разметкой.

Шаг 4: Перенос файлов

По правилам сайта любые медиаматериалы или файлы, подключаемые/прилагаемые к статье, необходимо перезаливать на наш сайт. Базовый алгоритм выглядит следующим образом:

1. У оригинальной статьи в нижнем меню нажмите Files и скачайте все файлы оттуда.
2. При публикации переведённого варианта статьи на нашем сайте (в частности, после сохранения статьи на Полигоне или в Основном пространстве) в нижнем меню нажмите Файлы и загрузите предварительно скачанные файлы туда.
3. Подождите пару минут, пока файлы кешируются, затем обновите страницу и удостоверьтесь, что все файлы на месте, а картинки отображаются корректно.

Однако этих шагов может быть недостаточно. Поэтому перед загрузкой файлов на наш сайт вам необходимо проверить ещё два момента: подключение файлов из других источников и наличие корректного пути к файлу.

Первым делом найдём файлы из других статей или с других вики на WikiDot. Это делается через поиск подстроки /local--files/ по исходнику (в браузерах и Visual Studio Code обычно это сочетание клавиш Ctrl+F). Прежде чем исправлять эти ссылки, не забудьте скачать файлы, на которые они указывают. Затем, у каждой ссылки измените доменное имя и адрес статьи на ваши. Далее приведён пример такой ссылки:

Здесь синим отмечено доменное имя, а зелёным — адрес статьи, из которой берётся файл. Исправленный вариант будет выглядеть так:

Также вы могли заметить, что в оригинале у файла не было указано расширение (выделенно красным). Если при загрузке файла на наш сайт он отображается в списке файлов с расширением, вам необходимо его указать, иначе ссылка не будет работать.

Далее найдём файлы, подключаемые с других сайтов (например, Discord или Imgur). И тут никаких хитростей, увы, нет. Самым надёжным решением будет просто проверить все ссылки через поиск подстрок http: и https: соответственно. Не забудьте исправить ссылки и на такие файлы, корректный формат для нашего филиала указан выше.

Шаг 5: Пара слов о плашке ACS

Иконки для часто используемых внесистемных классов хранятся на странице component:anomaly-class-bar-source, однако их можно загружать и в свою статью как обычные файлы.