@item Uses @url{https://en.wikipedia.org/wiki/Inetd, inetd} interface
for working as @url{https://en.wikipedia.org/wiki/Gopher_(protocol), Gopher}
server
+@item Topics (tags/categories) support
@item Supports on the fly generation of
@url{https://en.wikipedia.org/wiki/Atom_(feed), Atom} feeds
for posts, comments and per-post comments
copy of your blog/phlog!
@end itemize
-All of that, except for comments and phlog, could be achieved with some
-Git viewer like @url{https://git.zx2c4.com/cgit/about/, cgit}. But
-SGBlog also is able to:
+All of that, except for comments, topics and phlog, could be achieved
+with some Git viewer like @url{https://git.zx2c4.com/cgit/about/, cgit}.
+But SGBlog also is able to:
@itemize
@item Convert URLs to clickable links
@menu
* Comments::
+* Topics::
* Installation::
* Configuration::
@end menu
message to special address. For example:
@example
-mutt "mailto:comment@@blog.example.com?subject=576540a5b98517b46d0efc791bb90b9121bf147e" <<EOF
+$ mutt "mailto:comment@@blog.example.com?subject=576540a5b98517b46d0efc791bb90b9121bf147e" <<EOF
This is the comments contents.
Could be multilined of course.
EOF
are accepted and only with UTF-8, US-ASCII, ISO-8859-1 character sets.
Sane people won't send HTML email anyway, but this is just a precaution.
+@node Topics
+@unnumbered Topics
+
+Each post can have any number of attached topics (also known as tags or
+categories). They are whitespace separated single words kept in separate
+@url{https://git-scm.com/docs/git-notes, note} namespace. You can
+add/change comments with commands like:
+
+@example
+$ git notes --ref=topics add -m "linux hate" @@
+@end example
+
@node Installation
@unnumbered Installation
CommentsNotesRef: refs/notes/comments
# Display link for comment writing, if email is set
CommentsEmail: something@@example.com
+
+ # If that ref is set, then topics will be loaded from it
+ TopicsNotesRef: refs/notes/topics
+ # Optional file for topics state caching
+ TopicsCachePath: /path/to/sgblog-topics-cache.gob
@}
@end example
# Both are optional
CommentsNotesRef: refs/notes/comments
CommentsEmail: something@@example.com
+
+ # Both are optional too
+ TopicsNotesRef: refs/notes/topics
+ TopicsCachePath: /path/to/sgblog-topics-cache.gob
@}
@end example