(use-modules (haunt reader commonmark)) +
A reader for posts written in CommonMark, a fully specified variant of
+Markdown. Metadata is encoded as key: value pairs, one per line,
+at the beginning of the file. A line with the --- sentinel marks
+the end of the metadata section and the rest of the file is encoded as HTML.
+
Example: +
+title: Hello, CommonMark! +date: 2016-08-20 12:00 +tags: markdown, commonmark +--- + +## This is a CommonMark post + +CommonMark is a **strongly** defined, *highly* compatible +specification of Markdown, learn more about CommomMark +[here](http://commonmark.org/). +
(use-modules (haunt reader)) +
The purpose of a reader is to translate the markup within a post file +into an SXML tree representing the HTML structure and associate some +metadata with it. +
+Create a new reader. The reader is to be activated when
+matcher, a procedure that accepts a file name as its only
+argument, returns #t. When a post file matches, the procedure
+proc, which also accepts a file name as its only argument, reads
+the contents and returns a post object (see Posts).
+
Return #t if file-name is a file supported by
+reader.
+
Read a post object from file-name using reader, merging +its metadata with default-metadata, or the empty list if not +specified. +
Read all of the files in directory that match keep? as +post objects. The readers list must contain a matching reader +for every post. +
Create a procedure that returns #t when a file name ends with
+“.ext”.
+
A basic reader for posts written as Scheme code that evaluates to an
+an association list. The special key content contains the post
+body as an SXML tree.
+
Example: +
+(use-modules (haunt utils)) + +`((title . "Hello, world!") + (date . ,(string->date* "2015-04-10 23:00")) + (tags "foo" "bar") + (summary . "Just a test") + (content + ((h2 "Hello!") + (p "This is Haunt. A static site generator for GNU Guile.")))) +
A basic reader for posts written in plain ol’ HTML. Metadata is
+encoded as the key: value pairs, one per line, at the beginning
+of the file. A line with the --- sentinel marks the end of the
+metadata section and the rest of the file is encoded as HTML.
+
Example: +
+title: A Foo Walks Into a Bar +date: 2015-04-11 20:00 +tags: bar +--- +<p> + This is an example using raw HTML, because Guile doesn't have a + Markdown parser. +</p> +
+Next: CommonMark, Previous: Texinfo, Up: Readers [Contents][Index]
+(use-modules (haunt reader skribe)) +
A reader for posts written in Skribe, a markup language with the full power
+of Scheme. Skribe posts are created with the post expression with
+metadata encoded as :key expression pairs at the beginning of the
+post expression. After the metadata section, the rest of the post
+expression is encoded as HTML.
+
Example: +
+(post
+ :title "Hello, Skribe!"
+ :date (make-date* 2016 08 20 12 00)
+ :tags '("skribe" "foo" "baz")
+
+ (h2 [This is a Skribe post])
+
+ (p [Skribe is a ,(em [really]) cool document authoring format
+ that provides all the power of Scheme whilst giving the user
+ a means to write literal text without stuffing it into a
+ string literal. If this sort of thing suits you, be sure to
+ check out ,(anchor "Skribilo"
+ "http://www.nongnu.org/skribilo/"), too.]))
+(use-modules (haunt reader texinfo)) +
A reader for posts written in texinfo, the official documentation format
+of the GNU project. Metadata is encoded as key: value pairs, one
+per line, at the beginning of the file. A line with the ---
+sentinel marks the end of the metadata section and the rest of the file
+is encoded as HTML.
+
Example: +
+title: Hello, Texi!
+date: 2016-08-20 12:00
+tags: texinfo, foo
+---
+
+@emph{Texinfo} is the official documentation format of the
+@url{http://www.gnu.org/, GNU project}. It was invented by Richard
+Stallman and Bob Chassell many years ago, loosely based on Brian
+Reid's Scribe and other formatting languages of the time. It is
+used by many non-GNU projects as well.
+This document describes Haunt version 0.2, an extensible, +
This document describes Haunt version 0.2.1, an extensible, functional static site generator.
| • Contributing: | How to contribute to Haunt. | |||||||
+ | ||||||||
|---|---|---|---|---|---|---|---|---|
| • GNU Free Documentation License: | The license of this manual. | |||||||
| • Concept Index: | Concepts. @@ -137,6 +143,7 @@ functional static site generator. | |||||||
| • Programming Index: | Data types, procedures, syntax, and variables. | |||||||
+ | ||||||||
— The Detailed Node Listing — Installation @@ -148,6 +155,7 @@ Installation | ||||||||