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

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

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

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

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

  1. Скачать сам OpenOffice http://ru.openoffice.org/ (бесплатно) и установить как обычное приложение.
  2. Скачать расширение с официального сайта (см. выше) или копию с этого сайта
  3. Открыть его в OpenOffice: Файл - Открыть.
  4. После этого добавиться в окне экспорта (Файл - Экспорт) опция MediaWiki

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

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


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

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

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

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

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

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

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

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

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