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 
  35  tags: list of tags associated with this post
  36 
  37  comments: entry enumerates all the comment IDs for this post
  38 
  39  listed: list this post on the index/tag/archive pages?
  40 
  41 
  42 Comment
  43 -------
  44 
  45 Comments store their metadata alongside the comment text in a file called
  46 "meta.lisp".  The contents are a Lisp alist.  For example:
  47 
  48 ((author . "bob")
  49  (email . "bob@example.com")
  50  (time . "2015-09-19 21:30")
  51  (ip . "10.10.10.10")
  52  (url . "http://example.com")
  53  (moderated . #t))
  54 
  55 
  56 Again, the entries are self explanatory.
  57 
  58  author: the author of the comment
  59 
  60  email: the email address of the comment author
  61 
  62  time: time of comment (UTC)
  63 
  64  ip: the IP address used by the comment author to leave the comment
  65 
  66  url: the comment author's website
  67 
  68  moderated: has this post been moderated?