do not use a commit message

[phorkie.git] / README.rst

diff --git a/README.rst b/README.rst
index 0b40b395047bd5a8f965980cc020a36944c54f30..bda173d6e466153aa8274821055cf57112ab3181 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -20,9 +20,10 @@ Features
   - add new files
   - delete existing files
   - replace file with upload
   - add new files
   - delete existing files
   - replace file with upload

+- OpenID authentication

 - multiple files in one paste
 - syntax highlighting with GeSHi
 - multiple files in one paste
 - syntax highlighting with GeSHi

-- rST rendering
+- rST and Markdown rendering

 - image upload + display
 - external tool support
 
 - image upload + display
 - external tool support
 


@@ -41,7 +42,7 @@ Installation
 ============
 1. Unzip the phorkie release file::
 
 ============
 1. Unzip the phorkie release file::
 

-   $ tar xjvf phorkie-0.2.0.tar.bz2
+   $ tar xjvf phorkie-0.3.0.tar.bz2

 
 2. Create the git directories::
 
 
 2. Create the git directories::
 


@@ -58,7 +59,7 @@ Installation
 
    Look at ``config.default.php`` for values that you may adjust.
 
 
    Look at ``config.default.php`` for values that you may adjust.
 

-5. Set your web server's document root to ``/path/to/phorkie-0.2.0/www/``
+5. Set your web server's document root to ``/path/to/phorkie/www/``

 
 6. Open phorkie in your web browser
 
 
 6. Open phorkie in your web browser
 


@@ -67,6 +68,13 @@ Dependencies
 ============
 phorkie stands on the shoulders of giants.
 
 ============
 phorkie stands on the shoulders of giants.
 

+It requires the following programs to be installed
+on your machine:
+
+- Git v1.7.5 or later
+- PHP v5.3.0 or later
+- PEAR v1.9.2 or later
+

 ::
 
   $ pear install versioncontrol_git-alpha
 ::
 
   $ pear install versioncontrol_git-alpha


@@ -84,15 +92,19 @@ phorkie stands on the shoulders of giants.
   $ pear channel-discover zustellzentrum.cweiske.de
   $ pear install zz/mime_type_plaindetect-alpha
 
   $ pear channel-discover zustellzentrum.cweiske.de
   $ pear install zz/mime_type_plaindetect-alpha
 

+  $ pear channel-discover pear.michelf.ca
+  $ pear install michelf/Markdown
+

 Note that this version of GeSHi is a bit outdated, but it's the fastest
 way to install it.
 Note that this version of GeSHi is a bit outdated, but it's the fastest
 way to install it.

-
+If you install it manually be sure to update the
+path from ``data/config.default.php``.

 
 ======
 Search
 ======
 
 
 ======
 Search
 ======
 

-phorkie makes use of an Elasticsearch__ installation if you have one.
+phorkie makes use of an Elasticsearch__ installation, if you have one.

 
 It is used to provide search capabilities and the list of recent pastes.
 
 
 It is used to provide search capabilities and the list of recent pastes.
 


@@ -134,7 +146,7 @@ Make git repositories clonable
 To make git repositories clonable, you need to install ``git-daemon``
 (``git-daemon-run`` package on Debian/Ubuntu).
 
 To make git repositories clonable, you need to install ``git-daemon``
 (``git-daemon-run`` package on Debian/Ubuntu).
 

-Now make the repositories available by symlinking the paste repository
+Make the repositories available by symlinking the paste repository

 directory (``$GLOBALS['phorkie']['cfg']['repos']`` setting) into
 ``/var/cache/git``, e.g.::
 
 directory (``$GLOBALS['phorkie']['cfg']['repos']`` setting) into
 ``/var/cache/git``, e.g.::
 


@@ -148,13 +160,31 @@ The rest will be appended automatically.
 You're on your own to setup writable repositories.
 
 
 You're on your own to setup writable repositories.
 
 

+Protect your site with OpenID
+=============================
+You have the option of enabling OpenID authentication to help secure your
+pastes on phorkie.
+Set the ``$GLOBALS['phorkie']['auth']`` values in the
+``data/config.php`` file as desired.
+
+There are two different types of security you can apply.
+First, you can restrict to one of three ``securityLevels``:
+
+- completely open (``0``)
+- protection of write-enabled functions such as add, edit, etc. (``1``)
+- full site protection (``2``)
+
+Additionally, you can restrict your site to ``listedUsersOnly``.
+You will need to add the individual OpenID urls to the
+``$GLOBALS['phorkie']['auth']['users']`` variable.
+
+

 =================
 Technical details
 =================
 
 TODO
 ====
 =================
 Technical details
 =================
 
 TODO
 ====

-- OpenID-Login to get username+email as authorship information

 - filters (``xmllint --format``, ``rapper``)
 - document how to keep disk usage low (block size)
 - comments
 - filters (``xmllint --format``, ``rapper``)
 - document how to keep disk usage low (block size)
 - comments


@@ -182,6 +212,8 @@ URLs
   Show specific revision of the paste
 ``/[0-9]/delete``
   Delete the paste
   Show specific revision of the paste
 ``/[0-9]/delete``
   Delete the paste

+``/[0-9]/doap``
+  Show DOAP document for paste

 ``/[0-9]/fork``
   Create a fork of the paste
 ``/search?q=..(&page=[0-9]+)?``
 ``/[0-9]/fork``
   Create a fork of the paste
 ``/search?q=..(&page=[0-9]+)?``


@@ -192,8 +224,6 @@ URLs
   Shows form for new paste
 ``/login``
   Login page for protecting site
   Shows form for new paste
 ``/login``
   Login page for protecting site

-``/auth``
-  Authentication callback url

 ``/user``
   Edit logged-in user information
 
 ``/user``
   Edit logged-in user information
 


@@ -221,6 +251,7 @@ If you use nginx, place the following lines into your ``server`` block:
     rewrite ^/([0-9]+)$ /display.php?id=$1;
     rewrite ^/([0-9]+)/delete$ /delete.php?id=$1;
     rewrite ^/([0-9]+)/delete/confirm$ /delete.php?id=$1&confirm=1;
     rewrite ^/([0-9]+)$ /display.php?id=$1;
     rewrite ^/([0-9]+)/delete$ /delete.php?id=$1;
     rewrite ^/([0-9]+)/delete/confirm$ /delete.php?id=$1&confirm=1;

+    rewrite ^/([0-9]+)/doap$ /doap.php?id=$1;

     rewrite ^/([0-9]+)/edit$ /edit.php?id=$1;
     rewrite ^/([0-9]+)/fork$ /fork.php?id=$1;
     rewrite ^/([0-9]+)/raw/(.+)$ /raw.php?id=$1&file=$2;
     rewrite ^/([0-9]+)/edit$ /edit.php?id=$1;
     rewrite ^/([0-9]+)/fork$ /fork.php?id=$1;
     rewrite ^/([0-9]+)/raw/(.+)$ /raw.php?id=$1&file=$2;


@@ -236,6 +267,5 @@ If you use nginx, place the following lines into your ``server`` block:
     rewrite ^/search/([0-9]+)$ /search.php?page=$1;
 
     rewrite ^/login$ /login.php;
     rewrite ^/search/([0-9]+)$ /search.php?page=$1;
 
     rewrite ^/login$ /login.php;

-    rewrite ^/auth$ /auth.php;

     rewrite ^/user$ /user.php;
   }
     rewrite ^/user$ /user.php;
   }