Insertar Códigos
Introducción
Se pueden insertar bloques de código en las paginas para mostrar una sintaxis sin que la misma opere sobre la pagina en cuestión.
Ademas, arriba a la derecha del recuadro donde se mostrara el código, aparecerá un botón para copiar el mismo y pegarlo donde uno quiera. Esta funcionalidad esta disponible gracias al complemento: Copy2clipboard Plugin
Sintaxis
Hay 3 formas de insertar código:
- Haciendo una identacion de dos espacios
- Mediante la etiqueta:
<file> </file>
- Mediante la etiqueta:
<code> </code>
La sintaxis de cada una de estas 3 alternativas seria:
"Código insertado dejando dos espacios de identacion"
<code>"Código insertado mediante la etiqueta code"</code>
<file>"Código insertado mediante la etiqueta file"</file>
Las salidas de cada una de las tres sintaxis sera:
"Código insertado dejando dos espacios de identacion"
"Código insertado mediante la etiqueta code"
"Código insertado mediante la etiqueta file"
Como se ve, cualquiera de las tres formas cumple la misma funcionalidad.
Código Resaltado
La wiki puede resaltar código para que este sea mas fácil de leer. Para la tarea hace uso de GeSHi (Generic Syntax Highlighter) por lo que es posible resaltar cualquier lenguaje soportado por este sistema.
Para hacer uso de esta opción se usan las etiquetas <file> </file>
y <code> </code>
pero aclarando el lenguaje en el que esta escrito el código. Así, la sintaxis a utilizar sera:
<code "lenguaje"> "codigo" </code>
o alternativamente:
<file "lenguaje"> "codigo" </file>
A modo de ejemplo podríamos tener el siguiente código java que queremos que sea resaltado:
<code java> /** * The HelloWorldApp class implements an application that * simply displays "Hello World!" to the standard output. */ class HelloWorldApp { public static void main(String[] args) { System.out.println("Hello World!"); //Display the string. } } </code>
La salida sera:
/** * The HelloWorldApp class implements an application that * simply displays "Hello World!" to the standard output. */ class HelloWorldApp { public static void main(String[] args) { System.out.println("Hello World!"); //Display the string. } }
Los lenguajes que actualmente son reconocidos son:
4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic
Aquí puede consultar las opciones avanzadas para resaltar. Entre ellas, por ejemplo, se encuentran resaltar solo ciertas lineas o agregar numeración a ellas.
Códigos Descargables
Es posible hacer códigos descargables. Esto solo se puede hacer usando las etiquetas <code>
o <file>
(no se pueden usar dos espacios de identacion).
Para lograr esto se debe especificar un lenguaje y un nombre para el archivo dentro de la etiqueta inicial <code>
o <file>
.
La sintaxis seria entonces:
<file "lenguaje" "nombre archivo"."lenguaje"> "código" </file>
o alternativamente:
<code "lenguaje" "nombre archivo"."lenguaje"> "código" </code>
A modo de ejemplo podríamos tener el siguiente código “php” al cual le daremos el nombre “archivo-descargable”:
<file php archivo-descargable.php> <?php echo "hola mundo!"; ?> </file>
La salida de este código sera:
- archivo-descargable.php
<?php echo "hola mundo!"; ?>
Si no queremos que el código este resaltado tendremos que usar un guion medio (-
) luego de la palabra <code
o <file
inicial y antes del “lenguaje”:
<file - "lenguaje" "nombre archivo"."lenguaje"> "código" </file>
Por ejemplo:
<code - php archivo-descargable.php> <?php echo "hola mundo!"; ?> </code>
Lo cual generara el siguiente resultado:
- php archivo-descargable.php
<?php echo "hola mundo!"; ?>