X-Git-Url: https://git.cweiske.de/shpub.git/blobdiff_plain/25221c2608df58ebd0fe1c5fbbb886ec160c78ec..85560adaf8334674b1c66baa2edc7f00fa6e1100:/README.rst
diff --git a/README.rst b/README.rst
index d2255be..1ac15c9 100644
--- a/README.rst
+++ b/README.rst
@@ -9,8 +9,13 @@ Command line `micropub `_ client written in PHP.
========
Download
========
-The `github releases page `_
-has self-contained ``.phar`` files that have all dependencies included.
+shpub is released as self-contained ``.phar`` file that includes
+all dependencies.
+
+.. LATESTRELEASE
+
+See `shpub downloads page `_
+for all released versions.
Dependencies
@@ -19,6 +24,7 @@ When using the git version, you need to have the following dependencies
installed on your system:
- PHP 5.4+
+- PEAR's `Console_CommandLine `_
- PEAR's `HTTP_Request2 `_
- PEAR's `MIME_Type `_
- PEAR's `NET_URL2 `_
@@ -108,6 +114,29 @@ URL image upload::
Note created at server
http://known.bogo/2016/img-url
+Load note content from a file::
+
+ $ ./bin/shpub.php note - < /path/to/file.txt
+ Note created at server
+ http://known.bogo/2017/some-note
+
+
+Custom post types
+=================
+You may create custom post types with the ``x`` command.
+This is useful if your micropub endpoint supports additional types,
+like known's ``annotation`` type (comments and likes for posts).
+
+Create a comment to a known post::
+
+ $ ./bin/shpub.php x annotation\
+ -x url=http://known.bogo/2016/example-domain-1\
+ -x type=reply\
+ -x username=barryf\
+ -x userurl=http://example.org/~barryf\
+ -x userphoto=http://example.org/~barryf/avatar.jpg\
+ -x content="There is a typo in paragraph 1. 'Fou' should be 'Foo'"
+
===============
Delete/Undelete
@@ -134,6 +163,19 @@ Existing posts can be modified if the `server supports this`__::
__ https://indieweb.org/Micropub/Servers#Implementation_status
+===================
+Syndication targets
+===================
+You may list the syndication targets defined on the server::
+
+ $ ./bin/shpub.php targets
+ IndieNews
+ https://news.indieweb.org/en
+
+Then specify it when creating a post::
+
+ $ ./bin/shpub.php article -x mp-syndicate-to=https://news.indieweb.org/en title text
+
============
File uploads
============
@@ -174,6 +216,8 @@ to see ``curl`` command equivalents to the shpub HTTP requests::
===========
About shpub
===========
+shpub's homepage is http://cweiske.de/shpub.htm
+
Source code
===========