Справка:Вики-разметка

Материал из энциклопедии "Вики-Поляны"
Перейти к: навигация, поиск
Справочное руководство
Правила сайта
Регистрация
Страница участника
Личные данные
Авторские права
Первоисточники
Защита страниц
Загрузка файлов
Справочник по
редактированию статей
Создание статьи
Именование статьи
Викификация
Вики-разметка
Изображения
Таблицы
Цвета HTML
Библиографический список

Ниже приведена справочная таблица по редактированию текстов в вики-среде. Прежде чем применять эти «инструменты» на «живом теле» Вики-Полян, можно выбрать следующие возможности для экспериментирования:

  • использовать «песочницу» на каком-нибудь вики-ресурсе;
  • использовать свою личную страницу «Участник:Имя» или подстраницу «Участник:Имя/черновик»;
  • или использовать режим «Предварительный просмотр».

Изменения фиксируются только в случае, если вы нажали на кнопку «Записать страницу», расположенную под окном редактирования.

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

Используйте страницу «История», относящуюся к вашей статье. С помощью нее вы можете проследить изменения, произошедшие с редактируемым текстом (на страницу истории можно попасть, нажав на закладку История, расположенную вверху окна с вашей статьёй).

За изменениями, происходящими с вашей статьёй, можно следить также, если внести статью в свой Список наблюдения.

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

Разделы, абзацы, списки и строки

Как это выглядит Что нужно набрать HTML-аналог

Начните раздел со строки заголовка:

Новый раздел


Подраздел

Под-подраздел

Начните раздел со строки заголовка:

== Новый раздел ==

=== Подраздел ===

==== Под-подраздел ====
h1—h6

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

Но пустая строка начинает новый абзац.

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

Но пустая строка
начинает новый абзац.
p
С помощью тега «br» можно разрывать строки,
не начиная новый абзац.
С помощью тега «br» можно разрывать строки,<br />
не начиная новый абзац.
br

Сделать список очень просто:

  • каждая строка начинается со звёздочки;
    • чем больше звёздочек — тем глубже уровень;
      отступ внутри можно делать и с помощью двоеточия.
Сделать список очень просто:
* каждая строка начинается со звёздочки;
** чем больше звёздочек — тем глубже уровень;
**: отступ внутри можно делать и с помощью двоеточия.
ul, li
  1. Нумерованные списки тоже хороши:
    1. очень организованные;
    2. легко читаются.
# Нумерованные списки тоже хороши:
## очень организованные;
## легко читаются.
ol, li
  • Можно также делать смешанные списки:
    1. и вкладывать их
      • как, например,
    2. здесь.
* Можно также делать смешанные списки:
*# и вкладывать их
*#* как, например,
*# здесь.
ul, ol, li
Tочка с запятой в начале строки
и затем двоеточие
создают
двухуровневый список.
;Tочка с запятой в начале строки: и затем двоеточие
;создают: двухуровневый список.
dl, dt, dd
Двоеточие в начале строки делает отступ абзаца.

Простой перенос строки при этом начинает новый абзац.

Примечание: это применяется в основном на страницах обсуждения.

:Двоеточие в начале строки делает отступ абзаца.
Простой перенос строки при этом начинает новый абзац.
ЕСЛИ строка начинается с пробела, ТОГДА
  она будет отформатирована так же,  
    как и набрана;
  шрифтом фиксированной ширины;
  без переноса строк;
   [[без ссылок]];
КОНЕЦЕСЛИ
Это можно применять для:
  * вставки преформатированного текста;
  * описания алгоритмов;
  * исходного кода программ
  * ascii art (создание изображений при помощи 
    текстовых символов).

ВНИМАНИЕ! Если вы сделаете такую строку длинной, у неё появится полоса прокрутки. Никогда не начинайте обычные строки с пробела.

 ЕСЛИ строка начинается с пробела, ТОГДА
   она будет отформатирована так же, 
     как и набрана;
   шрифтом фиксированной ширины;
   без переноса строк;
    [[без ссылок]];
 КОНЕЦЕСЛИ
Это можно применять для:
  * вставки преформатированного текста;
  * описания алгоритмов;
  * исходного кода программ
  * ascii art (создание изображений
    при помощи текстовых символов);
pre
Центрированный текст.
<center>Центрированный текст.</center>
center
Горизонтальная разделительная линия:

четыре дефиса подряд

Горизонтальная разделительная линия: 
----
четыре дефиса подряд
hr

Этот абзац отцентрирован.

Этот абзац выровнен по левому краю.

Этот абзац выровнен по правому краю.

Вы можете управлять выравниванием текста абзаца, используя теги <p> с указанием в атрибуте style параметра text-align, со значением

  • center для выравнивания по центру,
  • left для выравнивания по левому краю,
  • right для выравнивания по правому краю.

По умолчанию принято выравнивание по левому краю.

Например, для выравнивания по правому краю используйте такую конструкцию:

<p style="text-align:right;">Текст</p>
p

Ссылки, URL

Как это выглядит Что надо набрать

Город Вятские Поляны.

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

Таким образом, приведённая выше ссылка ведёт на http://kraeved.vp43.ru/index.php?title=Вятские_Поляны, которая является статьёй с названием «Вятские Поляны».

Если падеж ссылающегося слова или словосочетания не совпадает с именительным, то следует в двойных квадратных скобках ставить вертикальную черту и слева от неё писать именительный падеж, а справа — соответствующий грамматике предложения, в которое вставлена ссылка. Так же можно поступать, если название ссылки не совпадает с именем статьи: [[Название целевой статьи|видимый текст ссылки]].

Пример: В данной энциклопедии размещаются статьи, связанные с Вятскими Полянами.

Город [[Вятские Поляны]].

В данной энциклопедии размещаются статьи, связанные с [[Вятские Поляны|Вятскими Полянами]].
Можно ссылаться на подраздел в самой статье, указав его после «решётки»: [[]].

Сервер переводит #Якорь из кириллического набора символов в латинский при сохранении страницы.

Можно ссылаться на подраздел в самой статье,
 указав его после «решётки»:
[[]].

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

Если вы хотите просто создать ссылку на категорию,
не добавляя в неё текущую страницу,
используйте ссылки следующего вида:
[[:Категория:Персоналии по алфавиту]].
При добавлении комментариев к странице обсуждения следует их подписать. Это можно сделать, добавив три тильды для получения имени пользователя:
Moderator

или четыре для получения имени пользователя плюс дата/время:

Moderator 08:10 Oct 5, 2014 (UTC)
При добавлении комментариев к странице обсуждения,
следует их подписать. Это можно сделать, добавив
три тильды для получения имени пользователя:
: ~~~
или четыре для получения имени пользователя плюс
дата/время:
: ~~~~
Именно вариант с датой и временем является предпочтительным.
Эта страница не существует — это страница, которая ещё не создана.

Вы можете создать её, кликнув по ссылке. Подробнее см. руководство Справка:Создание статьи.

[[Эта страница не существует]] — это 
страница, которая ещё не создана.
Указать e-mail можно так:

name@example.com

  • Этот адрес приведён для примера, не используйте его.
Указать e-mail можно так:
[mailto:name@example.com name@example.com]

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

Как это выглядит Что следует набрать

Полужирное и курсивное начертания используются в следующих случаях:

логическое ударение
структурное выделение
логическое ударение в структурном выделении (или наоборот)

Это двойные и тройные апострофы, а не кавычки.

''логическое ударение''<br />
'''структурное выделение'''<br />
'''''логическое ударение в структурном выделении (или наоборот)'''''.

Вы также можете писать курсивом и жирным, если вас интересует определённый стиль шрифта, а не логическое выделение, например, в математических формулах:

F = ma

Тем не менее, разница между этими двумя методами не очень важна для графических браузеров, и многие люди просто игнорируют её.

Вы также можете писать ''курсивом'' и '''жирным''',
если вас интересует определённый стиль шрифта, 
а не логическое выделение, например, в математических формулах:

:'''F''' = ''m'''''a'''
Моноширинный шрифт для технических терминов.
Моноширинный шрифт для <tt>технических терминов</tt>.
Специальное форматирование для фрагментов кода программы, не содержащих переносов строки.
Специальное форматирование для фрагментов 
<code>кода программы, не содержащих переносов строки.</code>
Вы можете использовать маленький текст для комментариев.
Вы можете использовать <small>маленький текст</small> для комментариев.
Вы можете перечёркивать удалённый материал

и подчёркивать новый материал.

Вы можете <strike>перечёркивать удалённый материал</strike>
и <u>подчёркивать новый материал</u>.
x²   ≥   0 true

Для разделения пробелами используйте знак пробела: &nbsp;. Это также предотвращает переносы строк посреди текста, что полезно в формулах.

''x''<sup>2</sup>&nbsp;&nbsp;&ge;&nbsp;&nbsp;0 true.
Нижний индекс: x2

Верхний индекс: x² или x²

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

ε0 = 8.85 × 10−12

C² / J m.
Нижний индекс: x<sub>2</sub>
Верхний индекс: x<sup>2</sup> или x&sup2;
&epsilon;<sub>0</sub> =
8.85 &times; 10<sup>&minus;12</sup>
C&sup2; / J m.

Подавление интерпретации разметки:
Link → (''to'') the [[Вики-Поляны]]

  • Используется для изображения данных, содержащих символы со специальным значением.
  • Игнорирует всю разметку wiki, включая ту, что выглядит как теги HTML.
  • Не игнорирует символьные последовательности HTML.
<nowiki>Link &rarr; (''to'') 
the [[Вики-Поляны]]</nowiki>

Комментарий в исходном тексте страницы:
не отображается на странице

Используется для внесения в исходный текст страницы комментария для последующих редакторов.

<!-- комментарий -->

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

В Вики-Полянах включена подсветка синтаксиса программного кода. Пример на языке Си:

<syntaxhighlight lang=c>
#include <stdio.h>
int main()
{
    printf("Hello, world!\n");
    return 0;
}</syntaxhighlight>

Результат:

#include <stdio.h>
int main() 
{
    printf("Hello, world!\n");
    return 0;
}

Поддерживаемые языки: 4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript, actionscript3, ada, algol68, apache, applescript, apt_sources, arm, asm, asp, asymptote, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcl, dcpu16, dcs, delphi, diff, div, dos, dot, e, ecmascript, eiffel, email, epc, erlang, euphoria, f1, falcon, fo, fortran, freebasic, freeswitch, fsharp, gambas, gdb, genero, genie, gettext, glsl, gml, gnuplot, go, groovy, gwbasic, haskell, haxe, hicest, hq9plus, html4strict, html5, icon, idl, ini, inno, intercal, io, j, java, java5, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, ldif, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, mmix, modula2, modula3, mpasm, mxml, mysql, nagios, netrexx, newlisp, nsis, oberon2, objc, objeck, ocaml, ocaml-brief, octave, oobas, oorexx, oracle11, oracle8, oxygene, oz, parasail, parigp, pascal, pcre, per, perl, perl6, pf, php, php-brief, pic16, pike, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, pys60, python, q, qbasic, rails, rebol, reg, rexx, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, spark, sparql, sql, stonescript, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, upc, urbi, uscript, vala, vb, vbnet, vedit, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, whois, winbatch, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic.

Оглавление статьи

Если в статье содержится, по меньшей мере, четыре раздела, то панель «Содержание» (с оглавлением статьи) автоматически появляется на странице, непосредственно перед первым заголовком, то есть сразу после вступительного раздела.

  • Если вы хотите, чтобы «Содержание» появилось в каком-либо другом месте статьи, а не там, где оно появляется по умолчанию, то поместите ключевое слово __TOC__ в этом месте.
  • А для того, чтобы «Содержание» вообще нигде не появлялось, достаточно поместить ключевое слово __NOTOC__ где угодно на странице.