› wiki2xhtml, краткое руководство

Другие языки: en de it

Чего это действительно требует, чтобы создать web-страницу с wiki2xhtml? Это короткий обзор и введение, которое должно показать возможности от wiki2xhtml.


Создать xhtml-файлы

Ты наверно задаешь вопрос: «Почему не HTML?». xhtml[1] в принципе то же самое как HTML с различием, что код должен быть более чистым. Таким образом ты можешь быть немного больше уверены, что браузер, который читает файл также, показывает тому, что ты хочешь.

wiki2xhtml читает текст из любых текстовых файлов. Бинарные файлы[2] (как изображения), которые не содержат текст, не приняты. Чтобы редактировать и написать текстовые файлы, я рекомендую пользователям Windows использовать редактора как Notepad++, PSPad, или Notepad2 (пожалуйста, не используй поставленный редактор при Microsoft, ты не можешь работать с этим). Хорошие независимые от платформы редакторы - например jEdit (Java) и Vim (для болельщиков консоли).

Расширение текстового файла не играет никакую роль. Применение .txt-файлов рекомендуется, таким образом ты немедленно видишь, что это - текстовые файлы. Если ты не имеешь под рукой как раз никакой текст, из которого ты хочешь создавать файл xhtml, ты можешь брать, например, слепой текст[3]. Сохраняй текст теперь в файл (например в index.txt; daraus wird nachher index.html, die im Internet automatisch erscheint, wenn kein spezieller Dateiname angegeben wird) в отдельном каталоге. В этот каталог (например, «page» в программном каталоге) сохраняются все файлы, которые нуждаются позже для страницы. Таким образом все файлы находятся в одном каталоге, и не нужно долго искать.

Программа запускается следующим образом:

В появляющемся теперь диалоговом окне файл (index.txt) может добавляться при «Select/Add files» щелчком на одну из кнопок. Нажимай «Next», потом на «Go!». Теперь файл index.html создается в каталоге «html»

Если это тебе удовлетворяет, ты теперь можешь оканчивать программу щёлкнув «Exit». В противном случае ты можешь возвратиться к предыдущей закладке[5] и изменить параметры настройки (и продолжать краткое руководство) Top

Добавить меню

Как только твоя web-страница составлена из больше чем одной страницы – что случается обычно – нужно меню для навигации. Чтобы не по-новому ввoдить при каждой страницуе и таким образом при изменении должны изменяться все страницы, это сохраняется в отдельном файле. Оно сохраняется по образцу «* заголовок 1, имя файла 1 ↵ * заголовок 2, имя файла 2 ↵ …» (↵ обозначает конец строки). Создавай второй текстовый файл (blindtext.txt) с любым содержанием (и по желанию еще третий или четвертый). Ты должен учитывать, что после преобразования расширение файла .txt должно переименовывать на .html! Таким образом index.txt становится index.html, blindtext.txt становится blindtext.html. Новые файлы теперь должны иметь название "homepage" и "blindtext" в меню. Создай новый текстовый файл для навигационного меню (navigation.txt) и вставь меню:

* Home, index.html * Blindtext, blindtext.html

Выбирай теперь в wiki2xhtml при закладке «Settings» под «Set the index file» файл navigation.txt и нажимай снова «Go!». Сейчас веб-страница обладает меню. Top

Форматирование

Существуют еще несколько команд, которые ты должен был знать. Ты можешь найти краткий обзор по всем возможным командам в документации.

Заголовки должны стоять на отдельной линии. При заголовке второго порядка ты должен ставить 2 знака равенства в начале и в конце строки (для заголовка третьего порядка 3 знака равенства и т. д., до 6): == Борода Ali Baba == Заголовок первого порядка, итак заголовок страницы и соответственно имя страницы, может ставиться где-нибудь в тексте со следующей командой: {{H1:Жизнь Ali Babas}}

Рассылки автоматически определяются, если они с http://, www или ftp:// начинаются. Если ты хочешь именовать рассылку, она может надписываться следующим образом: [http://freepdfxp.de/fpxp.htm Создать файлы PDF] Если цель находится на тот же самом домене (например связывается wiki2xhtml.sourceforge.net/doc.html с wiki2xhtml.sourceforge.net/doc-de.html), можно вводиться вместо этого внутренняя ссылка. (здесь в doc-de.html): [[doc.html английский]] Из этого следует следующая расслыка: английский. Если возникают проблемы с расслыками, смотри на документацию. Если это не помогает, ты можечь прочитать часто задаваемые вопросы в документации или спросить в [http: // lists.sourceforge.net/mailman/listinfo/wiki2xhtml-users списке адресатов].

Жир/курсив: для этих приложений используется апостроф. Если текст окружается с 2 апострофами, он ставится курсивом, с 3 он станет жирным. '''Жир''' и ''курсивно'' одновременно применять являются '''''ужасными!'''''

Top

подстрочное примечание

  1. [↑] Википедия: XHTML
  2. [↑] Бинарные файлы: смотри файл
  3. [↑] Слепой текст используется, чтобы наполнять, например, страницу текстом, чтобы можно смотреть, как результат выглядит.
  4. [↑] командная строка под Windows: command.com
  5. [↑] Wikipedia: закладка (Wikipedia).