I’m a writer blog

Guidelines for writing Poems, Stories and Tales

AsciiDoc: how can I get the author’s name in the output document?

Asked by: Casey Hart

If you are using the default Asciidoctor templates for HTML output, the author and their email address is included beneath the document heading.

What is author line?

What’s the author line? The author line is directly after the document title line in the document header. When the content on this line is structured correctly, the processor assigns the content to the built-in author and email attributes.

What is the difference between AsciiDoc and Asciidoctor?

Asciidoctor aims to be compliant with the AsciiDoc syntax, but there are some differences to keep in mind. Many of these differences exist so that Asciidoctor can: enforce rules we believe are too lax or ambiguous in AsciiDoc. process documents faster and smarter.

What is AsciiDoc format?

AsciiDoc is a text document format that was explicitly designed with the needs of publishing in mind, both print and web. It supports all the structural elements necessary for writing notes, documentation, articles, books, ebooks, slideshows, web pages, technical manuals and blogs.

How do I view AsciiDoc?

To preview an AsciiDoc document in a web browser, install the Chrome extension, the Edge add-on, the Firefox add-on, or the Opera extension (all produced from the same code base). Then you can see the AsciiDoc file rendered as HTML just by visiting it.

Is AsciiDoc a markdown?

AsciiDoc uses the same number of markup characters or less when compared to Markdown in nearly all cases. AsciiDoc uses a consistent formatting scheme (i.e., it has consistent patterns). AsciiDoc can handle all permutations of nested inline (and block) formatting, whereas Markdown often falls down.

How do I add an image to AsciiDoc?

Let’s break down the AsciiDoc syntax and resource coordinates you need to insert a block image into a page.

  1. On a new line, enter the macro’s name followed by two colons, image:: . …
  2. Enter the resource ID of the image file. …
  3. Complete the macro with a set of square brackets ( [] ).

How do I edit ADOC?

You can open an ADOC file and edit the text it contains in any text editor, including Microsoft Notepad (Windows), Apple TextEdit (Mac), Microsoft Visual Studio Code (cross-platform), and GitHub Atom (cross-platform).

How do I Preview ADOC?

Toggle the preview pane, which appears to the right of the editor, by using the key combination ctrl-shift-a or cmd-shift-a. It is currently enabled for . adoc , .
More options are available :

  1. in the package settings.
  2. in the global menu.
  3. by right-clicking on the preview.
  4. by right-clicking on an AsciiDoc file.