🌍
Español
Muestra las diferencias entre dos versiones de la página.
wiki:syntax [2013/05/20 20:02] albertparera [Code Blocks] |
wiki:syntax [2013/06/01 10:31] (actual) albertparera [Tablas] |
||
---|---|---|---|
Línea 343: | Línea 343: | ||
Echa un vistazo al fuente de esta página para ver cómo usar estos bloques. | Echa un vistazo al fuente de esta página para ver cómo usar estos bloques. | ||
- | ==== Syntax Highlighting ==== | + | ===== Resaltado de Sintaxis ===== |
- | [[wiki:DokuWiki]] can highlight sourcecode, which makes it easier to read. It uses the [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- so any language supported by GeSHi is supported. The syntax is the same like in the code and file blocks in the previous section, but this time the name of the used language is inserted inside the tag. Eg. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''. | + | [[DokuWiki]] puede resaltar el código fuente, que lo hace más sencillo de leer. Usa [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- por lo que cualquier lenguaje soportado por GeSHi es soportado. La sintaxis es muy parecida a la del bloque de código de la sección anterior, pero esta vez el nombre del lenguaje utilizado se inserta dentro de la etiqueta. Por ej. ''<nowiki><code java></nowiki>''. |
<code java> | <code java> | ||
- | /** | + | /** |
* The HelloWorldApp class implements an application that | * The HelloWorldApp class implements an application that | ||
* simply displays "Hello World!" to the standard output. | * simply displays "Hello World!" to the standard output. | ||
Línea 359: | Línea 359: | ||
</code> | </code> | ||
- | The following language strings are currently recognized: //abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoit, avisynth, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, cil, cmake, cobol, cpp, cpp-qt, csharp, css, d, dcs, delphi, diff, div, dos, dot, eiffel, email, erlang, fo, fortran, freebasic, genero, glsl, gml, gnuplot, groovy, gettext, haskell, hq9plus, html, idl, ini, inno, intercal, io, java5, java, javascript, kixtart, klonec, klonecpp, latex, lisp, locobasic, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, make, matlab, mirc, modula3, mpasm, mxml, mysql, nsis, oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, pascal, perl, per, php-brief, php, pic16, pixelbender, plsql, povray, powershell, progress, prolog, properties, providex, python, qbasic, rails, rebol, reg, robots, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, tcl, teraterm, text, thinbasic, tsql, typoscript, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xml, xorg_conf, xpp, z80// | + | Los lenguajes siguientes son reconocidos actualmente: //actionscript, actionscript-french, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, caddcl, cadlisp, c, c_mac, cfm, cpp, csharp, css, delphi, diff, d, div, dos, eiffel, freebasic, gml, groovy, html4strict, ini, inno, java, java5, javascript, lisp, lua, matlab, mpasm, mysql, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, tsql, reg, robots, ruby, vb, vbnet, vhdl, visualfoxpro, winbatch, xml// |
- | ==== Downloadable Code Blocks ==== | + | ==== Bloques de código descargables ==== |
When you use the ''%%<code>%%'' or ''%%<file>%%'' syntax as above, you might want to make the shown code available for download as well. You can to this by specifying a file name after language code like this: | When you use the ''%%<code>%%'' or ''%%<file>%%'' syntax as above, you might want to make the shown code available for download as well. You can to this by specifying a file name after language code like this: | ||
Línea 378: | Línea 378: | ||
- | ===== Embedding HTML and PHP ===== | + | ===== Incrustar HTML y PHP ===== |
- | + | ||
- | You can embed raw HTML or PHP code into your documents by using the ''%%<html>%%'' or ''%%<php>%%'' tags. (Use uppercase tags if you need to enclose block level elements.) | + | |
- | + | ||
- | HTML example: | + | |
+ | Puedes incrustar código HTML o PHP puro en tus documentos usando las etiquetas ''html'' o ''php'' de este modo: | ||
<code> | <code> | ||
<html> | <html> | ||
- | This is some <span style="color:red;font-size:150%;">inline HTML</span> | + | Esto es <font color="red" size="+1">HTML</font> |
</html> | </html> | ||
- | <HTML> | ||
- | <p style="border:2px dashed red;">And this is some block HTML</p> | ||
- | </HTML> | ||
</code> | </code> | ||
<html> | <html> | ||
- | This is some <span style="color:red;font-size:150%;">inline HTML</span> | + | Esto es <font color="red" size="+1">HTML</font> |
</html> | </html> | ||
- | <HTML> | ||
- | <p style="border:2px dashed red;">And this is some block HTML</p> | ||
- | </HTML> | ||
- | |||
- | PHP example: | ||
<code> | <code> | ||
<php> | <php> | ||
- | echo 'A logo generated by PHP:'; | + | echo 'Un logo generado por PHP:'; |
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; | echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; | ||
- | echo '(generated inline HTML)'; | ||
</php> | </php> | ||
- | <PHP> | ||
- | echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>'; | ||
- | echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>'; | ||
- | echo '</tr></table>'; | ||
- | </PHP> | ||
</code> | </code> | ||
<php> | <php> | ||
- | echo 'A logo generated by PHP:'; | + | echo 'Un logo generado por PHP:'; |
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; | echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; | ||
- | echo '(inline HTML)'; | ||
</php> | </php> | ||
- | <PHP> | ||
- | echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>'; | ||
- | echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>'; | ||
- | echo '</tr></table>'; | ||
- | </PHP> | ||
- | **Please Note**: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed. | + | **Por favor observa**: La inclusión de HTML y PHP se encuentra deshabilitada predeterminadamente en la configuración. Si se encuentra deshabilitado, el código se muestra en lugar de ejecutarse. |
- | ===== RSS/ATOM Feed Aggregation ===== | ||
- | [[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http://simplepie.org/|SimplePie]] is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters: | ||
- | ^ Parameter ^ Description ^ | + | ===== Agregar fuentes RSS/ATOM ===== |
- | | any number | will be used as maximum number items to show, defaults to 8 | | + | DokuWiki puede integrar información de fuentes XML externas. Para procesar las fuentes XML, se ocupa [[http://simplepie.org/|SimplePie]]. Todos los formatos entendidos por SimplePie, pueden usarse también en DocuWiki. Se puede afectar el despliegue por medio de varios parámetros separados por espacios: |
- | | reverse | display the last items in the feed first | | + | |
- | | author | show item authors names | | + | |
- | | date | show item dates | | + | |
- | | description| show the item description. If [[doku>config:htmlok|HTML]] is disabled all tags will be stripped | | + | |
- | | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). | | + | |
- | The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki:DokuWiki]] will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells [[wiki:DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered. | + | ^ Parámetro ^ Descripción ^ |
+ | | cualquier número | número de artículos a mostrar como máximo; por omisión, 8 | | ||
+ | | reverse | mostrar los últimos artículos al principio | | ||
+ | | author | mostrar los nombres de los autores de los artículos | | ||
+ | | date | mostrar las fechas de los artículos | | ||
+ | | description | mostrar las descripciones de los artículos. Si el HTML está deshabilitado, toda etiqueta se rasurará | | ||
+ | | //n//[dhm] | periodo de actualización, donde d=días, h=horas, m=minutos. (ej. 12h = 12 horas). | | ||
- | **Example:** | + | El periodo de actualización por omisión es de 4 horas. Cualquier valor menor a 10 minutos será tratado como 10 minutos. DokuWiki generalmente tratará de entregar una versión en caché de la página; obviamente esto no es apropiado cuando la página incluye contenido dinámico externo. El parámetro le dice a DokuWiki que regenere la página si hace más de //periodo de actualización// desde que la página se generó por última vez. |
- | {{rss>http://slashdot.org/index.rss 5 author date 1h }} | + | **Ejemplo:** |
- | {{rss>http://slashdot.org/index.rss 5 author date 1h }} | + | {{rss>http://barrapunto.com/index.rss 10 author date 2h }} |
+ | {{rss>http://barrapunto.com/index.rss 10 author date 2h }} | ||
+ | ===== Macros de Control ===== | ||
- | ===== Control Macros ===== | + | Algunas expresiones afectan la manera en que DokuWiki despliega una página, sin producir una salida //per se//. Se cuenta con las siguientes macros de control: |
- | Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble: | + | ^ Macro ^ Descripción | |
+ | | %%~~NOTOC~~%% | Si esta macro se encuentra en la página, no se generará una tabla de contenidos | | ||
+ | | %%~~NOCACHE~~%% | DokuWiki, por omisión, hace un caché de todo lo que despliega. A veces esto no es deseable (por ejemplo, cuando se usa la sintaxis %%<php>%% descrita arriba); añadir esta macro forzará a DokuWiki a regenerar la página cada vez que sea solicitada | | ||
+ | ===== Plugins de Sintaxis ===== | ||
- | ^ Macro ^ Description | | + | La sintaxis de DokuWiki puede extenderse con [[doku>plugins|Plugins]]. Como se usan los plugin instalados se describe en sus correspondientes páginas descriptivas. Los siguientes plugins de sintaxis están disponibles en esta particular instalación de DokuWiki: |
- | | %%~~NOTOC~~%% | If this macro is found on the page, no table of contents will be created | | + | |
- | | %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender a page on every call | | + | |
- | + | ||
- | ===== Syntax Plugins ===== | + | |
- | + | ||
- | DokuWiki's syntax can be extended by [[doku>plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation: | + | |
~~INFO:syntaxplugins~~ | ~~INFO:syntaxplugins~~ | ||
- |