Formatear texto en TWiki

Trabajar en TWiki es igual de fácil que digitar un texto - exactamente como correos electrónicos. No necesita saber HTML, aunque puede utilizarlo si prefiere. Los enlaces a otras páginas serán creados automáticamente cuando se utiliza una PalabraWiki. Y la taquigrafía TWiki le permite utilizar las posibilidades de HTML por medio de un sistema sencillo de codificación que no necesita mucho tiempo para aprenderse. Se lo explicamos a continuación - refiérese a esta página en una ventana emergente desde la sección Editar.

Taquigrafía TWiki para manipular documentos

Comando para formatear:	Usted escribe:	Se ve:
Párafos: Lineas vacías crearán párafos nuevos.	Primer párafo Segundo párafo	Primer párafo Segundo párafo
Títulos: Tres o más guiones al principio de una linea, seguidos por el símbolo más y el texto del título. Un más creará un título de primer nivel, dos más uno de segundo nivel, etc. Se puede introducir máximo 6 niveles de títulos. Puede crear un índice con la variable %TOC%. Si quiere excluir un título del índice, digite !! después de ---+. Se permite títulos vacíos, pero no aparecerán en el índice.	---++ Sushi ---+++ Maguro ---+++!! No estará en índice	Sushi Maguro No estará en índice
Texto en negrita: Palabras se mostrarán en negrita cuando uno las encierre en * asteriscos.	*Negrita*	Negrita
Texto en cursiva: Palabras se mostrarán en cursiva cuando uno las encierre en _ guiones abajo.	_Cursiva_	Cursiva
Negrita y cursiva: Palabras se mostrarán en negrita y cursiva cuando uno las encierre en __ dos guiones abajo.	__Negrita y cursiva__	Negrita y cursiva
Fuentes de espaciado fijo: Palabras se mostrarán con espaciado fijo cuando uno las encierre en = el símbolo igual.	=Fuentes de espaciado fijo=	Fuentes de espaciado fijo
Fuentes de espaciado fijo en negrita: Palabras se mostrarán con espaciado fijo y en negrita cuando uno las encierre en dos símbolos igual.	==Espaciado fijo en negrita==	Espaciado fijo en negrita
Después del segundo indicador para negrita, cursiva, etc. (* _ __ = ==) puede continuar con la punctuación normal, como comas o puntos. Asegúrese que no haya ningun espacio entre el texto y el indicador.	_Eso funciona_, _eso no funciona _	Eso funciona, _eso no funciona _
Texto literal: Encierre extractos de código y otro tipo de texto con los comandos <verbatim> y </verbatim>. El comando verbatim deshabilita el código HTML. Si requiere la interpretación del código HTML dentro del texto encerrado, use los comandos <pre> y </pre> en lugar del comando anterior. NOTE: Variables predeterminadas (* Set NOMBRE = valor) se encierran en determinadores de texto literal.	<verbatim> class CatAnimal { void purr() { <code here> } } </verbatim>	class CatAnimal { void purr() { <code here> } }
Separador horizontal Rule: Tres o más guiones al principio de una linea.	-------
Listas con viñetas: Multiples de tres espacios, un asterisco y otro espacio. En todos los tipos de listas, se puede fraccionar cada item en varias lineas por sangrar las lineas después de la primera por mínimo tres espacios.	* nivel 1 * nivel 2 * regresando a nivel 1 * Un ítem fraccionado en tres lineas * último ítem	nivel 1 nivel 2 regresando a nivel 1 Un ítem fraccionado en tres lineas último ítem
Listas enumeradas: Multiples de tres espacios, una letra indicando el tipo de enumeracón, un punto y otro espacio. Aparte de número, otros tipos de lista están disponibles: Tipo Estilo generado Ejemplo de secuencia 1. Números árabes 1, 2, 3, 4... A. Mayúscula A, B, C, D... a. Minúscula a, b, c, d... I. Números romanos en mayúscula I, II, III, IV... i. Números romanos en minúscula i, ii, iii, iv...	1. Sushi 1. Dim Sum 1. Fondue A. Sushi A. Dim Sum A. Fondue i. Sushi i. Dim Sum i. Fondue	Sushi Dim Sum Fondue Sushi Dim Sum Fondue Sushi Dim Sum Fondue
Listas de definición: Tres espacios, el símbolo dolar, el término a definir, dos puntos, un espacio y después la definición.	$ Sushi: Japan $ Dim Sum: S.F.	Sushi Japan Dim Sum S.F.
Tablas: Cada fila de una tabla en una linea que contenga una o más celdas. Cada celda empieza y termina con una linea vertical '|'. Espacios al inicio de una linea serán ignorados. | *bold* | celda de título con texto encerrado en asteriscos |   celda centrada   | celda con mínimo dos, y una cantidad igual de espacios en ambos lados |      alineada a la derecha | celda con más espacios en el lado izquierdo | 2 celdas unidas || y varias celdas unidas horizontalmente con varias lineas verticales una a la par de la otra |^| celda con acento circunflejo indica la union de celdas vertical Se puede fraccionar filas en varias lineas utilizando la barra invertida '\' al final de cada linea El contenido de las celdas de una tabla se ajusta automáticamente al tamaño determinado por el explorador Use &#124; o %VBAR% para agregar símbolos del tipo | en tablas.	| *L* | *C* | *R* | | A2 | B2 | C2 | | A3 | B3 | C3 | | columnas unidas ||| | A5-7 | 5 | 5 | |^| six | six | |^| seven | seven | | fraccionado\ | en\ | 3 lineas | | A9 | B9 | C9 |	L C R A2 B2 C2 A3 B3 C3 columnas unidas A5-7 5 5 six six seven seven fraccionado en 3 lineas A9 B9 C9
Enlaces de tipo PalabraWiki: PalabrasPegadasConMayusculas (o PalabrasWiki) generarán automáticamente un enlace cuando siga un espacio o paréntesis. Si quiere generar un enlace a otro grupo o red, escribe OtraRed.NombreDelTema. El texto del enlace que se presenta en la página final excluye el nombre de la red. Quiere decir que se muestra solamente el nombre del tema. Como excepción, se muestra el nombre de la red del tema WebHome. En general se recomienda utilizar las TWikiVariables %TWIKIWEB% y %MAINWEB% en lugar de las palabras TWiki y Main.	WebStatistics Sandbox.WebNotify Sandbox.WebHome	WebStatistics WebNotify Sandbox
Anclas: Se puede definir una referencia dentro de un tema (se llama palabra ancla) y enlazar un texto a esta ancla. Para definir una ancla, escribe #PalabraAncla al inicio de una linea. La ancla debe ser una PalabraWiki. Para enlazar a a una palabra ancla, utilice la sintaxis [[ElTema#LaPalabraAncla]]. Puede omitir el nombre del tema si la palabra ancla está dentro del mismo.	[[PalabraWiki#NoEsta]] [[#LaPalabraAncla][Saltar]] #LaPalabraAncla aquí	PalabraWiki#NoEsta Saltar aquí
Enlaces forzados: Se puede crear un enlace interno forzado encerrando palabras en doble corchete. Texto dentro de los corchetes puede contener espacios obcionales; el nombre del tema será formado escribiendo la primera letra en mayúscula y removiendo los espacios; por ejemplo, [[text formatting FAQ]] enlaza al tema PreguntasSobreFormatearTexto. De la misma manera puede referirse a otra red y utilizar anclas. Para escribir dos corchetes que normalmente generarían un enlace, ponga un signo de exclamación delante del primer corchete.	[[wiki syntax]] [[Main.TWiki users]] para evitar enlace: ![[wiki syntax]]	TWiki.wiki syntax Main.TWiki users para evitar enlace: [[wiki syntax]]
Enlaces específicos: Puede crear enlaces done especifica la etiqueta del enlace y el enlace en si por separado utilizando corchetes anidados [[enlace][etiqueta]]. Se permite con ambas opciones, enlaces internos (por ejemplo WikiSyntax) y direcciones del internet (por ejemplo http://TWiki.org/). Las reglas establecidas en Enlaces forzados también aplican para enlaces internos. Se puede añadir palabras ancla también para crear enlaces que se refieren a un lugar específico dentro del documento.	[[WikiSyntax][wiki syntax]] [[http://gnu.org][GNU]]	wiki syntax GNU
Impedir un enlace: Para impedir que una PalabraWiki sea transformada automáticamente a un enlace, digite un signo de exclamación antes de la palabra correspondiente.	!SunOS	SunOS
Deshabilitar enlaces: Puede deshabilitar la generación automática de enlaces de PalabrasWiki encerrando las partes correspondientes con <noautolink> y </noautolink>. Es posible apagar completamente la generación automática de enlaces, utilizando la preferencia NOAUTOLINK.	<noautolink> RedHat & SuSE </noautolink>	RedHat & SuSE
Direcciones de correo electrónico: Direcciones de correo electrónico serán convertidas en enlaces automáticamente. Para crear enlaces de correo electrónico que tengan una etiqueta específica, especifiquen asuntos o partes del mensaje o omiten la dirección de correo electrónico, puede escribir [[mailto:user@domain][etiqueta específica]].	a@b.com [[mailto:a@b.com]\ [Mail]] [[mailto:?subject=\ Hi][Hi]]	a@bPLEASENOSPAM.com Mail Hi
Contenido literal: TWiki convierte la taquigrafía TWiki a código HTML. Expertos ponen todo que debe ser interpretado literalmente como código HTML, sin la aplicación de las reglas de taquigrafía TWiki, dentro de los comandos <literal>..</literal>. cualquier HTML que está dentro de estos comandos tiene que ser bien escrito, quiere decir que todos los comandos deben ser cerrados antes de que termine el bloque de contenido literal. Variables TWiki serán interpretados dentro de bloques de contenido literal.	<literal> | No | es | una tabla | <literal>	| No | es | una tabla |
Contendio protegido: Expertos protegen texto de la manipulación por editores WYSIWYG utilizando los comandos <sticky>..</sticky>. Los comandos Sticky no tienen ningún efecto a la presentación de una página; son relevantes únicamente cuando hay que proteger contenido de editores WYSIWYG (generalmente porque contiene HTML no bien escrito o porque es HTML que el editor WYSIWYG filtraría o modificaría). Contenido protegido aparece como texto sencillo en el editor WYSIWYG.	<sticky> <div> Este div es necesario </div> </sticky>	Este div es necesario

Utilizando HTML

Puede utilizar las etiquetas (inglés: tags) de HTML sin ningún problema. Puede agregar HTML si en TWiki no hay ningún comando correspondiente. Por ejemplo, escriba <strike>texto tachado</strike> para obtener texto tachado.

Hay unas consideraciones técnicas y con respecto al uso que se deben tomar en consideración:

• En páginas donde aporta varia gente, es mejor no utilizar HTML, sino Taquigrafía TWiki - eso mantiene limpio el código de la página y facilita su lectura.
• Si utliza HTML, refiérese a la sintaxis XHTML 1.0 Transitional.
• Comandos de programación pueden ser bloqueados, dependiendo de la configuración del sistema.

Recomendaciones cuando pegue HTML de otras fuentes:

• Copie solamente texto que está entre las etiquetas <body> y </body>
• Remueve todas las lineas vacías. TWiki generará etiquetas de párafo <p /> en lineas vacías que puedan causar problemas si están entre etiquetas que lo no permiten, como por ejemplo entre etiquetas de tabla <table></table>.
• Remueve espacios que están al principio de lineas. TWiki podría interpretarlas como listas.
• No fraccione etiquetas en varias lineas. TWiki requiere que las paréntesis de apertura y de cierre - <...> - de las etiquetas HTMO están en la misma linea. Si no, la etiqueta no va a funcionar.
• En su editor de HTML, guarde sin saltos de lineas forzados cuando utiliza ajustes de texto.

TWiki convierte la notación en taquigrafía a HTML para efectos de presentación de la página. Para copiar el código completo de una página, simplemente revise el código fuente de la página en su navegador y guarde el contenido. Si necesita guardar el código fuente frequentemente, tal vez quiera revisar TWiki:Plugins/PublishAddOn.

Etiquetas de aplicaciones de gestión

Puede utilizar las etiquetas HTML para aplicaciones de gestión <script> para su página. Sin embargo tome en consideración que el administrador puede bloquear <script> en páginas por motivos de seguridad. Los comandos de TWiki y TWikiVariables no son interpretados cuando estén entre etiquetas de aplicaciones de gestión.

Hipervínculos

Tener la oportunidad de crear enlaces sin algún tipo de formato especial es una característica clave de TWiki. Los enlaces se realizan por medio de WikiWords y URLs metidos dentro del texto.

Enlaces internos

• BuenEstilo? es una PalabraWiki? que enlaza a la página GoodStyle ubicada en la web actual.
• TodaviaNoExiste? es una página que está esperando a ser escrita. Puede crear la página tocando el ?. (Pruebe tocarlo, pero después toque "Cancel" - crear la página echaría a perder este ejemplo!)

Enlaces externos

• http://..., https://..., ftp://..., gopher://..., news://..., file://..., telnet://... and mailto:...@... serán convertidos a enlaces automaticamente.
• Direcciones de correo electrónico como name@domain.com serán convertidas a enlaces automáticamente.

• [[Utilizando corchetes]] se le permite crear facilmente enlaces que no sean WikiWords.
  • También puede escribir [[http://yahoo.com Yahoo home page]] como una forma más sencilla de crear enlaces externos con algún texto descriptivo, como por ejemplo Yahoo home page.

Variables de TWiki

TWiki Variables are names that are enclosed in percent signs % that are expanded on the fly. Some variables take arguments, such as %INCLUDE%. For those variables, the arguments are included in curly braces ({ and }).

TWikiPreferences defines some site-wide variables. Among them are:

• Line break: Write %BR% to start a new line.
• Colored text: Write: %RED% Red %ENDCOLOR% and %BLUE% blue %ENDCOLOR% colors to get: Red and blue colors.

There are many more variables. To see them all, go to TWikiVariables.

Documentation Graphics: There are many graphics available to use in your topics. Use %ICON{"help"}%, %ICON{"tip"}%, and %ICON{"warning"}% to get: , , and , respectively. TWikiDocGraphics lists them all.

To "escape" a variable, prefix it with an exclamation mark. Write: !%SOMEVARIABLE% to get: %SOMEVARIABLE%.

Extensiones (TWikiPlugins) para formatear

Plugins amplian la funcionalidad de TWiki en muchos campos diferentes. Hay una gran cantidad de TWiki plugins que está disponible en la red Plugins en TWiki.org.

Actualmente se encuentran las siguientes extensiones instaladas en este sistema, listadas por %PLUGINDESCRIPTIONS%:

• SpreadSheetPlugin (any TWiki, 10197): Add spreadsheet calculation like "$SUM( $ABOVE() )" to TWiki tables and other topic text
• CommentPlugin (TWiki-4, $Rev: 14736 (05 Sep 2007) $): Allows users to quickly post comments to a page without an edit/preview/save cycle
• BlackListPlugin (any TWiki, 13186): Utility to keep malicious users away from a public TWiki site
• ChartPlugin (1.401): Create PNG or GIF charts to visualize TWiki tables
• EditTablePlugin (any TWiki, 11646): Edit TWiki tables using edit fields, date pickers and drop down boxes
• GaugePlugin (1.003): Build dashboards that contain graphical images of gauges defined with %GAUGE{}% variables.
• InterwikiPlugin (Dakar, $Rev: 11935$): Link ExternalSite:Page text to external sites based on aliases defined in a rules topic
• LocalCityTimePlugin (1.011): Shows the local time of a city embedded in a TWiki topic.
• PerlDocPlugin (1.001): Extract the Perl documentation (POD) from a Perl module and display it in a topic.
• PreferencesPlugin (Dakar, 9839): Allows editing of preferences using fields predefined in a form
• RenderListPlugin (any TWiki, 1.034): Render bullet lists in a variety of formats
• SlideShowPlugin (Any TWiki, $Rev: 12013$): Create web based presentations based on topics with headings.
• SmiliesPlugin (Dakar, 8154): Render smilies as icons, like for  :-) or for = :eek:=
• TWikiDrawPlugin (Dakar, 8154): Java Applet based drawing editor
• TWikiOrgPlugin (1.001): TWiki.org specific extensions
• TablePlugin (1.020, 12339): Control attributes of tables and sorting of table columns
• TagMePlugin (Any TWiki, 1.032): Tag wiki content collectively to find content by keywords
• TopicCreatePlugin (1.000): Automatically create a set of topics and attachments at topic save time
• TwistyPlugin (1.2.0, $Rev: 12154$): Twisty section JavaScript library to open/close content dynamically
• VarCachePlugin (Dakar, 8154): Cache TWiki variables in selected topics for faster page rendering
• WysiwygPlugin (Dakar, 12422): Translator framework for Wysiwyg editors

Revise el estado de estas extensiones y su configuración en TWikiPreferences.

Errores comunes de edición

Las reglas para formatear TWiki son bastante fáciles de aplicar y rápidos de digitar. Sin embargo, hay algunas cosillas que hay que tomar en consideración, que también están incluidas en la lista de preguntas frecuentes TextFormattingFAQ:

• P: Texto encerrado en los signos mayor o menor que como por ejemplo <nombre de archivo> no se muestran en la página. Cómo hago para que se muestren tal como están?
  • R: Los signos '<' y '>' tienen un significado especial en el idioma de programación HTML; definen etiquetas de HTML. Tiene que protegerlos, quiere decir que tiene que escribir '<' en lugar de '<' y '>' en lugar de '>'.
    Ejemplo: 'prog <nombre del archivo>' para que se muestre como 'prog <nombre del archivo>'.

• P: Por qué a veces no se muestra el signo '&'?
  • R: El signo '&' tiene un significado especial en HTML; inicializa una expresión especial. Por ejemplo '©' es el signo de copyright ©. Tiene que proteger '&' para poder verlo como tal, quiere decir que tiene que digitar '&' en lugar de '&'.
    Ejemplo: Digite 'Eso & lo otro' para obtener 'Eso & lo otro'.

-- Contributors: SebastianKlus - 15 Mar 2008

Discussion