Преобразование текста в формат вики

Материал из СисадминВики (SysadminWiki.ru)
Перейти к: навигация, поиск

Небольшие фрагменты текста с малым форматированием легче сразу скопировать в окно редактора на вики сайте и отформатировать вручную. Со временем, когда символы и теги форматирования вики не будут резать глаза, этот способ окажется самым лёгким. Справка по редактированию этого сайта даст полезные советы и ссылки на эту тему.

Подготовка материала

Для больших текстов удобней сначала обработать документ специальными конвертерами. Рекомендую использовать конвертер для OpenOffice, т.к. получаемый им текст содержит более чистую разметку (меньше управляющих тегов).

  • LibreOffice (OpenOffice) версии 5 и более уже включает утилиту экспорта.
  • Для LibreOffice (OpenOffice) версии 6 есть также альтернативная утилита writer2wiki позволяющая сопоставить стилям LibreOffice шаблоны MediaWiki. Утилита вызывается через меню Сервис - Дополнения - Экспортировать в Wiki-текст.
  1. Скачать LibreOffice или OpenOffice (бесплатно) и установить как обычное приложение.
  2. Скачать расширение с официального сайта (см. выше)
  3. Открыть его в OpenOffice: Файл - Открыть.
  4. После этого добавиться в окне экспорта (Файл - Экспорт) опция MediaWiki

Алгоритм переноса текста

Теперь, чтобы воспользоваться конвертером

  1. выделяем нужную часть (главу)
  2. копируем в новый (пустой) документ: Файл - Создать - Текстовый документ
  3. экспортируем новый файл в текстовый файл вики формата
  4. открываем текстовый файл в текстовом редакторе по умолчанию (дважды щёлкаем мышью по файлу)
  5. делаем (если необходимо) ручную доработку текста
  6. копируем текст в окно редактирования вики сайта


Обработка после конвертера

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

Несмотря на то, что конвертер OpenOffice выдаёт довольно чистый текст с хорошим форматированием, тем не менее выдаваемый им текст стоит просмотреть на наличие:

  • Избыточного форматирования таблицы. Конвертер описывает вид каждой ячейки, что сильно загромождает текст. В большинстве случаев достаточно указать '''{| class="wikitable sortable"''' и убрать всё остальное форматирование
  • Лишних тэгов <nowiki></nowiki>, которые, например, ставятся, если в тексте встречаются квадратные скобки "[]"
  • Лишних тэгов <sup></sup>, которые добавляются к сноскам (тэг <ref>)

Удалять лишнее форматирование проще всего в каком-нибудь простом текстовом редакторе с помощью команды Замена, указав в качестве замены пустое поле. После изменений можно скопировать новый текст обратно в окно редактирования вики и сделать предварительный просмотр.

Организация материала

  • Вики статьи лучше не делать большими, чтобы не вызвать конфликты при одновременной правке несколькими людьми. Текст лучше разбивать на логические блоки (фрагменты), например, главы, части, разделы. Лучше всего это делать на основе содержания.
  • Название статей должно отражать не только название главы, но и название книги, а лучше и автора. Это позволит обеспечить уникальность статьи, хоть и будет выглядеть громоздко. Например, название статьи строить так:
Имя Автора - Название Книги - Название Раздела - Название или Номер Главы
  • Чтобы после разбиения получить целостный текст, каждый фрагмент стоит поместить в категорию, название которой отражает название документа (книги) и положение фрагмента в содержании, по аналогии с названием статьи. Не стоит называть категории "Глава 1" или "Часть Первая", так как в другой книге (документе) вполне возможно также будет первая глава и оба фрагмента попадут в одну и ту же категорию. Например, для вышеуказанной статьи логично создать категорию:
[[Категория:Имя Автора - Название Книги - Название Раздела]]

В эту категорию нужно будет поместить все статьи из раздела Название Раздела. В свою очеред сам раздел Название Раздела поместить в категорию:

[[Категория:Имя Автора - Название Книги]]