AsciiDoc - AsciiDoc

AsciiDoc
První vydání2002; Před 18 lety (2002)
Otevřený formát ?Ano
webová stránkaasciidoc.org Upravte to na Wikidata
AsciiDoc
Původní autořiStuart Rackham
VývojářiDan Allen, Michel Krämer, et al.
První vydání25. listopadu 2002; Před 18 lety (2002-11-25)
Stabilní uvolnění
9.0.4 / 20. října 2020; Před 41 dny (2020-10-20)
Úložištěgithub.com/ asciidoc/ asciidoc-py3
NapsánoKrajta
Operační systémCross-platform
TypGenerátor dokumentace
LicenceGPL v2
webová stránkaasciidoc.org
Asciidoctor
Původní autořiRyan Waldron
VývojářiDan Allen, Sarah White, et al.
První vydání30. ledna 2013; před 7 lety (2013-01-30)
Stabilní uvolnění
2.0.12 / 9. listopadu 2020; Před 21 dny (2020-11-09)
Úložištěgithub.com/ asciidoctor/ asciidoctor
NapsánoRubín
Operační systémCross-platform
TypGenerátor dokumentace
LicenceMIT
webová stránkaasciidoctor.org

AsciiDoc je čitelné člověkem formát dokumentu, sémanticky ekvivalentní formátu DocBook XML, ale pomocí prostý text přirážka konvence. Dokumenty AsciiDoc lze vytvářet pomocí libovolného textový editor a číst „tak, jak je“, nebo vykreslen do HTML nebo jakýkoli jiný formát podporovaný řetězcem nástrojů DocBook, tj. PDF, TeX, Unix stránky, e-knihy, prezentace atd.[1] Běžné přípony souborů pro soubory AsciiDoc jsou txt(jak to podporuje tvůrce AsciiDoc) a adoc.[2][3]

Dějiny

AsciiDoc byl vytvořen v roce 2002 uživatelem Stuart Rackham, který publikoval nástroje („asciidoc“ a „a2x“), napsané v Programovací jazyk Python převádět „čitelné“ soubory ve formátu prostého textu do běžně používaných formátů publikovaných dokumentů.[1]

A Rubín implementace s názvem „Asciidoctor“, vydaná v roce 2013, je používána společností GitHub[4] a GitLab.[5] Tato implementace je k dispozici také v Jáva používání ekosystému JRuby a v JavaScript ekosystém využívající Opal.js.

Některý z O'Reilly Media Knihy a e-knihy jsou autorem značek AsciiDoc.[6]

Většina Projekt Git dokumentace je napsána v AsciiDoc.[7]

Příklad

Následující text zobrazuje text pomocí značky AsciiDoc a vykreslování podobné tomu, které vytváří procesor AsciiDoc:

Zdrojový text Asciidoc
= Můj článek J. Smithhttps: //wikipedia.org [Wikipedia] je online encyklopedie, dostupná v angličtině a *mnoho* další jazyky. == Software Program 'název-balíčku' můžete nainstalovat pomocí `klenot` příkaz: gem install package-name == HardwareMetals běžně používané patří:* měď* cín* Vést
Výsledek vykreslený HTML
Můj článek

J. Smith

Wikipedia je online encyklopedie, dostupná v angličtině a mnoho jiné jazyky.

Software

Můžete nainstalovat název-balíčku za použití klenot příkaz:

gem nainstalovat název-balíčku
Hardware

Mezi běžně používané kovy patří:

  • měď
  • cín
  • Vést

Nástroje

  • Antora - generátor webů s více úložišti pro technické autory používající sakra.
  • AsciiBinder - (zastaralý) dokumentační systém postavený na Asciidoctor pro lidi, kteří mají spoustu dokumentů k pravidelné údržbě a opětovnému publikování.
  • západ - statický generátor stránek inspirovaný Jekyll.

Viz také

Reference

  1. ^ A b „AsciiDoc“.
  2. ^ „AsciiDoc - často kladené otázky“. asciidoc.org. Citováno 2020-03-20.
  3. ^ "AsciiDoc doporučené postupy | Asciidoctor". asciidoctor.org. Citováno 2020-03-20.
  4. ^ „AsciiDoc, založený na Asciidoctor, se vrací na GitHub a jeho 5+ milionů úložišť“.
  5. ^ "Asciidoc". Uživatelské dokumenty GitLab. Citováno 6. února 2020.
  6. ^ „AsciiDoc 101 (kapitola 4 Začínáme s Atlasem)“. Autorská uvítací sada. O'Reilly Media. Archivovány od originál dne 14. října 2017. Citováno 19. května 2016.
  7. ^ „Git wiki“. Git SCM.

externí odkazy