add a README - tttml - converters for a simpler syntax than markdown
(HTM) git clone git://bitreich.org/tttml git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/tttml
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) Tags
(DIR) README
---
(DIR) commit e5f695470b3ce7553e2e1609b9341e957f5fceae
(DIR) parent 97183e4b8e6d679289e808e461a4f8b4294fde4f
(HTM) Author: Josuah Demangeon <mail@josuah.net>
Date: Thu, 19 Apr 2018 03:45:53 +0200
add a README
Diffstat:
M Makefile | 4 ++++
A README | 86 ++++++++++++++++++++++++++++++
2 files changed, 90 insertions(+), 0 deletions(-)
---
(DIR) diff --git a/Makefile b/Makefile
@@ -4,6 +4,10 @@ MAN5 = markup.5
all:
+
+README: $(MAN5)
+ mandoc -T utf8 $(MAN5) | col -bx >$@
+
install:
mkdir -p $(PREFIX)/bin
cp $(BIN) $(PREFIX)/bin
(DIR) diff --git a/README b/README
@@ -0,0 +1,86 @@
+MARKUP(5) File Formats Manual MARKUP(5)
+
+NAME
+ markup simpler markup syntax than markdown
+
+SYNOPSIS
+ markup.md
+
+DESCRIPTION
+ The markup format is a very simple format for writiing text that look
+ good enough to be published without conversion. It lacks the markdown
+ recursive syntax (such as recursive lists anb quotes) which also remove
+ markdown ambiguities. Each block of text is separated from anotherone by
+ an empty line.
+
+ paragraph
+ Any non-special block of text:
+
+ First paragraph of text.
+
+ Second paragraph of text.
+
+ title Block that ends by a line with only =:
+
+ Title can therefore have multiple lines if required
+ although it is not advised.
+ ======================================================
+
+ heading
+ Block that ends with a line with only -:
+
+ Heading can also have multiple lines
+ ------------------------------------------------------
+
+ subheading
+ Block with a single line with at least 3 leading # characters
+ starting at subheading and going down the outline (subheading,
+ subsubheading ...) every time an additionnal # is added:
+
+ ### Subheading
+
+ #### Subsubheading
+
+ ##### Subsubsubheading
+
+ tag Block that start with a tag line:
+
+ *tagline with asterisks and a column*:
+ Body of the tag block that can span over multiple
+ lines like regular paragraphs.
+
+ list Block that start with a dash:
+
+ - List item. The following lines might not have
+ leading space.
+
+ - Note that multi-paragraph lists are not handled
+
+ quote Block that has a leading > on every line:
+
+ > Mail-style quoting. Note that nested quotes
+ > are not handled.
+
+ literal
+ Block that has a leading tab on every line:
+
+ Nothing gets interpreted in these blocks.
+ They get printed as-is.
+ They may contain extra tabs.
+
+ link Block that start with a label line and eventual subsequent
+ description lines:
+
+ [label]: git://josuah.net/git/markup.git
+ git repository for the markup set of tools
+
+ [label2]: /url/without/description.txt
+
+SEE ALSO
+ smu(1), simple markup - markdown like syntax:
+ https://github.com/Gottox/smu
+
+AUTHORS
+ Josuah Demangeon <mail@josuah.net>
+
+OpenBSD 6.3 April 19, 2018 OpenBSD 6.3