1 Lisp-formated Post and Comment Metadata
   2 =======================================
   3 
   4 We use a Lisp-type syntax to keep track of all the metadata.  For more
   5 information about the exact syntax, look at lisp.txt in the docs directory.
   6 
   7 
   8 Post
   9 ----
  10 
  11 Posts' metadata is stored alongside the post text in a file called
  12 "post.lisp".  The contents are a Lisp alist.  For example:
  13 
  14 ((time . "2015-09-19 21:28")
  15  (title . "abcdef")
  16  (fmt . 3)
  17  (tags "tag1" "tag2")
  18  (comments 1 2 3)
  19  (listed #t))
  20 
  21 
  22 Most entries are self explanatory.  With that said,
  23 
  24  time: the time of publication (UTC)
  25 
  26  title: the title of this post
  27 
  28  fmt: format version for the post text itself
  29 
  30    The supported formats are:
  31 
  32      2: raw HTML
  33      3: pseudo-LaTeX
  34      4: Markdown (MD)
  35 
  36  tags: list of tags associated with this post
  37 
  38  comments: entry enumerates all the comment IDs for this post
  39 
  40  listed: list this post on the index/tag/archive pages?
  41 
  42 
  43 Comment
  44 -------
  45 
  46 Comments store their metadata alongside the comment text in a file called
  47 "meta.lisp".  The contents are a Lisp alist.  For example:
  48 
  49 ((author . "bob")
  50  (email . "bob@example.com")
  51  (time . "2015-09-19 21:30")
  52  (ip . "10.10.10.10")
  53  (url . "http://example.com")
  54  (moderated . #t))
  55 
  56 
  57 Again, the entries are self explanatory.
  58 
  59  author: the author of the comment
  60 
  61  email: the email address of the comment author
  62 
  63  time: time of comment (UTC)
  64 
  65  ip: the IP address used by the comment author to leave the comment
  66 
  67  url: the comment author's website
  68 
  69  moderated: has this post been moderated?