Learn X in Y minutes

AsciiDoc je označevalni jezik, ki je podoben Markdownu in ga je mogoče uporabiti za vse od knjig do spletnih dnevnikov. Jezik, ki ga je leta 2002 ustvaril Stuart Rackham, je preprost, vendar omogoča veliko prilagoditev.

Glava dokumenta

Glave so neobvezne in ne smejo vsebovati praznih vrstic. Od vsebine jih mora ločiti vsaj ena prazna vrstica.

Naslov

= Naslov dokumenta

Prvi stavek dokumenta.

Naslov in avtor

= Naslov dokumenta
Ime Priimek <[email protected]>

Prvi stavek dokumenta.

Naslov in več avtorjev

= Naslov dokumenta
Ime Priimek <[email protected]>; Janez Novak <[email protected]>

Prvi stavek dokumenta.

Vrstica za revizijo

= Naslov dokumenta V1
Janez Novak <[email protected]>
v1.0, 2016-01-13

Prvi stavek dokumenta.

Odstavki

Za odstavke ne potrebujete nič posebnega.

Da jih ločite, dodajte prazno črto med odstavki.

Če želite ustvariti prazno vrstico, dodajte +
in ustvarili boste prelom vrstice!

Oblikovanje besedila

_podčrtaj za pošvno_
*zvezdice za krepko*
*_kombinacije za zabavo_*
`krativec za monospace`
`*krepki monospace*`

Naslovi razdelkov

= Stopnja 0 (samo za naslov dokumenta)

== Stopnja 1 <h2>

=== Stopnja 2 <h3>

==== Stopnja 3 <h4>

===== Stopnja 4 <h5>

Seznami

Če želite ustvariti neoštevilčen seznam, uporabite zvezdice.

* foo
* bar
* baz

Če želite ustvaril oštevilčen seznam, uporabite pike.

. predmet 1
. predmet 2
. predmet 3

Seznami lahko do petkrat gnezdite tako, da dodate dodatne zvezdice ali pike.

* foo 1
** foo 2
*** foo 3
**** foo 4
***** foo 5

. foo 1
.. foo 2
... foo 3
.... foo 4
..... foo 5

Nadaljnje branje

Obstajata dve orodji za obdelavo AsciiDoc dokumentov:

1. AsciiDoc: izvirna implementacija v Pythonu je na voljo v glavnih distribucijah Linuxa. Stabilen in trenutno v vzdrževalnem načinu.
2. Asciidoctor: alternativna Ruby implementacija, uporabno tudi iz Java in JavaScript. Z aktivnim razvojem si prizadeva razširiti sintakso AsciiDoc z novimi funkcijami in izhodnimi formati.

Naslednje povezave so povezane Asciidoctor implementacijo:

• Markdown - AsciiDoc syntax comparison: primerjava skupnih elementov Markdowna in AsciiDoca.
• Getting started: namestitev in navodila, ki omogočajo enostavne dokumente.
• Asciidoctor User Manual: popolni priročnik z enim dokumentom s sklicevanjem na sintakso, primeri in oridji za upodabljanje.

Got a suggestion? A correction, perhaps? Open an Issue on the GitHub Repo, or make a pull request yourself!

Originally contributed by Ryan Mavilia, and updated by 2 contributors.