Help:Extension:CodeMirror/pt-br
A extensão CodeMirror oferece realce de sintaxe nos editores de wikitexto. Isso pode facilitar a edição ao usar cores e sombreamento para separar visualmente o texto simples de links, predefinições e outras marcações de wikitexto.
Como funciona
Ativação
O CodeMirror pode ser ativado ao definir Ativar realce de sintaxe nas suas preferências.
No WikiEditor (também conhecido como editor de 2010, ativado com a preferência Ativar a barra de ferramentas de edição), ele também pode ser ativado ou desativado usando o botão de realce "
Syntax" na barra de ferramentas.
No editor de 2017, você pode ativar ou desativar o CodeMirror clicando no botão "Page options" 
na barra de ferramentas e, em seguida, selecionando "Syntax highlighting".
Atalhos de teclado
You can review keyboard shortcuts by opening the help dialog with Ctrl+⇧ Shift+/.
| Lista de atalhos de teclado | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Recursos
Acesso às preferências
| Versão MediaWiki: | ≥ 1.44 |
A maioria dos recursos documentados aqui pode ser desativada ou ativada por cada usuário individualmente.
Para abrir o painel de preferências, pressione Ctrl+⇧ Shift+, (ou ⌘ Command+⇧ Shift+, no macOS).
Se você usar o WikiEditor, também poderá acessar suas preferências do CodeMirror clicando no botão 
na seção Avançado da barra de ferramentas.
Suas preferências do CodeMirror serão lembradas em diferentes dispositivos e sessões.
Correspondência de colchetes
Quando o cursor está diretamente ao lado de um colchete, o recurso destaca o colchete correspondente.
Dobramento de código
| Versão MediaWiki: | ≥ 1.43 |
O dobramento de código permite recolher parâmetros de predefinições, tags de extensões e outros blocos de código. Isso pode facilitar bastante o gerenciamento de predefinições grandes e complexas.
Uso
Quando o cursor ou a seleção cobre qualquer parte de uma sintaxe compatível, um ícone de dica 
aparece logo acima do texto. Ao clicar nele, o código é recolhido, deixando visível apenas o nome da predefinição ou da tag.
O código dobrado exibirá o nome da predefinição ou da tag seguido do ícone de reticências 
. Clicar nesse ícone expandirá o código de volta ao seu estado original.
| Atalhos | Atalhos (Mac OS) | Descrição |
|---|---|---|
| Ctrl+⇧ Shift+[ | ⌘ Command+Alt+[ | Dobrar o código selecionado. |
| Ctrl+⇧ Shift+] | ⌘ Command+Alt+] | Desdobrar o código selecionado. |
| Ctrl+Alt+[ | Ctrl+Alt+[ | Recolher todo o código. |
| Ctrl+Alt+] | Ctrl+Alt+] | Expandir todo o código. |
Personalização
Se você quiser manter o atalho de teclado para dobrar templates, mas ocultar o componente visual, pode fazer isso adicionando o seguinte ao seu CSS pessoal:[1]
.cm-tooltip-fold {
display: none;
}
Autocompletion
| Versão MediaWiki: | ≥ 1.44 |
This feature provides autocompletion of palavras mágicas, parser extension tags, and URL protocols.
If you enter {{#, you should see a list of all parser functions that start with #.
Similarly, typing double underscores (__) will show a list of double-underscored magic words.
You can continue to type to narrow your search. Use the arrow keys to select the desired text, and hit the ↵ Enter or Tab ↹ key to make your selection.
Autocompletion does not work for templates, or for magic words or parser functions that do not begin with # or __.
Opening links in wikitext
| Versão MediaWiki: | ≥ 1.44 |
You can quickly open links specified in the wikitext. Do this by holding down the Ctrl key (or ⌘ Command on MacOS) and clicking on a page title inside of link syntax, such as [[Main Page]].
Clicking this case would open Main Page in a new tab.
This feature also works for template names and file names.
Line numbering
When enabled, line numbers are automatically displayed in all editors. On the Wikimedia wikis, it is only enabled for specific namespaces of specific wikis.[2]
Line numbers will take into account any hidden lines, such as those through code folding.
Highlight the active line
| Versão MediaWiki: | ≥ 1.44 |
In your CodeMirror preferences, you can select "Highlight the active line" to enable this feature, which can make it easier to tell which line of text the cursor is on, especially on large pages.
Line wrapping
| Versão MediaWiki: | ≥ 1.44 |
Line wrapping is the default behaviour in most editors. Sometimes you may want to disable this, especially when writing complex wikitext or other code. You can disable line wrapping in your CodeMirror preferences.
Multiple cursors and selections
You can add additional cursors or selections by holding the Ctrl key (or ⌘ Command on MacOS) and clicking on the desired content or cursor placement. After doing so, any changes you make will be applied to all the selections at the same time.
You can also press Ctrl+d (or ⌘ Command+d on MacOS) to select the next occurrence of the current selection or word, which create multiple selections. This can be useful as a quick find and replace feature.
Highlight special characters
By default, CodeMirror will highlight non-printable control characters and other characters such as non-breaking spaces. Control characters appear as a red dot, while non-breaking spaces are displayed as a faint gray dot. Hovering over these characters will show a tooltip stating which character it is.
If desired, you can disable this feature in your CodeMirror preferences.
Colorblind mode
For users who have difficulty distinguishing between colors, CodeMirror offers a colorblind-friendly mode. This feature can be activated on wikis with CodeMirror enabled with "Enable colorblind-friendly scheme for syntax highlighting when editing wikitext" in your preferences.
With the colorblind-friendly scheme active, the colors of the following page elements change:
| Headings, symbols, signatures, section names, magic words | #E4A400 |
| Templates | #9C3A00 |
| HTML tags, references, mathematical expressions | #56B4E9 |
| Variables | #009E73 |
In addition, background highlights and colors are removed from all text and objects. Bolding and underlining behavior remains unaffected.
Bidi isolation
On right-to-left pages, CodeMirror can isolate HTML and other tags as bidirectional text, which can improve readability. The standard algorithm for the layout of text places neutral punctuation characters between right-to-left text on the wrong side. With bidi isolation, we can correct this so it reads more legibly:
 |
 |
Color and style customization
The colors and styles used in CodeMirror can be overridden by defining your own styles for the classes in the table below in your personal CSS.[1] Please be aware that changing some things like the line height or font size may not work in the 2017 wikitext editor.
| CSS class(es) | Element | CodeMirror styling |
|---|---|---|
| .cm-mw-skipformatting | leading space | foo bar |
| .cm-mw-list | asterisk or number sign | * foo bar, # foo bar |
| .cm-mw-signature, .cm-mw-hr |
signature, horizontal rule | ∼∼∼∼, ---- |
| .cm-mw-indenting | colons | ::: foo bar |
| .cm-mw-html-entity | HTML entities | & |
| .cm-mw-comment | HTML comment | <!-- comment --> |
| .cm-mw-apostrophes-bold, .cm-mw-apostrophes-italic |
bold and italic | '''bold''' ''italic'' |
| Headings | ||
| .cm-mw-section-1 | level 1 heading[3] | = Heading = |
| .cm-mw-section-2 | level 2 heading[3] | == Heading == |
| .cm-mw-section-3 | level 3 heading | === Heading === |
| .cm-mw-section-4 | level 4 heading | ==== Heading ==== |
| .cm-mw-section-5 | level 5 heading | ===== Heading ===== |
| .cm-mw-section-6 | level 6 heading | ====== Heading ====== |
| .cm-mw-section-header | equal signs | == |
| Templates | ||
| example | {{cite book|title=foo bar}} | |
| .cm-mw-template | other template content | foo bar |
| .cm-mw-template-name | template name | cite book |
| .cm-mw-template-argument-name | template parameters | title= |
| .cm-mw-template-delimiter | pipe | | |
| .cm-mw-template-bracket | opening/closing brackets | {{ }} |
| .cm-mw-template-ground .cm-mw-template2-ground .cm-mw-template3-ground |
whole template (the number is the level of nesting) |
{{foo|{{cite book|title=foo bar}}}} |
| Variables | ||
| example | {{{foo|bar}}} | |
| .cm-mw-templatevariable | variable | bar |
| .cm-mw-templatevariable-name | triple-braced variable name | foo |
| .cm-mw-templatevariable-bracket | opening/closing brackets | {{{ }}} |
| .cm-mw-templatevariable-delimiter | pipe | | |
| Parser functions | ||
| example | {{#assessment: A | High }} | |
| .cm-mw-parserfunction | parser function parameters | High |
| .cm-mw-parserfunction-name | parser function name | PAGENAME #invoke |
| .cm-mw-parserfunction-bracket | opening/closing brackets | {{ }} |
| .cm-mw-parserfunction-delimiter | delimiter | : |
| Extension tags | ||
| Note: Extension may use their own styles and rules for highlighting text within the extension tag. | ||
| example | <poem style="padding: 1em;">string whole line string</poem> | |
| .cm-mw-exttag | text inside tags | string |
| .cm-mw-exttag-name, .cm-mw-ext-poem[4] |
tag name | poem |
| .cm-mw-exttag-bracket | opening/closing brackets | < > |
| .cm-mw-tag-ref | reference content | <ref>{{cite web|url=https://example.org}}</ref> |
| .cm-mw-exttag-attribute .cm-mw-exttag-attribute-value |
reference attributes | style="padding: 1em;" |
| HTML tags | ||
| example | <span style="foo">foo bar</span> | |
| .cm-mw-htmltag-name | HTML tag | span |
| .cm-mw-htmltag-bracket | opening/closing brackets | < > |
| .cm-mw-htmltag-attribute .cm-mw-htmltag-attribute-value |
parameters and values | style="foo" |
| superscript subscript |
foo<sup>bar</sup> foo<sub>bar</sub> | |
| Pre-formatted text | ||
| .cm-mw-tag-pre | pre-formatted text | <pre>foo bar</pre> |
| .cm-mw-tag-nowiki | nowiki text | <nowiki>foo bar</nowiki> |
| Internal links | ||
| example | [[foo bar]] [[foo#section|bar]] | |
| .cm-mw-link-pagename | internal link target | foo bar |
| .cm-mw-link | # character | #section |
| .cm-mw-link-tosection | characters after the # | #section |
| .cm-mw-link-bracket | opening/closing brackets | [[ ]] |
| .cm-mw-link-text | link label | (no additional formatting) |
| .cm-mw-link-delimiter | pipe | | |
| .cm-mw-pagename | internal link targets | foo bar |
| External links | ||
| example | https://www.example.org [https://www.example.org] [https://www.example.org example.org] | |
| .cm-mw-extlink, .cm-mw-free-extlink |
external link target | www.example.org |
| .cm-mw-extlink-protocol, .cm-mw-free-extlink-protocol |
protocol | https:// |
| .cm-mw-extlink-text | link label | (no additional formatting) |
| .cm-mw-extlink-bracket | opening/closing brackets | [ ] |
| Tables | ||
| example | {| class="wikitable" |- ! Header text !! Header text |- | Example || Example |} | |
| .cm-mw-table-bracket | opening/closing brackets and pipe | {| |} |
| .cm-mw-table-delimiter | row and column separators | | |- ! |
| .cm-mw-table-definition .cm-mw-table-definition-value |
table classes and styles | class="wikitable" |
| .cm-mw-table-caption | caption text | |+ caption |
| Other | ||
| .cm-mw-double-underscore | magic words | __TOC__ |
| .cm-mw-list | semicolon (definition lists) | ;Foo:Bar |
| .cm-special-char-nbsp | non-breaking space | · · |
| .cm-specialChar | control characters | • |
Notes
- 1 2 Your personal CSS is at Special:MyPage/common.css. You can also make your changes take effect globally if GlobalCssJs is installed. On Wikimedia wikis, your global CSS is at meta:Special:MyPage/global.css.
- ↑
Controlled by the
$wgCodeMirrorLineNumberingNamespacesconfiguration setting. See Extension:CodeMirror#Configuration for more information. - 1 2 The size is not changed in the 2017 wikitext editor.
- ↑ Where "poem" is the name of the tag.