Extensão:CodeMirror

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:CodeMirror and the translation is 73% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎magyar • ‎português do Brasil • ‎sicilianu • ‎svenska • ‎čeština • ‎українська • ‎العربية • ‎中文 • ‎日本語 • ‎한국어
Manual de extensões do MediaWiki
OOjs UI icon advanced.svg
CodeMirror
Estado da versão: estável
Pride and codemirror.png
Implementação Interface de usuário
Descrição Fornece destaque de sintaxe no editor wikitexto
Autor(es) Pavel Astakhov (pastakhovdiscussão)
Última versão 4.0.0
Política de
compatibilidade
Snapshots releases along with MediaWiki. Master is not backwards compatible.
MediaWiki 1.32+
PHP 5.3+
Modifica o banco
de dados
Não
Licença GNU GPL (Licença Pública Geral) 2.0 ou superior
Download
  • $wgCodeMirrorEnableBracketMatching
  • $wgCodeMirrorAccessibilityColors
  • $wgCodeMirrorLineNumberingNamespaces
Para traduzir a extensão CodeMirror, verifique sua disponibilidade no translatewiki.net

Verificar uso e matriz de versões

Função no Vagrant codemirror
Problemas Tarefas em aberto · Relatar um bug

A extensão CodeMirror providência o realce de sintaxe no editor de wikitexto da MediaWiki. Ela adiciona um botão com o ícone Codemirror-icon.png à barra de ferramentas de edição, que permite alternar o realce de sintaxe entre ativo e desativo. Ele suporta a Barra de Ferramentas do WikiEditor de 2010 e também a Barra de Ferramentas do VisualEditor.

Por padrão ele vem desativado. Quando ativado, ele alterará a área de texto padrão com o editor providênciado pela [do CodeMirror]. Quando desativado, o oposto ocorrerá.

The colors used in this extension have been optimised to provide higher contrast, accessibility and better readability.

Please note though, that the updated color scheme is currently only enabled by default for some wikis (see roadmap and configuration).

Features

Bracket matching

This feature allows highlighting of the closest matching pair of surrounding brackets while navigating through wikitext code using the cursor. Bracket matching will be active in both editors when syntax highlighting is turned on, in any namespace using these editors.

Please note that bracket matching is only enabled by default in some wikis (see roadmap and configuration).

Line numbering

In the wikitext edit mode line numbers are automatically displayed in both editors.

Please note that this feature is only enabled for the template namespace by default (see roadmap and configuration).

Suporte a navegadores

Todos os navegadores suportados pelo MediaWiki são suportados.

Instalação

  • Se estiver usando o Vagrant , instale com vagrant roles enable codemirror --provision
Instalação manual

Configuração

Para customização de cores e estilo, veja meta:Community Tech/Wikitext editor syntax highlighting#Color and style customization. Você pode utilizar os seus próprios estilos para realçar o wikitexto. Estilos utilizados disponíveis aqui. Você deve pôr os seus estilos em common.css.

Adicione o código acima na parte inferior do seu LocalSettings.php .

# Enables use of CodeMirror by default but still allow users to disable it
$wgDefaultUserOptions['usecodemirror'] = 1;

To try out the new features mentioned above in your local installation, add the following lines as well. Please note though, that these features are meant to become default features. The settings might not have an effect any more then.

# Enable bracket matching in CodeMirror
$wgCodeMirrorEnableBracketMatching = true;

# Enable accessible colors in CodeMirror
$wgCodeMirrorAccessibilityColors = true;

# Enable line numbering in CodeMirror
# defaults to the template namespace `[ NS_TEMPLATE ]`
# `null` enables it for all namespace
# [] for disabling everywhere
$wgCodeMirrorLineNumberingNamespaces = null;

Integração de extensão

Se a sua extensão MediaWiki adiciona uma nova tag, e você quer que o CodeMirror realce o conteúdo corretamente dentro dele, você pode adicionar o suporte do CodeMirror à sua extensão. Aqui estão dois exemplos: extensão Cite e a extensão PhpTags.

Pendências

  • highlighting definition lists ( ;foo :bar ) (phab:T170042)
  • auto-completion (phab:T95100)
  • dobragem de código T166098
  • highlighting inside gallery tag (<gallery> foo | bar </gallery>)

Ver também