[Summary view] [Print] [Text view]

   1  @title Phame User Guide
   2  @group userguide
   3  
   4  Journal about your thoughts and feelings. Share with others. Profit.
   5  
   6  = Overview =
   7  
   8  Phame is a simple blogging platform. You can write drafts which only you can
   9  see. Later, you can publish these drafts as posts which anyone who can access
  10  the Phabricator instance can see. You can also add posts to blogs to increase
  11  your distribution.
  12  
  13  Overall, Phame is intended to help an individual spread their message. As
  14  such, pertinent design decisions skew towards favoring the individual
  15  rather than the collective.
  16  
  17  = Drafts =
  18  
  19  Drafts are completely private so draft away.
  20  
  21  = Posts =
  22  
  23  Posts are accessible to anyone who has access to the Phabricator instance.
  24  
  25  = Blogs =
  26  
  27  Blogs are collections of posts. Each blog has associated metadata like
  28  a name, description, and set of bloggers who can add posts to the blog.
  29  Each blogger can also edit metadata about the blog and delete the blog
  30  outright.
  31  
  32  NOTE: removing a blogger from a given blog does not remove their posts that
  33  are already associated with the blog. Rather, it removes their ability to edit
  34  metadata about and add posts to the blog.
  35  
  36  Blogs can be useful for powering external websites, like
  37  
  38    blog.yourcompany.com
  39  
  40  by making pertinent configuration changes with your DNS authority and
  41  Phabricator instance. For the Phabricator instance, you must
  42  
  43   - Enable `policy.allow-public` in Phabricator configuration.
  44   - Configure the blog to have the view policy `public`.
  45  
  46  For your DNS authority, simply point the pertinent domain name at your
  47  Phabricator instance. e.g. by IP address.
  48  
  49  = Comment Widgets =
  50  
  51  Phame supports comment widgets from Facebook and Disqus. The administrator
  52  of the Phabricator instance must properly configure Phabricator to enable
  53  this functionality.
  54  
  55  A given comment widget is tied 1:1 with a given post. This means the same
  56  instance of a given comment widget will appear for a given post regardless
  57  of whether that post is being viewed in the context of a blog.
  58  
  59  = Next Steps =
  60  
  61   - Phame is extremely new and very basic for now. Give us feedback on
  62     what you'd like to see improve! See @{article:Give Feedback! Get
  63     Support!}.