Команда include

## Назначение и синтаксис команды (:include:)

Команда (:include:) предназначена для вставки в вики-страницу содержимого прикрепленных файлов. Общий синтаксис команды выглядит следующим образом:
(:include Attach:filename [params...]:)
Здесь filename - это имя прикрепленного файла, а параметры команды рассмотрены в следующем разделе

## Параметры команды (:include:)

Команда (:include:) может принимать следующие параметры:

- encoding
- htmlescape
- wikiparse

### encoding

Параметр encoding указывает кодировку вставляемого текста. OutWiker не может самостоятельно определить кодировку файла, по умолчанию считается, что используется кодировка UTF-8.
Если нужно вставить файл text_utf8.txt в кодировке UTF-8, то достаточно написать
(:include Attach:text_utf8.txt:)
В результате мы получим:
Текст в
кодировке UTF-8
Для того же файла кодировку можно указать в явном виде:
(:include Attach:text_utf8.txt encoding=utf8 :)
Для вставки файла text_1251.txt в кодировке cp1251 команда будет выглядеть следующим образом:
(:include Attach:text_1251.txt encoding=cp1251:)
В результате ее выполнения мы увидим:
Это текст
в кодировке 1251
Если мы забудем указать нужную кодировку, то получим ошибку. Например, команда
(:include Attach:text_1251.txt:)
Выдаст следующий текст:
Encoding error in file text_1251.txt
Полный список поддерживаемый кодировок довольно обширный, его можно найти на этой странице справки по языку Python, перечислим наиболее используемые кодировки (одна и та же кодировка может иметь несколько названий):

- utf8, utf-8, utf_8, U8, UTF;
- cp1251, windows-1251;
- koi8_r;
- koi8_u;
- utf_32, utf-32, utf32;
- utf_16, utf-16, utf16;
- mac_cyrillic, maccyrillic;
- cp866, 866, IBM866;

### htmlescape

Параметр htmlescape указывает команде, что в прочитанном тексте из файла необходимо заменить символы <, > и & соответственно на &lt;, &gt; и &amp;. Это особенно полезно для вставки исходных текстов программы из прикрепленных файлов.
Например, команда
(:include Attach:html.txt:)
Выведет текст полужирным шрифтом:
Это текст с HTML-тегами
А при добавлении параметра htmlescape:
(:include Attach:html.txt htmlescape:)
будет выведен код HTML:
<B>Это текст с HTML-тегами</B>

### wikiparse

Параметр wikiparse указывает команде, что содержимое вставляемого файла предварительно необходимо пропустить через вики-парсер, то есть, что прикрепленный файл содержит вики-нотацию, которую необходимо разобрать.
Например, команда
(:include Attach:wiki.txt:)
выведет следующий текст:
'''Этот текст содержит вики-нотацию'''
А с параметром wikiparse:
(:include Attach:wiki.txt wikiparse :)
содержимое вики-нотации будет преобразовано в HTML:
Этот текст содержит вики-нотацию

Если в команде (:include:) установлены одновременно параметры htmlescape и wikiparse, то сначала происходит замена символов HTML, а потом разбор вики-нотации.
Для вставки исходного текста программ можно использовать следующий формат команды (:include:):

    <PRE>
    (:include Attach:filename htmlescape:)
    </PRE>