Skip to content

On-the-fly documentation generation powered by ndogen

Notifications You must be signed in to change notification settings

quasipartikel/ndogen-client

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ndogen-client

A viewer for a all-new ambitious source documentation format. ;-)

Ndogen exposes documentation as data (JSON) instead of pre-rendered HTML. This approach not only saves some bytes at transmission, it also allows clients to individually render the result.

I'll start with a clean document output format, with some unobtrusive interaction (navigation, search, etc.).

ndogen Syntax (Early Draft)

NDOGEN - Natural text markup
=================================================================

Ndogen exposes documentation as data (JSON) instead of pre-rendered HTML. 
This approach not only saves some bytes at transmission, it also allows
clients to individually render the result. 


Block Elements
-----------------------------------------------------------------

Paragraph
.................................................................

A paragraph is simply one or more consecutive lines of text, separated
by one or more blank lines. Normal paragraphs should not be indented with
spaces or tabs.


Sections
.................................................................

Sections, inspired by the Setext-style, are “underlined” using equal signs
(for first-level sections) and dashes (for second-level sections) or dots 
(third-level sections).

For example:

$ Section 1
$ =============
$ 
$ Section 2
$ -------------
$ 
$ Section 3
$ .............


Unordered Lists
.................................................................

Ndogen supports nested lists and hanging indents.

$  * Red
$  * Green
$    Additional Line
$    * Dark Green
$    * Light Green
$  * Blue


Ordered Lists
.................................................................

$  # Red
$  # Green
$    Additional Line
$    # Dark Green
$    # Light Green
$  # Blue


Code Blocks
.................................................................

Use preceded $-signs to denote code blocks.

$ $ $(function() {
$ $   ndogen.run();
$ $ });


Topics
.................................................................

$  A Topic:
$  
$  A subsequent paragraph,
$  with some text


Definitions
.................................................................

$  First definition:    The value can be a paragraph
$                       or any other element.
$
$  Second definition:   * Item 1
$                       * Item 2


Span Elements
-----------------------------------------------------------------


Links
.................................................................

Links are ready to be used inline. Links can be references to local
anchors or external resources.

$ An external Link[http://quasipartikel.at].
$ For more than one word as the link name you have to use quotes. 
$ "See here"[http://github.com/oliver----/ndogen]
$ 
$ This is a references to a local anchor [SomeAnchor]


Emphasized text
.................................................................

$ _Single underscores_ or *single asterisks*


Strong text
.................................................................

$ _Double underscores_ or *double asterisks*


Inline Code
.................................................................

$ You can create an instance with `new Person()`

About

On-the-fly documentation generation powered by ndogen

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published