|
| 1 | +--- |
| 2 | +language: asciidoc |
| 3 | +contributors: |
| 4 | + - ["Ryan Mavilia", "http://unoriginality.rocks/"] |
| 5 | +translators: |
| 6 | + - ["Abel Salgado Romero", "https://twitter.com/abelsromero"] |
| 7 | +lang: ca-es |
| 8 | +filename: asciidoc-ca.md |
| 9 | +--- |
| 10 | + |
| 11 | +AsciiDoc és un llenguatge de marques similar a Markdown i que pot ser usat per qualsevol ús, des de llibres fins a blogs. |
| 12 | +Creat al 2002 per Stuart Rackham, és un llenguatge simple però permet un gran nivell de personalització. |
| 13 | + |
| 14 | +Capçalera de document |
| 15 | + |
| 16 | +La capçalera és opcional i no pot contenir línies buides. Ha d'estar separada del contingut per com a mínim una línia en blanc. |
| 17 | + |
| 18 | +Només títol |
| 19 | + |
| 20 | +``` |
| 21 | += Títol del document |
| 22 | +
|
| 23 | +Primer contingut del document. |
| 24 | +``` |
| 25 | + |
| 26 | +Títol i autor |
| 27 | + |
| 28 | +``` |
| 29 | += Títol del document |
| 30 | + |
| 31 | +
|
| 32 | +Inici d'aquest document. |
| 33 | +``` |
| 34 | + |
| 35 | +Múltiples autors |
| 36 | + |
| 37 | +``` |
| 38 | += Títol del document |
| 39 | + |
| 40 | +
|
| 41 | +Inici d'un document amb múltiples autors. |
| 42 | +``` |
| 43 | + |
| 44 | +Línia de versió (requereix línia d'autor) |
| 45 | + |
| 46 | +``` |
| 47 | += Títol del document V1 |
| 48 | + |
| 49 | +v1.0, 2016-01-13 |
| 50 | +
|
| 51 | +Aquest article sobre patates fregides serà genial. |
| 52 | +``` |
| 53 | + |
| 54 | +Paràgraf |
| 55 | + |
| 56 | +``` |
| 57 | +No necessites res especial per un paràgraf. |
| 58 | +
|
| 59 | +Insereix una línia buida entre cada paràgraf per separar-los. |
| 60 | +
|
| 61 | +Per inserir un salt de línia, afegeix només un + |
| 62 | +i ja ho tens! |
| 63 | +``` |
| 64 | + |
| 65 | +Donant format al text |
| 66 | + |
| 67 | +``` |
| 68 | +_guió baix per cursiva_ |
| 69 | +*asteriscs per negreta* |
| 70 | +*_combina'ls i veuràs_* |
| 71 | +`usa cometes invertides per monospace` |
| 72 | +`*combina per negreta monospace*` |
| 73 | +``` |
| 74 | + |
| 75 | +Títols de secció |
| 76 | + |
| 77 | +``` |
| 78 | += Nivell 0 (usa'l només pel títol del document) |
| 79 | +
|
| 80 | +== Nivell 1 <h2> |
| 81 | +
|
| 82 | +=== Nivell 2 <h3> |
| 83 | +
|
| 84 | +==== Nivell 3 <h4> |
| 85 | +
|
| 86 | +===== Nivell 4 <h5> |
| 87 | +``` |
| 88 | + |
| 89 | +Llistes |
| 90 | + |
| 91 | +Per crear una llista sense ordre usa asteriscs. |
| 92 | + |
| 93 | +``` |
| 94 | +* foo |
| 95 | +* bar |
| 96 | +* baz |
| 97 | +``` |
| 98 | + |
| 99 | +Per crear una llista numerada usa punts. |
| 100 | + |
| 101 | +``` |
| 102 | +. element 1 |
| 103 | +. element 2 |
| 104 | +. element 3 |
| 105 | +``` |
| 106 | + |
| 107 | +Pots crear fins a 5 subnivells de llista afegint asteriscs o punts. |
| 108 | + |
| 109 | +``` |
| 110 | +* foo 1 |
| 111 | +** foo 2 |
| 112 | +*** foo 3 |
| 113 | +**** foo 4 |
| 114 | +***** foo 5 |
| 115 | +
|
| 116 | +. foo 1 |
| 117 | +.. foo 2 |
| 118 | +... foo 3 |
| 119 | +.... foo 4 |
| 120 | +..... foo 5 |
| 121 | +``` |
| 122 | + |
| 123 | +## Referències |
| 124 | + |
| 125 | +Existeixen dues eines per processar documentació en AsciiDoc: |
| 126 | + |
| 127 | +1. [AsciiDoc](http://asciidoc.org/): implementació original per Python, disponible a las principals distribucions Linux. Versió estable actualment en mode manteniment. |
| 128 | +2. [Asciidoctor](http://asciidoctor.org/): implementació alternativa per Ruby, usable també des de Java i JavaScript. Implementació completa en evolució, té com a objectiu ampliar AsciiDoc amb noves funcionalitats i conversors de sortida. |
| 129 | + |
| 130 | +Els següents enllaços pertanyen a `Asciidoctor` (documentació en anglès): |
| 131 | + |
| 132 | +* [Comparació de sintaxi Markdown - AsciiDoc](http://asciidoctor.org/docs/user-manual/#comparison-by-example): comparativa d'elements comuns entre Markdown i AsciiDoc. |
| 133 | +* [Primeres pases](http://asciidoctor.org/docs/#get-started-with-asciidoctor): manuals d'instal·lació i inici per convertir documents simples. |
| 134 | +* [Manual d'usuari d'Asciidoctor](http://asciidoctor.org/docs/user-manual/): referència completa en un únic document, conté exemples, guies d'eines, etc. |
0 commit comments