AsciiDoc Guide (ADOC source)
An AsciiDoc getting-started guide with source blocks, an admonition, and a table — for testing AsciiDoc renderers (Asciidoctor), editors, and conversion to HTML/PDF.
= Novus Widget: Getting Started
Novus Examples <docs@example.com>
:toc:
:icons: font
A sample AsciiDoc document for testing renderers and editors.
== Installation
[source,bash]
----
npm install novus-widget
----
== Usage
Import the widget and mount it:
[source,js]
----
import { Widget } from "novus-widget";
new Widget("#app").render();
----
TIP: Call `render()` after the DOM is ready.
== Options
[cols="1,1,3", options="header"]
|===
| Option | Default | Description
| theme | light | Colour theme (light or dark)
| size | md | One of sm, md, lg
| locale | en | BCP-47 language tag
|===
== License
Free for any use. This text is synthetic sample content.
Specifications
- Format
- AsciiDoc
- Features
- headings, source blocks, admonition, table
What is a .adoc file?
AsciiDoc is a lightweight plain-text markup language for writing documentation, articles, and books. It is more powerful than Markdown — with admonitions, includes, tables, and cross-references — and converts to HTML, PDF, DocBook, and man pages via tools like Asciidoctor. The .adoc extension is the common file type.
How to use this file
Use an example .adoc file to test AsciiDoc editors and renderers, syntax highlighting, and Asciidoctor conversion to HTML or PDF.
Related files
- texLaTeX Article (TEX source)A small LaTeX article source with an abstract, a numbered equation (the Nyquist criterion), and a table — for testing LaTeX editors, syntax highlighters, and TeX-to-PDF pipelines.

- rstreStructuredText Doc (RST source)A reStructuredText document with directives, a code block, a note admonition, and a table — for testing docutils/Sphinx rendering, reST parsers, and editors.

- assASS Subtitles (Advanced SSA)An Advanced SubStation Alpha (.ass) subtitle with a styles section and three timed Dialogue events — the styled format libass renders — carrying the same captions as the SRT/VTT twins.

- sbvSBV Captions (YouTube)A YouTube SBV caption file — start,end timestamp lines followed by caption text — carrying the same three captions, for testing SBV parsers and YouTube caption import.

- ssaSSA Subtitles (SubStation Alpha)A SubStation Alpha (.ssa) subtitle — the predecessor of ASS — with a V4 styles section and timed Dialogue events, carrying the same captions, for testing SSA parsers and SSA-to-ASS upgrades.

- ttmlTTML Captions (DFXP)A TTML (Timed Text Markup Language / DFXP) caption document — timed XML paragraphs with a styling region — carrying the same captions, for testing XML caption parsers and IMSC players.

Generated by generation/docs_realworld.py. Free for any use, no attribution required — license.