Muestra las diferencias entre dos versiones de la página.
Próxima revisión | Revisión previa Próxima revisión Ambos lados, revisión siguiente | ||
wiki:syntax [2014/05/28 01:44] 127.0.0.1 editor externo |
wiki:syntax [2017/09/27 19:15] admin |
||
---|---|---|---|
Línea 1: | Línea 1: | ||
- | ====== | + | ====== |
- | [[doku>DokuWiki]] | + | [[DokuWiki]] |
- | ===== Basic Text Formatting | + | ===== Formato básico de texto ===== |
- | DokuWiki | + | DokuWiki |
- | DokuWiki | + | DokuWiki |
- | | + | |
- | You can use <sub>subscript</ | + | También puedes usar <sub>subíndices</ |
- | | + | |
- | You can mark something as <del>deleted</ | + | Del mismo modo, también puedes marcar algo como <del>borrado</ |
- | | + | |
- | **Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line. | + | Los **párrafos** se crean a partir de líneas en blanco. Si quieres |
- | This is some text with some linebreaks\\ Note that the | + | Esto es un texto con algunos saltos de línea.\\ Advierte que las |
- | two backslashes are only recognized at the end of a line\\ | + | dos barras invertidas son reconocidas solamente al final de una línea\\ |
- | or followed by\\ a whitespace | + | o cuando están seguidas de\\ un espacio en blanco |
- | | + | |
- | | + | |
- | | + | |
- | You should use forced newlines only if really needed. | + | Solamente deberías forzar saltos de línea cuando realmente lo necesites. |
- | ===== Links ===== | ||
- | DokuWiki supports multiple ways of creating links. | ||
- | ==== External ==== | ||
- | External links are recognized automagically: | + | ===== Enlaces ===== |
- | | + | DokuWiki |
- | | + | ==== Externos ==== |
- | link text as well: [[http:// | + | |
- | addresses like this one: < | + | |
- | ==== Internal ==== | + | Los enlaces externos se reconocen automáticamente: |
- | Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]]. | + | Dokuwiki soporta múltiples formas de crear enlaces. Los enlaces externos se reconocen |
+ | automáticamente: | ||
+ | establecer enlaces con nombre: | ||
+ | Las direcciones de correo electrónico como ésta: < | ||
+ | también son reconocidas. | ||
- | Internal links are created by using square brackets. You can either just give | + | **Nota**: para los enlaces con nombre hay que usar el caracter separador | (barra vertical). A la izquierda del separador va la dirección del enlace y a la derecha el nombre del enlace.\\ |
- | | + | Algunos teclados lo tienen en la tecla del número 1 y se obtiene presionando dicha tecla simultánemamnte con AltGr.\\ |
+ | Si no tuvieras en tu teclado el caracter separador, **en Windows** se consigue mediante la combinación //alt+124// (tecleando con el teclado numérico).\\ | ||
+ | Si no te funcionaran ninguno de los dos métodos anteriores (puede ocurrir en Mac, en Linux y en notebooks sin teclado numérico) puedes copiar el siguiente texto para construir un enlace con nombre: | ||
+ | < | ||
+ | Pégalo en tu documento y luego reemplaza ' | ||
- | [[doku> | + | ==== Internos ==== |
- | You can use [[some:namespaces]] by using a colon in the pagename. | + | Los enlaces internos se crean mediante corchetes. Puedes tanto simplemente usar [[doku>es:pagename|pagename]] como usar el extendido[[doku> |
- | | + | |
- | + | | |
- | For details about namespaces see [[doku>namespaces]]. | + | a minúsculas automáticamente y no se permiten caracteres especiales. |
- | + | ||
- | Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to [[syntax# | + | |
- | + | ||
- | This links to [[syntax# | + | |
- | + | ||
- | Notes: | + | |
- | + | ||
- | * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones. | + | |
- | | + | |
- | * When a section' | + | |
- | + | ||
- | ==== Interwiki ==== | + | |
- | + | ||
- | DokuWiki supports [[doku> | + | |
- | + | ||
- | DokuWiki supports [[doku> | + | |
- | For example this is a link to Wikipedia' | + | |
- | + | ||
- | ==== Windows Shares ==== | + | |
- | + | ||
- | Windows shares like [[\\server\share|this]] are recognized, too. Please note that these only make sense in a homogeneous user group like a corporate [[wp> | + | |
- | + | ||
- | Windows Shares like [[\\server\share|this]] are recognized, too. | + | |
- | + | ||
- | Notes: | + | |
- | + | ||
- | * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone" | + | |
- | * For Mozilla and Firefox it can be enabled through different workaround mentioned in the [[http:// | + | |
- | + | ||
- | LANG.nosmblinks = ''; | + | |
- | + | ||
- | ==== Image Links ==== | + | |
- | + | ||
- | You can also use an image to link to another internal or external page by combining the syntax for links and [[# | + | |
- | + | ||
- | [[http:// | + | |
- | + | ||
- | [[http:// | + | |
- | + | ||
- | Please note: The image formatting is the only formatting syntax accepted in link names. | + | |
- | + | ||
- | The whole [[# | + | |
- | + | ||
- | ===== Footnotes ===== | + | |
- | + | ||
- | You can add footnotes ((This is a footnote)) by using double parentheses. | + | |
- | + | ||
- | | + | |
- | + | ||
- | ===== Sectioning ===== | + | |
- | + | ||
- | You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically -- this can be disabled by including the string ''< | + | |
- | + | ||
- | ==== Headline Level 3 ==== | + | |
- | === Headline Level 4 === | + | |
- | == Headline Level 5 == | + | |
- | + | ||
- | ==== Headline Level 3 ==== | + | |
- | === Headline Level 4 === | + | |
- | == Headline Level 5 == | + | |
- | + | ||
- | By using four or more dashes, you can make a horizontal line: | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | ===== Media Files ===== | + | |
- | + | ||
- | You can include external and internal [[doku> | + | |
- | + | ||
- | Real size: {{wiki: | + | |
- | + | ||
- | Resize to given width: | + | |
- | + | ||
- | Resize to given width and height((when the aspect ratio of the given width and height doesn' | + | |
- | + | ||
- | Resized external image: | + | |
- | + | ||
- | Real size: {{wiki: | + | |
- | Resize to given width: | + | |
- | Resize to given width and height: {{wiki: | + | |
- | Resized external image: | + | |
- | + | ||
- | + | ||
- | By using left or right whitespaces you can choose the alignment. | + | |
- | + | ||
- | {{ wiki: | + | |
- | + | ||
- | {{wiki: | + | |
- | + | ||
- | {{ wiki: | + | |
- | + | ||
- | {{ wiki: | + | |
- | {{wiki: | + | |
- | {{ wiki: | + | |
- | + | ||
- | Of course, you can add a title (displayed as a tooltip by most browsers), too. | + | |
- | + | ||
- | {{ wiki: | + | |
- | + | ||
- | {{ wiki: | + | |
- | + | ||
- | For linking an image to another page see [[#Image Links]] above. | + | |
- | + | ||
- | ==== Supported Media Formats ==== | + | |
- | + | ||
- | DokuWiki can embed the following media formats directly. | + | |
- | + | ||
- | | Image | '' | + | |
- | | Video | '' | + | |
- | | Audio | '' | + | |
- | | Flash | '' | + | |
- | + | ||
- | If you specify a filename that is not a supported media format, then it will be displayed as a link instead. | + | |
- | + | ||
- | ==== Fallback Formats ==== | + | |
- | + | ||
- | Unfortunately not all browsers understand all video and audio formats. To mitigate the problem, you can upload your file in different formats for maximum browser compatibility. | + | |
- | + | ||
- | For example consider this embedded mp4 video: | + | |
- | + | ||
- | {{video.mp4|A funny video}} | + | |
- | + | ||
- | When you upload a '' | + | |
- | + | ||
- | Additionally DokuWiki supports a " | + | |
- | + | ||
- | ===== Lists ===== | + | |
- | + | ||
- | Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a '' | + | |
- | + | ||
- | * This is a list | + | |
- | * The second item | + | |
- | * You may have different levels | + | |
- | * Another item | + | |
- | + | ||
- | - The same list but ordered | + | |
- | - Another item | + | |
- | - Just use indention for deeper levels | + | |
- | - That's it | + | |
- | + | ||
- | < | + | |
- | * This is a list | + | |
- | * The second item | + | |
- | * You may have different levels | + | |
- | * Another item | + | |
- | + | ||
- | - The same list but ordered | + | |
- | - Another item | + | |
- | - Just use indention for deeper levels | + | |
- | - That's it | + | |
- | </ | + | |
- | + | ||
- | Also take a look at the [[doku> | + | |
- | + | ||
- | ===== Text Conversions ===== | + | |
- | + | ||
- | DokuWiki can convert certain pre-defined characters or strings into images or other text or HTML. | + | |
- | + | ||
- | The text to image conversion is mainly done for smileys. And the text to HTML conversion is used for typography replacements, | + | |
- | + | ||
- | ==== Text to Image Conversions ==== | + | |
- | + | ||
- | DokuWiki converts commonly used [[wp> | + | |
- | + | ||
- | * 8-) %% 8-) %% | + | |
- | * 8-O %% 8-O %% | + | |
- | * :-( %% :-( %% | + | |
- | * :-) %% :-) %% | + | |
- | * =) %% =) %% | + | |
- | * :-/ %% :-/ %% | + | |
- | * :-\ %% :-\ %% | + | |
- | * :-? %% :-? %% | + | |
- | * :-D %% :-D %% | + | |
- | * :-P %% :-P %% | + | |
- | * :-O %% :-O %% | + | |
- | * :-X %% :-X %% | + | |
- | * :-| %% :-| %% | + | |
- | * ;-) %% ;-) %% | + | |
- | * ^_^ %% ^_^ %% | + | |
- | * :?: %% :?: %% | + | |
- | * :!: %% :!: %% | + | |
- | * LOL %% LOL %% | + | |
- | * FIXME %% FIXME %% | + | |
- | * DELETEME %% DELETEME %% | + | |
- | + | ||
- | ==== Text to HTML Conversions ==== | + | |
- | + | ||
- | Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entities. Here is an example of recognized characters. | + | |
- | + | ||
- | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | + | |
- | "He thought ' | + | |
- | + | ||
- | < | + | |
- | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | + | |
- | "He thought ' | + | |
- | </ | + | |
- | + | ||
- | The same can be done to produce any kind of HTML, it just needs to be added to the [[doku> | + | |
- | + | ||
- | There are three exceptions which do not come from that pattern file: multiplication entity (640x480), ' | + | |
- | + | ||
- | ===== Quoting ===== | + | |
- | + | ||
- | Some times you want to mark some text to show it's a reply or comment. You can use the following syntax: | + | |
- | + | ||
- | I think we should do it | + | |
| | ||
- | > No we shouldn' | + | Puedes usar [[doku>es:pagename|pagename]] mediante dos puntos en el nombre de la página. |
- | + | ||
- | >> Well, I say we should | + | |
- | + | ||
- | > Really? | + | |
- | + | ||
- | >> Yes! | + | |
- | + | ||
- | >>> | + | |
- | + | ||
- | I think we should do it | + | |
- | + | ||
- | > No we shouldn' | + | |
- | + | ||
- | >> Well, I say we should | + | |
- | + | ||
- | > Really? | + | |
- | + | ||
- | >> Yes! | + | |
- | + | ||
- | >>> | + | |
- | + | ||
- | ===== Tables ===== | + | |
- | + | ||
- | DokuWiki supports a simple syntax to create tables. | + | |
- | + | ||
- | ^ Heading 1 ^ Heading 2 ^ Heading 3 ^ | + | |
- | | Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 | | + | |
- | | Row 2 Col 1 | some colspan (note the double pipe) || | + | |
- | | Row 3 Col 1 | Row 3 Col 2 | Row 3 Col 3 | | + | |
- | + | ||
- | Table rows have to start and end with a '' | + | |
- | + | ||
- | ^ Heading 1 ^ Heading 2 ^ Heading 3 ^ | + | |
- | | Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 | | + | |
- | | Row 2 Col 1 | some colspan (note the double pipe) || | + | |
- | | Row 3 Col 1 | Row 3 Col 2 | Row 3 Col 3 | | + | |
- | + | ||
- | To connect cells horizontally, | + | |
- | + | ||
- | Vertical tableheaders are possible, too. | + | |
- | + | ||
- | | ^ Heading 1 ^ Heading 2 ^ | + | |
- | ^ Heading 3 | Row 1 Col 2 | Row 1 Col 3 | | + | |
- | ^ Heading 4 | no colspan this time | | | + | |
- | ^ Heading 5 | Row 2 Col 2 | Row 2 Col 3 | | + | |
- | + | ||
- | As you can see, it's the cell separator before a cell which decides about the formatting: | + | |
- | + | ||
- | | ^ Heading 1 ^ Heading 2 ^ | + | |
- | ^ Heading 3 | Row 1 Col 2 | Row 1 Col 3 | | + | |
- | ^ Heading 4 | no colspan this time | | | + | |
- | ^ Heading 5 | Row 2 Col 2 | Row 2 Col 3 | | + | |
- | + | ||
- | You can have rowspans (vertically connected cells) by adding '':::'' | + | |
- | + | ||
- | ^ Heading 1 ^ Heading 2 ^ Heading 3 ^ | + | |
- | | Row 1 Col 1 | this cell spans vertically | Row 1 Col 3 | | + | |
- | | Row 2 Col 1 | ::: | Row 2 Col 3 | | + | |
- | | Row 3 Col 1 | ::: | Row 2 Col 3 | | + | |
- | + | ||
- | Apart from the rowspan syntax those cells should not contain anything else. | + | |
- | + | ||
- | ^ Heading 1 ^ Heading 2 ^ Heading 3 ^ | + | |
- | | Row 1 Col 1 | this cell spans vertically | Row 1 Col 3 | | + | |
- | | Row 2 Col 1 | ::: | Row 2 Col 3 | | + | |
- | | Row 3 Col 1 | ::: | Row 2 Col 3 | | + | |
- | + | ||
- | You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text. | + | |
- | + | ||
- | ^ Table with alignment | + | |
- | | | + | |
- | |left | | + | |
- | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | + | |
- | + | ||
- | This is how it looks in the source: | + | |
- | + | ||
- | ^ Table with alignment | + | |
- | | | + | |
- | |left | | + | |
- | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | + | |
- | + | ||
- | Note: Vertical alignment is not supported. | + | |
- | + | ||
- | ===== No Formatting ===== | + | |
- | + | ||
- | If you need to display text exactly like it is typed (without any formatting), | + | |
- | + | ||
- | < | + | |
- | This is some text which contains addresses like this: http:// | + | |
- | </ | + | |
- | The same is true for %%// | + | |
- | + | ||
- | < | + | |
- | This is some text which contains addresses like this: http:// | + | |
- | </ | + | |
- | The same is true for %%// | + | |
- | + | ||
- | ===== Code Blocks ===== | + | |
- | + | ||
- | You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags '' | + | |
- | + | ||
- | This is text is indented by two spaces. | + | |
- | + | ||
- | < | + | |
- | This is preformatted code all spaces are preserved: like <-this | + | |
- | </ | + | |
- | + | ||
- | < | + | |
- | This is pretty much the same, but you could use it to show that you quoted a file. | + | |
- | </ | + | |
- | + | ||
- | Those blocks were created by this source: | + | |
- | + | ||
- | This is text is indented by two spaces. | + | |
- | + | ||
- | < | + | |
- | This is preformatted code all spaces are preserved: like <-this | + | |
- | </ | + | |
- | + | ||
- | < | + | |
- | This is pretty much the same, but you could use it to show that you quoted a file. | + | |
- | </ | + | |
- | + | ||
- | ==== Syntax Highlighting ==== | + | |
- | + | ||
- | [[wiki: | + | |
- | + | ||
- | <code java> | + | |
- | /** | + | |
- | * The HelloWorldApp class implements an application that | + | |
- | * simply displays "Hello World!" | + | |
- | */ | + | |
- | class HelloWorldApp { | + | |
- | public static void main(String[] args) { | + | |
- | System.out.println(" | + | |
- | } | + | |
- | } | + | |
- | </ | + | |
- | + | ||
- | The following language strings are currently recognized: //4cs, 6502acme, 6502kickass, | + | |
- | + | ||
- | ==== Downloadable Code Blocks ==== | + | |
- | + | ||
- | When you use the '' | + | |
- | + | ||
- | < | + | |
- | <file php myexample.php> | + | |
- | <?php echo "hello world!"; | + | |
- | </ | + | |
- | </ | + | |
- | + | ||
- | <file php myexample.php> | + | |
- | <?php echo "hello world!"; | + | |
- | </ | + | |
- | + | ||
- | If you don't want any highlighting but want a downloadable file, specify a dash ('' | + | |
- | + | ||
- | + | ||
- | ===== Embedding HTML and PHP ===== | + | |
- | + | ||
- | You can embed raw HTML or PHP code into your documents by using the '' | + | |
- | + | ||
- | HTML example: | + | |
- | + | ||
- | < | + | |
- | < | + | |
- | This is some <span style=" | + | |
- | </ | + | |
- | < | + | |
- | <p style=" | + | |
- | </ | + | |
- | </ | + | |
- | + | ||
- | < | + | |
- | This is some <span style=" | + | |
- | </ | + | |
- | < | + | |
- | <p style=" | + | |
- | </ | + | |
- | + | ||
- | PHP example: | + | |
- | + | ||
- | < | + | |
- | < | + | |
- | echo 'The PHP version: '; | + | |
- | echo phpversion(); | + | |
- | echo ' (generated inline HTML)'; | + | |
- | </ | + | |
- | < | + | |
- | echo '< | + | |
- | echo '< | + | |
- | echo '</ | + | |
- | </ | + | |
- | </ | + | |
- | + | ||
- | < | + | |
- | echo 'The PHP version: '; | + | |
- | echo phpversion(); | + | |
- | echo ' (inline HTML)'; | + | |
- | </ | + | |
- | < | + | |
- | echo '< | + | |
- | echo '< | + | |
- | echo '</ | + | |
- | </ | + | |
- | + | ||
- | **Please Note**: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed. | + | |
- | + | ||
- | ===== RSS/ATOM Feed Aggregation ===== | + | |
- | [[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http:// | + | |
- | + | ||
- | ^ Parameter | + | |
- | | any number | will be used as maximum number items to show, defaults to 8 | | + | |
- | | reverse | + | |
- | | author | + | |
- | | 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: | + | |
- | + | ||
- | **Example: | + | |
- | + | ||
- | {{rss> | + | |
- | + | ||
- | {{rss> | + | |
- | + | ||
- | + | ||
- | ===== Control Macros ===== | + | |
- | Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble: | + | Puedes usar [[doku> |
- | ^ Macro ^ Description | + | Para más detalles sobre espacios de nombres mira [[doku> |
- | | %%~~NOTOC~~%% | + | |
- | | %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%< | + | |
- | ===== Syntax Plugins ===== | + | Es también posible enlazar con una sección específica. Basta con añadir el nombre de sección detrás de una almohadilla, |
- | DokuWiki' | + | Esto enlaza a [[es: |
- | ~~INFO:syntaxplugins~~ | + | Notas: |
+ | * Los enlaces a [[es: | ||
+ | * DokuWiki no utiliza [[wp> | ||
+ | * Cuando se cambia el encabezamiento de una sección, su bookmark también cambia. Así que no dependas demasiado del enlace de secciones. |