Author: Shimmy Xu <firstname.lastname@example.org>
Date: Sun, 5 Jan 2020 10:52:10 -0600
Add notes on email hashes
1 file changed, 8 insertions(+), 0 deletions(-)
diff --git a/README.org b/README.org
@@ -27,4 +27,12 @@ The theme expects to find =/data/comments.toml= in the blog directory with the f
+For the email form to work properly, please specify in blog's =config.toml= author's email, which will be used for submission and matching blog author's comments. You can specify author information like so:
+ email = "email@example.com"
+The last 10 characters of =email_hash= will be displayed on the page for anyone aside from the blog author (SHA256 is used to match author email to given email hash). It is preferable to also only store the last 10 or fewer characters of email hash in the =comments.toml= file. This is used as an alternative to services like Gravatar or Libravatar for identification purposes, which would have required storing the entire hash value.
By default, form data is sent using URL encoding in body of the email. An easy way to convert it back is to use =urllib.parse.unquote= in Python.