{{{1}}}
Документация по шаблону [ просмотреть ] [ изменить ] [ история ] [ очистить ] | Этот шаблон используется на более чем 38 000 страницах, и изменения могут быть широко заметны . Протестируйте изменения на подстраницах / sandbox или / testcases шаблона или на подстранице вашего собственного пользователя . Обсудите изменения на странице обсуждения, прежде чем внедрять их. Счетчик включений обновляется автоматически ( см. Документацию ). |
использование
Оборачивает короткий отрезок текста в <syntaxhighlight>теги (см. Mw: Extension: SyntaxHighlight ). Этот шаблон следует использовать для коротких образцов; более длинный контент следует использовать <pre>...</pre>или <syntaxhighlight>...</syntaxhighlight>. См. Help: Wiki markup для объяснения того, что делают различные теги.
Если содержание включает в себя знак равенства (=), необходимо указать параметр в явном виде: {{code|1=date=30 Feb 2010}}.
В шаблоне используется <syntaxhighlight>тег с атрибутом inline=1. Это работает как сочетание из <code>и <nowiki>теги, применяемые к расширенной вики - текста. Например, {{code|some '''wiki''' text}}будет не оказывать слово «вики» жирный шрифт, и будет оказывать утроенные одинарные кавычки:
some '''wiki''' text
Однако по- {{code|a {{template}} call}}прежнему будет вызывать шаблон:
a {{[[Template:{{{1}}}|{{{1}}}]]}} call
Используйте <nowiki>...</nowiki>вокруг имени шаблона, чтобы избежать этой проблемы:
a {{template}} call
При использовании в строке с обычным текстом {{code}}обычно выглядит лучше и легче всего читается, когда он явно отделен от обычного текста:
foo {{code|bar baz}} quux.
хорошо расположены:
- foo
bar bazquux.
против:
foo {{code|bar baz}} quux.
что будет для многих визуально запутанным:
- foo
bar bazquux.
потому что "foo" и " bar" будут казаться более связанными, чем " bar" и " baz"; ширина символа пробела в моноширинном шрифте почти всегда больше, чем в пропорциональном шрифте.
Используйте параметр {{{2}}} (без названия, как |2=или более явно как |lang=), чтобы указать язык для mw: Extension: SyntaxHighlight GeSHi . По умолчанию для этого параметра используется обычный текст, т.е. без выделения. Там нет подсветки вариант для вики - текста как язык разметки, хотя html4strictи html5являются допустимыми значениями, так же как php, perl, css, javascript, mysqlи многие другие. Попытка использовать недопустимый приводит к отображению списка допустимых вместо выходных данных шаблона при предварительном просмотре или сохранении страницы.
Этот шаблон не нужно заменять .
Примеры
| Разметка | Отображается как |
|---|---|
Lorem {{code | ipsum '' 'dolor' ''}} сидеть амет | Lorem |
Объявление {{code | lang = cpp | int foo (const std :: string & bar, const std :: vector <long double *> & baz);}} является прототипом функции, определенной позже. | Объявление является прототипом функции, определенной позже. |
Если код содержит [[знак равенства]], например {{code | lang = javascript | code = var img = document.getElementsByTagName ("img");}}, вы должны явно указать первый параметр как {{{ 1}}} или {{{code}}}; см. также [[: bugzilla: 5138]]. | Если код содержит знак равенства , например , вы должны явно указать первый параметр как {{{1}}} или {{{code}}}; см. также bugzilla: 5138 . |
Включенные шаблоны
Встроенные шаблоны не работают должным образом внутри {{ code }}; для более длинных блоков кода произвольной формы, которые могут содержать шаблоны, такие как {{ var }} и {{ samp }}, используйте <code>...</code>в качестве оболочки вместо этого шаблона.
Шаблоны, используемые внутри {{ code }}, предоставляют визуализированный HTML- код - это может быть полезно. Например:
| Разметка | Отображается как |
|---|---|
{{code |{{cite web | title = Title | url = http: //example.org}}}} |
|
В приведенном выше примере показан HTML-код, отображаемый с помощью шаблона цитирования, включая скрытые метаданные.
Смотрите также
- {{ codett }}, оболочка для этого шаблона, которая удаляет стиль фона и границ.
- {{ mono }}, только моноширинный шрифт
- {{ Syntaxhighlight }}
- Справка: разметка вики
