RPG Maker Wiki:Destaque de sintaxe

A RPG Maker Wiki possui uma extensão chamada GeSHi (acrônimo para Generic Syntax Highlighter), adicionada a pedido pelo servidor (a Wikia), que serve para destacar partes da sintaxe de uma língua de programação específica. Atualmente, essa wiki utiliza essa extensão para as línguas de programação utilizadas na criação de scripts para qualquer versão do RPG Maker, portanto utiliza-se o Ruby e o Lua. Com essa extensão, fica mais fácil, tanto para o editor quanto para o leitor, entender pedaços de códigos que são adicionados aos artigos para dar exemplos de como uma função daquela língua se comporta. A seguir, um exemplo de como deve ser utilizado:

function teste(arg1)
   if arg1 then
      print("it is working")
   end
end

teste("Hello World")

Essa extensão possui uma série de opções para permitir um amplo uso dela, nessa página encontram-se quais as opções que se pode utilizar junto do código <source> para a criação de artigos mais organizados.

Introdução

O uso da tag <source> permite a visualização de seções com códigos, além de adicionar cor de acordo com as opções daquela língua. Assim como as tags <pre> e <poem>, ela preserva o espaço em branco ou seja, o que for escrito no editor será demonstrado exatamente igual no artigo quando salvo.

Uso

Na página da wiki, agora pode-se usar os elementos de <source>:

<source lang="php">
<?php
    $v = "string";    // sample initialization
?>
html text
<?
    echo $v;         // end of php code
?>
</source>

irá mostrar

<?php
    $v = "string";    // sample initialization
?>
html text
<?
    echo $v;         // end of php code
?>

Parâmetros

lang="??"

Define qual linguagem de programação será usado. Isso irá afetar como as sintaxes serão destacadas.

line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS"

Define qual será o tipo de numeração das linhas na visualização do código. O padrão é não haver essa numeração.

line start="??"

Define em qual linha o código será iniciado. Deve ser utilizado em conjunto com o código line. Por exemplo, caso escreva line start="10", na visualização o sistema irá contar a primeira linha como a décima e continuará a partir daí (10, 11, 12.. etc).

highlight="??"

Especifica qual linha será destacada no código. Esse código não é afetado pelo código line

Trocando as cores utilizadas

A partir de uma certa versão do GeSHi, tornou-se possível trocar as cores utilizadas pela extensão para destacar as sintaxes nas línguas de programação. Para tal, um administrador ou um burocrata deve editar a página MediaWiki:Geshi.css e colocar a cor desejada na parte destacada que quer alterar. Para saber qual cor alterar, faça um teste na páginas de testes e procure no código fonte por <div class="mw-genshi">. Essa div deve conter dentro os códigos de cor a serem trocados.