Редактирование и создание страниц в WEB-энциклопедии просто и не должно вызывать никаких трудностей. Для этого используйте WikiMarkup-язык, стандартный XHTML или используйте встроенный тулбар редактора страниц. В любом случае, Вы сможете отформатировать текст, вставить ссылки, изображения, примеры вёрстки, примеры программного кода и многое другое быстро и просто.
Редактировать1 - WikiMarkup-язык
WikiMarkup-язык — набор приставок и суффиксов, позволяющий форматировать текст любой сложности.
Редактировать1.1 Основное форматирование текста
- Пишем
'''bold''' получаем bold - Пишем
''italic'' получаем italic - Пишем
__underlined__ получаем underlined - Пишем
--striked-- получаем striked - При использовнии любых комбинаций, например, пишем
--striked '' '''bold''' and italic''-- получаем striked bold and italic
Редактировать1.2 - Ссылки
Обозначения ссылок начинаются с [ и заканчиваются ].
Примечание: ссылки также опознаются и при использовании двойных квадратных скобок, например, [[Ссылка]].
- Для создания ссылки на страницу энциклопедии, следует написать
[PageName], получится PageName (из-за того, что страница не существует, цвет ссылки отличается от стандартного) - Можно также создавать название ссылки:
[PageName|Это ссылка] получится Это ссылка - Ссылки на Email адрес распознаются автоматически, например:
[mail@server.com] получится mail@server.com.
К Email адресу тоже можно добавить название: [mail@server.com|Контактный адрес], выйдет так: Контактный адрес
- Ко внешним ссылкам добавляется специальная иконка :
[http://www.buildersite.info], выглядит так: http://www.buildersite.info - Есть возможность сослаться на внутренний файл, или папку, например:
[blog/|Blog] выйдет так: Blog и [GPL.txt|GPL], отобразится так: GPL
Редактировать1.2.1 - Примечания
Ссылки и Изображения используют одинаковый синтаксис языка разметки, с некоторыми изменениями (см. ниже).
Редактировать1.2.2 - Вложения на (к) странице
При желании «прикрепить» к странице вложение (будет отображаться внизу страницы), используйте такой синтаксис:
[attachment:Attach.arj]
Редактировать1.2.3 - Категории (как множественные тги)
При желании «назначить» странице категории (из тех, что используются в Базе Знаний), используйте такой синтаксис:
[c:CategoryName]
Если есть необходимость указать, что страница не относится ни к какой из существующих категорий, используйте такое:
[c:-|uncategorized Pages]
Редактировать1.3 - Заголовки
Вы можете создавать заголовки, используя последовательность одинаковых (=) символов, например:
==Очень Большой Заголовок (H1)=====Большой Заголовок (H2)=======Небольшой Заголовок (H3)=========Ещё меньший Заголовок (H4)=====- Первые три вида заголовков используются как разделители страницы, последний вид — просто малый заголовок без разделителя (используется редко)
- H1 обычно не используется, так как используется (по умолчанию) для названия страниц
Примечание: заголовки должны быть размещены в начале предложения (такое правило).
Редактировать1.3.1 - Горизонтальная линия
Для размещения горизонтальной линии (разделителя страницы), используйте четыре дефиса: ----.
Редактировать1.4 - Изображения
Для вставки в текст изображений используют [ и ] как разделители.
Примечание: изображения также распознаются и при использовании двойных квадратных скобок, например, [[image|Title|Url]].
Несколько вариантов распознавания изображений в тексте:
[image|Title|Url|Big Url/Link Url (не обязательно)] вставляем изображение без границ и подложки[imageleft|Title|Url|Big Url/Link Url (не обязательно)] и [imageright|Title|Url|Big Url (не обязательно)] вставляем в текст изображение, выравнивая по левому или правому краю, показывая границы и подложку[imageauto|Title|Url|Big Url/Link Url (не обязательно)] вставляем в текст изображение, выравнивая автоматически, показывая границы и подложку- Всё, что находится в Big Url/Link Url является дополнительными параметрами, связывающими изображение с полноразмерной (его) версией, или любыми другими ресурсами
Редактировать1.4.1 - Примечание
Ссылки и Изображения используют одинаковый синтаксис языка разметки, с некоторыми изменениями (см. выше).
Редактировать1.5 - Списки
Для создания списков используйте символы разметки (*) и/или (#). Для создания вложенных списков, больше одного (*) и/или (#).
* Element 1
* Element 2выходит
|
# Element 1
# Element 2выходит- Element 1
- Element 2
|
# Element 1
# Element 2
#* Element 2.1
#* Element 2.2
# Element 3выходит- Element 1
- Element 2
- Element 3
|
# Element 1
# Element 2
#* Element 2.1
#*# Element 2.1.1
#*#* Element 2.1.1.1
# Element 3выходит- Element 1
- Element 2
- Element 3
|
Редактировать1.6 - Отображение стороннего Кода и NoWiki тэгов
Если будет необходимо вставить образец кода, используйте {{ и }}, например {{This is code}} получится так: This is code.
Если потребуется показать блок исполняемого кода, например для отображения C# class-а, вставьте его в {{{{ и }}}}, выйдет так:
using System;
namespace MyNamespace {
public class HelloWorld {
public static void Main(string[] args) {
Console.WriteLine("Hello World");
}
}
}
Если будет необходимо вставить блок текста с отображением разметки WikiMarkup, используйте тэги <nowiki> и </nowiki>, например: <nowiki>[MyPage]</nowiki> получится: [MyPage].
Редактировать1.6.1 - @@ тэг
Если Вы хотите указать фрагмент кода (например XML, или даже язык этой wiki), причём, Вам необходимо показать его "как есть", используйте двойной @ (на отдельных строках, до, и после окончания кода):
<xml>
'''Bold'''
<any a="n" />
</xml>
Редактировать1.6.2 - поддержка подсветки отображения кода
У Вас есть возможность указать любой фрагмент кода (из ASPX, C, C++, C#, COBOL, Eiffel, Fortran, Haskell, HTML, Java, JavaScript, Mercury, MSIL, Pascal, Perl, PHP, Python, Ruby, SQL, Visual Basic, VBScript, VB.NET, XML), синтаксис (для C#):
<code c#>public static void TestMethod() { return; }</code>, будет отображено следующим обарзом:
public static void TestMethod() { return; }
Включать любой фрагмент в раздел <code language> и </code>, вместо language — подставляя название языка программирования (например, ниже — code sql).
IF NOT EXISTS
( SELECT * FROM information_schema.columns
WHERE table_name = 'Customer'
AND column_name = 'FavoriteColorId'
)
BEGIN
ALTER TABLE Customer
ADD FavoriteColorId int
END
Редактировать1.7 - Разрыв строки
Два перевода строки используются и обрабатываются wiki, как двойной перевод каретки. Одиночный перевод строки — игнорируется. Если необходимо вставить одиночный перевод строки, используйте стандартный XHTML тэг <br /> или WikiMarkup параметр {BR} (без учёта регистра). Не рекомендуется злоупотреблять одиночными переводами строки, во избежание создания беспорядка на страницах.
Редактировать1.8 - Специальные тэги
В нашей Wiki используется несколько специальных маркеров, которые интерпретируются движком автоматически. Это:
- {wikititle} отображает EDGEPEDIA (название всей Wiki)
- {up} отображает GetFile.aspx?File= (путь папки загрузки файлов)
- {top} отображает Вверх (ссылка в начало текущей страницы)
- {toc} отображает оглавление конкретной страницы, использует Hx (номер заголовка) заголовка (каждого)
- {rating} подключает (в месте вставки) модуль голосования пользователей за созданную страницу
- {mainurl} отображает http://www.edgepedia.net/ (Главный URL всей Wiki)
- {clear} вставляется после кода вставки изображений, если следом идёт текст (как перевод каретки)
- ~~~~ отображает admin, 03/11/2007 13:23 подпись Автора и время создания страницы (редакции изменений)
Редактировать1.9 - Боксы
Если возникнет необходимость вставить какую-то часть контента в отдельный бокс, используйте тройные скобки: ((( и ))). Например, (((Мой бокс))) отобразится в Мой бокс
Редактировать1.10 - Отступы в тексте
Можно организовать отступы используя одно, или более двоеточий, в начале строк.
: Одиночный отступ
:: Двойной отступ
в результате выйдет:
Одиночный отступ
Двойной отступ
Редактировать1.11 - Таблицы
Язык разметки WikiMarkup полностью поддерживает отображение таблиц. Рассмотрим создание и отображение страниц в разделе Tables.
Редактировать1.12 - XHTML поддержка и отображение стронних тэгов
Наша Wiki поддерживает стандартные правила XHTML. Для вставки скриптов используйте <script> хотя, администратор, наверняка, отключил такую возможность (увы).
Для отображения XHTML комментариев используйте: <!–– ––>.
Для вставки блока HTML или XML разметки и , используйте <esc></esc> тэг. Такое использование делает видимыми все, сторонние тэги, например.
<esc><strong>Сторонний тэг</strong></esc>
отобразит конструкцию
<strong>Сторонний тэг</strong>
Редактировать2 - Вставка одной страницы wiki, в другую
Если Вы хотите процитировать текст (вид) одной страницы этой wiki, в другой странице, используйте конструкцию (пример: вставка MainPage):
{t:MainPage}
Выглядеть будет так: