[go: up one dir, main page]

Talk:AsciiDoc

Latest comment: 1 year ago by Cdokolas in topic More tools

Separation of program implementation and the markup language itself

edit

Although the program name is AsciiDoc, and presumably the reference implementation for transforming AsciiDoc, it would be good to separate the markup language from the programs that implement it. So something like a section describing what the language is, and another for the programs available to implement it. — Preceding unsigned comment added by Allgood38 (talkcontribs) 14:09, 24 March 2015 (UTC)Reply

Good idea. Be bold and do it! The example section does a half-decent job of explaining the language itself. The history section could use some improvement regarding history, but has information on two implementations. --RainerBlome (talk) 08:28, 30 March 2015 (UTC)Reply

File extension?

edit

Do asciidoc files usually have some specific file extension? Perhaps .asc or something like that, since some software (e.g. GitHub) seem to be able to identify asciidoc documents? —Kri (talk) 21:55, 20 May 2015 (UTC)Reply

The AsciiDoc FAQ says [1] says
"What is the preferred file name extension for AsciiDoc files? The .txt text file extension is preferred".
Most git documentation[2] is written in AsciiDoc[3] using a ".txt" extension.
On the other hand, many people recommend using ".asciidoc" or ".adoc" extension.[4]; [5]; [6]
What should we say in this article about the file extension? --DavidCary (talk) 20:33, 26 August 2015 (UTC)Reply
What you have written here seems like a good start to me. :) —Kri (talk) 15:54, 26 October 2015 (UTC)Reply

More tools

edit

Somebody should (properly) add docToolchain[7] in the list of tools Cdokolas (talk) 09:36, 17 May 2023 (UTC)Reply