добавить статью - создать статью - добавить объявление - создать объявление - добавить страницу - создать страницу - add article - create article - add advert - create ad - add page - edit this page - create page Главная страница InternetBaza.net

Инструменты пользователя

Инструменты сайта


d.wiki:b.syntax
+18

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

Для создания новых страниц и внесения дополнений и изменений в уже существующие применяется синтаксис форматирования

Синтаксис форматирования

Поддерживается простой язык вики-разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи, нажав кнопку «Править» или иконку «Править страницу» с правой стороны. Если хотите поупражняться, используйте "песочницу" - специальную тестовую страницу. Простую разметку легко сделать с помощью панели инструментов.

Основные конструкции форматирования

Выделение текста жирным шрифтом, курсивом, подчёркнутый текст и вывод текста моноширинным шрифтом. Все эти конструкции можно объединить.

Выделение текста **жирным шрифтом**, //курсивом//, 
__подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''. 
Все эти конструкции можно **__//''объединить''//__**. 

Также можно использовать подстрочный и надстрочный индексы.

Также можно использовать <sub>подстрочный</sub> и 
<sup>надстрочный</sup> индексы.

Ещё можно зачеркнуть текст.

Ещё можно <del>зачеркнуть текст</del>.

Абзацы отбиваются пустой строкой. Если нужно принудительно вставить перенос строки, не создавая абзац, вставьте два обратных слэша и за ним пробел или переход к новой строке.

Просто текст с разрывом строк
Обратите внимание, что два обратных слэша действуют только в конце строки
или если за ними стоит
пробел. Если его не поставить, \\получится вот так.

Просто текст с разрывом строк\\ Обратите внимание,
что два обратных слэша действуют только в конце строки\\
или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.

Принудительные переносы следует использовать только в случае крайней необходимости.

Ссылки

Ссылки могут быть внешними и внутренними. Создаются они по-разному, в зависимости от информационных материалов, на которые ссылаются, и их месторасположения.

Внешние

Внешние ссылки распознаются автоматически: http://www.bestbaza.ru или просто www.bestbaza.ru — также можно указывать текст ссылки: Это ссылка на Best Baza. Адреса электронной почты тоже распознаются: andi@splitbrain.org .

Внешние ссылки распознаются автоматически: http://www.bestbaza.ru 
или просто www.bestbaza.ru --- также можно указывать 
текст ссылки: [[http://www.bestbaza.ru|Это ссылка на Best Baza]]. 
Адреса электронной почты тоже распознаются: <andi@splitbrain.org> .

Внутренние

Внутренние ссылки создаются посредством квадратных скобок. Можно либо просто указать имя страницы, либо дополнительно прописать текст ссылки. Имена статей автоматически переводятся в нижний регистр, спецсимволы (любые знаки, кроме букв и цифр) использовать нельзя.

Внутренние ссылки создаются посредством квадратных скобок. 
Можно либо просто указать [[wiki:start|имя страницы]], 
либо дополнительно прописать [[wiki:start|текст ссылки]]. 
Имена статей автоматически  переводятся в нижний регистр, 
спецсимволы (любые знаки, кроме букв и цифр) использовать нельзя.

Можно использовать в ссылке пространства имён через двоеточие.

Можно использовать в ссылке [[wiki:start|пространства имён]] 
через двоеточие.

Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так же, как это делается в HTML. Ссылка на этот раздел.

Ссылка на [[#внутренние|этот раздел]].

Примечания:

  • Ссылки на существующие статьи отображаются иначе, чем ссылки на несуществующие.
  • Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.
  • Ссылки на разделы делаются именно на разделы.

Интервики

Это короткие ссылки на другие вики-сайты. Вот, например, ссылка на статью Википедии о вики: Wiki.

Это короткие ссылки на другие вики-сайты. Вот, например, 
ссылка на статью Википедии о вики: [[wp>Wiki]].

Изображения-ссылки

Совместив синтаксис ссылки и изображения, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:

[[http://www.dokuwiki.org|{{wiki:dokuwiki-128.png}}]]

Учтите: форматирование картинок — это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки. Поддерживается весь синтаксис картинок и ссылок, включая изменение размеров изображений, URL-адресов внутренних и внешних изображений и ссылок интервики.

Сноски

С помощью двойных скобок можно добавить сноску1).

С помощью двойных скобок можно добавить сноску((Сноска —
помещаемые внизу страницы примечание, ссылка, перевод.)).

Разбивка на разделы

Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку ~~NOTOC~~.

Заголовок 3 уровня

Заголовок 4 уровня

Заголовок 5 уровня
==== Заголовок 3 уровня ====
=== Заголовок 4 уровня ===
== Заголовок 5 уровня ==

Четыре и более тире преобразуются в горизонтальную черту:


Изображения и другие медиафайлы

В целях защиты сайта от стороннего вмешательства со стороны злоумышленников, закачка файлов на сервер для пользователей ограничена. Такое право имеют только модераторы и администратор. Файлы, уже размещенные непосредственно в директориях сайта, называются внутренними, и могут использоватья любым зарегистрированным пользователем. Кроме того, в тексте публикации можно ссылаться и на внешние файлы изображений – тех, которые размещены на других интернет-ресурсах.

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

В текст изображения вставляются с помощью фигурных скобок. При желании можно указывать размер картинки:

Нормальный размер:

Отмасштабированная до заданной ширины:

Отмасштабированная до заданных ширины и высоты:

Отмасштабированная по ширине внешняя картинка: sm-16510015756.jpg

Нормальный размер:                        {{wiki:dokuwiki-128.png}}
Отмасштабированная до заданной ширины:   {{wiki:dokuwiki-128.png?50}}
Отмасштабированная до заданных ширины и высоты: {{wiki:dokuwiki-128.png?200x50}}
Отмасштабированная по ширине 
внешняя картинка: {{http://www.catalog.internetbaza.net/1/foto/sm-16510015756.jpg?200}}

Как видно из примера, при масштабировании изображений целесообразно указывать только ширину, чтобы картинка сохраняла пропорциональность – не обрезалась, не растягивалась и не сжималась.

Поставив слева или справа пробел, можно также задать выравнивание картинки на странице:

  {{ wiki:dokuwiki-128.png}} - по правой стороне
  {{wiki:dokuwiki-128.png }} - по левой
  {{ wiki:dokuwiki-128.png }} — посередине

И, конечно же, картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки):

Это логотип

{{ wiki:dokuwiki-128.png |Это логотип}}

Узнать, как вставить картинку со ссылкой можно в разделе выше.

Поддерживаемые медиа-форматы

В контент сайта можно внедрить напрямую следующие форматы медиа-файлов:

Изображения gif, jpg, png
Видео webm, ogv, mp4
Аудио ogg, mp3, wav
Флэш swf

Если указать в имени файла другой формат, который не поддерживается, то он будет отображаться в виде ссылки.

Если добавить к ссылке на медиа-файл ?linkonly , то вместо содержимого файла отобразится ссылка на него:

{{wiki:dokuwiki-128.png?linkonly}}

dokuwiki-128.png Это просто ссылка на изображение.

Списки

Списки могут быть нумерованными и маркированными. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом звёздочку (*) в случае маркированного списка, или два пробела и дефис (-) — в случае нумерованного:

  • Первый элемент маркированного списка
  • Второй элемент списка
    • Можно сделать вложенный список, если добавить еще пробелы
    • Второй элемент вложенного списка
  • Ещё один элемент
  1. Тот же список, только нумерованный
    1. Ещё элемент – вложенный
      1. Чем больше пробелов в начале, тем глубже вложенность
    2. Всё просто
  2. Очень просто
  * Первый элемент маркированного списка
  * Второй элемент списка
    * Можно сделать вложенный список, если добавить еще пробелы
    * Второй элемент вложенного списка
  * Ещё один элемент

  - Тот же список, только нумерованный
    - Ещё элемент -- вложенный
      - Чем больше пробелов в начале, тем глубже вложенность
    - Всё просто
  - Очень просто

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

Некоторые заранее определенные символы или строки могут преобразовываться в изображения или в другой текст, или в HTML.

Конвертация текста в изображения в основном делаются для смайликов. Преобразование текста в HTML используется для замены типографики, но может быть настроено и на использование другого HTML.

Конвертация текста в изображения

Наиболее употребляемые смайлики преобразуются в их графические эквиваленты. Коллекции смайликов и других изображений при необходимости могут быть настроены и расширены. Вот обзор смайликов, доступных в настоящее время:

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME
  • DELETEME DELETEME

Типографские символы

Символы, набранные простым текстом, могут конвертироваться в их типографски корректные эквиваленты. Распознаются следующие символы:

→ ← ↔ ⇒ ⇐ ⇔ » « – — '640×480' © ™ ® …
«Александр Сергеевич™ — это наше всё © не я»

-> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ...
"Александр Сергеевич(tm) --- это наше всё (c) не я"

Вместо кавычек

Иногда в тексте приходится передавать содержание диалога или комментариев и ответов на них. Обычно для таких текстов используются кавычки, либо другие, не менее сложные для набора на клавиатуре синтаксические конструкции. Чтобы упростить задачу, можно использовать такой синтаксис:

Я думаю, что мы должны это сделать

> Нет, мы не должны

>> Ну, я говорю, что мы должны

> На самом деле?

>> Да!

>>> Тогда давайте сделаем это!

Я думаю, что мы должны это сделать

Нет, мы не должны
Ну, я говорю, что мы должны
На самом деле?
Да!
Тогда давайте сделаем это!

Таблицы

Поддерживается простейший синтаксис формирования таблиц.

Заголовок 1 Заголовок 2 Заголовок 3
Ряд 1 Колонка 1 Ряд 1 Колонка 2 Ряд 1 Колонка 3
Ряд 2 Колонка 1 Объединение ячеек (обратите внимание на двойную вертикальную черту)
Ряд 3 Колонка 1 Ряд 3 Колонка 2 Ряд 3 Колонка 3

Нормальные ряды должны начинаться и заканчиваться вертикальной чертой - |, а заголовки – «крышечкой» - ^:

^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^
| Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        |
| Ряд 2 Колонка 1  | Объединение ячеек (обратите внимание на двойную вертикальную черту) ||
| Ряд 3 Колонка 1  | Ряд 3 Колонка 2     | Ряд 3 Колонка 3        |

Чтобы объединить две соседние ячейки в ряду, просто оставьте соседнюю ячейку полностью пустой, как показано выше. Следите, чтобы количество разделителей клеток было одинаковым!

Вертикальные заголовки тоже можно сделать:

Заголовок 1 Заголовок 2
Заголовок 3 Ряд 1 Колонка 2 Ряд 1 Колонка 3
Заголовок 4 Объединения нет
Заголовок 5 Ряд 3 Колонка 2 Ряд 3 Колонка 3
|              ^ Заголовок 1       ^ Заголовок 2      ^
^ Заголовок 3  | Ряд 1 Колонка 2   | Ряд 1 Колонка 3  |
^ Заголовок 4  | Объединения нет   |                  |
^ Заголовок 5  | Ряд 3 Колонка 2   | Ряд 3 Колонка 3  |

Как легко увидеть, разделитель, стоящий перед ячейкой, определяет форматирование, препятствуя объединению, даже если оставить ячейку пустой.

Можно сделать вертикально объединённые ячейки добавлением трёх двоеточий ::: в объединяемые нижележащие ячейки:

Заголовок 1 Заголовок 2 Заголовок 3
Ряд 1 Колонка 1 эта ячейка объединена вертикально Ряд 1 Колонка 3
Ряд 2 Колонка 1 Ряд 2 Колонка 3
Ряд 3 Колонка 1 Ряд 3 Колонка 3

В этих ячейках не должно быть ничего, кроме синтаксиса объединения (:::).

^ Заголовок 1     ^ Заголовок 2                       ^ Заголовок 3     ^
| Ряд 1 Колонка 1 | эта ячейка объединена вертикально | Ряд 1 Колонка 3 |
| Ряд 2 Колонка 1 | :::                               | Ряд 2 Колонка 3 |
| Ряд 3 Колонка 1 | :::                               | Ряд 3 Колонка 3 |

Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа — если надо выравнять влево, и по два с каждой стороны — если по центру:

Таблица с выравниванием
вправо по центру влево
влево вправо по центру
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx
^           Таблица с выравниванием        ^^^
|        вправо|   по центру  |влево         |
|влево         |        вправо|   по центру  |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Примечание: вертикальное выравнивание не поддерживается.

Неформатируемые блоки

Если вам нужно отобразить часть текста такой же, как она набрана (без форматирования), ограничьте эту область тегами <nowiki> или еще проще – двойными знаками процента %%.

Это текст, который содержит URL-адрес: http://www.splitbrain.org и **форматирование**, но с ним ничего не происходит - он остается в неизменном виде, не форматируется. То же самое верно и для //__это__ текст// со смайликом ;-).

<nowiki>
Это текст, который содержит URL-адрес: http://www.splitbrain.org и **форматирование**, 
но с ним ничего не происходит - он остается в неизменном виде, не форматируется.
</nowiki>
То же самое верно и для %%//__это__ текст// со смайликом ;-)%%.

Кроме того, неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах), либо используя тэги <code> или <file>.

Эта строка начинается двумя пробелами.
Это неформатированный текст, в котором сохранены 
все пробелы: вот             <- так.
В принципе то же самое, но этим выделением 
можно показать, что цитируется содержимое файла.

Чтобы увидеть, как используются эти блоки, смотрите код статьи.

Подсветка синтаксиса

Программный код может подсвечиваться, чтобы его было проще читать. Для этого используется библиотека GeSHi – Generic Syntax Highlighter – соответственно, подсвечиваются все языки, поддерживаемые GeSHi. Синтаксис такой же, как и в предыдущем разделе, но на этот раз внутри тэга добавляется название языка. Например <code java> или <file java>.

/**
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}

На данный момент распознаются следующие языки: 4cs;, abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, ecmascript, eiffel, email, erlang, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, plsql, postgresql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, z80.

Скачиваемые блоки кода

Используя тэги <code> или <file>, как показано выше, вы можете сделать отображаемый код доступным для загрузки. Для этого определите имя файла после кода языка вот так:

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>
myexample.php
<?php echo "hello world!"; ?>

Если вам не нужна подсветка, но нужен загружаемый файл, поставьте прочерк (-) на месте кода языка: <code - myfile.foo>.

Особенность: при написании имени файла на русском языке для формирования корректного имени файла обрамляйте название файла двойными кавычками например «Фоо Бар.php».

"Фоо Бар.php"
<?php echo "hello world!"; ?>

Вставка HTML и PHP

Чистый HTML- или PHP-код можно вставлять в документ с помощью тэгов html 2) и php:

<html>
Тут вставлен <font color="red" size="+1">HTML-код</font>
</html>

Тут вставлен <font color="red" size="+1">HTML-код</font>

<php>
echo 'Логотип, сгенерированный PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Логотип PHP!" />';
</php>

echo 'Логотип, сгенерированный PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Логотип PHP!" />';

Примечание: по умолчанию вставка HTML и PHP запрещена. Когда она запрещена, код не исполняется, а выводится в исходном виде.

Синтаксические плагины

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

1) Сноска — помещаемые внизу страницы примечание, ссылка, перевод.
2) html — для строчного кода; HTML — для блочного кода
d.wiki/b.syntax.txt · Последние изменения: 2017/11/01 16:22 (внешнее изменение)

@Mail.ru Сюжеты истории будущего 2016 InternetBaza.net