sintaxis_de_wiki

Diferencias

Muestra las diferencias entre dos versiones de la página.

Enlace a la vista de comparación

Ambos lados, revisión anterior Revisión previa
Próxima revisión
Revisión previa
sintaxis_de_wiki [2022/03/12 14:46] – [Code Blocks] peronsintaxis_de_wiki [2022/12/26 03:16] (actual) – [Interno] hora_z
Línea 1: Línea 1:
 ====== Sintaxis de Wiki ====== ====== Sintaxis de Wiki ======
  
-[[doku>DokuWiki]] soporta lenguaje markup simple, que intenta hacer que el código fuenete DokuWiki sea tan legible como sea posible. Esta página contiene todas las sintaxis posibles que puedes utilizar para editar las páginas de la [[start|Wiki de Texto-plano]]. Simplemente hecha un vistazo al código fuente de la página presionando "Edit this page". Si deseas probar algo, usa la página [[playground:playground|playground]]. Los atributos de marcado son fácilmente accesibles con los  [[doku>toolbar|quickbuttons]].+[[doku>DokuWiki]] soporta lenguaje markup simple, que intenta hacer que el código fuente DokuWiki sea tan legible como sea posible. Esta página contiene todas las sintaxis posibles que puedes utilizar para editar las páginas de la [[start|Wiki de Texto-plano]]. Simplemente hecha un vistazo al código fuente de la página presionando "Edit this page". Si deseas probar algo, usa la página [[playground:playground|playground]]. Los atributos de marcado son fácilmente accesibles con los  [[doku>toolbar|quickbuttons]].
  
 ===== Formateo de texto básico ===== ===== Formateo de texto básico =====
Línea 10: Línea 10:
   Por supuesto podrás  **__//''combinar''//__** todos ellos.   Por supuesto podrás  **__//''combinar''//__** todos ellos.
  
-Podrás utilizar <sub>subscriptos</sub> and <sup>superscriptos</sup>, sin problmeas.+Podrás utilizar <sub>subscriptos</sub> <sup>superscriptos</sup>, sin problmeas.
  
   Podrás utilizar <sub>subscriptos</sub> and <sup>superscriptos</sup>, sin problmeas.   Podrás utilizar <sub>subscriptos</sub> and <sup>superscriptos</sup>, sin problmeas.
Línea 32: Línea 32:
 ===== Enlaces ===== ===== Enlaces =====
  
-DokuWiki soporta múltiples formaas de crear enlaces hipertextuales.+DokuWiki soporta múltiples formas de crear enlaces hipertextuales.
  
 ==== Externos ==== ==== Externos ====
Línea 38: Línea 38:
 Los enlaces externos son reconocidos automáticamente: https://texto-plano.xyz o simplemente texto-plano.xyz - Podrás también utilizar un enlace textual también: [[https://texto-plano.xyz|Esto dirige a texto-plano.xyz]]. Las direcciones de correo electrónico se indican así: <fulana@texto-plano.xyz>. Los enlaces externos son reconocidos automáticamente: https://texto-plano.xyz o simplemente texto-plano.xyz - Podrás también utilizar un enlace textual también: [[https://texto-plano.xyz|Esto dirige a texto-plano.xyz]]. Las direcciones de correo electrónico se indican así: <fulana@texto-plano.xyz>.
  
-  o si están seguidas por un espacio en blanco\\. \\esto sucede si no lo hay. +  Los enlaces externos son reconocidos automáticamente: https://texto-plano.xyz o simplemente texto-plano.xyz - Podrás también utilizar un enlace textual también: [[https://texto-plano.xyz|Esto dirige a texto-plano.xyz]]. Las direcciones de correo electrónico se indican así: <fulana@texto-plano.xyz>.
-  https://texto-plano.xyz o simplemente texto-plano.xyz - Podrás también utilizar un enlace textual +
-  también: [[https://texto-plano.xyz|Esto dirige a texto-plano.xyz]].  +
-  Las direcciones de correo electrónico se indican así: <fulana@texto-plano.xyz>.+
  
 ==== Interno ==== ==== Interno ====
  
-Los enlaces internos se crean usando doble corchete. Puedes usar un [[nombre]] o usar un  [[nombre|texto de enlace]] adicional.+Los wikienlaces son internos se crean usando doble corchete. Puedes usar un [[wikienlace]] o usar un  [[texto adicional|wikienlace]] suplementario.
  
-  Los enlaces internos se crean usando doble corchete. +  Los wikienlaces internos se crean usando doble corchete. 
-  Puedes usar un [[nombre]] o usar un  [[nombre|texto de enlace]] adicional.+  Puedes usar un [[nombre]] o usar un  [[texto adicional|wikienlace]] suplementario.
  
-Los [[doku>pagename|nombres Wiki]] son automáticamente convertidos a minúscula, y no se permiten caracteres especiales.+Los [[doku>pagename|wikienlaces]] serán pasados a minúscula automáticamente, y en ellos no están permitido utilizar caracteres especiales.
  
-Puedes usar [[some:namespaces]] usando un : en el pagename.+Puedes usar [[texto:pagenames]] usando un : en el wikienlace.
  
-  Puedes usar [[some:namespaces]] usando un : en el pagename.+  Puedes usar [[texto:namespaces]] usando un : en el wikienlace.
  
 Para mayores detalles sobre los nombres de página de Wiki consulta [[doku>namespaces]]. Para mayores detalles sobre los nombres de página de Wiki consulta [[doku>namespaces]].
  
-Te será posible enlazar a una sección específica. Simplemente agrega la sección deseada detrás de un caracter numeral, tal como se usa en HTML. +Te será posible enlazar a una sección específica del documento wiki. Simplemente agrega la sección deseada por detrás de un caracter numeral, tal como es usual en la sintaxis HTML.
  
 Esto enlaza a [[sintaxis_de_wiki#interno|esta Sección]]. Esto enlaza a [[sintaxis_de_wiki#interno|esta Sección]].
Línea 66: Línea 63:
 Notas: Notas:
  
-  * Los enlaces a [[syntaxis_de_wiki|páginas existentes]] se mostrarán de un estilo diferente a los enlaces [[no existentes]].+  * Los wikienlaces a [[sintaxis_de_wiki#interno|páginas existentes]] se mostrarán de un estilo diferente a los enlaces [[no existentes]].
   * DokuWiki no usa [[wp>CamelCase]] para crear enlaces automáticamente por defecto, pero puede activarse este comportamiento en el fichero [[doku>config]]. Ayuda: Si DokuWiki es un enlace, entonces está activado.   * DokuWiki no usa [[wp>CamelCase]] para crear enlaces automáticamente por defecto, pero puede activarse este comportamiento en el fichero [[doku>config]]. Ayuda: Si DokuWiki es un enlace, entonces está activado.
-  * Cuando cambias el titulado de sección, lo enlaces de los marcadores lo harán también. No dependas demasiado del enlaces de sección.+  * Cuando cambias el titulado de sección, los enlaces de los marcadores lo harán también. No dependas demasiado del enlaces de sección.
  
 ==== Interwiki ==== ==== Interwiki ====
Línea 79: Línea 76:
 ==== Windows Shares ==== ==== Windows Shares ====
  
-Windows shares like [[\\server\share|this]] are recognizedtooPlease note that these only make sense in a homogeneous user group like a corporate [[wp>Intranet]].+DocuWiki acepta Windows shares como [[\\server\share|este]], tambiénPor favor ten en cuenta que estos no sirven en texto-plano.xyz, y sólo tienen sentido en un grupo de usuarios homogéneos como una [[wp>Pubnix]].
  
   Windows Shares like [[\\server\share|this]] are recognized, too.   Windows Shares like [[\\server\share|this]] are recognized, too.
Línea 85: Línea 82:
 Notes: Notes:
  
-  * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone"). +  * Por razones de seguridad la navegación directa en windows shares sólo funciona en Microsoft Internet Explorer por defecto (y sólo en la "zona local"). 
-  * For Mozilla and Firefox it can be enabled through different workaround mentioned in the [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. Howeverthere will still be a JavaScript warning about trying to open a Windows Share. To remove this warning (for all users), put the following line in ''conf/lang/en/lang.php'' (more details at [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]): <code - conf/lang/en/lang.php>+  * Para Mozilla Firefox puede activarse a través de diferentes procedimientos mencionados en la [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. Sin embargoaún se presentará una advertencia de JavaScript cuando intentes abrir una Windows Share. Para quitar esta advertencia (para todos los usuarios), coloca la siguiente línea en ''conf/lang/en/lang.php'' (consulta más detalles en [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]): <code - conf/lang/es/lang.php>
 <?php <?php
 /** /**
- * Customization of the english language file + * Customization del fichero de idioma castellano 
- Copy only the strings that needs to be modified+ Copia solo las cadenas que necesitan ser modificadas
  */  */
 $lang['js']['nosmblinks'] = ''; $lang['js']['nosmblinks'] = '';
Línea 197: Línea 194:
 ===== Listas de ítems ===== ===== Listas de ítems =====
  
-Dokuwiki soporta lístas ordenadas y no ordenadas. Para crear un ítem de lista, indiza tu texto con dos espacios y emplea un ''*'' para las líneas no ordenadas o un ''-'' para las listas ordenadas.+Dokuwiki soporta lístas ordenadas y no ordenadas. Para crear un ítem de lista, sangra tu texto con dos espacios y emplea un ''*'' para las líneas no ordenadas o un ''-'' para las listas ordenadas.
  
   * Esto es una lista   * Esto es una lista
Línea 206: Línea 203:
   - Esta es la misma lista pero ordenada   - Esta es la misma lista pero ordenada
   - Otro ítem   - Otro ítem
-    - Simplemente indiza con dos espacios mas para agregar otro nivel.+    - Simplemente sangra con dos espacios mas para agregar otro nivel.
   - ¡Es simple!   - ¡Es simple!
  
Línea 217: Línea 214:
   - Esta es la misma lista pero ordenada   - Esta es la misma lista pero ordenada
   - Otro ítem   - Otro ítem
-    - Simplemente indiza con dos espacios mas para agregar otro nivel.+    - Simplemente sangra con dos espacios mas para agregar otro nivel.
   - ¡Es simple!   - ¡Es simple!
 </code> </code>
Línea 229: Línea 226:
 Las conversiones de imagen a texto son realizadas fundamentalmente para los smileys. Y la conversión de texto a HTML se usa para reemplazar su tipografía, pero también puede configurarse para usar otro HTML también. Las conversiones de imagen a texto son realizadas fundamentalmente para los smileys. Y la conversión de texto a HTML se usa para reemplazar su tipografía, pero también puede configurarse para usar otro HTML también.
  
-==== Conversiones de Texto a Imágen ====+==== Conversiones de Texto a Imagen ====
  
 DokuWiki convierte [[wp>emoticon|emoticones]] comunes a su equivalencia gráfica. Tales [[doku>Smileys]] y otras imágenes pueden ser configuradas y extendidas. He aquí una lista de los Smileys incluidos en DokuWiki: DokuWiki convierte [[wp>emoticon|emoticones]] comunes a su equivalencia gráfica. Tales [[doku>Smileys]] y otras imágenes pueden ser configuradas y extendidas. He aquí una lista de los Smileys incluidos en DokuWiki:
Línea 363: Línea 360:
 Nota: La alineación vertical no está soportada. Nota: La alineación vertical no está soportada.
  
-===== Sin Formado =====+===== Sin Formateado =====
  
 Si necesitas presentar un texto exactamente como está tipeado (sin que se interprete o produzca ningún formato), cierra el área tanto con una etiqueta ''%%<nowiki>%%'' o más fácil, con signos de porcentaje doble ''<nowiki>%%</nowiki>''. Si necesitas presentar un texto exactamente como está tipeado (sin que se interprete o produzca ningún formato), cierra el área tanto con una etiqueta ''%%<nowiki>%%'' o más fácil, con signos de porcentaje doble ''<nowiki>%%</nowiki>''.
Línea 423: Línea 420:
 Existen [[doku>syntax_highlighting|opciones avanzadas]] adicionales disponibles para el resaltado de syntaxis, tales como resaltado de líneas o agregar números de línea. Existen [[doku>syntax_highlighting|opciones avanzadas]] adicionales disponibles para el resaltado de syntaxis, tales como resaltado de líneas o agregar números de línea.
  
-==== Downloadable Code Blocks ====+==== Códigos de Bloque Descargables ====
  
-When you use the ''%%<code>%%'' or ''%%<file>%%'' syntax as aboveyou might want to make the shown code available for download as wellYou can do this by specifying a file name after language code like this:+Cuando uses la sintaxis ''%%<code>%%'' ''%%<file>%%'' como se indicó anteriormentepodrías querer que también sea presentado con un indicativo que lo deje disponible para descargarloPodrás hacerlo si le especificas un nombre de fichero de la siguiente manera:
  
 <code> <code>
-<file php myexample.php> +<file php miejemplo.php> 
-<?php echo "hello world!"; ?>+<?php echo "hola texto-plano!"; ?>
 </file> </file>
 </code> </code>
  
-<file php myexample.php> +<file php miejemplo.php> 
-<?php echo "hello world!"; ?>+<?php echo "hola texto-plano!"; ?>
 </file> </file>
  
-If you don't want any highlighting but want a downloadable filespecify a dash (''-''as the language code: ''%%<code - myfile.foo>%%''.+Si no deseas ningún resaltado de sintaxis pero deseas establecer que el fichero quede disponible para su descargadebes indicarlo con un guión medio (''-''como variable de la etiqueta code, de la siguiente forma: ''%%<code - micódigo.foo>%%''.
  
  
-===== Embedding HTML and PHP =====+===== Incrustado de HTML 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.)+Podrás incrustar código fuente HTML PHP en bruto a tus documentos utilizando las etiquetas ''%%<html>%%'' ''%%<php>%%''; utiliza mayúsculas si necesitas encerrar elementos de nivel de bloque.
  
-HTML example:+Ejemplo de HTML:
  
 <code> <code>
 <html> <html>
-This is some <span style="color:red;font-size:150%;">inline HTML</span>+Este es un <span style="color:red;font-size:150%;">código HTML en línea</span>
 </html> </html>
 <HTML> <HTML>
-<p style="border:2px dashed red;">And this is some block HTML</p>+<p style="border:2px dashed red;">Y esto es algún bloque HTML</p>
 </HTML> </HTML>
 </code> </code>
  
 <html> <html>
-This is some <span style="color:red;font-size:150%;">inline HTML</span>+Este es un <span style="color:red;font-size:150%;">código HTML en línea</span>
 </html> </html>
 <HTML> <HTML>
-<p style="border:2px dashed red;">And this is some block HTML</p>+<p style="border:2px dashed red;">Y esto es algún bloque HTML</p>
 </HTML> </HTML>
  
-PHP example:+Ejemplo de PHP:
  
 <code> <code>
 <php> <php>
-echo 'The PHP version: ';+echo 'La versión de PHP: ';
 echo phpversion(); echo phpversion();
-echo ' (generated inline HTML)';+echo ' (HTML generado en línea)';
 </php> </php>
 <PHP> <PHP>
-echo '<table class="inline"><tr><td>The samebut inside a block level element:</td>';+echo '<table class="inline"><tr><td>Lo mismopero dentro de un elemento de nivel de bloque:</td>';
 echo '<td>'.phpversion().'</td>'; echo '<td>'.phpversion().'</td>';
 echo '</tr></table>'; echo '</tr></table>';
Línea 478: Línea 475:
  
 <php> <php>
-echo 'The PHP version: ';+echo 'La versión de PHP: ';
 echo phpversion(); echo phpversion();
 echo ' (inline HTML)'; echo ' (inline HTML)';
 </php> </php>
 <PHP> <PHP>
-echo '<table class="inline"><tr><td>The samebut inside a block level element:</td>';+echo '<table class="inline"><tr><td>Lo mismopero dentro de un elemento de nivel de bloque:</td>';
 echo '<td>'.phpversion().'</td>'; echo '<td>'.phpversion().'</td>';
 echo '</tr></table>'; echo '</tr></table>';
 </PHP> </PHP>
  
-**Please Note**: HTML and PHP embedding is disabled by default in the configurationIf disabledthe code is displayed instead of executed.+**Por favor ten en cuenta**: Incrustar HTML PHP está desactivado por defecto en la configuración de nuestra WikiAl estar desactivadodicho código HTML o PHP se presenta en lugar de ejecutarse.
  
-===== RSS/ATOM Feed Aggregation ===== +===== Agregadores de Suscripción RSS/ATOM ===== 
-[[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http://simplepie.org/|SimplePie]] is usedAll formats understood by SimplePie can be used in DokuWiki as wellYou can influence the rendering by multiple additional space separated parameters:+[[DokuWiki]] es capaz de integrar datos de suscripciones XML externos; para ello se utiliza [[http://simplepie.org/|SimplePie]]. Pueden utilizarse todos los formatos comprendidos por SimplePie pueden utilizarse también en DokuWiki. Podrás influenciar sobre la manera en la cual se presentan utilizando parámetros separados por múltiples espacios en blanco adicionales:
  
-Parameter  Description +Parámetro  Descripción 
-| any number | will be used as maximum number items to showdefaults to 8 | +| any number | indica la cantidad máxima de ítems mostradospor defecto es 8 | 
-| reverse    | display the last items in the feed first +| reverse    | muestra los últimos ítems de la suscripción en primer lugar 
-| author     show item authors names +| author     Muestra los nombres de los autores de los ítems 
-| date       show item dates +| date       muestra las fechas de los ítems 
-| description| show the item descriptionIf [[doku>config:htmlok|HTML]] is disabled all tags will be stripped +| description| muestra la descripción del ítemSi [[doku>config:htmlok|HTML]] está desactivado, todas las etiquetas serán reducidas 
-| nosort     do not sort the items in the feed +| nosort     no ordena los ítems en la suscripción 
-| //n//[dhm] | refresh periodwhere d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). |+| //n//[dhm] | período de refrescodonde d=días, h=horas, m=minutos. (ej. 12h = 12 horas). |
  
-The refresh period defaults to hoursAny value below 10 minutes will be treated as 10 minutes. [[wiki:DokuWiki]] will generally try to supply a cached version of a pageobviously this is inappropriate when the page contains dynamic external contentThe parameter tells [[wiki:DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered.+El período de refresco por defecto es horasCualquier valor por debajo de los 10 minutos será tratado como si fuesen 10 minutos. [[wiki:DokuWiki]] generalmente intentará proveer una versión almacenada en caché de la páginaobviamente esto resulta apropiado cuando la página contiene contenido externo dinámicoEl parámetro indica a [[wiki:DokuWiki]] reinterpretar la página si han transcurrido más de un //peíodo de refresco// desde que la página se interpretó por última vez.
  
-By default the feed will be sorted by datenewest items firstYou can sort it by oldest first using the ''reverse'' parameteror display the feed as is with ''nosort''.+Por defecto la suscripción será ordenada por fechacon sus ítems más recientes al principioPodrás ordenarla indicando lo más antiguo primero utilizando el parámetro ''reverse'', o presentar la suscripción sin ordenar tal cual sea recibida, indicando el parámetro ''nosort''.
  
-**Example:**+**Ejemplo:**
  
   {{rss>http://slashdot.org/index.rss 5 author date 1h }}   {{rss>http://slashdot.org/index.rss 5 author date 1h }}
Línea 513: Línea 510:
  
  
-===== Control Macros =====+===== Macros de Control =====
  
-Some syntax influences how DokuWiki renders a page without creating any output it selfThe following control macros are availble:+Cierta sintaxis influencia cómo DokuWiki interpreta la página sin crear salida algunaLos macros de control disponibles son los siguientes:
  
-^ Macro           Description +^ Macro           Descripción 
-| %%~~NOTOC~~%%   If this macro is found on the page, no table of contents will be created +| %%~~NOTOC~~%%   Si encuentra este macro, no se creará tabla de contenidos 
-| %%~~NOCACHE~~%% | DokuWiki caches all output by defaultSometimes this might not be wanted (egwhen the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender page on every call |+| %%~~NOCACHE~~%% | DokuWiki almacena en caché toda la salida por defectoEsto podría no desearse (ejal utilizar la sintaxis %%<php>%% arriba descripta); agregar este macro fuerza a DokuWiki a presentar una página en cada llamada |
  
-===== Syntax Plugins =====+===== Plugins de Sintaxis =====
  
-DokuWiki's syntax can be extended by [[doku>plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pagesThe following syntax plugins are available in this particular DokuWiki installation:+La sintaxis de DokuWiki puede ser extendida merced de los [[doku>plugins|Plugins]]. La forma de instalar dichos plugins y utilizarlos está descripta en sus páginas específicas. Los siguientes plugins de sintaxis están disponibles en esta instalación DokuWiki particular:
  
 ~~INFO:syntaxplugins~~ ~~INFO:syntaxplugins~~
  • sintaxis_de_wiki.1647096398.txt.gz
  • Última modificación: 2022/03/12 14:46
  • por peron